Microsoft SharePoint Online সংযোগকারী স্থাপন করুন

আপনি আপনার গুগল ওয়ার্কস্পেস কন্টেন্টের পাশাপাশি আপনার প্রতিষ্ঠানের শেয়ারপয়েন্ট অনলাইন কন্টেন্ট থেকেও ফলাফল দেখানোর জন্য গুগল ক্লাউড সার্চ সেট আপ করতে পারেন। ক্লাউড সার্চ শেয়ারপয়েন্ট অনলাইন কানেক্টরটি ব্যবহার করুন এবং একটি নির্দিষ্ট শেয়ারপয়েন্ট অনলাইন ডেটা সোর্স অ্যাক্সেস করার জন্য এটি কনফিগার করুন।

গুরুত্বপূর্ণ বিবেচ্য বিষয়

SharePoint Online কানেক্টরটি স্থাপন করার আগে, নিম্নলিখিত বিষয়গুলো সম্পর্কে সচেতন থাকুন।

সম্মানিত SharePoint সেটিংস

কানেক্টরটি সর্বদা SharePoint-এর সার্চ ভিজিবিলিটি সেটিং মেনে চলে। ড্রাফট ডকুমেন্টের ক্ষেত্রে, কানেক্টরটি SharePoint Online অ্যাক্সেস করার জন্য যে ইউজার অ্যাকাউন্ট ব্যবহার করে, তার পারমিশনই নিয়ন্ত্রণ করে যে এটি কোন ড্রাফট ডকুমেন্টগুলোকে ইনডেক্স করবে এবং ফেরত দেবে। যদি অ্যাকাউন্টটির শুধুমাত্র "ফুল রিড" পারমিশন থাকে, তবে কানেক্টরটি "ড্রাফট আইটেম ভিজিবিলিটি" সেটিং মেনে চলে।

ব্যবহারকারী অ্যাকাউন্টের অ্যাক্সেসের উপর ভিত্তি করে ফলাফল সীমিত করতে আপনি কানেক্টরটি কনফিগার করতে পারেন। নিরাপত্তা ছাঁটাই প্রয়োগ করতে, এই বাহ্যিক পরিচয়গুলিকে Google Cloud Directory-এর সাথে সিঙ্ক্রোনাইজ করুন:

  • অফিস ৩৬৫ / অ্যাজুর এডি ব্যবহারকারীগণ।
  • অফিস ৩৬৫ / অ্যাজুর এডি নিরাপত্তা গ্রুপসমূহ।
  • SharePoint গ্রুপসমূহ (যার সদস্য হিসেবে Office 365 ব্যবহারকারী ও গ্রুপসমূহ রয়েছে)।

অনুসন্ধান অপ্টিমাইজেশন

প্রাসঙ্গিক ফলাফল দেখানোর জন্য কানেক্টরটি কনফিগার করে সার্চের অভিজ্ঞতা উন্নত করুন। ফিল্ড ইমপ্যাক্ট লেভেল নির্ধারণ করতে কনফিগারেশন ফাইলে এইচটিএমএল জেনারেশন প্যারামিটার ব্যবহার করুন।

একটি স্কিমা সেট আপ করতে, 'একটি স্কিমা তৈরি এবং নিবন্ধন করুন ' দেখুন। একটি স্কিমা সেট আপ করার সময়:

  • কানেক্টরটি SharePoint কন্টেন্ট টাইপগুলোকে বৈধ অবজেক্ট ডেফিনিশন নামে (AZ, az, 0-9) স্বাভাবিক করে। উদাহরণস্বরূপ, "News Article" হয়ে যায় "NewsArticle"।
  • যদি কানেক্টরটি কোনো অবজেক্ট ডেফিনিশন মেলাতে না পারে, তবে এটি ফলব্যাক অবজেক্ট টাইপ ( itemMetadata.objectType ) ব্যবহার করে। মেটাডেটা কনফিগারেশন প্যারামিটারগুলো দেখুন।
  • কানেক্টরটি SharePoint প্রপার্টির নামগুলোকে প্রপার্টির সংজ্ঞার সাথে সংযুক্ত করে।
  • কানেক্টরটি মাইক্রোসফ্ট আউটলুক .msg ফাইলগুলির মিডিয়া টাইপ ওভাররাইড করে এবং সেগুলিকে application/vnd.ms-outlook হিসেবে ইনডেক্স করে।

