Configure and use the Documentum connector in SharePoint Server

S’APPLIQUE À :2013 2016 2019 Édition d’abonnement SharePoint dans Microsoft 365

Cet article explique comment installer et configurer microsoft SharePoint Server Indexing Connector pour Documentum.

Le connecteur d’indexation Microsoft SharePoint Server pour Documentum vous permet d’indexer le contenu stocké dans le système EMC Documentum. Cet article explique comment installer et configurer le connecteur d’indexation pour Documentum à utiliser avec SharePoint Server.

Le composant Indexing Connector for Documentum :

• Connecteur 64 bits basé sur l’infrastructure du connecteur de recherche SharePoint Server.

• prend en charge plusieurs versions du serveur de contenu EMC Documentum ;

• indexe les objets Documentum et les métadonnées d'objet. Voir Types et propriétés d’objets Documentum pris en charge et non pris en charge dans SharePoint Server.

• prend en charge les stratégies et définitions de sécurité Documentum ;

• Prend en charge Microsoft PowerShell pour la configuration et l’administration automatisées. Voir Utilisation de la cmdlet SPEnterpriseSearchDCTMConnectorConfig ;

• dispose d'une URL de résultats de recherche configurable pour prendre en charge plusieurs applications clientes Documentum ;

• prend en charge l'exclusion de fichiers et de dossiers pour l'analyse.

Avant de commencer

Avant de commencer cette opération, lisez les informations suivantes sur les conditions préalables et la configuration requise :

• Les systèmes d'exploitation pris en charge sont Windows Server 2008 R2, Windows Server 2008 Service Pack 2 et Windows Server 2012.

• L’un des produits SharePoint 2019, SharePoint 2016 ou SharePoint 2013 suivants est installé et configuré :

  • Microsoft SharePoint Server Enterprise

  • Microsoft SharePoint Server Standard

• Une application de service de recherche est installée et configurée.

• Un serveur Documentum Foundation Services (DFS) avec une version compatible avec DFS Productivity Layer 6.7 SP2 est installé sur un hôte Windows.

• DFS Productivity Layer 6.7 SP2 est installé et vous avez accès aux assemblies .NET inclus dans DFS Productivity Layer 6.7 SP2. Le composant Indexing Connector for Documentum utilise DFS en tant qu'API de connectivité pour accéder aux référentiels Documentum.

• Documentum Content Server est installé. Les versions prises en charge de Documentum Content Server sont déterminées par DFS 6.7 SP2. Vous trouverez la liste détaillée dans les notes de publication de DFS Productivity Layer 6.7 SP2.

• Configurez le connecteur d’indexation pour Documentum avec -ACLTranslation « Claims » si vous devez analyser les référentiels Documentum pour lesquels Documentum Trusted Content Services (TCS) est activé. Vous pouvez également utiliser cette configuration de connecteur pour activer le mappage automatique entre les utilisateurs Windows Active Directory et les utilisateurs Documentum, que les services de contenu approuvés Documentum soient activés sur le référentiel ou non.

Vue d’ensemble

Les étapes suivantes fournissent une vue d’ensemble générale des tâches impliquées dans l’installation et la configuration du connecteur d’indexation pour Documentum à utiliser avec SharePoint Server.

1. Préparation

1. Assurez-vous que votre système répond aux conditions préalables et à la configuration requise dans la section Avant de commencer.

2. Téléchargez le connecteur d’indexation SharePoint Server 2016 pour Documentum à partir du Centre de téléchargement Microsoft.

3. Déterminez le compte d'accès au contenu Documentum à utiliser pour l'analyse.

4. Préparez les serveurs SharePoint qui hébergent un composant d’analyse. Sur chaque serveur :

   • Définissez les assemblies .NET DFS Productivity Layer.

   • Modifiez le fichier machine.config pour définir les liaisons Documentum.

2. Installer le connecteur d’indexation pour Documentum

