Configure and use the Documentum connector in SharePoint Server

SI APPLICA A:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

Questo articolo descrive come installare e configurare il connettore di indicizzazione di Microsoft SharePoint Server per Documentum.

Il connettore di indicizzazione di Microsoft SharePoint Server per Documentum consente di indicizzare il contenuto archiviato nel sistema EMC Documentum. Questo articolo descrive come installare e configurare il connettore di indicizzazione per Documentum per l'uso con SharePoint Server.

Il connettore di indicizzazione per Documentum presenta le seguenti caratteristiche:

• Connettore a 64 bit basato su SharePoint Server Search Connector Framework.

• Supporta più versioni di EMC Documentum Content Server.

• Indicizza gli oggetti e i metadati degli oggetti di Documentum. Vedere Tipi e proprietà di oggetti Documentum supportati e non supportati in SharePoint Server.

• Supporta i criteri e le definizioni di sicurezza di Documentum.

• Supporta Microsoft PowerShell per la configurazione e l'amministrazione automatizzate. Vedere Uso del cmdlet SPEnterpriseSearchDCTMConnectorConfig.

• Dispone di un URL dei risultati di ricerca configurabile per supportare più applicazioni client di Documentum.

• Supporta l'esclusione di file e cartelle per la ricerca per indicizzazione.

Prima di iniziare

Prima di iniziare questa operazione, prendere visione dei seguenti prerequisiti e requisiti di sistema:

• I sistemi operativi supportati sono Windows Server 2008 R2, Windows Server 2008 Service Pack 2 e Windows Server 2012.

• Viene installato e configurato uno dei seguenti prodotti SharePoint 2019, SharePoint 2016 o SharePoint 2013:

  • Microsoft SharePoint Server Enterprise

  • Microsoft SharePoint Server Standard

• Deve essere installata e configurata un'applicazione del servizio di ricerca.

• Deve essere installata in un host Windows un'istanza di Documentum Foundation Services (DFS) Server con una versione compatibile con DFS Productivity Layer 6.7 SP2.

• Deve essere installato DFS Productivity Layer 6.7 SP2 ed è necessario disporre dell'accesso agli assembly .NET inclusi in DFS Productivity Layer 6.7 SP2. Nel connettore di indicizzazione per Documentum viene utilizzato DFS come API di connettività per l'accesso agli archivi Documentum.

• È installato Documentum Content Server. Le versioni supportate di Documentum Content Server sono determinate da DFS 6.7 SP2. È possibile trovare un elenco dettagliato nelle note sulla versione di DFS Productivity Layer 6.7 SP2.

• Il connettore di indicizzazione per Documentum deve essere configurato con -ACLTranslation "Claims" se è necessario eseguire ricerche per indicizzazione in archivi Documentum in cui è abilitato Documentum Trusted Content Services (TCS). Questa configurazione del connettore consente anche di abilitare il mapping automatico tra gli utenti di Windows Active Directory e gli utenti di Documentum, indipendentemente dall'abilitazione di TCS nell'archivio.

Panoramica

I passaggi seguenti offrono una panoramica generale delle attività necessarie per installare e configurare il connettore di indicizzazione per Documentum da usare con SharePoint Server.

1. Preparazione

1. Verifica della conformità del sistema ai prerequisiti e ai requisiti di sistema elencati nella sezione Prima di iniziare.

2. Scaricare SharePoint Server 2016 Indexing Connector per Documentum dall'Area download Microsoft.

3. Scelta dell'account di accesso al contenuto di Documentum da utilizzare per la ricerca per indicizzazione.

4. Preparare i server SharePoint che ospitano un componente di ricerca per indicizzazione. In ogni server effettuare le seguenti operazioni:

   • Impostazione degli assembly .NET di DFS Productivity Layer.

   • Modifica del file machine.config per impostare i binding di Documentum.

2. Installare il connettore di indicizzazione per Documentum

1. Installare il connettore di indicizzazione per Documentum in ogni server SharePoint nella farm che ospita un componente di ricerca per indicizzazione.

2. Registrare il connettore di indicizzazione per Documentum nell'applicazione del servizio di ricerca usando Microsoft PowerShell.

3. Configurare il connettore di indicizzazione per Documentum

Configurare il connettore di indicizzazione per Documentum in ogni server SharePoint nella farm che ospita un componente di ricerca per indicizzazione usando il cmdlet Indexing Connector for Documentum PowerShell. Scegliere una delle seguenti configurazioni:

4. Configurare una regola di ricerca per indicizzazione di Documentum e un'origine di contenuto nell'applicazione del servizio di ricerca tramite Amministrazione centrale

1. Creazione di una regola di ricerca per indicizzazione per Documentum

2. Creazione di un'origine contenuto di Documentum

3. Esecuzione di una ricerca per indicizzazione completa.

Preparare i server SharePoint che ospitano un componente di ricerca per indicizzazione

