Microsoft SharePoint On-Prem कनेक्टर को डिप्लॉय करना

चेतावनी: Cloud Search रेफ़रंस कनेक्टर, सैंपल कोड के तौर पर "जैसे हैं" के तौर पर दिए गए हैं, ताकि काम करने वाले कनेक्टर बनाने में उनका इस्तेमाल किया जा सके. इस सैंपल कोड को प्रोडक्शन में इस्तेमाल किए जाने से पहले, इसमें काफ़ी ज़्यादा बदलाव करने और इसे टेस्ट करने की ज़रूरत होती है. प्रोडक्शन में इस्तेमाल के लिए, हमारा सुझाव है कि हमारे किसी Cloud Search पार्टनर से मदद लें. सही Cloud Search पार्टनर ढूंढने में मदद पाने के लिए, अपने Google खाता मैनेजर से संपर्क करें.

Google Cloud Search सेट अप करके, Google Workspace कॉन्टेंट के साथ-साथ अपने संगठन के SharePoint की कंपनी के कॉन्टेंट से नतीजे दिखाए जा सकते हैं. Google Cloud Search SharePoint On-Prem कनेक्टर का इस्तेमाल करें और इसे किसी खास SharePoint डेटा सोर्स को ऐक्सेस करने के लिए कॉन्फ़िगर करें.

ज़रूरी बातें

सम्मानित SharePoint सेटिंग

Cloud Search SharePoint On-Prem कनेक्टर हमेशा, SharePoint पर Search किसको दिखे सेटिंग के हिसाब से काम करता है, जिसे बदला नहीं जा सकता. ड्राफ़्ट दस्तावेज़ों के लिए, उपयोगकर्ता खाते की अनुमतियां (जिसे कनेक्टर, SharePoint Online को ऐक्सेस करने के लिए इस्तेमाल करता है) की मदद से यह कंट्रोल करता है कि कौनसे ड्राफ़्ट दस्तावेज़ इंडेक्स किए जाएंगे और लौटाए जाएंगे. अगर खाते के पास सिर्फ़ "पूरी तरह से पढ़ने" की अनुमतियां हैं, तो कनेक्टर SharePoint पर "ड्राफ़्ट आइटम की विज़िबिलिटी" सेटिंग का पालन करता है.

उपयोगकर्ता खाते के ऐक्सेस के आधार पर नतीजों को सीमित करने के लिए, कनेक्टर को भी कॉन्फ़िगर किया जा सकता है. एसीएल तय करने के लिए, Google के मुख्य खातों और बाहरी प्रिंसिपल का इस्तेमाल किया जा सकता है. SharePoint कॉन्टेंट के लिए सिक्योरिटी ट्रिमिंग सिस्टम लागू करने के लिए, नीचे दी गई बाहरी पहचानों को Google डायरेक्ट्री के साथ सिंक करें:

• सक्रिय निर्देशिका उपयोगकर्ता
• चालू डायरेक्ट्री ग्रुप
• SharePoint लोकल ग्रुप (इसमें Active Directory के उपयोगकर्ताओं और ग्रुप के सदस्य होने चाहिए)

AD उपयोगकर्ताओं और ग्रुप को सिंक करने के लिए, Google Cloud डायरेक्ट्री सिंक का इस्तेमाल करें. इससे, पहचान के लिए मैप किए गए ग्रुप की सुविधा चालू हो जाएगी. SharePoint लोकल ग्रुप को सिंक करने के लिए, SharePoint Identity Connector का इस्तेमाल करें.

कनेक्टर को मुख्य जानकारी सिंक करने के लिए, एडी के साथ लुकअप भी करना होगा. इससे ज़्यादा जानकारी फ़ेच की जा सकेगी. उदाहरण के लिए, विज्ञापन के साथ खोजने से कनेक्टर ये काम कर सकता है:

• किसी डोमेन ग्रुप के SID को, उससे जुड़े sAMAccountName के साथ मैप करें.
• SharePoint की स्थानीय ग्रुप की सदस्यताओं के लिए, ईमेल पते के साथ उपयोगकर्ता sAMAccountName को मैप करें.