1. Installez le connecteur d’indexation pour Documentum sur chaque serveur SharePoint de la batterie de serveurs qui héberge un composant d’analyse.

2. Inscrivez le connecteur d’indexation pour Documentum dans l’application service Search à l’aide de Microsoft PowerShell.

3. Configurer le connecteur d’indexation pour Documentum

Configurez le connecteur d’indexation pour Documentum sur chaque serveur SharePoint de la batterie de serveurs qui héberge un composant d’analyse à l’aide de l’applet de commande PowerShell Indexing Connector for Documentum. Choisissez l'une des configurations suivantes :

4. Configurer une règle d’analyse Documentum et une source de contenu dans l’application service Search à l’aide de l’Administration centrale

1. Création d'une règle d'analyse pour Documentum.

2. Création d'une source de contenu Documentum.

3. Effectuez une analyse complète.

Préparer les serveurs SharePoint qui hébergent un composant d’analyse

Détermination du compte d'accès au contenu Documentum à utiliser pour l'analyse

1. Vous devrez spécifier le compte d'accès au contenu et le mot de passe ultérieurement dans la procédure de configuration lorsque vous configurerez des règles d'analyse. Le composant Indexing Connector for Documentum utilise le compte d'accès au contenu pour récupérer du contenu à partir du référentiel Documentum. Ce compte doit disposer des autorisations minimales suivantes :

   • Autorisation d'accès en lecture des documents à analyser.
   • Autorisation de parcourir les fichiers CAB, les dossiers et les enregistrements (documents comportant uniquement des métadonnées) à analyser.

Définition des assemblies .NET DFS Productivity Layer

1. Localisez les assemblies .NET DFS Productivity Layer suivants et vérifiez que le numéro de version est 6.7.2000.36 pour tous les fichiers. Une fois extraits vers le chemin par défaut, ces fichiers se trouvent dans le répertoire %local%\emc-dfs-sdk-6.7\emc-dfs-sdk-6.7\lib\dotnet.

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

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

   • Emc.Documentum.FS.runtime.dll

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

2. Sur chaque serveur qui héberge un composant d’analyse, connectez-vous avec un compte membre du groupe Administrateurs sur ce serveur et déployez les assemblys .NET de la couche de productivité DFS sur le Global Assembly Cache %windir%\assembly.

   Remarque

   Vous pouvez glisser-déplacer les quatre fichiers DLL dans le Global Assembly Cache ( %windir%\assembly) pour les déployer, mais vous devrez peut-être désactiver le contrôle de compte d'utilisateur.

La procédure suivante explique comment modifier le fichier machine.config sur chaque serveur SharePoint qui héberge un composant d’analyse afin d’inclure les paramètres WCF pour la couche de productivité DFS. Vous vous assurez ainsi que les assemblies .NET DFS Productivity Layer fonctionnent correctement.

Les paramètres WCF que vous allez définir dans Edit the machine.config file autorisent le transfert d'objets de contenu Documentum (le fichier du document et ses métadonnées) d'une taille maximale de 30 mégaoctets (Mo) chacun. L’administrateur peut augmenter maxReceivedMessageSize dans la liaison DfsDefaultService pour un contenu plus volumineux.

Modification du fichier machine.config

1. Sur chaque serveur hébergeant un composant d'analyse, ouvrez le fichier machine.config. Ce fichier se trouve dans le répertoire %windir%\Microsoft.NET\Framework64\v4.0.30319\Config.

2. Copiez l'extrait XML suivant dans l'élément <configuration>:

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

Installation et inscription du composant Indexing Connector for Documentum

Installation du composant Indexing Connector for Documentum

1. Téléchargez le composant Indexing Connector for Documentum à partir du centre de téléchargement Microsoft.

2. Sur chaque serveur de la batterie de serveurs qui héberge un composant d’analyse, installez le connecteur d’indexation pour Documentum en exécutant le fichier DCTMIndexConn.exe. Suivez les étapes de l'Assistant Installation.

