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

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

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

विचार करने वाली ज़रूरी बातें

SharePoint On-premises कनेक्टर को डिप्लॉय करने से पहले, इन बातों का ध्यान रखें.

SharePoint की सेटिंग का पालन किया जाता है

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

उपयोगकर्ता खाते की ऐक्सेस अनुमतियों के आधार पर भी नतीजों को सीमित किया जा सकता है. इसके लिए, Google और बाहरी प्रिंसिपल का इस्तेमाल करके, एसीएल तय किए जा सकते हैं. सुरक्षा से जुड़ी जानकारी को छोटा करने की सुविधा लागू करने के लिए, इन बाहरी आइडेंटिटी को Google Cloud Directory के साथ सिंक करें:

Active Directory के उपयोगकर्ता और ग्रुप.
SharePoint के लोकल ग्रुप (इनमें Active Directory के उपयोगकर्ता और ग्रुप सदस्य के तौर पर शामिल होते हैं).

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

कनेक्टर, Active Directory लुकअप भी करता है. इससे प्रिंसिपल को सिंक करने के लिए जानकारी मिलती है. जैसे, एसआईडी को sAMAccountNames से मैप करना.

सर्च ऑप्टिमाइज़ेशन

कनेक्टर को कॉन्फ़िगर करके, खोज के अनुभव को बेहतर बनाएं, ताकि काम के नतीजे मिल सकें. फ़ील्ड के असर के लेवल सेट करने के लिए, कॉन्फ़िगरेशन फ़ाइल में एचटीएमएल जनरेशन पैरामीटर का इस्तेमाल करें.

स्कीमा सेट अप करने के लिए, स्कीमा बनाना और रजिस्टर करना लेख पढ़ें. स्कीमा सेट अप करते समय:

कनेक्टर, SharePoint के कॉन्टेंट टाइप को मान्य ऑब्जेक्ट डेफ़िनिशन के नामों (A-Z, a-z, 0-9) के हिसाब से व्यवस्थित करता है. उदाहरण के लिए, "News Article" को "NewsArticle" में बदल दिया जाता है.
अगर कनेक्टर किसी ऑब्जेक्ट की परिभाषा से मेल नहीं खाता है, तो यह फ़ॉलबैक ऑब्जेक्ट टाइप (itemMetadata.objectType) का इस्तेमाल करता है. मेटाडेटा कॉन्फ़िगरेशन पैरामीटर देखें.
कनेक्टर, हेक्स वर्णों को डिकोड करके और "ows_" प्रीफ़िक्स हटाकर, प्रॉपर्टी के नामों को सामान्य करता है.

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

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

एक से ज़्यादा किरायेदार वाले कॉन्फ़िगरेशन

मल्टी-टैलेंट डिप्लॉयमेंट के लिए, साइट कलेक्शन मोड कॉन्फ़िगर करें:

कनेक्टर खाते को साइट कलेक्शन एडमिन की अनुमतियां दें.
sharepoint.server को साइट कलेक्शन के यूआरएल पर सेट करें. उदाहरण के लिए, http://sharepoint.example.com/sites/collection).
sharepoint.siteCollectionOnly को true पर सेट करें.

हर साइट कलेक्शन के लिए, एक कनेक्टर इंस्टेंस कॉन्फ़िगर करें.

सीमाएं

मॉनिटर किए गए डेटाबेस की संख्या बढ़ने पर, बदलावों का पता लगाने में लगने वाला समय बढ़ जाता है.
एसीएल में यूनीक उपयोगकर्ताओं और ग्रुप की संख्या बढ़ने पर, मेमोरी का इस्तेमाल बढ़ जाता है.
यह कनेक्टर, सिर्फ़ एक Active Directory डोमेन की पहचानों के साथ काम करता है.
सूचनाएं मिटाने में चार घंटे से ज़्यादा समय लग सकता है.

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

सिस्टम की ज़रूरतें
ऑपरेटिंग सिस्टम	Windows Server 2016, Ubuntu, Red Hat Enterprise Linux 5.0 या SUSE Enterprise Linux 10 (64-bit).
सॉफ़्टवेयर	SharePoint Server 2013 या 2016; Java JRE 1.8.
पुष्टि करना	NTLM, Kerberos, HTTP Basic या ADFS.

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

SharePoint On-premises कनेक्टर को डिप्लॉय करने के लिए, यह तरीका अपनाएं.

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