Scelta dell'account di accesso al contenuto di Documentum da utilizzare per la ricerca per indicizzazione

1. Sarà necessario specificare l'account e la password di accesso al contenuto di Documentum successivamente nella procedura di configurazione, quando verranno definite le regole di ricerca per indicizzazione. Nel connettore di indicizzazione per Documentum viene utilizzato l'account di accesso al contenuto per recuperare contenuto dall'archivio Documentum. Questo account deve disporre delle seguenti autorizzazioni minime:

   • Autorizzazione di lettura per i documenti in cui si desidera eseguire ricerche per indicizzazione.
   • Autorizzazione di esplorazione per file CAB, cartelle e record (documenti solo con metadati) in cui si desidera eseguire ricerche per indicizzazione.

Impostazione degli assembly .NET di DFS Productivity Layer

1. Individuare i seguenti assembly .NET di DFS Productivity Layer e verificare che il numero di versione sia 6.7.2000.36 per tutti i file. Quando vengono estratti nel percorso predefinito, questi file si trovano nella %local%\emc-dfs-sdk-6.7\emc-dfs-sdk-6.7\lib\dotnet directory.

   • Emc.Documentum.FS.DataModel.Core.dll

   • Emc.Documentum.FS.DataModel.Shared.dll

   • Emc.Documentum.FS.runtime.dll

   • Emc.Documentum.FS.Services.Core.dll

2. In ogni server che ospita un componente di ricerca per indicizzazione accedere con un account membro del gruppo Administrators in tale server e distribuire gli assembly .NET del livello di produttività DFS nella Global Assembly Cache %windir%\assembly.

   Nota

   È possibile trascinare e rilasciare le quattro DLL nella Global Assembly Cache ( %windir%\assembly) per distribuirle, ma potrebbe essere necessario disattivare Controllo account utente per eseguire questa operazione.

La procedura seguente illustra come modificare il file machine.config in ogni server SharePoint che ospita un componente di ricerca per indicizzazione per includere le impostazioni WCF per il livello di produttività DFS. Questa operazione viene eseguita per garantire il corretto funzionamento degli assembly .NET di DFS Productivity Layer.

Le impostazioni WCF che vengono impostate in Modifica del file machine.config consentono un massimo di 30 megabyte (MB) per oggetto contenuto di Documentum (il file del documento più i relativi metadati) trasferito. L'amministratore può aumentare il valore di maxReceivedMessageSize nel binding DfsDefaultService per contenuto di dimensioni maggiori.

Modifica del file machine.config

1. Aprire il file machine.config in ogni server che ospita un componente di ricerca per indicizzazione. Questo file si trova nella directory %windir%\Microsoft.NET\Framework64\v4.0.30319\Config.

2. Copiare il frammento XML seguente nell'elemento di <configurazione> :

   <system.serviceModel>
   <bindings>
   <basicHttpBinding>
   <binding name="DfsAgentService" closeTimeout="00:01:00"
    openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00"
    allowCookies="false" bypassProxyOnLocal="false" hostNameComparisonMode="StrongWildcard"
    maxBufferSize="10000000" maxBufferPoolSize="10000000" maxReceivedMessageSize="10000000"
    messageEncoding="Text" textEncoding="utf-8" transferMode="Buffered"
    useDefaultWebProxy="true">
   <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384"
     maxBytesPerRead="4096" maxNameTableCharCount="16384" />
   <security mode="None">
   <transport clientCredentialType="None" proxyCredentialType="None"
   realm="" />
   <message clientCredentialType="UserName" algorithmSuite="Default" />
   </security>
   </binding>
   <binding name="DfsContextRegistryService" closeTimeout="00:01:00"
      openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00"
      allowCookies="false" bypassProxyOnLocal="false" hostNameComparisonMode="StrongWildcard"
      maxBufferSize="10000000" maxBufferPoolSize="10000000" maxReceivedMessageSize="10000000"
      messageEncoding="Text" textEncoding="utf-8" transferMode="Buffered"
      useDefaultWebProxy="true">
   <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384"
   maxBytesPerRead="4096" maxNameTableCharCount="16384" />
   <security mode="None">
   <transport clientCredentialType="None" proxyCredentialType="None"
   realm="" />
   <message clientCredentialType="UserName" algorithmSuite="Default" />
   </security>
   </binding>
   <binding name="DfsDefaultService" closeTimeout="00:01:00" openTimeout="00:10:00" receiveTimeout="00:20:00" sendTimeout="00:10:00" allowCookies="false" bypassProxyOnLocal="false" hostNameComparisonMode="StrongWildcard" maxBufferSize="10000000" maxBufferPoolSize="10000000" maxReceivedMessageSize="30000000" messageEncoding="Text" textEncoding="utf-8" transferMode="StreamedResponse" useDefaultWebProxy="true">
   <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384" maxBytesPerRead="1048576" maxNameTableCharCount="16384"/>
   <security mode="None">
   <transport clientCredentialType="None" proxyCredentialType="None" realm=""/>
   <message clientCredentialType="UserName" algorithmSuite="Default"/>
   </security>
   </binding>
   </basicHttpBinding>
   </bindings>
   </system.serviceModel>
   