পরিচিত সংযোগকারীর সীমাবদ্ধতা

  • প্রতিটি কানেক্টর ইনস্ট্যান্স শুধুমাত্র একটি সাইট কালেকশন থেকে কন্টেন্ট ইনডেক্স করে। একাধিক সাইট কালেকশন ইনডেক্স করার জন্য, অতিরিক্ত ইনস্ট্যান্স সেট আপ করুন।
  • ACL-এ স্বতন্ত্র ব্যবহারকারী এবং গ্রুপের সংখ্যা বাড়ার সাথে সাথে মেমরি ব্যবহারও বৃদ্ধি পায়।
  • ডিলিট নোটিফিকেশনগুলো কার্যকর হতে ৪ ঘণ্টার বেশি সময় লাগতে পারে।

সিস্টেমের প্রয়োজনীয়তা

সিস্টেমের প্রয়োজনীয়তা
অপারেটিং সিস্টেম উইন্ডোজ সার্ভার ২০১৬, উবুন্টু, রেড হ্যাট এন্টারপ্রাইজ লিনাক্স ৫.০, অথবা সুসে এন্টারপ্রাইজ লিনাক্স ১০ (৬৪-বিট)।
প্রমাণীকরণ সরাসরি প্রমাণীকরণ।
সফটওয়্যার শেয়ারপয়েন্ট অনলাইন পরিবেশ; জাভা জেআরই ১.৮।

কানেক্টরটি স্থাপন করুন

SharePoint Online কানেক্টরটি স্থাপন করতে এই ধাপগুলো অনুসরণ করুন।

পূর্বশর্ত

  1. একটি গুগল ওয়ার্কস্পেস প্রাইভেট কী তৈরি করুন। ক্লাউড সার্চ এপিআই-তে অ্যাক্সেস কনফিগার করতে দেখুন।
  2. অনুসন্ধান করতে এবং এর আইডি রেকর্ড করতে একটি ডেটা সোর্স যোগ করুন। অনুসন্ধানের জন্য একটি ডেটা সোর্স যোগ করা দেখুন।
  3. ACL-ভিত্তিক ফলাফলের জন্য, আপনার অ্যাডমিনিস্ট্রেটরকে অবশ্যই দুটি আইডেন্টিটি সোর্স (একটি Office 365-এর জন্য এবং একটি SharePoint গ্রুপের জন্য) তৈরি করতে হবে এবং Google Workspace কাস্টমার আইডি প্রদান করতে হবে। ব্যবহারকারীর আইডেন্টিটি ম্যাপ করুন (Map user identities ) দেখুন।
  4. SharePoint Online সাইট কালেকশন অ্যাডমিনিস্ট্রেটর অধিকারসহ কানেক্টরটির জন্য একটি ব্যবহারকারী অ্যাকাউন্ট তৈরি করুন।
  5. Group.Read.All এবং User.Read.All অনুমতিসহ Azure Active Directory অ্যাপ্লিকেশন ক্রেডেনশিয়াল তৈরি করুন। অ্যাপ্লিকেশন আইডি, টেন্যান্ট এবং ক্লায়েন্ট সিক্রেট নোট করে রাখুন।

ধাপ ১. কানেক্টর সফটওয়্যারটি ইনস্টল করুন।

  1. রিপোজিটরিটি ক্লোন করুন:
    $ git clone https://github.com/google-cloudsearch/sharepoint-connector.git
    $ cd sharepoint-connector
  2. আপনার নির্বাচিত সংস্করণটি যাচাই করুন (যেমন, v1-0.0.3 ):
    $ git checkout tags/v1-0.0.3
  3. সংযোগকারীটি তৈরি করুন:
    $ mvn package
    টেস্টগুলি এড়িয়ে যেতে, mvn package -DskipTests ব্যবহার করুন।
  4. জিপ ফাইলটি আপনার ইনস্টলেশন ডিরেক্টরিতে এক্সট্র্যাক্ট করুন।

ধাপ ২. কনফিগারেশন ফাইলটি তৈরি করুন।

ইনস্টলেশন ডিরেক্টরিতে sharepoint-online-connector.config তৈরি করুন। নিচের উদাহরণে দেখানো অনুযায়ী প্যারামিটারগুলো কী-ভ্যালু পেয়ার হিসেবে যোগ করুন:

api.sourceId=08ef8becd116faa4546b8ca2c84b2879
api.serviceAccountPrivateKeyFile=service_account.json
sharepoint.server=https://mydomain.onmicrosoft.com
sharepoint.siteCollectionOnly=true
sharepoint.username=admin@mydomain.onmicrosoft.com
sharepoint.password=password
sharepoint.formsAuthenticationMode=LIVE
sharepoint.deploymentType=ONLINE
api.identitySourceId=08ef8becd116faa475de26d9b291fed9
api.referenceIdentitySources=defaultIdentitySource
api.referenceIdentitySource.defaultIdentitySource.id=08ef8becd116faa5d3783f8c5a80e5aa