Inscription du composant Indexing Connector for Documentum auprès de l'application de service de recherche

1. Exécutez cette procédure sur un serveur SharePoint qui héberge un composant d’analyse pour inscrire le connecteur auprès de l’application service Search.

2. Démarrez SharePoint Management Shell.

3. À l'invite de commandes Microsoft PowerShell, tapez la ou les commandes suivantes :

   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"
   

   Où :

   • <nom de votre application de service de recherche> est le nom de l'application de service de recherche auprès de laquelle vous inscrivez le connecteur.

   • <%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\CONFIG\SearchConnectors\Documentum\MODEL.xml> est le chemin du fichier de modèle du composant Indexing Connector for Documentum. L'emplacement par défaut est donné dans cet exemple.

Configuration du composant Indexing Connector for Documentum

Vous pouvez configurer les paramètres du connecteur avec l'applet de commande PowerShell Indexing Connector for Documentum ( Set-SPEnterpriseSearchDCTMConnectorConfig). Les paramètres sont stockés dans %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\CONFIG\SearchConnectors\Documentum\DCTMConfig.xml et doivent être les mêmes sur chaque serveur SharePoint Server 2016 qui héberge un composant d’analyse.

Les paramètres de l'applet de commande PowerShell à utiliser et les étapes de configuration supplémentaires à effectuer dépendent du mode de configuration que vous choisissez.

Configuration du composant Indexing Connector for Documentum afin qu'il prenne en charge les services de contenu approuvés et le mappage utilisateur automatique

Les procédures suivantes expliquent comment configurer le composant Indexing Connector for Documentum afin qu'il prenne en charge les services de contenu approuvés. Les procédures indiquent également comment activer le mappage utilisateur automatique en configurant le service de synchronisation de filtrage de sécurité, et comment créer et déployer des filtrages de sécurité préalables et ultérieurs. Une fois ces procédures terminées, vos informations d'identification d'utilisateur Documentum seront automatiquement synchronisées avec les services de domaine Active Directory (AD), les résultats de recherche seront filtrés en fonction et les utilisateurs pourront récupérer les résultats de recherche Documentum qu'ils sont autorisés à voir.

Le service de synchronisation de filtrage de sécurité mappe les utilisateurs Documentum aux utilisateurs AD en se référant aux champs Documentum user_os_domain, user_login_name, user_source et user_ldap_dn. Si le champ user_ldap_dn est complété, le service de synchronisation de filtrage de sécurité tentera d'extraire un domaine de la première valeur de contrôleur de domaine. Par exemple, si le champ user_ldap_dn correspond à « CN=User Name, OU=Unit,DC=Domain,DC=Department,DC=Company », le service de synchronisation de filtrage de sécurité extrait le domaine à partir de DC=Domain et ignore DC=Department,DC=Company.

Configuration du connecteur afin qu'il prenne en charge les services de contenu approuvés et le mappage utilisateur automatique

1. Démarrez sharePoint Management Shell sur chaque serveur qui héberge un composant d’analyse.

2. À l'invite de commandes Microsoft PowerShell, tapez la ou les commandes suivantes :

   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")
   

   Où :

   • <MyWebTopServer:PortOfMyWebTopServer> correspond au nom et au numéro de port du serveur web DFS principal que vous utilisez.

   • <MyRepository n> correspond au nom du référentiel Documentum à analyser.

   • <DFSWebServices n>:<30000> correspond au nom et au numéro de port du serveur de services web Documentum qui héberge le référentiel Documentum à analyser.

3. Redémarrez le service OSearch15. Cette opération doit être effectuée avant de créer une source de contenu pour Documentum.

   IMPORTANT: N’utilisez pas la page Services sur le serveur du site web Administration centrale de SharePoint pour redémarrer ce service. L'index de recherche serait réinitialisé et vous devriez effectuer une analyse complète de l'ensemble du contenu pour reconstruire l'index.

   • Vérifiez que le compte d'utilisateur qui exécute cette procédure est un administrateur du serveur qui héberge le composant d'analyse.

   • Ouvrez une fenêtre d'invite de commandes.

   • Pour arrêter le service OSearch15, tapez la commande : net stop osearch15

   • Pour démarrer le service OSearch15, tapez la commande : net start osearch15