Installazione e registrazione del connettore di indicizzazione per Documentum

Installazione del connettore di indicizzazione per Documentum

1. Scaricare il connettore di indicizzazione per Documentum dall'Area download Microsoft.

2. In ogni server della farm che ospita un componente di ricerca per indicizzazione installare il connettore di indicizzazione per Documentum eseguendo il file DCTMIndexConn.exe. Seguire le indicazioni dell'installazione guidata.

Registrazione del connettore di indicizzazione per Documentum nell'applicazione del servizio di ricerca

1. Eseguire questa procedura in un server SharePoint che ospita un componente di ricerca per indicizzazione per registrare il connettore nell'applicazione del servizio di ricerca.

2. Avviare una SharePoint Management Shell.

3. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:

   New-SPEnterpriseSearchCrawlCustomConnector -SearchApplication "<name of your Search service application>" -Protocol "dctm" -ModelFilePath "<%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\CONFIG\SearchConnectors\Documentum\MODEL.xml>" -Name "Microsoft SharePoint 2016 Indexing Connector for Documentum"
   

   Dove:

   • <nome dell'applicazione> del servizio di ricerca è il nome dell'applicazione del servizio di ricerca a cui si sta registrando il connettore.

   • <%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\CONFIG\SearchConnectors\Documentum\MODEL.xml> è il percorso del file del modello connettore di indicizzazione per Documentum. In questo esempio viene utilizzato il percorso predefinito.

Configurazione del connettore di indicizzazione per Documentum

Configurare le impostazioni del connettore con il cmdlet Indexing Connector for Documentum PowerShell ( Set-SPEnterpriseSearchDCTMConnectorConfig). Le impostazioni vengono archiviate in %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\CONFIG\SearchConnectors\Documentum\DCTMConfig.xml e devono essere le stesse in ogni server SharePoint Server 2016 che ospita un componente di ricerca per indicizzazione.

I parametri del cmdlet di PowerShell da utilizzare e i passaggi di configurazione aggiuntivi da eseguire dipendono dalla modalità di configurazione scelta.

Configurazione del connettore di indicizzazione per Documentum per il supporto di TCS e del mapping automatico degli utenti

Nelle seguenti procedure viene illustrato come configurare il connettore di indicizzazione per Documentum per il supporto di TCS. Nelle procedure viene mostrato inoltre come abilitare il mapping automatico degli utenti configurando il servizio di sincronizzazione della limitazione per motivi di sicurezza e come creare e distribuire trimmer personalizzati di pre-sicurezza e post-sicurezza. Al termine delle procedure, le credenziali utente di Documentum verranno sincronizzate automaticamente con Servizi di dominio Active Directory, ai risultati di ricerca verrà applicata la limitazione per motivi di sicurezza appropriata e gli utenti potranno recuperare solo i risultati di ricerca di Documentum che sono autorizzati a visualizzare.

Il servizio di sincronizzazione Trimmer di sicurezza esegue il mapping degli utenti di Documentum agli utenti di Active Directory esaminando i campi di Documentum user_os_domain, user_login_name, user_source e user_ldap_dn. Se il campo user_ldap_dn viene popolato, il servizio di sincronizzazione Trimmer di sicurezza tenterà di estrarre un dominio dal primo valore del controller di dominio. Ad esempio, se il campo user_ldap_dn viene popolato con " CN=Nome utente, OU=Unità,DC=Dominio,DC=Reparto,DC=Società ", il servizio di sincronizzazione Trimmer di sicurezza estrarrà il dominio da DC=Domain e ignorerà DC=Department,DC=Company.

Per configurare il connettore per il supporto di TCS e del mapping automatico degli utenti

1. Avviare una Shell di gestione SharePoint in ogni server che ospita un componente di ricerca per indicizzazione.

2. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:

   Set-SPEnterpriseSearchDCTMConnectorConfig -Shared -ACLTranslation "Claims" -DisplayURLPatternForDocument "http://<MyWebTopServer:PortOfMyWebTopServer>/webtop/component/drl?objectId={ObjectId}&amp;format={Format}&amp;RepositoryName={RepositoryName}" -DisplayURLPatternForContainer "http://<MyWebTopServer:PortOfMyWebTopServer>/webtop/component/drl?objectId={ObjectId}&amp;RepositoryName={RepositoryName}"
   Set-SPEnterpriseSearchDCTMConnectorConfig -Repository -RepositoryName "<MyRepository1>" -DFSWebServiceURL @("http://<DFSWebServices>:<30000>/services"), ("http://<DFSWebServices2>:<30000>/services")
   
   Set-SPEnterpriseSearchDCTMConnectorConfig -Repository -RepositoryName "<MyRepository2>" -DFSWebServiceURL @("http://<DFSWebServices>:<30000>/services")
   

   Dove:

   • <MyWebTopServer:PortOfMyWebTopServer> è il nome e il numero di porta del server Dfs Web Top in uso.

   • <MyRepository n> è il nome del repository Documentum per cui si vuole eseguire la ricerca per indicizzazione.

   • <DFSWebServices n>:<30000> è il nome e il numero di porta del server dei servizi Web Documentum che ospita il repository Documentum per cui si vuole eseguire la ricerca per indicizzazione.