ध्यान दें: इस कनेक्टर के सभी नतीजों को सार्वजनिक किया जा सकता है. यह सुविधा आपके डोमेन में सभी के लिए उपलब्ध होगी. ऐसा करने के लिए, SharePoint On-Prem कनेक्टर कॉन्फ़िगरेशन फ़ाइल में ये पैरामीटर तय करें:

defaultAcl.mode=override
defaultAcl.public=true

सार्वजनिक नतीजे सेट अप करते समय, आपको आइडेंटिटी कनेक्टर सेट अप करने की ज़रूरत नहीं होती.

खोज ऑप्टिमाइज़ेशन

कनेक्टर को कॉन्फ़िगर करके, उपयोगकर्ताओं को बेहतर अनुभव दिया जा सकता है, ताकि वे ज़्यादा काम के खोज नतीजे दिखा सकें.

एपीआई का इस्तेमाल करने के लिए, SharePoint Online कनेक्टर कॉन्फ़िगरेशन फ़ाइल में, एचटीएमएल जनरेशन पैरामीटर के लिए वैल्यू सेट करें. इन पैरामीटर की मदद से, यह सेट किया जा सकता है कि मैच पर किन फ़ील्ड का ज़्यादा या कम असर है.

स्कीमा सेट अप करने के लिए, स्कीमा बनाएं और रजिस्टर करें में दिए गए निर्देशों का पालन करें. स्कीमा सेट अप करते समय:

• SharePoint कॉन्टेंट टाइप के नामों को उनसे जुड़ी ऑब्जेक्ट परिभाषाओं के साथ मैप करने के लिए, कनेक्टर कॉन्टेंट टाइप के नामों को सामान्य बना देता है. इसके लिए, इस्तेमाल न किए जा सकने वाले वर्णों को बाहर रखा जाता है. ऑब्जेक्ट की परिभाषाओं के लिए, Cloud Search API सिर्फ़ A-Z, a-z, और 0-9 को मान्य वर्णों के तौर पर इस्तेमाल करता है. उदाहरण के लिए, कॉन्टेंट टाइप "एलान", ऑब्जेक्ट की परिभाषा "एलान" से मैप करता है. "समाचार लेख" वाला कॉन्टेंट टाइप, "Newsarticle" (कोई स्पेस नहीं) पर मैप होता है.

• कनेक्टर जब ऑब्जेक्ट डेफ़िनिशन का मिलान किसी ऑब्जेक्ट डेफ़िनिशन से नहीं कर पाता, तब कनेक्टर फ़ॉलबैक ऑब्जेक्ट टाइप (itemMetadata.objectType) का इस्तेमाल करता है. मेटाडेटा कॉन्फ़िगरेशन पैरामीटर के बारे में ज़्यादा जानें.

• SharePoint प्रॉपर्टी के नामों को प्रॉपर्टी की परिभाषाओं से मैप करने के लिए, कनेक्टर, हेक्स-एन्कोडेड वर्णों को डिकोड करके और "ows_" प्रीफ़िक्स को हटाकर, प्रॉपर्टी के नामों को सामान्य बना देता है. इसके बाद, इस्तेमाल न किए जा सकने वाले वर्णों (A-Z, a-z, और 0-9 को छोड़कर सभी वर्णों को मान्य वर्णों के तौर पर) हटा देता है.

Microsoft Outlook मैसेज मैनेज करना

कॉन्टेंट इंडेक्स करते समय, जब कनेक्टर को Microsoft Outlook .msg फ़ाइलें मिलती हैं, तो वह फ़ाइलों के मीडिया टाइप को बदल देता है और उन्हें application/vnd.ms-outlook. के तौर पर इंडेक्स कर देता है

मल्टी-टेनेंट कॉन्फ़िगरेशन