Configuration du service de synchronisation de filtrage de sécurité

1. Ouvrez le fichier Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe.config. Ce fichier est stocké dans le dossier où vous avez installé le connecteur Indexing Connector pour Documentum. L’emplacement par défaut est %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\CONFIG\SearchConnectors\Documentum

2. À l'aide des mêmes informations que vous avez fournies lors de la configuration du composant Indexing Connector for Documentum, modifiez le fichier de configuration comme suit :

   • Dans la section Emc.Documentum, dans l'élément ModuleInfo, effectuez les opérations suivantes :

     • Dans l'attribut host, entrez le nom d'hôte du serveur Documentum.

     • Dans l'attribut port, entrez le numéro de port du serveur Documentum.

   • Dans la section Source de données : Paramètres Documentum, dans l'élément Repositories, effectuez les opérations suivantes :

     • Dans l’attribut id du dépôt , tapez l’ID du référentiel Documentum.

     • Dans l'attribut name, entrez le nom du référentiel Documentum.

     • Dans l'attribut login, entrez le nom d'ouverture de session Documentum. Utilisez le même nom d'ouverture de session que le compte d'accès au contenu Documentum. Il doit s'agir d'un utilisateur disposant d'autorisations utilisateur élevées sur le serveur de contenu Documentum.

     • Dans l'attribut dfs, entrez l'emplacement des DFS en fournissant l'URI du DFS.

   • (Facultatif) Si votre connexion Documentum requiert un protocole SSL/HTTPS, vous devez modifier le mode de sécurité.

     • Dans la section Source de données : Paramètres Documentum, sous-section Documentum, dans l'élément basicHttpBinding, remplacez l'attribut de mode de sécurité None par Transport pour les liaisons suivantes :

       • DfsAgentService

       • DfsContextRegistryService

       • DfsDefaultService

   • Dans la section Source de données : Paramètres Documentum, sous-section Documentum, dans l'élément netNamedPipeBinding, remplacez l'attribut de mode de sécurité None par Transport pour les liaisons suivantes :

     • localNamedPipeBinding

3. Enregistrez et fermez le fichier.

4. Copiez les assemblies .NET DFS Productivity Layer sur le serveur exécutant le service de synchronisation de filtrage de sécurité.

   • Localisez les assemblies .NET DFS Productivity Layer suivants et vérifiez que le numéro de version est 6.7.2000.36 pour tous les fichiers. Une fois extraits vers le chemin par défaut, ces fichiers se trouvent dans le répertoire %local%\emc-dfs-sdk-6.7\emc-dfs-sdk-6.7\lib\dotnet.

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

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

     • Emc.Documentum.FS.runtime.dll

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

   • Sur le serveur qui héberge le service de synchronisation de suppression de sécurité, connectez-vous avec un compte membre du groupe Administrateurs sur ce serveur et déployez les assemblys .NET de la couche de productivité DFS sur le Global Assembly Cache %windir%\assembly.

   Remarque

   Vous pouvez glisser-déplacer les quatre fichiers DLL dans le Global Assembly Cache ( %windir%\assembly) pour les déployer, mais vous devrez peut-être désactiver le contrôle de compte d'utilisateur.

5. Configurez l'authentification pour le service de synchronisation de filtrage de sécurité et installez le service.

   • Vérifiez que le compte d'utilisateur qui exécute cette procédure est membre du groupe Administrateurs de batterie.

   • Ouvrez une fenêtre d'invite de commandes sur chaque serveur hébergeant un composant de traitement des requêtes.

   • Tapez la commande suivante : Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe -p

     Lorsque vous y êtes invité, entrez le mot de passe du compte que vous avez fourni dans l'attribut login. Utilisez le même nom d'ouverture de session que le compte d'accès au contenu Documentum. Ce mot de passe sera désormais automatiquement chiffré et ajouté au fichier de configuration du service de synchronisation de filtrage de sécurité.

   • Installez le service de synchronisation de filtrage de sécurité. Tapez la commande suivante : Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe -i

