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:

  1. 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.

  2. 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:

  1. Nel riquadro di navigazione, scegliere Gestione collezioni.

  2. Fare clic su Nuova raccolta.

  3. Fare clic su SharePoint On Prem, quindi su Next.

  4. Dare un nome alla collezione.

  5. Se la lingua dei documenti in SharePoint non è l'inglese, selezionare la lingua appropriata.

    Per un elenco delle lingue supportate, vedi Supporto linguistico.

  6. Opzionale: Modificare la pianificazione della sincronizzazione.

    Per ulteriori informazioni, vedere Opzioni di pianificazione delrawl.

  7. 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.

  8. 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.
  9. 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>.

  10. 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.
  11. 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}) ".
  12. 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.

  13. 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:

  1. Accedi al tuo cluster Discovery.

  2. Immettere il comando seguente per ottenere il nome del pod crawler:

    oc get pods | grep crawler
    

    Potresti vedere un output simile al seguente messaggio:

    wd-discovery-crawler-57985fc5cf-rxk89     1/1     Running     0          85m
    
  3. Inserite il seguente comando per ottenere il file ESSPSolution.wsp, sostituendo {crawler-pod-name} con il nome del pod crawler ottenuto nel passo precedente:

    oc exec {crawler-pod-name} -- ls -l /opt/ibm/wex/zing/resources/ | grep ESSPSolution
    

    Potresti vedere un output simile al seguente messaggio:

    -rw-r--r--. 1 dadmin dadmin  8600 Feb  3 08:23 ESSPSolution-${build-version}.wsp
    
  4. Immettere il comando seguente per copiare il file ESSPSolution.wsp sul server host, sostituendo {build-version} con il numero di versione della build del passo precedente e {crawler-pod-name} con il nome del pod crawler:

    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:

  1. Eseguire lo script ESSPSolution.wsp sul server SharePoint immettendo il seguente cmdlet Windows PowerShell: Add-SPSolution -LiteralPath C:\files\ESSPSolution.wsp

  2. In SharePoint, aprire SharePoint Amministrazione centrale e quindi aprire Impostazioni di sistema.

  3. Distribuire il pacchetto utilizzando le soluzioni aziendali.

  4. Selezionate la soluzione esspsolution.wsp e 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.

  5. 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.