अगर आपका SharePoint मल्टी-टेनेंट डिप्लॉयमेंट है और वह एक ही वेब ऐप्लिकेशन पर एक से ज़्यादा ग्राहक साइटों को होस्ट करता है, तो आपको कॉन्फ़िगरेशन फ़ाइल में साइट कलेक्शन मोड को कॉन्फ़िगर करना होगा. एक से ज़्यादा टेनेंट डिप्लॉयमेंट में, आपको सिर्फ़ अपनी साइट के कलेक्शन के लिए अनुमतियां मिलती हैं और आपको पूरी तरह से पढ़ने की अनुमति नहीं मिल सकती. यह अनुमति SharePoint On-Prem कनेक्टर के मुताबिक ज़रूरी है.

साइट कलेक्शन मोड चालू करने के लिए:

• कनेक्टर उपयोगकर्ता खाता साइट कलेक्शन एडमिन को अनुमतियां दें.
• अपनी कनेक्टर कॉन्फ़िगरेशन फ़ाइल में, sharepoint.server को साइट कलेक्शन यूआरएल पर सेट करें, जैसे कि http://sharepoint.example.com/sites/sitecollection. यूआरएल को ठीक उसी केस का इस्तेमाल करने की ज़रूरत नहीं है जैसा SharePoint पर है.
• अपनी कनेक्टर कॉन्फ़िगरेशन फ़ाइल में sharepoint.siteCollectionOnly को true पर सेट करें.

अगर आपके पास मल्टी-टेनेंट एनवायरमेंट में इंडेक्स करने के लिए, कई साइट कलेक्शन हैं, तो आपको हर साइट कलेक्शन के लिए एक कनेक्टर इंस्टेंस कॉन्फ़िगर करना होगा.

कनेक्टर की जानी-पहचानी सीमाएं

• कनेक्टर के मॉनिटर किए जाने वाले डेटाबेस की संख्या के साथ, कनेक्टर को डेटाबेस के आइटम में हुए बदलावों का पता लगाने में लगने वाला समय बढ़ जाता है.
• हर साइट संग्रह के लिए ACL में उपयोग किए जाने वाले अद्वितीय उपयोगकर्ताओं और समूहों की संख्या के साथ मेमोरी की खपत बढ़ती है.
• कनेक्टर को सिर्फ़ एक Active Directory डोमेन की पहचान वाली फ़ाइलों के साथ कॉन्फ़िगर किया जा सकता है.
• Active Directory और Windows के कुछ सामान्य प्रिंसिपल, जैसे कि Everyone, BUILTIN\Users, और All Authenticated Users का इस्तेमाल नहीं किया जा सकता.
• सूचनाएं तुरंत नहीं मिटती हैं. हालांकि, कनेक्टर को यह पता लगाने में चार घंटे से ज़्यादा समय लग सकता है कि उपयोगकर्ता ने सोर्स रिपॉज़िटरी से कॉन्टेंट मिटा दिया है.

सिस्टम की ज़रूरतें

सिस्टम की ज़रूरतें
ऑपरेटिंग सिस्टम	Windows सर्वर 2016 Ubuntu Red Hat Enterprise Linux 5.0 SUSE Enterprise Linux 10 (64 बिट)
सॉफ़्टवेयर	SharePoint सर्वर SharePoint सर्वर 2016 SharePoint सर्वर 2013 Java JRE 1.8, आपके कंप्यूटर पर इंस्टॉल किया गया है, जो Google Cloud Search SharePoint On-Prem कनेक्टर को चलाता है
पुष्टि करना	एनटीएलएम Kerberos एचटीटीपी बेसिक एडीएफ़एस

कनेक्टर को डिप्लॉय करें

ज़रूरी शर्तें

1. Google Workspace निजी कुंजी बनाएं, जिसमें आपका सेवा खाता आईडी शामिल हो. निजी कुंजी पाने का तरीका जानने के लिए, Google Cloud Search API का ऐक्सेस कॉन्फ़िगर करें पर जाएं.

2. आपके Google Workspace एडमिन को खोजने के लिए एक डेटा सोर्स जोड़ना होगा. डेटा सोर्स आईडी रिकॉर्ड करें.