6. Démarrez le service de synchronisation de filtrage de sécurité.

   • Ouvrez l'outil Gestionnaire de serveur Windows.

   • Développez le menu Configuration et cliquez sur Services.

   • Cliquez avec le bouton droit sur le service Synchronisation de sécurité SharePoint Documentum, puis cliquez sur Propriétés. Dans l'onglet Ouverture de session, sélectionnez Ce compte et indiquez les informations d'identification et les détails du compte qui exécute les services SharePoint. Cliquez sur OK.

   • Cliquez avec le bouton droit sur le service Synchronisation de sécurité SharePoint Documentum, puis cliquez sur Démarrer.

   • Vérifiez que la colonne Statut passe sur Démarré.

7. Vérifiez que le service est en cours d'exécution et que la synchronisation de sécurité est terminée.

   • Exécutez la commande Microsoft.Office.Server.Search.Connector.Documentum.TrimmerSync.exe -d pour que l'écriture de la mémoire du service de synchronisation de filtrage de sécurité se fasse dans un fichier texte.

   • Vérifiez que le service de synchronisation de filtrage de sécurité se connecte au serveur Documentum. Lire le fichier DCTMSecuritySync.log qui se trouve dans le répertoire <Microsoft Office Server path>\15.0\Data\Office Server\Applications\Search\Nodes

   • Vérifiez que les informations d’appartenance du serveur Documentum sont écrites dans le fichier DCTMSecuritySync_Dump.txt qui se trouve dans le répertoire <Microsoft Office Server path>\15.0\Data\Office Server\Applications\Search\Nodes

Pour pouvoir ajouter les filtrages de sécurité préalables et ultérieurs, vous devez ajouter une règle d'analyse simple pour Documentum. Par la suite, vous pourrez spécifier davantage de règles d'analyse ou les développer.

Création d'une règle d'analyse simple pour Documentum

1. Vérifiez que le compte d'utilisateur qui exécute cette procédure est un administrateur de l'application de service de recherche.

2. Sur la page d'accueil de l'Administration centrale de SharePoint, dans la section Gestion des applications, cliquez sur Gérer les applications de service.

3. Sur la page Gérer les applications de service, cliquez sur l'application de service de recherche pour laquelle vous voulez créer une règle d'analyse.

4. Sur la page Administration de la recherche, dans la section Analyse, cliquez sur Règles d'analyse.

5. Sur la page Gérer les règles d'analyse, cliquez sur Nouvelle règle d'analyse.

6. Dans la page Ajout d'une règle d'analyse, spécifiez les informations suivantes pour créer une règle d'analyse :

   • Dans la zone Chemin d’accès, tapez dctm://*.

   • Dans la section Analyser la configuration, sélectionnez Inclure tous les éléments de ce chemin d'accès, puis sélectionnez Analyser les URL complexes (celles contenant des points d'interrogation - ?).

   • Dans la section Spécifier l'authentification, sélectionnez Spécifier un autre compte d'accès au contenu, puis entrez les compte d'accès au contenu et mot de passe Documentum dans les zones appropriées.

   • Vérifiez que la case Ne pas permettre l'authentification de base est décochée.

7. Cliquez sur OK pour ajouter la règle d'analyse.

Ajout du filtrage de sécurité préalable et ultérieur du composant Indexing Connector for Documentum

1. Démarrez sharePoint Management Shell sur chaque serveur qui héberge un composant de traitement des requêtes.

2. À l'invite de commandes Microsoft PowerShell, tapez la ou les commandes suivantes :

   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:\\*
   

   Où :

   • <name of your Search service application> est le nom de l'application de service de recherche.