বিস্তারিত জানতে রেফারেন্স অথবা গুগল-প্রদত্ত প্যারামিটারগুলো দেখুন।

ধাপ ৩. লগিং সেট আপ করুন।

একটি logs ফোল্ডার এবং একটি logging.properties ফাইল তৈরি করুন এবং তাতে নিম্নলিখিত বিষয়বস্তু যোগ করুন:

   handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
   # Default log level
   .level = INFO

   # uncomment line below to increase logging level for SharePoint APIsa
   #com.google.enterprise.cloudsearch.sharepoint.level=FINE

   # uncomment line below to increase logging level to enable API trace
   #com.google.api.client.http.level = FINE
   java.util.logging.ConsoleHandler.level = INFO
   java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log
   java.util.logging.FileHandler.limit=10485760
   java.util.logging.FileHandler.count=10
   java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter

ধাপ ৪. SharePoint আইডেন্টিটি কানেক্টরটি কনফিগার করুন।

আইডেন্টিটি-ভিত্তিক ACL প্রয়োগ করতে, নিম্নলিখিত উদাহরণের মতো আপনার api.customerId এবং অন্যান্য সংযোগ প্যারামিটার সহ sharepoint-online-identity-connector.config ফাইলটি তৈরি করুন:

```properties
### SharePoint Online identity connector configuration ###
# Required parameters for data source access
api.customerId=C05d3djk8
api.serviceAccountPrivateKeyFile=service_account.json

# Required parameters for SharePoint Online access
sharepoint.server=https://mydomain.onmicrosoft.com
sharepoint.siteCollectionOnly=true
sharepoint.username=admin@mydomain.onmicrosoft.com
sharepoint.password=pa$sw0rd
sharepoint.formsAuthenticationMode=LIVE
sharepoint.deploymentType=ONLINE

# SharePoint identity mapping parameters
api.identitySourceId=08ef8becd116faa475de26d9b291fed9
api.referenceIdentitySources=defaultIdentitySource
api.referenceIdentitySource.defaultIdentitySource.id=08ef8becd116faa5d3783f8c5a80e5aa
```

ধাপ ৫. Office 365 আইডেন্টিটি কানেক্টরটি ইনস্টল করুন।

আপনি যদি SharePoint Online আইডেন্টিটি-ভিত্তিক ACL ব্যবহার করেন, তাহলে এই ধাপটি অনুসরণ করুন। আপনি যদি পাবলিক ACL ব্যবহার করেন, তাহলে এই ধাপটি বাদ দিন।

  1. Office 365 রিপোজিটরি ক্লোন করুন:

    $ git clone https://github.com/google-cloudsearch/office-365-connector.git
    $ cd office-365-connector
    
  2. mvn package ব্যবহার করে কানেক্টরটি চেক আউট ও বিল্ড করুন।

  3. জিপ ফাইলটি আপনার ইনস্টলেশন ডিরেক্টরিতে এক্সট্র্যাক্ট করুন।

ধাপ ৬. Office 365 আইডেন্টিটি কানেক্টরটি কনফিগার করুন।

  1. আইডেন্টিটি কানেক্টর ইনস্টলেশনের একই ডিরেক্টরিতে, o365-identity-connector.config নামে একটি ফাইল তৈরি করুন এবং প্যারামিটারগুলোকে কী-ভ্যালু পেয়ার হিসেবে যোগ করুন:

    ### Office 365 Identity connector configuration ###
    api.identitySourceId=<var>12345abcde</var>
    api.customerId=<var>abcde12345</var>
    o365.clientId=<var>a63c6eb3-29e7-486</var>
    o365.tenant=<var>185ef9ed-29e7-486</var>
    o365.clientSecret=<var>raHJN15vRLBKs</var>
    

    প্যারামিটারের বিবরণের জন্য, Office 365 আইডেন্টিটি কানেক্টর দেখুন।

  2. একই ডিরেক্টরিতে logs নামে একটি ফোল্ডার তৈরি করুন।

  3. একই ডিরেক্টরিতে logging.properties নামে একটি ফাইল তৈরি করুন এবং তাতে নিম্নলিখিত বিষয়বস্তু যোগ করুন:

       handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
       # Default log level
       .level = INFO
       # uncomment line below to increase logging level for Office 365 APIs
       #com.google.enterprise.cloudsearch.o365.level=FINE
    
       # uncomment line below to increase logging level to enable Google API traces
       #com.google.api.client.http.level = FINE
       java.util.logging.ConsoleHandler.level = INFO
       java.util.logging.FileHandler.pattern=logs/connector-o365.%g.log
       java.util.logging.FileHandler.limit=10485760
       java.util.logging.FileHandler.count=10
       java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
    