3. अगर कनेक्टर, एसीएल के आधार पर नतीजे दिखाता है (नतीजे सार्वजनिक नहीं होते हैं), तो आपके Google Workspace एडमिन को दो आइडेंटिटी सोर्स बनाने होंगे और आपको अपने आईडी देने होंगे:

   • Active Directory के उपयोगकर्ताओं और ग्रुप को सिंक करने के लिए पहचान का सोर्स.
   • SharePoint लोकल ग्रुप के लिए पहचान का सोर्स

   एडमिन के पास आपके संगठन का Google Workspace ग्राहक आईडी होना ज़रूरी है और वह आपको यह आईडी भी देना होगा.

   Cloud Search में उपयोगकर्ता की पहचान मैप करें में, इन वैल्यू को पाने का तरीका जानें.

   ध्यान दें: आपको हर Active Directory डोमेन के लिए एक पहचान स्रोत सेट अप करना होगा. अगर Active Directory को SharePoint इंस्टेंस की मदद से शेयर किया गया है, तो सभी SharePoint कनेक्टर इंस्टेंस के लिए पहचान सोर्स का इस्तेमाल किया जा सकता है.

4. कनेक्टर के लिए ऐसा उपयोगकर्ता खाता सेट अप करें जिसके पास उपयोगकर्ता नीति में, SharePoint वेब ऐप्लिकेशन के लिए पूरी तरह पढ़ने की अनुमतियां हों.

5. अगर SharePoint वेब ऐप्लिकेशन में रूट साइट कलेक्शन नहीं है, तो एक रूट साइट कलेक्शन बनाएं.

6. अगर आपकी साइट के किसी भी कलेक्शन को राइट-लॉक किया गया है, तो SharePoint सर्वर में एडमिन के खास अधिकार वाले खाते से साइन इन करें और PrepareWriteLockedSites.ps1 स्क्रिप्ट चलाएं.

7. कनेक्टर कॉन्फ़िगरेशन से जुड़ी जानकारी देने के लिए डेटा सोर्स की मेट्रिक पाने के लिए, SharePoint सर्वर में उस खाते से साइन इन करें जिसके पास फ़ार्म मैनेज करने के अधिकार हों और diagnose_sp.ps1 चलाएं.

   आउटपुट, वेब ऐप्लिकेशन, दस्तावेज़ों, और उपयोगकर्ता ग्रुप की सदस्यताओं की संख्या रिपोर्ट करता है. इस जानकारी का इस्तेमाल करके, यह अनुमान लगाया जा सकता है कि आपको कितने कनेक्टर इंस्टेंस की ज़रूरत है, मेमोरी की ज़रूरत है, और दस्तावेज़ों की संख्या कितनी है.

पहला चरण. Google Cloud Search SharePoint On-Prem कनेक्टर सॉफ़्टवेयर इंस्टॉल करें.

1. GitHub से कनेक्टर रिपॉज़िटरी का क्लोन बनाएं.

   $ git clone https://github.com/google-cloudsearch/sharepoint-connector.git
   $ cd sharepoint-connector

2. कनेक्टर का मनचाहा वर्शन देखें:

   $ git checkout tags/latest_version

   कहां: latest_version = कोई वैल्यू, जैसे कि v1-0.0.5

3. कनेक्टर बनाएं.

   $ mvn package

   कनेक्टर बनाते समय टेस्ट स्किप करने के लिए, mvn package के बजाय mvn package -DskipTests चलाएं.

4. कनेक्टर की ZIP फ़ाइल को, अपनी लोकल इंस्टॉलेशन डायरेक्ट्री में कॉपी करें:

   $ cp target/google-cloudsearch-sharepoint-connector-latest_version.zip installation-dir
   $ cd installation-dir
   $ unzip google-cloudsearch-sharepoint-connector-latest_version.zip
   $ cd google-cloudsearch-sharepoint-connector-latest_version

दूसरा चरण. SharePoint On-Prem कनेक्टर कॉन्फ़िगरेशन फ़ाइल बनाना

1. जिस डायरेक्ट्री में कनेक्टर इंस्टॉल किया गया था उसी डायरेक्ट्री में फ़ाइल बनाएं. Google का सुझाव है कि आप फ़ाइल को connector-config.properties नाम दें, ताकि कनेक्टर चलाने के लिए किसी अतिरिक्त कमांड-लाइन पैरामीटर की ज़रूरत न पड़े. अगर आपको कई कनेक्टर इंस्टेंस चलाने हैं, तो इन्हें अलग करने के लिए नाम में जानकारी जोड़ें.