3. Riavviare il servizio OSearch15. Questa operazione deve essere eseguita prima di creare un'origine contenuto per Documentum.

   IMPORTANTE: Non usare la pagina Servizi nel server del sito Web Amministrazione centrale SharePoint per riavviare il servizio. In questo modo viene reimpostato l'indice di ricerca, che richiede di eseguire una ricerca per indicizzazione completa di tutto il contenuto per ricompilare l'indice.

   • Verificare che l'account utente utilizzato per eseguire questa procedura sia un amministratore per il server che ospita il componente di ricerca per indicizzazione.

   • Aprire una finestra del prompt dei comandi

   • Per arrestare il servizio OSearch15, digitare questo comando: net stop osearch15

   • Per avviare il servizio OSearch15, digitare questo comando: net start osearch15

Per configurare il servizio di sincronizzazione della limitazione per motivi di sicurezza

1. Aprire il file Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe.config. Questo file viene archiviato nella cartella in cui è stato installato il connettore Indexing Connector for Documentum. Il percorso predefinito è %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\CONFIG\SearchConnectors\Documentum

2. Utilizzando le stesse informazioni specificate per la configurazione del connettore di indicizzazione per Documentum, modificare il file di configurazione come indicato di seguito.

   • Nell'elemento ModuleInfo della sezione Emc.Documentum effettuare le seguenti operazioni:

     • Nell'attributo host digitare il nome host del server Documentum.

     • Nell'attributo port digitare il numero di porta del server Documentum.

   • Nell'elemento Repositories della sezione Data Source: Documentum Settings effettuare le seguenti operazioni:

     • Nell'attributo dell'ID del repository digitare l'ID del repository Documentum.

     • Nell'attributo name digitare il nome dell'archivio Documentum.

     • Nell'attributo login digitare il nome di accesso di Documentum. Utilizzare lo stesso nome di accesso dell'account di accesso al contenuto di Documentum. Deve corrispondere a un utente con autorizzazioni utente con privilegi elevati per Documentum Content Server.

     • Nell'attributo dfs digitare il percorso di Documentum Foundation Services (DFS) specificando il relativo URI.

   • (Facoltativo) Se la connessione a Documentum richiede l'utilizzo del protocollo SSL/HTTPS, sarà necessario modificare la modalità di sicurezza.

     • Nell'elemento basicHttpBinding del sottoparagrafo Documentum della sezione Data Source: Documentum Settings impostare l'attributo della modalità di sicurezza cambiandolo da None in Transport per i seguenti binding:

       • DfsAgentService

       • DfsContextRegistryService

       • DfsDefaultService

   • Nell'elemento netNamedPipeBinding del sottoparagrafo Documentum della sezione Data Source: Documentum Settings impostare l'attributo della modalità di sicurezza cambiandolo da None in Transport per i seguenti binding:

     • localNamedPipeBinding

3. Salvare e chiudere il file.

4. Copiare gli assembly .NET di DFS Productivity Layer nel server che esegue il servizio di sincronizzazione della limitazione per motivi di sicurezza.

   • Individuare i seguenti assembly .NET di DFS Productivity Layer e verificare che il numero di versione sia 6.7.2000.36 per tutti i file. Quando vengono estratti nel percorso predefinito, questi file si trovano nella %local%\emc-dfs-sdk-6.7\emc-dfs-sdk-6.7\lib\dotnet directory.

     • Emc.Documentum.FS.DataModel.Core.dll

     • Emc.Documentum.FS.DataModel.Shared.dll

     • Emc.Documentum.FS.runtime.dll

     • Emc.Documentum.FS.Services.Core.dll

   • Nel server che ospita il servizio di sincronizzazione del taglio della sicurezza accedere con un account membro del gruppo Administrators in tale server e distribuire gli assembly .NET del livello di produttività DFS nella Global Assembly Cache %windir%\assembly.

   Nota

   È possibile trascinare e rilasciare le quattro DLL nella Global Assembly Cache ( %windir%\assembly) per distribuirle, ma potrebbe essere necessario disattivare Controllo account utente per eseguire questa operazione.