3. Redémarrez le Contrôleur d'hôte de recherche SharePoint.

   • Ouvrez une fenêtre d'invite de commandes.

   • Pour arrêter le Contrôleur d'hôte de recherche SharePoint, tapez la commande suivante : net stop spsearchhostcontroller

   • Pour démarrer le Contrôleur d'hôte de recherche SharePoint, tapez la commande suivante : net stop spsearchhostcontroller

4. Continuez avec Création d'une source de contenu Documentum.

Configuration du composant Indexing Connector for Documentum à l'aide d'une table de mappage utilisateur

Les procédures suivantes expliquent comment créer manuellement une table de mappage utilisateur qui indique comment les utilisateurs Documentum sont mappés aux services de domaine Active Directory (AD DS) ou aux utilisateurs du service Active Directory et comment configurer le connecteur afin qu'il prenne en charge l'analyse du contenu Documentum et qu'il utilise la table de mappage utilisateur.

• La table de mappage utilisateur doit être sous la forme d'une base de données SQL Server 2008 ou version ultérieure.

• Le compte de service OSearch15 doit au moins disposer des autorisations en lecture pour les données de la table de mappage utilisateur.

Création d'une table de mappage utilisateur

Tout d’abord, créez une table de mappage d’utilisateurs dans SQL Server 2008 ou une version ultérieure. La table de mappage utilisateur doit être au format suivant :

Utilisez le script suivant pour créer une table de mappage d’utilisateurs :

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

Vous pouvez également créer manuellement la table de mappage d’utilisateurs à l’aide de SQL Server Management Studio ou d’un outil équivalent. Si vous créez la table manuellement, veillez à utiliser le même schéma que celui défini dans le script.

Ensuite, renseignez la table de mappage utilisateur avec des paires d’informations d’identification Documentum/Windows NT. Le tableau à l'étape précédente indique le type d'entrée attendu.

Exemple :

Dan Park, un utilisateur du référentiel Documentum, dispose d'un nom d'ouverture de session lié au référentiel Finances. Le compte d'utilisateur de domaine Windows de Dan est Contoso\dpark. Dans ce cas, la table de mappage utilisateur de Dan doit être comme suit :

Enfin, accordez au compte OSearch15 l’accès en lecture à la table de mappage d’utilisateurs.

Configuration du connecteur à l'aide d'une table de mappage utilisateur

1. Démarrez sharePoint Management Shell sur chaque serveur qui héberge un composant d’analyse.

2. À l'invite de commandes Microsoft PowerShell, tapez la ou les commandes suivantes :

   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")
   

   Où :

   • <MyWebTopServer:PortOfMyWebTopServer> correspond au nom et au numéro de port du serveur web DFS principal que vous utilisez.

   • <YourDatabaseServerName> correspond au nom du serveur de base de données sur lequel vous avez créé la table de mappage utilisateur.

   • <YourDatabaseInstanceName> correspond au nom de l'instance de base de données du serveur de base de données sur lequel vous avez créé la table de mappage utilisateur.

   • <YourMappingDatabaseName> correspond au nom de la base de données dans laquelle vous avez créé la table de mappage utilisateur.

   • <YourMappingTableName> correspond au nom de la table de mappage utilisateur que vous avez créée.

   • <MyRepository n> correspond au nom du référentiel Documentum à analyser.

   • <DFSWebServices n>:<30000> correspond aux nom et numéro de port du serveur de services web Documentum hébergeant le référentiel Documentum à analyser.

3. Redémarrez le service OSearch15. L'administrateur du serveur qui héberge le composant d'analyse doit redémarrer le service OSearch15 pour qu'une source de contenu puisse être créée pour Documentum.

   Importante

   N'utilisez pas les services sur une page de serveur sur le site web de l'Administration centrale SharePoint pour redémarrer ce service. L'index de recherche serait réinitialisé et vous devriez effectuer une analyse complète de l'ensemble du contenu pour reconstruire l'index.

   • Vérifiez que le compte d'utilisateur qui exécute cette procédure est un administrateur du serveur qui héberge le composant d'analyse.

   • Ouvrez une fenêtre d'invite de commandes.

   • Pour arrêter le service OSearch15, tapez la commande : net stop osearch15

   • Pour démarrer le service OSearch15, tapez la commande : net start osearch15