ধাপ ৭. কানেক্টরটি চালু করুন।

কানেক্টরগুলো কনফিগার করার পর, সিনক্রোনাইজেশন ও ইন্ডেক্সিং শুরু করতে সেগুলো চালান। প্রতিটি কমান্ড তার নিজস্ব টার্মিনাল উইন্ডোতে চালান।

  1. ব্যবহারকারী ও গ্রুপ সিঙ্ক্রোনাইজ করতে Office 365 আইডেন্টিটি কানেক্টরটি চালান:

    $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-office-365-connector-v1-0.0.3.jar -Dconfig=o365-identity-connector.config
    
  2. সাইট কালেকশন গ্রুপগুলো সিঙ্ক্রোনাইজ করতে SharePoint Online আইডেন্টিটি কানেক্টরটি চালান:

    $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-0.0.3.jar -Dconfig=sharepoint-online-identity-connector.config
    
  3. কন্টেন্ট ইন্ডেক্স করতে SharePoint Online কানেক্টরটি চালান:

    $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-0.0.3.jar -Dconfig=sharepoint-online-connector.config
    

কনফিগারেশন প্যারামিটার রেফারেন্স

নিম্নলিখিত বিভাগগুলিতে SharePoint Online কানেক্টর কনফিগার করতে ব্যবহৃত কনফিগারেশন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে।

ডেটা উৎস অ্যাক্সেস

সেটিং প্যারামিটার
ডেটা উৎস আইডি api.sourceId= 1234567890abcdef

আবশ্যক। গুগল ওয়ার্কস্পেস প্রশাসক কর্তৃক সেট আপ করা গুগল ক্লাউড সার্চ ডেটা সোর্স আইডি।

সার্ভিস অ্যাকাউন্টের প্রাইভেট কী ফাইলের পাথ api.serviceAccountPrivateKeyFile= PrivateKey.json

প্রয়োজনীয়। গুগল ক্লাউড সার্চ পরিষেবা অ্যাকাউন্ট কী ফাইলের পাথ।

SharePoint অনলাইন অ্যাক্সেস

সেটিং প্যারামিটার
SharePoint সাইট কালেকশনের জন্য সম্পূর্ণ যোগ্য ডোমেইন নাম sharepoint.server= http://yoursharepoint.example.com/

আবশ্যক। যদি ডোমেইন নামটি সম্পূর্ণ-যোগ্য না হয়, তাহলে কানেক্টর হোস্টে ডিএনএস ওভাররাইড সেট করুন।

শুধুমাত্র সাইট সংগ্রহ মোড sharepoint.siteCollectionOnly=true

আবশ্যক। SharePoint Online-এর জন্য মানটি true সেট করুন।

SharePoint ব্যবহারকারীর নাম sharepoint.username= username

আবশ্যক। SharePoint Online অ্যাক্সেস করতে ব্যবহৃত অ্যাকাউন্টের ইউজারনেম।

SharePoint পাসওয়ার্ড sharepoint.password= user_password

আবশ্যক। SharePoint Online অ্যাক্সেস করতে ব্যবহৃত অ্যাকাউন্টের পাসওয়ার্ড।

প্রমাণীকরণ মোড sharepoint.formsAuthenticationMode=LIVE

আবশ্যক। SharePoint Online-এর ক্ষেত্রে, মানটি সর্বদা `LIVE` হয়।

মোতায়েনের ধরণ sharepoint.deploymentType=ONLINE

আবশ্যক। SharePoint Online-এর ক্ষেত্রে, এর মান সর্বদা `ONLINE` হবে।

SharePoint পরিচয় ম্যাপিং

সেটিং প্যারামিটার
পরিচয় উৎস আইডি api.identitySourceId= 1234567890abcdef

প্রয়োজনীয়। SharePoint গ্রুপ আইডেন্টিটি সোর্সের জন্য ক্লাউড সার্চ আইডেন্টিটি সোর্স আইডি।

রেফারেন্স পরিচয় উৎস api.referenceIdentitySources=defaultIdentitySource

আবশ্যক। SharePoint Online-এর ক্ষেত্রে, এর মান সর্বদা `defaultIdentitySource` হবে।

রেফারেন্স পরিচয় উৎস আইডি api.referenceIdentitySource.defaultIdentitySource.id= 112233abcd