5. Configurare l'autenticazione per il servizio di sincronizzazione della limitazione per motivi di sicurezza e installare il servizio.

   • Verificare che l'account utente utilizzato per eseguire la procedura sia membro del gruppo Amministratori farm.

   • Aprire una finestra del prompt dei comandi in ogni server che ospita un componente di elaborazione delle query.

   • Digitare il seguente comando: Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe -p

     Quando richiesto, immettere la password dell'account specificato nell'attributo login. Utilizzare lo stesso nome di accesso dell'account di accesso al contenuto di Documentum. La password verrà crittografata automaticamente e aggiunta nel file di configurazione del servizio di sincronizzazione della limitazione per motivi di sicurezza.

   • Installare il servizio di sincronizzazione della limitazione per motivi di sicurezza. Digitare il seguente comando: Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe -i

6. Avviare il servizio di sincronizzazione della limitazione per motivi di sicurezza.

   • Aprire Server Manager di Windows.

   • Scegliere Servizi dal menu Configurazione.

   • Fare clic con il pulsante destro del mouse sul servizioSharePoint Documentum Security Sync, quindi scegliere Proprietà. Nella scheda Connessione selezionare Account e specificare i dettagli e le credenziali dell'account che esegue i servizi SharePoint. Fare clic su OK.

   • Fare clic con il pulsante destro del mouse sul servizio SharePoint Documentum Security Sync, quindi scegliere Avvia.

   • Verificare che la colonna Stato cambi in Avviato.

7. Verificare che il servizio sia in esecuzione e che sia stata eseguita la sincronizzazione della sicurezza.

   • Eseguire il comando Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe -d per scrivere la memoria del servizio di sincronizzazione della limitazione per motivi di sicurezza in un file di testo.

   • Verificare che il servizio di sincronizzazione della limitazione per motivi di sicurezza si connetta al server Documentum. Leggere il file DCTMSecuritySync.log che si trova nella directory <Microsoft Office Server path>\15.0\Data\Office Server\Applications\Search\Nodes

   • Verificare che le informazioni sull'appartenenza dal server Documentum siano scritte nel file DCTMSecuritySync_Dump.txt che si trova nella directory <Microsoft Office Server path>\15.0\Data\Office Server\Applications\Search\Nodes

Per poter aggiungere i trimmer di pre-sicurezza e post-sicurezza, è necessario innanzitutto aggiungere una regola di ricerca per indicizzazione semplice per Documentum. Successivamente è possibile specificare o espandere le regole di ricerca per indicizzazione.

Creazione di una regola di ricerca per indicizzazione semplice per Documentum

1. Verificare che l'account utente utilizzato per eseguire questa procedura sia un amministratore dell'applicazione del servizio di ricerca.

2. Nella sezione Gestione applicazioni della home page amministrazione centrale SharePoint fare clic su Gestisci applicazioni di servizio.

3. Nella pagina Gestisci applicazioni di servizio fare clic sull'applicazione del servizio di ricerca per cui si desidera creare una regola di ricerca per indicizzazione.

4. Nella sezione Ricerca per indicizzazione della pagina Amministrazione ricerca fare clic su Regole di ricerca per indicizzazione.

5. Nella pagina Gestisci regole di ricerca per indicizzazione fare clic su Nuova regola ricerca per indicizzazione.

6. Nella pagina Aggiungi regola ricerca per indicizzazione specificare le seguenti informazioni per creare una regola di ricerca per indicizzazione:

   • Nella casella Percorso digitare dctm://*.

   • Nella sezione Configurazione ricerca per indicizzazione selezionare Includi tutti gli elementi nel percorso, quindi Esegui ricerca per indicizzazione di URL complessi, ovvero URL che contengono un punto interrogativo (?).

   • Nella sezione Impostazione autenticazione selezionare Specifica un account di accesso contenuto diverso, quindi digitare la password e l'account di accesso al contenuto di Documentum nelle caselle appropriate.

   • Assicurarsi che la casella di controllo Autenticazione di base non consentita sia deselezionata.

7. Fare clic su OK per aggiungere la regola di ricerca per indicizzazione.

Per aggiungere i trimmer di pre-sicurezza e post-sicurezza del connettore di indicizzazione per Documentum

1. Avviare una Shell di gestione SharePoint in ogni server che ospita un componente di elaborazione delle query.

2. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:

   New-SPEnterpriseSearchSecurityTrimmer -SearchApplication <name of your Search service application> -typeName "Microsoft.Office.Server.Search.Connector.Documentum.Trimmers.DctmTrimPre, Microsoft.Office.Server.Search.Connector.Documentum.Trimmers, Version=15.0.0.0,Culture=neutral, PublicKeyToken=48e046c834625a88, processorArchitecture=MSIL" -id 26 -RulePath dctm:\\*
   New-SPEnterpriseSearchSecurityTrimmer -SearchApplication <name of your Search service application> -typeName "Microsoft.Office.Server.Search.Connector.Documentum.Trimmers.DctmTrimPost, Microsoft.Office.Server.Search.Connector.Documentum.Trimmers, Version=15.0.0.0,Culture=neutral, PublicKeyToken=48e046c834625a88, processorArchitecture=MSIL" -id 17 -RulePath dctm:\\*
   

   Dove:

   • <il nome dell'applicazione> del servizio di ricerca è il nome dell'applicazione del servizio di ricerca.

