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

আপনার প্রতিষ্ঠানের SharePoint অনলাইন কন্টেন্ট থেকে ফলাফল ফেরত দেওয়ার জন্য আপনি Google Cloud Search সেট আপ করতে পারেন, যা আপনার Google Workspace কন্টেন্টের পাশাপাশি। Cloud Search SharePoint Online সংযোগকারী ব্যবহার করুন এবং একটি নির্দিষ্ট SharePoint অনলাইন ডেটা উৎস অ্যাক্সেস করার জন্য এটি কনফিগার করুন।

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

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

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

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

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

  • অফিস 365 / Azure AD ব্যবহারকারীরা।
  • অফিস 365 / Azure AD নিরাপত্তা গোষ্ঠী।
  • SharePoint গ্রুপ (Office 365 ব্যবহারকারী এবং সদস্যদের সাথে গ্রুপ)।

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

প্রাসঙ্গিক ফলাফল ফেরত দেওয়ার জন্য সংযোগকারীটি কনফিগার করে অনুসন্ধানের অভিজ্ঞতা উন্নত করুন। ফিল্ড ইমপ্যাক্ট লেভেল সেট করতে কনফিগারেশন ফাইলে HTML জেনারেশন প্যারামিটার ব্যবহার করুন।

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

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

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

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

সিস্টেমের জন্য আবশ্যক

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

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

SharePoint অনলাইন সংযোগকারী স্থাপন করতে এই পদক্ষেপগুলি অনুসরণ করুন।

পূর্বশর্ত

  1. একটি Google Workspace প্রাইভেট কী তৈরি করুন। ক্লাউড সার্চ API-তে অ্যাক্সেস কনফিগার করুন দেখুন।
  2. অনুসন্ধানের জন্য একটি ডেটা উৎস যোগ করুন এবং এর আইডি রেকর্ড করুন। অনুসন্ধানের জন্য একটি ডেটা উৎস যোগ করুন দেখুন।
  3. ACL-ভিত্তিক ফলাফলের জন্য, আপনার প্রশাসককে দুটি পরিচয় উৎস তৈরি করতে হবে (একটি Office 365 এর জন্য এবং একটি SharePoint গ্রুপের জন্য) এবং Google Workspace গ্রাহক আইডি প্রদান করতে হবে। মানচিত্র ব্যবহারকারী পরিচয় দেখুন।
  4. SharePoint অনলাইন সাইট কালেকশন অ্যাডমিনিস্ট্রেটর সুবিধা সহ সংযোগকারীর জন্য একটি ব্যবহারকারী অ্যাকাউন্ট সেট আপ করুন।
  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
```

ধাপ ৫. অফিস ৩৬৫ আইডেন্টিটি কানেক্টর ইনস্টল করুন

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

  1. অফিস 365 রিপোজিটরি ক্লোন করুন:

    $ git clone https://github.com/google-cloudsearch/office-365-connector.git
    $ cd office-365-connector
    
  2. mvn package ব্যবহার করে সংযোগকারীটি পরীক্ষা করে দেখুন এবং তৈরি করুন।

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

ধাপ ৬. অফিস ৩৬৫ আইডেন্টিটি কানেক্টর কনফিগার করুন

  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 অনলাইন পরিচয় সংযোগকারীটি চালান:

    $ 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 অনলাইন সংযোগকারী চালান:

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

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

নিম্নলিখিত বিভাগগুলিতে SharePoint অনলাইন সংযোগকারী কনফিগার করতে ব্যবহৃত কনফিগারেশন প্যারামিটারগুলির তালিকা রয়েছে।

ডেটা সোর্স অ্যাক্সেস

বিন্যাস প্যারামিটার
ডেটা সোর্স আইডি api.sourceId= 1234567890abcdef

প্রয়োজন। Google Workspace অ্যাডমিনিস্ট্রেটর দ্বারা সেট আপ করা Google Cloud Search ডেটা সোর্স আইডি।

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

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

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

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

প্রয়োজনীয়। যদি ডোমেন নামটি সম্পূর্ণরূপে যোগ্য না হয়, তাহলে সংযোগকারী হোস্টে DNS ওভাররাইড সেট করুন।

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

প্রয়োজন। SharePoint Online এর জন্য, true মান সেট করুন।

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

প্রয়োজন। SharePoint অনলাইন অ্যাক্সেস করতে ব্যবহৃত অ্যাকাউন্টের ব্যবহারকারীর নাম।

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

প্রয়োজন। SharePoint অনলাইন অ্যাক্সেস করতে ব্যবহৃত অ্যাকাউন্টের পাসওয়ার্ড।

প্রমাণীকরণ মোড 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

প্রয়োজনীয়। Office 365 ব্যবহারকারী এবং গোষ্ঠীর পরিচয় উৎসের জন্য ক্লাউড অনুসন্ধান পরিচয় উৎস আইডি।

HTML কন্টেন্ট তৈরি

বিন্যাস প্যারামিটার
HTML টেমপ্লেট শিরোনাম ক্ষেত্র contentTemplate.sharePointItem.title= Title

জেনারেট করা HTML-এর জন্য HTML টেমপ্লেট শিরোনাম হিসেবে ব্যবহার করার জন্য SharePoint ক্ষেত্র।

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

জেনারেট করা HTML-এ উচ্চ-মানের ক্ষেত্র হিসেবে অন্তর্ভুক্ত করার জন্য কমা দ্বারা পৃথক করা ক্ষেত্রগুলির একটি তালিকা। যখন অনুসন্ধান ক্যোয়ারী পদগুলি এই ক্ষেত্রগুলির সাথে মেলে, তখন ফলাফলগুলি উচ্চতর স্থান পায়।

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

মাঝারি মানের ক্ষেত্র হিসেবে তৈরি HTML-এ অন্তর্ভুক্ত করার জন্য কমা দ্বারা পৃথক করা ক্ষেত্রগুলির একটি তালিকা।

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

কমা দ্বারা পৃথক করা ক্ষেত্রগুলির একটি তালিকা যা তৈরি করা HTML-এ নিম্নমানের ক্ষেত্র হিসাবে অন্তর্ভুক্ত করা হবে।

HTML কন্টেন্ট আনম্যাপ করা কলাম contentTemplate.sharepointItem.unmappedColumnsMode= APPEND

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

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

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

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

প্রয়োজনীয়। Office 365 পরিচয় উৎস আইডি। এই মানটি SharePoint অনলাইন সংযোগকারী কনফিগারেশনে `api.referenceIdentitySource.defaultIdentitySource.id` এর মানের সাথে মিলিত হওয়া উচিত।

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

প্রয়োজন। আপনার প্রতিষ্ঠানের Google Workspace গ্রাহক আইডি।

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

প্রয়োজনীয়। Office 365 অ্যাপ্লিকেশন সেটআপ থেকে অ্যাপ্লিকেশন আইডি।

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

প্রয়োজনীয়। আপনার অফিস 365 অ্যাকাউন্টের জন্য ভাড়াটে (আপনার Azure Activity Directory অ্যাপ)

অফিস 365 ক্লায়েন্ট সিক্রেট o365.clientSecret= raHJN15vRLBKs

প্রয়োজনীয়। Office 365 অ্যাপ্লিকেশন সেটআপ থেকে ক্রেডেনশিয়াল সিক্রেট