2. नीचे दिए गए उदाहरण की तरह, फ़ाइल के कॉन्टेंट में पैरामीटर को की/वैल्यू पेयर के तौर पर जोड़ें:

   ### Sharepoint On-Prem Connector configuration ###
   
   # Required parameters for data source access
   api.sourceId=08ef8becd116faa4546b8ca2c84b2879
   api.serviceAccountPrivateKeyFile=service_account.json
   api.identitySourceId=08ef8becd116faa475de26d9b291fed9
   
   # Required parameters for SharePoint on-premises access
   sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
   sharepoint.siteCollectionOnly=true
   sharepoint.username=contoso\\admin
   sharepoint.password=pa$sw0rd
   sharepoint.stripDomainInUserPrincipals=true
   
   # Required parameters for AD lookup
   adLookup.host=dc.contoso.com
   adLookup.username=contoso\\admin
   adLookup.password=pa$sw0rd
   api.referenceIdentitySources=CONTOSO,contoso
   api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
   api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
   
   # Optional parameters for schema mapping
   contentTemplate.sharepointItem.title=Title
   contentTemplate.sharepointItem.unmappedColumnsMode=APPEND
   

   हर पैरामीटर की पूरी जानकारी पाने के लिए, कॉन्फ़िगरेशन पैरामीटर के रेफ़रंस पेज पर जाएं.

3. (ज़रूरी नहीं) ज़रूरत के हिसाब से दूसरे कनेक्टर पैरामीटर कॉन्फ़िगर करें. ज़्यादा जानकारी के लिए, Google के दिए गए कनेक्टर पैरामीटर पर जाएं.

तीसरा चरण. एचटीटीपीएस के लिए, SharePoint को भरोसेमंद होस्ट के तौर पर जोड़ें

अगर SharePoint को एचटीटीपीएस का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया है, तो एक SharePoint सर्टिफ़िकेट पाएं, ताकि उसे कनेक्टर के लिए भरोसेमंद होस्ट के तौर पर जोड़ा जा सके.

1. कनेक्टर चलाने वाले कंप्यूटर पर, ब्राउज़र खोलें और SharePoint पर जाएं.

2. चेतावनी वाला पेज खुलने पर, मुझे जोखिमों के बारे में पता है और अपवाद जोड़ें पर क्लिक करें. इस पेज पर "यह कनेक्शन गैर-भरोसेमंद है" जैसा मैसेज दिखता है, क्योंकि इस सर्टिफ़िकेट पर खुद ही हस्ताक्षर किया जाता है और इसे किसी भरोसेमंद सर्टिफ़िकेट देने वाली संस्था ने साइन नहीं किया है.

3. व्यू बटन उपलब्ध होने पर, उस पर क्लिक करें.

4. जानकारी टैब पर जाएं और एक्सपोर्ट करें पर क्लिक करें.

5. इस सर्टिफ़िकेट को कनेक्टर डायरेक्ट्री में sharepoint.crt नाम के साथ सेव करें.

6. विंडो बंद करने के लिए, बंद करें पर क्लिक करें. इसके बाद, रद्द करें पर क्लिक करें.

7. कोई कमांड प्रॉम्प्ट खोलें और यह कमांड डालें:

   $ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint

   जब "इस सर्टिफ़िकेट पर भरोसा करें?" पूछे, तो हां में जवाब दें.

चरण 4. लॉग इन करने की सुविधा सेट अप करें

1. कनेक्टर बाइनरी वाली डायरेक्ट्री में, logs नाम का फ़ोल्डर बनाएं.

2. उसी डायरेक्ट्री में (logs नहीं), लैटिन1 कोड में बदली गई logging.properties नाम की फ़ाइल बनाएं.

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 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 On-Prem Identity कनेक्टर को कॉन्फ़िगर करना