Poursuivez avec Créer une règle d’analyse pour Documentum , puis continuez avec Créer une source de contenu Documentum.

Création de la catégorie Documentum de propriétés analysées

Vous devez créer une catégorie de propriétés analysées qui contiendra les propriétés Documentum analysées. Pour ce faire, utilisez la cmdlet New-SPEnterpriseSearchMetadataCategory et spécifiez la valeur prédéfinie 34972762-7E3F-4f4f-AE5C-5ABBA92EC530 pour le paramètre PropSet de la cmdlet. Utilisez le code PowerShell suivant pour créer la catégorie de propriétés analysées de cette façon.

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

Création d'une règle d'analyse pour Documentum

Avant une analyse, vous devez créer au moins une règle d'analyse pour authentifier le robot avec le serveur DFS. Vous pouvez créer plusieurs règles d'analyse pour inclure ou exclure du contenu spécifique dans Documentum.

1. Vérifiez que le compte d'utilisateur qui exécute cette procédure est un administrateur de l'application de service de recherche.

2. Sur la page d'accueil de l'Administration centrale de SharePoint, dans la section Gestion des applications, cliquez sur Gérer les applications de service.

3. Sur la page Gérer les applications de service, cliquez sur l'application de service de recherche pour laquelle vous voulez créer une règle d'analyse.

4. Sur la page Administration de la recherche, dans la section Analyse, cliquez sur Règles d'analyse.

5. Sur la page Gérer les règles d'analyse, cliquez sur Nouvelle règle d'analyse.

6. Dans la page Ajout d'une règle d'analyse, spécifiez les informations suivantes :

   • Dans la zone Chemin d'accès, entrez le chemin d'accès auquel la règle d'analyse doit s'appliquer. Vous pouvez utiliser des caractères génériques standard. Pour utiliser des expressions régulières plutôt que des caractères génériques, sélectionnez l'option Utiliser la syntaxe des expressions courantes lors de la mise en correspondance de cette règle. Pour des exemples, voir Syntaxe pour faire référence à un objet Documentum.

   • Dans la section Analyser la configuration, sélectionnez Inclure tous les éléments de ce chemin d'accès, puis sélectionnez Analyser les URL complexes (celles contenant des points d'interrogation - ?).

   • Dans la section Spécifier l'authentification, sélectionnez Spécifier un autre compte d'accès au contenu, puis entrez les compte d'accès au contenu et mot de passe Documentum dans les zones. Voir Determine which Documentum content access account to use plus haut dans cet article.

   • Vérifiez que la case Ne pas permettre l'authentification de base est décochée.

7. Cliquez sur OK pour ajouter la règle d'analyse.

   Remarque

   Vous pouvez créer plusieurs règles d’analyse pour Documentum afin d’inclure ou d’exclure du contenu Documentum.

   Vous pouvez utiliser différentes règles d’analyse pour spécifier différents comptes d’accès au contenu pour différents contenus Documentum. Par exemple, vous avez deux référentiels et deux comptes d'accès au contenu pour chaque référentiel. Le compte d'accès au contenu Documentum spécifié dans la règle d'analyse s'applique uniquement au contenu Documentum désigné par le chemin d'accès de cette règle d'analyse. Si vous utilisez le service de synchronisation de filtrage de sécurité, vous devez configurer ce service pour chaque serveur Documentum.

Création d'une source de contenu Documentum

Vous pouvez créer une source de contenu pour le contenu Documentum afin de spécifier les référentiels de contenu Documentum à analyser.

1. Vérifiez que le compte d'utilisateur qui exécute cette procédure est un administrateur de l'application de service de recherche.