Google Workspace की निजी कुंजी बनाएं. Cloud Search API का ऐक्सेस कॉन्फ़िगर करना लेख पढ़ें.
खोज के लिए कोई डेटा सोर्स जोड़ें और उसका आईडी रिकॉर्ड करें. खोज के लिए डेटा सोर्स जोड़ना लेख पढ़ें.
एसीएल पर आधारित नतीजों के लिए, आपके एडमिन को दो आइडेंटिटी सोर्स बनाने होंगे. एक Active Directory के लिए और दूसरा SharePoint के लोकल ग्रुप के लिए. साथ ही, Google Workspace का ग्राहक आईडी देना होगा. मैप के उपयोगकर्ता की पहचान देखें.
कनेक्टर के लिए, पूरी तरह से पढ़ने की अनुमतियों वाला उपयोगकर्ता खाता सेट अप करें.
पक्का करें कि SharePoint वेब ऐप्लिकेशन में रूट साइट कलेक्शन हो.
अगर साइट कलेक्शन में बदलाव नहीं किया जा सकता, तो PrepareWriteLockedSites.ps1 स्क्रिप्ट चलाएं.

पहला चरण. कनेक्टर सॉफ़्टवेयर इंस्टॉल करना

रिपॉज़िटरी को क्लोन करें:

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

चुना गया वर्शन देखें. जैसे, v1-0.0.5):
```
$ git checkout tags/v1-0.0.5
```
कनेक्टर बनाएं:
```
$ mvn package
```
टेस्ट को छोड़ने के लिए, mvn package -DskipTests का इस्तेमाल करें.
ZIP फ़ाइल को इंस्टॉलेशन डायरेक्ट्री में एक्स्ट्रैक्ट करें.

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

इंस्टॉलेशन डायरेक्ट्री में connector-config.properties बनाएं. पैरामीटर को की-वैल्यू पेयर के तौर पर जोड़ें:

api.sourceId=08ef8becd116faa4546b8ca2c84b2879
api.serviceAccountPrivateKeyFile=service_account.json
api.identitySourceId=08ef8becd116faa475de26d9b291fed9
sharepoint.server=http://sp-2016:32967/sites/collection
sharepoint.siteCollectionOnly=true
sharepoint.username=contoso\\admin
sharepoint.password=password
adLookup.host=dc.contoso.com
adLookup.username=contoso\\admin
adLookup.password=password

ज़्यादा जानकारी के लिए, रेफ़रंस या Google के उपलब्ध कराए गए पैरामीटर देखें.

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

अगर एचटीटीपीएस का इस्तेमाल किया जा रहा है, तो SharePoint सर्टिफ़िकेट एक्सपोर्ट करें और उसे कनेक्टर के कीस्टोर में इंपोर्ट करें:

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

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

इस कॉन्टेंट के साथ एक logs फ़ोल्डर और एक logging.properties फ़ाइल बनाएं: properties handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler .level = INFO java.util.logging.ConsoleHandler.level = INFO java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log

चरण 5. आइडेंटिटी कनेक्टर को कॉन्फ़िगर करना

पहचान के आधार पर एसीएल लागू करने के लिए, अपने api.customerId और कनेक्शन के अन्य पैरामीटर के साथ sharepoint-onprem-identity-connector.config बनाएं.

छठा चरण. कनेक्टर लॉन्च करना

Active Directory के उपयोगकर्ताओं और ग्रुप को सिंक करने के लिए, GCDS चलाएं.
साइट कलेक्शन ग्रुप को सिंक करने के लिए, SharePoint Identity Connector चलाएं.
कॉन्टेंट को इंडेक्स करने के लिए, SharePoint On-premises कनेक्टर चलाएं.

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

यहां दिए गए सेक्शन में, SharePoint On-premises कनेक्टर को कॉन्फ़िगर करने के लिए इस्तेमाल किए गए कॉन्फ़िगरेशन पैरामीटर की सूची दी गई है.

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

सेटिंग	पैरामीटर
डेटा सोर्स का आईडी	`api.sourceId=ID`
सेवा खाता	`api.serviceAccountPrivateKeyFile=path`

SharePoint on-premises का ऐक्सेस

सेटिंग	पैरामीटर
सर्वर यूआरएल	`sharepoint.server=URL`
क्रेडेंशियल	`sharepoint.username` और `sharepoint.password`

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

सेटिंग	पैरामीटर
टाइटल फ़ील्ड	`contentTemplate.sharePointItem.title=Title`
क्वालिटी फ़ील्ड	`contentTemplate.sharePointItem.quality.high`, `medium` या `low`