खोज नतीजों पर SharePoint On-Prem पहचान-आधारित ACL लागू करने के लिए यह चरण ज़रूरी है. अगर आपने कनेक्टर को सार्वजनिक ACL के साथ सेट अप किया है, तो इस चरण को छोड़ा जा सकता है.

1. SharePoint Online कनेक्टर को जिस डायरेक्ट्री में इंस्टॉल करते हैं उसी डायरेक्ट्री में एक फ़ाइल बनाएं और उसे sharepoint-onprem-identity-connector.config नाम दें.

2. नीचे दिए गए उदाहरण की तरह, फ़ाइल के कॉन्टेंट में पैरामीटर को की/वैल्यू पेयर के तौर पर जोड़ें:

   ### SharePoint On-prem identity connector configuration ###
   
   # Required parameters for data source access
   api.customerId=C05d3djk8
   api.serviceAccountPrivateKeyFile=service_account.json
   api.identitySourceId=08ef8becd116faa475de26d9b291fed9
   
   # Required parameters for SharePoint access
   sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
   sharepoint.siteCollectionOnly=true
   sharepoint.username=contoso\\admin
   sharepoint.password=pa$sw0rd
   sharepoint.stripDomainInUserPrincipals=true
   
   # Required parameters for AD lookup
   adLookup.host=dc.contoso.com
   adLookup.username=contoso\\admin
   adLookup.password=pa$sw0rd
   api.referenceIdentitySources=CONTOSO,contoso
   api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
   api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
   

   ये वैल्यू करीब-करीब SharePoint On-Prem कनेक्टर की तरह ही हैं. हालांकि, api.sourceId के बजाय, पैरामीटर api.customerId है. api.customerId की वैल्यू, वह ग्राहक आईडी है जो आपको अपने Google Workspace एडमिन से मिला है.

छठा चरण. SharePoint On-Prem कनेक्टर को लॉन्च करना

नीचे दिए गए चरणों में, आपने मुख्य खातों को कंपनी की इमारत में चालू डायरेक्ट्री और SharePoint साइट संग्रह, दोनों में Cloud Identity सेवा में मौजूद पहचानों से मैप किया जाएगा. यह सिंक, Google Cloud डायरेक्ट्री सिंक (जीसीडीएस) और SharePoint On-Prem Identity कनेक्टर की मदद से किया जाता है.

जब जीसीडीएस उपयोगकर्ताओं और ग्रुप को सिंक कर ले, तब SharePoint साइट के कलेक्शन ग्रुप को सिंक करने के लिए, SharePoint On-Prem Identity कनेक्टर चालू करें. आखिर में, Cloud Search उपयोगकर्ताओं को नतीजों को इंडेक्स करने और उन्हें दिखाने के लिए, SharePoing On-Prem कनेक्टर का इस्तेमाल करें.

1. अगर आपने अब तक ऐसा नहीं किया है, तो जीसीडीएस को कॉन्फ़िगर करें और चलाएं. पक्का करें कि पहचान के लिए मैप किए गए ग्रुप की सुविधा चालू हो.

2. SharePoint On-Prem Identity कनेक्टर चलाएं:

   $ java -Djava.util.logging.config.file=logging.properties -cp "google-cloudsearch-sharepoint-connector-version.jar" com.google.enterprise.cloudsearch.sharepoint.SharePointIdentityConnector -Dconfig=sharepoint-onprem-identity-connector.config

3. SharePoint On-Prem कनेक्टर चलाएं. अपनी SharePoint साइट की सुरक्षा के लिए कमांड सिंटैक्स का इस्तेमाल करें:

   • एचटीटीपी (किसी भरोसेमंद होस्ट की ज़रूरत नहीं है):

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

   • एचटीटीपीएस (भरोसेमंद होस्ट के तौर पर SharePoint को जोड़ें):

     $ java -Djavax.net.ssl.trustStore=cacerts.jks -Djavax.net.ssl.trustStoreType=jks -Djavax.net.ssl.trustStorePassword=changeit -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jar

कॉन्फ़िगरेशन पैरामीटर के बारे में जानकारी

डेटा स्रोत का ऐक्सेस