3. Riavviare il servizio Controller host della ricerca di SharePoint.

   • Aprire una finestra del prompt dei comandi

   • Per arrestare il servizio Controller host della ricerca di SharePoint, digitare il comando seguente: net stop spsearchhostcontroller

   • Per avviare il servizio Controller host della ricerca di SharePoint, digitare il seguente comando: net start spsearchhostcontroller

4. Continuare con la procedura descritta nella sezione Creazione di un'origine contenuto di Documentum.

Configurazione del connettore di indicizzazione per Documentum tramite una tabella di mapping degli utenti

Nelle procedure riportate di seguito viene illustrato come creare manualmente una tabella di mapping degli utenti in cui viene specificato come sono mappati gli utenti di Documentum agli utenti di Servizi di dominio Active Directory o dei servizi Active Directory, nonché come configurare il connettore per supportare la ricerca per indicizzazione del contenuto di Documentum e l'utilizzo della tabella di mapping degli utenti.

• La tabella di mapping degli utenti deve trovarsi in un database di SQL Server 2008 o versione successiva.

• L'account del servizio OSearch15 deve disporre come minimo dell'autorizzazione di lettura per i dati della tabella di mapping degli utenti.

Per creare una tabella di mapping degli utenti

Creare prima di tutto una tabella di mapping utente in SQL Server 2008 o una versione successiva. Questa tabella deve essere nel seguente formato:

Utilizzare il seguente script per creare una tabella di mapping degli utenti:

CREATE TABLE <replace with your user mapping table name>
(
DCTMCredentialDomain nvarchar (255) NOT NULL ,
DCTMCredentialRepository nvarchar (32) NOT NULL ,
DCTMCredentialLoginName nvarchar (80) NOT NULL ,
NTCredential nvarchar (255) NOT NULL ,
CONSTRAINT PK_CredentialMapping PRIMARY KEY CLUSTERED
( DCTMCredentialDomain, DCTMCredentialRepository, DCTMCredentialLogonName )
)

In alternativa, è possibile creare manualmente la tabella di mapping degli utenti utilizzando SQL Server Management Studio o uno strumento equivalente. In questo caso utilizzare lo stesso schema definito nello script.

Popolare quindi la tabella di mapping degli utenti con coppie di credenziali Documentum/Windows NT. Nella tabella riportata nel passaggio precedente viene mostrato il tipo di input previsto.

Esempio:

Un utente di un archivio Documentum Indro Neri dispone di un accesso collegato all'archivio Finance. L'account utente del dominio di Windows di Indro Neri è Contoso\ineri. In questo caso, la voce della tabella di mapping degli utenti relativa a Indro Neri sarà la seguente:

Infine, concedere all'account OSearch15 l'accesso in lettura alla tabella di mapping degli utenti.

Per configurare il connettore utilizzando una tabella di mapping degli utenti

1. Avviare una Shell di gestione SharePoint in ogni server che ospita un componente di ricerca per indicizzazione.

2. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:

   Set-SPEnterpriseSearchDCTMConnectorConfig -Shared -ACLTranslation UserMappingTable -DisplayURLPatternForContainer "http://<MyWebTopServer:PortOfMyWebTopServer>/webtop/component/drl?objectId={ObjectId}&amp;RepositoryName={RepositoryName}" -DisplayURLPatternForDocument "http://<MyWebTopServer:PortOfMyWebTopServer>/webtop/component/drl?objectId={ObjectId}&amp;format={Format}&amp;RepositoryName={RepositoryName}" -UnmappedAccount "DiscardACE" -UserMappingTableSQLServer "<YourDatabaseServerName>" -UserMappingTableSQLInstance "<YourDatabaseInstanceName>" -UserMappingTableDBName "<YourMappingDatabaseName>" -UserMappingTableName "<YourMappingTableName>"
   Set-SPEnterpriseSearchDCTMConnectorConfig -Repository -RepositoryName "<MyRepository1>" -DFSWebServiceURL @("http://<DFSWebServices>:<30000>/services", "http://<DFSWebServices2>:<30000>/services")
   Set-SPEnterpriseSearchDCTMConnectorConfig -Repository -RepositoryName "<MyRepository2>" -DFSWebServiceURL @("http://<DFSWebServices>:<30000>/services")
   

   Dove:

   • <MyWebTopServer:PortOfMyWebTopServer> è il nome e il numero di porta del server Dfs Web Top in uso.

   • <YourDatabaseServerName> è il nome del server di database in cui è stata creata la tabella di mapping degli utenti.

   • <NomeIstanzaDatabase> è il nome dell'istanza di database del server di database in cui è stata creata la tabella di mapping degli utenti.

   • <YourMappingDatabaseName> è il nome del database in cui è stata creata la tabella di mapping utente.

   • <YourMappingTableName> è il nome della tabella di mapping utente creata.

   • <MyRepository n> è il nome del repository Documentum per cui si vuole eseguire la ricerca per indicizzazione.

   • <DFSWebServices n>:<30000> è il nome e il numero di porta del server dei servizi Web Documentum che ospita il repository Documentum per cui si vuole eseguire la ricerca per indicizzazione.