2. Dans la page d’accueil Administration centrale de SharePoint, dans la section Gestion des applications, cliquez sur Gérer les applications de service.

3. Cliquez sur l'application de service de recherche dans laquelle vous voulez créer une source de contenu.

4. Dans la page Administration de la recherche, dans la section Analyse, cliquez sur Sources de contenu.

5. Dans la page Ajouter une source de contenu, cliquez sur Nouvelle source de contenu.

6. Sur la page Ajouter une source de contenu, effectuez les opérations suivantes :

   1. Dans la zone Nom, entrez le nom de la nouvelle source de contenu.

   2. Dans la section Type de source de contenu, sélectionnez Référentiel personnalisé.

   3. Dans la section Type de référentiel , sélectionnez SharePoint Indexing Connector pour Documentum. Utilisez le nom spécifié lors de l'inscription du composant Indexing Connector for Documentum auprès de l'application de service de recherche.

   4. Dans la section Adresses de démarrage, entrez les adresses de démarrage. Le format des adresses de démarrage est identique au modèle de chemin d'accès. Vous pouvez entrer plusieurs adresses de démarrage pour la source de contenu, une par ligne. Pour des exemples, voir Syntaxe pour faire référence à un objet Documentum.

   5. Dans la section Planifications d'analyse, sélectionnez les planifications à partir des listes déroulantes Analyse complète et Analyse incrémentielle ou créez des planifications pour chaque type d'analyse.

   6. Dans la section Priorité de la source de contenu, affectez un niveau de priorité à la source de contenu en fonction des exigences de votre entreprise.

   7. Cliquez sur OK.

7. Sur la page Gérer les sources de contenu, cliquez avec le bouton droit sur la source de contenu pour Documentum et cliquez sur Démarrer l'analyse complète.

La source de contenu Documentum est configurée et le système peut analyser les référentiels de contenu Documentum spécifiés dans la source de contenu.

SharePoint Server prend en charge l’architecture évolutive pour le scale-out des performances. Vous pouvez déployer plusieurs serveurs qui hébergent un composant d’analyse et configurer plusieurs analyseurs pour analyser la base de données DOCUMENTum EMC en même temps.

Syntaxe pour faire référence à un objet Documentum

Le format pour faire référence à un objet Documentum utilisé pour le chemin d'accès (lors de la configuration d'une règle d'analyse) et l'adresse de démarrage (lors de la configuration d'une source de contenu) est défini dans le tableau ci-dessous :

<clientapphostname> est le nom d’hôte de votre application cliente Documentum, par exemple Webtop ou DA. Le <clientapphostname> configuré ici doit être identique à celui utilisé dans la source de contenu. <le nom> du dépôt, <le nom> de l’armoire et <le nom> du dossier respectent la casse.

Utilisation de la cmdlet SPEnterpriseSearchDCTMConnectorConfig

Utilisez les commandes Microsoft PowerShell suivantes pour afficher de l’aide et des exemples pour l’applet de commande Indexing Connector for Documentum :

• Get-help Set-SPEnterpriseSearchDCTMConnectorConfig -full permet d'afficher l'aide complète.

• Get-help Set-SPEnterpriseSearchDCTMConnectorConfig -examples permet d'afficher uniquement des exemples.

L'applet de commande Set-SPEnterpriseSearchDCTMConnectorConfig accepte trois jeux de paramètres. Vous utilisez le jeu de paramètres Partagés pour modifier les paramètres de configuration qui affectent tous les dépôts Documentum que vous analysez. Vous utilisez l’ensemble de paramètres Dépôt pour modifier les paramètres de configuration qui affectent uniquement un dépôt spécifique. Vous utilisez le jeu de paramètres Remove pour supprimer un dépôt spécifique de la configuration du connecteur.

Le tableau suivant indique les paramètres obligatoires et facultatifs.

Voir aussi

Propriétés et types d’objet Documentum pris en charge et non pris en charge dans SharePoint Server