অফিস ৩৬৫ ব্যবহারকারী এবং গ্রুপ আইডেন্টিটি সোর্সের জন্য ক্লাউড সার্চ আইডেন্টিটি সোর্স আইডি প্রয়োজন।

এইচটিএমএল বিষয়বস্তু তৈরি

সেটিং প্যারামিটার
এইচটিএমএল টেমপ্লেট শিরোনাম ক্ষেত্র contentTemplate.sharePointItem.title= Title

জেনারেট করা HTML-এর টেমপ্লেট টাইটেল হিসেবে ব্যবহার করার জন্য SharePoint ফিল্ড।

এইচটিএমএল কন্টেন্ট উচ্চ অনুসন্ধান মানের ক্ষেত্র contentTemplate.sharePointItem.quality.high= highField1 [, highField2 ,...]

তৈরি হওয়া HTML-এ উচ্চ-মানের ফিল্ড হিসেবে অন্তর্ভুক্ত করার জন্য ফিল্ডগুলোর একটি কমা-দ্বারা-বিভক্ত তালিকা। যখন সার্চ কোয়েরির শব্দগুলো এই ফিল্ডগুলোর সাথে মিলে যায়, তখন ফলাফলগুলো উচ্চতর র‍্যাঙ্ক পায়।

এইচটিএমএল কন্টেন্ট মিডিয়াম সার্চ কোয়ালিটি ফিল্ড contentTemplate.sharePointItem.quality.medium= mediumField1 [, mediumField2 ,...]

তৈরি করা HTML-এ মাঝারি মানের ফিল্ড হিসেবে অন্তর্ভুক্ত করার জন্য ফিল্ডগুলোর একটি কমা-দ্বারা-বিভক্ত তালিকা।

এইচটিএমএল কন্টেন্টের নিম্ন অনুসন্ধান মানের ক্ষেত্রগুলি contentTemplate.sharePointItem.quality.low= lowField1 [, lowField2 ,...]

তৈরি করা HTML-এ নিম্নমানের ফিল্ড হিসেবে অন্তর্ভুক্ত করার জন্য ফিল্ডগুলোর একটি কমা-দ্বারা-বিভক্ত তালিকা।

এইচটিএমএল কন্টেন্টের আনম্যাপড কলাম contentTemplate.sharepointItem.unmappedColumnsMode= APPEND

কানেক্টরটি কীভাবে আনম্যাপড কলামগুলো পরিচালনা করে। এর মান হলো APPEND (ডিফল্ট) অথবা IGNORE।

  • APPEND—এই কানেক্টরটি এমন সমস্ত ফিল্ড সহ HTML কন্টেন্ট তৈরি করে, যেগুলোর জন্য কোনো কোয়ালিটি লেভেল (উচ্চ, মাঝারি বা নিম্ন) নির্ধারণ করা হয়নি।
  • উপেক্ষা করুন—কানেক্টরটি শুধুমাত্র ম্যাপ করা ফিল্ডগুলো দিয়ে HTML কন্টেন্ট তৈরি করে।

অফিস ৩৬৫ আইডেন্টিটি কানেক্টর কনফিগারেশন

সেটিং প্যারামিটার
পরিচয় উৎস আইডি api.identitySourceId= 1234567890abcdef

আবশ্যক। Office 365 আইডেন্টিটি সোর্স আইডি। এই মানটি SharePoint Online কানেক্টর কনফিগারেশনে থাকা `api.referenceIdentitySource.defaultIdentitySource.id`-এর মানের সাথে অবশ্যই মিলতে হবে।

গুগল গ্রাহক আইডি api.customerId= c1b1d1e1

আবশ্যক। আপনার প্রতিষ্ঠানের গুগল ওয়ার্কস্পেস গ্রাহক আইডি।

অফিস ৩৬৫ অ্যাপ্লিকেশন আইডি o365.clientId= a63c6eb3-29e7-486

অফিস ৩৬৫ অ্যাপ্লিকেশন সেটআপ থেকে অ্যাপ্লিকেশন আইডিটি প্রয়োজন।

অফিস ৩৬৫ ভাড়াটিয়া o365.tenant= 185ef9ed-29e7-486

আবশ্যক। আপনার Office 365 অ্যাকাউন্টের টেন্যান্ট (আপনার Azure Activity Directory অ্যাপ)

অফিস ৩৬৫ ক্লায়েন্ট গোপনীয়তা o365.clientSecret= raHJN15vRLBKs

অফিস ৩৬৫ অ্যাপ্লিকেশন সেটআপ থেকে ক্রেডেনশিয়াল সিক্রেট প্রয়োজন।