3. Riavviare il servizio OSearch15. L'amministratore del server che ospita il componente di ricerca per indicizzazione deve riavviare il servizio OSearch15 affinché sia possibile creare un'origine contenuto per Documentum.

   Importante

   Non usare la pagina Servizi nel server del sito Web Amministrazione centrale SharePoint per riavviare il servizio. In questo modo viene reimpostato l'indice di ricerca, che richiede di eseguire una ricerca per indicizzazione completa di tutto il contenuto per ricompilare l'indice.

   • Verificare che l'account utente utilizzato per eseguire questa procedura sia un amministratore per il server che ospita il componente di ricerca per indicizzazione.

   • Aprire una finestra del prompt dei comandi

   • Per arrestare il servizio OSearch15, digitare questo comando: net stop osearch15

   • Per avviare il servizio OSearch15, digitare questo comando: net start osearch15

Continuare con la procedura descritta nella sezione Creazione di una regola di ricerca per indicizzazione per Documentum e quindi con la procedura descritta nella sezione Creazione di un'origine contenuto di Documentum.

Creazione della categoria di proprietà sottoposte a ricerca per indicizzazione di Documentum

È necessario creare una categoria di proprietà sottoposte a ricerca per indicizzazione che conterrà le proprietà sottoposte a ricerca per indicizzazione di Documentum. A tale scopo, utilizzare il cmdlet New-SPEnterpriseSearchMetadataCategory e specificare il valore predefinito 34972762-7E3F-4f4f-AE5C-5ABBA92EC530 per il parametro PropSet del cmdlet. Usare il codice di PowerShell seguente per creare la categoria delle proprietà sottoposte a ricerca per indicizzazione in questo modo.

$ssa = Get-SPEnterpriseSearchServiceApplication
New-SPEnterpriseSearchMetadataCategory -Name "Documentum Connector" -SearchApplication $ssa -PropSet "34972762-7E3F-4f4f-AE5C-5ABBA92EC530" -DiscoverNewProperties $true

Creazione di una regola di ricerca per indicizzazione per Documentum

Per poter eseguire una ricerca per indicizzazione, è necessario innanzitutto creare almeno una regola di ricerca per indicizzazione per autenticare il crawler in DFS Server. È possibile creare più regole di ricerca per indicizzazione per includere o escludere contenuto specifico in Documentum.

1. Verificare che l'account utente che esegue questa procedura sia un amministratore per l'applicazione del servizio di ricerca.

2. Nella sezione Gestione applicazioni della home page amministrazione centrale SharePoint fare clic su Gestisci applicazioni di servizio.

3. Nella pagina Gestisci applicazioni di servizio fare clic sull'applicazione del servizio di ricerca per cui si desidera creare una regola di ricerca per indicizzazione.

4. Nella sezione Ricerca per indicizzazione della pagina Amministrazione ricerca fare clic su Regole di ricerca per indicizzazione.

5. Nella pagina Gestisci regole di ricerca per indicizzazione fare clic su Nuova regola ricerca per indicizzazione.

6. Nella pagina Aggiungi regola ricerca per indicizzazione specificare le seguenti informazioni:

   • Nella casella Percorso digitare il percorso a cui applicare la regola di ricerca per indicizzazione. È possibile utilizzare caratteri jolly standard. Per utilizzare un'espressione regolare anziché i caratteri jolly, selezionare Usa sintassi espressioni regolari per la corrispondenza con questa regola. Per alcuni esempi, vedere Sintassi per i riferimenti a un oggetto Documentum.

   • Nella sezione Configurazione ricerca per indicizzazione selezionare Includi tutti gli elementi nel percorso, quindi Esegui ricerca per indicizzazione di URL complessi, ovvero URL che contengono un punto interrogativo (?).

   • Nella sezione Impostazione autenticazione selezionare Specifica un account di accesso contenuto diverso, quindi digitare la password e l'account di accesso al contenuto di Documentum nelle relative caselle. Vedere Scelta dell'account di accesso al contenuto di Documentum da utilizzare per la ricerca per indicizzazione più indietro in questo articolo.

   • Assicurarsi che la casella di controllo Autenticazione di base non consentita sia deselezionata.