सेटिंग	पैरामीटर
डेटा सोर्स आईडी	api.sourceId=1234567890abcdef ज़रूरी है. Google Cloud Search का डेटा सोर्स आईडी, जिसे Google Workspace एडमिन ने सेट अप किया हो.
सेवा खाते की निजी कुंजी फ़ाइल का पाथ	api.serviceAccountPrivateKeyFile=PrivateKey.json ज़रूरी है. Google Cloud Search सेवा खाते की कुंजी फ़ाइल का पाथ.

SharePoint को कंपनी की इमारत में ऐक्सेस करना

सेटिंग	पैरामीटर
SharePoint सर्वर का यूआरएल	sharepoint.server=http://yoursharepoint.example.com/ ज़रूरी है. पूरी तरह क्वालिफ़ाइड होस्ट नेम के तौर पर SharePoint सर्वर का यूआरएल, जैसे कि http://yoursharepoint.example.com/. अगर होस्ट नाम पूरी तरह क्वालिफ़ाइड नहीं है, तो आपको कनेक्टर होस्ट पर डीएनएस ओवरराइड सेट करना होगा.
SharePoint का उपयोगकर्ता नाम	sharepoint.username=YOURDOMAIN\\ConnectorUser यह तब ज़रूरी होता है, जब Linux पर या ऐसी Windows मशीन पर कनेक्टर चलाया जाता है जो SharePoint Server AD डोमेन का हिस्सा नहीं है.
SharePoint पासवर्ड	sharepoint.password=user_password यह तब ज़रूरी होता है, जब Linux पर या ऐसी Windows मशीन पर कनेक्टर चलाया जाता है जो SharePoint Server AD डोमेन का हिस्सा नहीं है.
SharePoint से कनेक्ट करने के लिए, लाइव पुष्टि करने की सुविधा का इस्तेमाल करना	sharepoint.username=AdaptorUser Live Authentication Id sharepoint.password uS3R_passWoRD sharepoint.formsAuthenticationMode=LIVE
SharePoint से कनेक्ट करने के लिए ADFS प्रमाणीकरण का उपयोग करें	sharepoint.username=[e-mail] sharepoint.password=uS3R_passWoRD sharepoint.sts.endpoint=https://adfs.example.com/adfs/services/trust/2005/usernamemixed sharepoint.sts.realm=urn:myserver:sharepoint या https://yoursharepoint.example.com/_trust sharepoint.formsAuthenticationMode=ADFS

साइट कलेक्शन को इंडेक्स करना

सेटिंग	पैरामीटर
इंडेक्स टाइप	sharepoint.siteCollectionOnly=boolean ज़रूरी नहीं है. हालांकि, मल्टी-टेनेंट SharePoint डिप्लॉयमेंट को छोड़कर इस बारे में ज़्यादा जानें (ज़्यादा जानें). कनेक्टर इंडेक्स sharepoint.server को वर्चुअल सर्वर के बजाय साइट कलेक्शन के तौर पर रखने के लिए, 'सही है' पर सेट करें. डिफ़ॉल्ट तौर पर, यह शून्य पर सेट होता है (अपने-आप पहचानी गई भाषा).

SharePoint की पहचान की मैपिंग

सेटिंग	पैरामीटर
पहचान स्रोत आईडी	api.identitySourceId=1234567890abcdef ज़रूरी है. SharePoint लोकल ग्रुप को सिंक करने के लिए पहचान सोर्स आईडी.Google Workspace एडमिन का सेट अप किया गया Google Cloud Search सोर्स आईडी, जैसा कि खोजने के लिए डेटा सोर्स जोड़ना में बताया गया है.
पहचान फ़ाइल के सोर्स	api.referenceIdentitySources=CONTOSO,contoso ऐक्टिव डायरेक्ट्री के मुख्य खातों के लिए, रेफ़रंस आइडेंटिटी सोर्स की कॉमा-डीलिमिटेड सूची. यह वैल्यू, चालू डायरेक्ट्री के मुख्य खातों के Active Directory NETBIOS नाम से मैच करती है.
पहचान आईडी के सोर्स आईडी	api.referenceIdentitySource.DOMAIN.id=identity-source-id ज़रूरी है. Active Directory के मुख्य खातों को सिंक करने के लिए पहचान स्रोत आईडी.

