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 কানেক্টর কনফিগার করতে ব্যবহৃত কনফিগারেশন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে।

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

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

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

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

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