7. Fare clic su OK per aggiungere la regola di ricerca per indicizzazione.

   Nota

   È possibile creare più regole di ricerca per indicizzazione per Documentum per includere o escludere contenuto di Documentum.

   È possibile usare regole di ricerca per indicizzazione diverse per specificare account di accesso al contenuto diversi per contenuto di Documentum diverso. Ad esempio, sono disponibili due repository e due account di accesso al contenuto per ogni repository. L'account di accesso al contenuto di Documentum specificato in una regola di ricerca per indicizzazione verrà applicato solo al contenuto di Documentum coperto dal percorso in tale regola di ricerca per indicizzazione. Se si usa il servizio di sincronizzazione di limitazione della sicurezza, è necessario configurare questo servizio per ogni server Documentum.

Creazione di un'origine contenuto di Documentum

Creare un'origine contenuto di Documentum per specificare gli archivi di contenuto di Documentum in cui si desidera eseguire ricerche per indicizzazione.

1. Verificare che l'account utente che esegue questa procedura sia un amministratore per l'applicazione del servizio di ricerca.

2. Nella home page di Amministrazione centrale SharePointSharePoint fare clic su Gestisci applicazioni di servizio nella sezione Gestione applicazioni.

3. Fare clic sull'applicazione del servizio di ricerca in cui si desidera creare un'origine contenuto.

4. Nella sezione Ricerca per indicizzazione della pagina Amministrazione ricerca fare clic su Origini di contenuto.

5. Nella pagina Gestisci origini contenuto fare clic su Nuova origine di contenuto.

6. Nella pagina Aggiungi origine contenuto effettuare le seguenti operazioni:

   1. Nella casella Nome digitare il nome della nuova origine contenuto.

   2. Nella sezione Tipo di origine contenuto selezionare Archivio personalizzato.

   3. Nella sezione Tipo di repository selezionare Connettore di indicizzazione di SharePoint per Documentum. Utilizzare il nome specificato al momento della registrazione del connettore di indicizzazione per Documentum nell'applicazione del servizio di ricerca.

   4. Nella sezione Indirizzi iniziali digitare gli indirizzi iniziali. Il formato dell'indirizzo iniziale è lo stesso del modello di percorso. È possibile digitare più indirizzi iniziali per l'origine contenuto, uno per riga. Per alcuni esempi, vedere Sintassi per i riferimenti a un oggetto Documentum.

   5. Nella sezione Pianificazioni ricerca per indicizzazione selezionare le pianificazioni negli elenchi a discesa Ricerca per indicizzazione completa e Ricerca per indicizzazione incrementale oppure creare pianificazioni per ogni tipo di ricerca per indicizzazione.

   6. Nella sezione Priorità origine contenuto assegnare un livello di priorità all'origine contenuto in base ai requisiti aziendali.

   7. Fare clic su OK.

7. Nella pagina Gestisci origini di contenuto fare clic con il pulsante destro del mouse sull'origine contenuto di Documentum e scegliere Avvia ricerca per indicizzazione completa.

L'origine contenuto di Documentum ora è configurata e il sistema può eseguire ricerche per indicizzazione negli archivi di contenuto di Documentum specificati nell'origine contenuto.

SharePoint Server supporta l'architettura scalabile per il ridimensionamento delle prestazioni. È possibile distribuire più server che ospitano un componente di ricerca per indicizzazione ed è possibile configurare più crawler per eseguire contemporaneamente la ricerca per indicizzazione nel database EMC Documentum.

Sintassi per i riferimenti a un oggetto Documentum

Nella tabella riportata di seguito viene definito il formato per i riferimenti a un oggetto Documentum utilizzato per il percorso (quando si configura una regola di ricerca per indicizzazione) e per l'indirizzo iniziale (quando si configura un'origine contenuto):

<clientapphostname> è il nome host dell'applicazione client Documentum, ad esempio Webtop o DA. Il <clientapphostname> configurato qui deve essere uguale a quello usato nell'origine del contenuto. <il nome> del repository, <il nome> dell'archivio e il nome> della cartella fanno distinzione tra maiuscole e< minuscole.

Uso del cmdlet SPEnterpriseSearchDCTMConnectorConfig

Usare i comandi di Microsoft PowerShell seguenti per visualizzare la Guida e gli esempi per il cmdlet Indexing Connector for Documentum:

• Get-help Set-SPEnterpriseSearchDCTMConnectorConfig -full mostra la guida completa.

• Get-help Set-SPEnterpriseSearchDCTMConnectorConfig -examples mostra solo esempi.

Il cmdlet Set-SPEnterpriseSearchDCTMConnectorConfig accetta tre set di parametri. Il set di parametri Shared consente di modificare le impostazioni di configurazione relative a tutti gli archivi Documentum in cui vengono eseguite ricerche per indicizzazione. Con il set di parametri Repository è possibile modificare le impostazioni di configurazione relative solo a un archivio specifico. Utilizzando infine il set di parametri Remove è possibile rimuovere un archivio specifico dalla configurazione del connettore.

Nella tabella riportata di seguito vengono indicati i parametri obbligatori e quelli facoltativi.

Vedere anche

Tipi di oggetti e proprietà di Documentum supportati e non supportati in SharePoint Server