सक्रिय निर्देशिका लुकअप

सेटिंग	पैरामीटर
Active Directory होस्ट	adLookup.host=host ज़रूरी है. ऐक्टिव डायरेक्ट्री का होस्टनेम, जैसे कि dc.contoso.com या आईपी पता.
Active Directory लुकअप पोर्ट	adLookup.port=port ज़रूरी नहीं. डिफ़ॉल्ट संख्या 389 है. एसएसएल के लिए, 686 का इस्तेमाल करें.
Active Directory लुकअप का तरीका	adLookup.method=value ज़रूरी नहीं. डिफ़ॉल्ट `स्टैंडर्ड` है. एचटीटीपीएस कनेक्शन के लिए, `एसएसएल` पर सेट करें.
एक्टिव डायरेक्ट्री लुकअप उपयोगकर्ता	adLookup.username=CONTOSO\user1 ज़रूरी है. उपयोगकर्ता को ऐक्टिव डायरेक्ट्री को खोजने की अनुमति है.
Active Directory लुकअप पासवर्ड	adLookup.password=password123 ज़रूरी है. adLookup.user के ज़रिए तय उपयोगकर्ता के लिए पासवर्ड.

एचटीएमएल कॉन्टेंट जनरेट करना

सेटिंग	पैरामीटर
एचटीएमएल टेंप्लेट के टाइटल वाला फ़ील्ड	contentTemplate.sharePointItem.title=Title जनरेट किए गए एचटीएमएल के लिए, एचटीएमएल टेंप्लेट के टाइटल के तौर पर इस्तेमाल करने के लिए SharePoint फ़ील्ड.
एचटीएमएल कॉन्टेंट के लिए, खोज की अच्छी क्वालिटी वाले फ़ील्ड	contentTemplate.sharePointItem.quality.high=highField1[,highField2,...] जनरेट किए गए एचटीएमएल में, अच्छी क्वालिटी वाले फ़ील्ड के तौर पर शामिल करने के लिए, कॉमा लगाकर अलग की गई फ़ील्ड की सूची. जब खोज क्वेरी के लिए इस्तेमाल किए गए शब्द इन फ़ील्ड से मैच होते हैं, तो नतीजों की रैंकिंग बेहतर होती है.
एचटीएमएल कॉन्टेंट के मीडियम सर्च क्वालिटी फ़ील्ड	contentTemplate.sharePointItem.quality.medium=mediumField1[,mediumField2,...] जनरेट किए गए एचटीएमएल में मीडियम क्वालिटी के फ़ील्ड के तौर पर शामिल करने के लिए, कॉमा लगाकर अलग की गई फ़ील्ड की सूची.
एचटीएमएल कॉन्टेंट के लिए, खोज की खराब क्वालिटी वाले फ़ील्ड	contentTemplate.sharePointItem.quality.low=lowField1[,lowField2,...] जनरेट किए गए एचटीएमएल में, कम क्वालिटी वाले फ़ील्ड के तौर पर शामिल करने के लिए, कॉमा लगाकर अलग की गई फ़ील्ड की सूची.
एचटीएमएल कॉन्टेंट, मैप नहीं किया गया कॉलम	contentTemplate.sharepointItem.unmappedColumnsMode=APPEND कनेक्टर मैप नहीं किए गए कॉलम को कैसे मैनेज करता है. मान APPEND (डिफ़ॉल्ट) या IGNORE है. जोड़ें—कनेक्टर सभी फ़ील्ड के साथ एचटीएमएल कॉन्टेंट जनरेट करता है. इसमें वे फ़ील्ड भी शामिल हैं जिन्हें क्वालिटी लेवल (ज़्यादा, मीडियम या कम) के हिसाब से सेट नहीं किया गया है. ध्यान न दें—कनेक्टर सिर्फ़ मैप किए गए फ़ील्ड के साथ एचटीएमएल कॉन्टेंट जनरेट करता है.