Microsoft SharePoint On Prem
Esegue il crawling dei documenti archiviati in un'origine dati Microsoft SharePoint on-premises.
IBM Cloud Pak for Data IBM Software Hub
Queste informazioni si applicano solo alle distribuzioni installate. Per ulteriori informazioni sulla connessione a un sito on-premises SharePoint da una distribuzione gestita, vedere SharePoint On Prem.
Quali documenti vengono carrellati
- Vengono sottoposti a scansione solo i documenti supportati da Discovery ; tutti gli altri vengono ignorati. Per ulteriori informazioni, vedere Tipi di file supportati.
- È supportata la sicurezza a livello di documento. Quando questa opzione è attivata, gli utenti possono eseguire il crawling e la query dello stesso contenuto a cui possono accedere quando sono connessi a SharePoint. Per ulteriori informazioni, vedere Supporto della sicurezza a livello di documento.
- Quando una fonte viene ricaricata, i nuovi documenti vengono aggiunti, i documenti aggiornati vengono modificati nella versione corrente e i documenti eliminati vengono eliminati dall'indice della raccolta.
- Tutti i connettori dell'origine dati Discovery sono di sola lettura. Indipendentemente dalle autorizzazioni concesse all'account di crawl, Discovery non scrive, aggiorna o cancella mai alcun contenuto nell'origine dati originale.
Requisiti dell'origine dati
Oltre ai requisiti dell'origine dati per tutte le distribuzioni installate, l'origine dati SharePoint On Prem deve soddisfare i seguenti requisiti:
- La connessione all'origine dati supporta SharePoint 2013, 2016 o 2019.
- È necessario ottenere le licenze di servizio necessarie per l'origine dati a cui ci si vuole collegare. Per ulteriori informazioni sulle licenze, contattare l'amministratore di sistema dell'origine dati.
Per ulteriori informazioni su SharePoint On Prem, vedere Documentazione per sviluppatori Microsoft SharePoint.
procedura
prerequisita
Prima di creare una raccolta SharePoint On Prem, è necessario eseguire le seguenti operazioni:
-
Collaborare con l'amministratore di Sharepoint per coordinare l'impostazione dell'accesso completo in lettura per l'applicazione web.
Per ulteriori informazioni, vedere Gestione delle autorizzazioni per un'applicazione Web in Sharepoint Server.
-
Se si desidera attivare la sicurezza a livello di documento, è necessario eseguire alcune operazioni per impostarla. Per ulteriori informazioni, vedere Supporto della sicurezza a livello di documento.
È necessario raccogliere le seguenti informazioni dall'amministratore LDAP:
- URL server LDAP
- Il server LDAP URL a cui connettersi, ad esempio
ldap://<ldap_server>:<port>. - Nome utente vincolato LDAP
- Il nome utente utilizzato per collegarsi al servizio directory. Nella maggior parte dei casi, questo nome utente è un DN (distinguished name). Il nome di accesso potrebbe a volte funzionare con Active Directory. Ma a differenza dell'accesso generale a Windows, è sensibile alle maiuscole. Il nome distinto funziona sempre.
- Password utente vincolante LDAP
- La password utilizzata per collegarsi al servizio directory.
- DN base LDAP
- Il punto di partenza per la ricerca delle voci utente in LDAP, ad esempio
CN=Users,DC=example,DC=com. - Filtro utente LDAP
- Il filtro utente per cercare le voci degli utenti in LDAP. Se non specificato, il valore predefinito è "
(userPrincipalName={0})".
Se si utilizza la versione 2.2.1 o precedente, è necessario completare alcune operazioni preliminari aggiuntive prima di potersi collegare all'origine dati. Per ulteriori informazioni, vedere SharePoint Su Prem i passaggi dei prerequisiti per le versioni precedenti.
Connessione a un'origine dati SharePoint On Prem
Dal progetto Discovery, completare i seguenti passaggi:
-
Nel riquadro di navigazione, scegliere Gestione collezioni.
-
Fare clic su Nuova raccolta.
-
Fare clic su SharePoint On Prem, quindi su Next.
-
Dare un nome alla collezione.
-
Se la lingua dei documenti in SharePoint non è l'inglese, selezionare la lingua appropriata.
Per un elenco delle lingue supportate, vedi Supporto linguistico.
-
Opzionale: Modificare la pianificazione della sincronizzazione.
Per ulteriori informazioni, vedere Opzioni di pianificazione delrawl.
-
Nella sezione Inserire le credenziali, compilare i seguenti campi:
- Nome utente
- Il nome utente dell'utente di SharePoint con accesso a tutti i siti e gli elenchi che devono essere sottoposti a scansione e indicizzati.
- Password
- La password dell'utente SharePoint.
Questo valore non viene mai restituito e viene utilizzato solo quando si creano o modificano le credenziali.
-
Opzionale: se si desidera utilizzare l'autenticazione basata su rivendicazioni del Security Assertion Mark-up Language (SAML), impostare l'interruttore Abilita autenticazione SAML su
On. Altrimenti, viene utilizzata l'autenticazione di Windows NT LAN Manager (NTLM). Aggiungere i valori ai seguenti campi:- Endpoint del provider di identità
- L' URL e dell'endpoint dell'Identity Provider, ad esempio
https://adfs.server.example.com/adfs/services/trust/2005/UsernameMixed. - Endpoint della Relying Party
- Facoltativo. URL dell'endpoint Relying Party Trust. Se non specificato, viene utilizzato il seguente valore:
https://<sharepoint_server>:<port>/_trust/. - Identificatore fiduciario della Relying Party
- URL dell'identificativo fiduciario della Relying Party, ad esempio
urn:sharepoint:sample. Se non specificato, viene utilizzato il seguente valore:https://<sharepoint_server>:<port>/_trust/. Questa funzione è disponibile nelle versioni 2013, 2016 e 2019.
-
Nella sezione Specificare ciò che si desidera sottoporre a crawling, aggiungere il servizio web SharePoint URL al campo Url dell'applicazione web. Ad esempio,
https://<host>:<port>. -
Opzionale: se si utilizza un server proxy per accedere al server di origine dati, nella sezione Impostazioni proxy, impostare l'interruttore Abilita impostazioni proxy su
On. Aggiungere i valori ai seguenti campi:- Nome utente
- Facoltativo. Il nome utente del server proxy da autenticare, se il server proxy richiede l'autenticazione. Se non si conosce il nome utente, è possibile ottenerlo dall'amministratore del server proxy.
- Password
- Facoltativo. La password del server proxy da autenticare, se il server proxy richiede l'autenticazione. Se non si conosce la password, è possibile ottenerla dall'amministratore del server proxy.
- Nome host o indirizzo IP del server proxy
- Il nome host o l'indirizzo IP del server proxy.
- Numero porta del server proxy
- La porta di rete a cui si desidera connettersi sul server proxy.
-
Opzionale: se si desidera attivare la sicurezza a livello di documento, nella sezione Sicurezza, impostare l'interruttore Abilita sicurezza a livello di documento su
On.Quando questa opzione è attivata, gli utenti possono eseguire il crawling e la query dello stesso contenuto a cui possono accedere quando sono connessi a SharePoint. Completate i passi preliminari per aggiungere il supporto.
Quando si attiva questa opzione, è necessario fornire i valori per i seguenti campi:
- URL server LDAP
- Il server LDAP URL a cui connettersi, ad esempio
ldap://<ldap_server>:<port>. - Nome utente vincolato LDAP
- Il nome utente utilizzato per collegarsi al servizio directory. Nella maggior parte dei casi, questo nome utente è un DN (distinguished name). Il nome di accesso potrebbe a volte funzionare con Active Directory. Ma a differenza dell'accesso generale a Windows, è sensibile alle maiuscole. Il nome distinto funziona sempre.
- Password utente vincolante LDAP
- La password utilizzata per collegarsi al servizio directory.
- DN base LDAP
- Il punto di partenza per la ricerca delle voci utente in LDAP, ad esempio
CN=Users,DC=example,DC=com. - Filtro utente LDAP
- Il filtro utente per cercare le voci degli utenti in LDAP. Se non specificato, il valore predefinito è "
(userPrincipalName={0})".
-
Se si desidera che il crawler estragga il testo dalle immagini del sito, espandere Altre impostazioni di elaborazione e impostare Applica il riconoscimento ottico dei caratteri (OCR) su
On.Quando l'OCR è abilitato e i documenti contengono immagini, l'elaborazione richiede più tempo. Per ulteriori informazioni, vedere Riconoscimento ottico dei caratteri.
-
Fai clic su Finish.
La collezione viene creata rapidamente. L'elaborazione dei dati richiede più tempo per l'aggiunta alla raccolta.
Se si desidera controllare i progressi, andare alla pagina Attività. Nel riquadro di navigazione, fare clic su Gestione raccolte, quindi fare clic per aprire la raccolta.
Passi preliminari per le versioni precedenti
Se si utilizza la versione 2.2.1 o precedente, è necessario completare questi passaggi aggiuntivi prima di potersi collegare all'origine dati:
- Ottenere un pacchetto di servizi web dal cluster Discovery. Questo pacchetto di servizi Web è un modulo personalizzato che il crawler utilizza per ottenere le informazioni necessarie per eseguire il crawling con successo. Per ulteriori informazioni, vedere Ottenere il pacchetto di servizi Web.
- Distribuire il pacchetto di servizi Web sul server SharePoint. Per ulteriori informazioni, vedere Dispiegare i servizi Web sul server SharePoint.
Ottenere il pacchetto di servizi web
Per ottenere il pacchetto di servizi Web dal cluster Discovery, completare i seguenti passaggi:
-
Accedi al tuo cluster Discovery.
-
Immettere il comando seguente per ottenere il nome del pod
crawler:oc get pods | grep crawlerPotresti vedere un output simile al seguente messaggio:
wd-discovery-crawler-57985fc5cf-rxk89 1/1 Running 0 85m -
Inserite il seguente comando per ottenere il file
ESSPSolution.wsp, sostituendo{crawler-pod-name}con il nome del podcrawlerottenuto nel passo precedente:oc exec {crawler-pod-name} -- ls -l /opt/ibm/wex/zing/resources/ | grep ESSPSolutionPotresti vedere un output simile al seguente messaggio:
-rw-r--r--. 1 dadmin dadmin 8600 Feb 3 08:23 ESSPSolution-${build-version}.wsp -
Immettere il comando seguente per copiare il file
ESSPSolution.wspsul server host, sostituendo{build-version}con il numero di versione della build del passo precedente e{crawler-pod-name}con il nome del podcrawler:oc cp {crawler-pod-name}:/opt/ibm/wex/zing/resources/ESSPSolution-${build-version}.wsp ESSPSolution.wsp
Distribuire i servizi Web sul server SharePoint
È possibile distribuire manualmente i servizi Web sul server SharePoint o eseguire uno script che li distribuisca automaticamente.
Per eseguire lo script che distribuisce automaticamente i servizi web:
-
Eseguire lo script
ESSPSolution.wspsul server SharePoint immettendo il seguente cmdlet Windows PowerShell:Add-SPSolution -LiteralPath C:\files\ESSPSolution.wsp -
In SharePoint, aprire SharePoint Amministrazione centrale e quindi aprire Impostazioni di sistema.
-
Distribuire il pacchetto utilizzando le soluzioni aziendali.
-
Selezionate la soluzione
esspsolution.wspe distribuitela.Al termine della distribuzione, la soluzione farm è elencata nella console di amministrazione SharePoint. Un amministratore può attivare o disattivare la soluzione e programmare i trigger.
-
Opzionale: Indipendentemente dall'approccio utilizzato per distribuire i servizi Web, per completare la distribuzione in alcuni ambienti potrebbe essere necessario applicare le seguenti configurazioni al server Internet Information Services (IIS) che ospita il server SharePoint e i servizi Web:
- Consentire l'impersonificazione di .NET su IIS
- Cambiare il livello di fiducia ASP.NET in WSS_Medium
È possibile applicare queste configurazioni in Internet Information Services Manager.