Configurer SAP DMS pour l’indexation de contenu externe

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 13 minutes de lecture

    • Créez des instances de service et des clés de service dans votre SAP compte global Business Technology Platform (BTP) pour permettre SAP au connecteur de contenu externe DMS d’accéder à vos documents DMS et à vos SAP référentiels.

    Avant de commencer

    Vous devez être un administrateur de compte global sur le SAP BTP. Votre compte global doit être autorisé à accéder SAP au service de gestion des documents.

    Un SAP administrateur de compte global doit avoir créé un sous-compte dans votre SAP compte global BTP, avec les droits suivants :
    • Service de gestion des documents, option d’application
    • Service de gestion des documents, option d’intégration
    • Service de gestion des documents, option référentiel
    • Environnement CloudFoundry
    • Service d’autorisation et de gestion des approbations
    Si vous n’avez pas encore de sous-compte avec ces droits dans votre SAP compte global BTP, effectuez la Créer un sous-compte dans la SAP Business Technology Platform (BTP) tâche préliminaire avant d’effectuer cette tâche.

    Rôle requis : aucun

    Pourquoi et quand exécuter cette tâche

    Le SAP connecteur de contenu externe DMS récupère les documents à partir des référentiels de votre SAP système source DMS à l’aide du service de gestion des documents, API REST de l’option d’intégration.

    Pour permettre au connecteur d’accéder à votre SAP système source DMS via cette API, vous devez configurer les instances de service et les clés de service dans la plateforme de technologie d’entreprise SAP (BTP) DMS. Votre administrateur de connecteur peut utiliser les paramètres copiés à partir de vos nouvelles clés de service pour configurer le connecteur externe DMS afin qu’il SAP se connecte correctement à votre système source.

    Procédure

    1. Créez une instance de service pour le service de gestion des documents, l’option d’application dans votre sous-compte.
      1. Connectez-vous à la SAP Business Technology Platform (BTP) à l’adresse à l’aide https://cockpit.btp.cloud.sap/ des informations d’identification de votre compte global.
      2. Dans l’onglet Sous-comptes, sélectionnez votre sous-compte.
      3. Accédez à la Place de marché des services.
      4. Recherchez et sélectionnez l’entrée Service de gestion des documents, Option d’application .
      5. Sélectionnez Créer.
      6. Renseignez les champs du formulaire Nouvelle instance ou Abonnement.
        Champ Description
        Plan Sélectionnez Standard, puis l’option de clause de non-responsabilité.
        Environnement d’exécution Sélectionnez Cloud Foundry.
        Espace Saisissez le nom de l’espace Cloud Foundry que vous avez créé pour votre sous-compte. Si vous avez suivi les étapes de création de sous-compte à partir de Créer un sous-compte dans la SAP Business Technology Platform (BTP), ce nom est DMS.
        Nom d'instance Saisissez un nom de votre choix. Par exemple, vous pouvez saisir DMS-AO.
      7. Sélectionnez Créer.
        SAP BTP crée l’instance Service de gestion des documents, service d’option d’application dans votre sous-compte.
    2. Créez une clé de service pour votre nouvelle instance de service de gestion des documents ou d’option d’application.
      1. À partir de votre sous-compte, accédez à Instances et abonnements.
      2. Dans l’onglet Abonnements, dans la ligne de votre nouvelle instance de service d’option d’application de service de gestion des documents, sélectionnez … > Créer une clé de service.
      3. Dans le formulaire Nouvelle clé de service, saisissez un nom pour votre nouvelle clé de service.
        Par exemple, vous pouvez saisir DMS-AO.
      4. Sélectionnez Créer.
        SAP BTP crée le service de gestion des documents, la clé de service d’option d’application dans votre sous-compte.
    3. Créez une instance de service pour le service de gestion des documents, option d’intégration dans votre sous-compte.
      1. Connectez-vous à la SAP Business Technology Platform (BTP) à l’adresse à l’aide https://cockpit.btp.cloud.sap/ des informations d’identification de votre compte global.
      2. Dans l’onglet Sous-comptes, sélectionnez votre sous-compte.
      3. Accédez à la Place de marché des services.
      4. Recherchez et sélectionnez l’entrée Service de gestion des documents, option d’intégration .
      5. Sélectionnez Créer.
      6. Renseignez les champs du formulaire Nouvelle instance ou Abonnement.
        Champ Description
        Plan Sélectionnez Standard, puis l’option de clause de non-responsabilité.
        Environnement d’exécution Sélectionnez Cloud Foundry.
        Espace Saisissez le nom de l’espace Cloud Foundry que vous avez créé pour votre sous-compte. Si vous avez suivi les étapes de création de sous-compte à partir de Créer un sous-compte dans la SAP Business Technology Platform (BTP), ce nom est DMS.
        Nom d'instance Saisissez un nom de votre choix. Par exemple, vous pouvez saisir DMS-IO.
      7. Sélectionnez Créer.
        SAP BTP crée le service de gestion des documents, l’instance de service d’option d’intégration dans votre sous-compte.
    4. Créez une clé de service pour votre nouvelle instance de service Service de gestion des documents, Option d’intégration, puis copiez ses paramètres client et l’URL de l’API.
      1. À partir de votre sous-compte, accédez à Instances et abonnements.
      2. Dans l’onglet Abonnements, dans la ligne relative à votre nouvelle instance de service Service de gestion des documents, Option d’intégration, sélectionnez … > Créer une clé de service.
      3. Dans le formulaire Nouvelle clé de service, saisissez un nom pour votre nouvelle clé de service.
        Par exemple, vous pouvez saisir DMS-IO.
      4. Sélectionnez Créer.
        SAP BTP crée la clé de service Service de gestion des documents, option d’intégration dans votre sous-compte.
      5. Dans la section Clés de service, affichez votre nouvelle clé de service en sélectionnant … > Vue dans son entrée.
      6. Sur le formulaire Informations d’identification, copiez les valeurs clientid, clientsecret et url de la section UAA et stockez-les dans un emplacement sécurisé.
        Important :
        Votre administrateur du connecteur de contenu externe a besoin de ces valeurs de paramètre client lors de la configuration du connecteur de SAP contenu externe DMS.
      7. Sur le formulaire Informations d’identification, copiez la valeur du champ URL à partir de l’entrée ecmservice de la section Points de terminaison et stockez-la dans un emplacement sécurisé.
        Important :
        Votre administrateur du connecteur de contenu externe a besoin de cette URL de point de terminaison lors de la configuration du connecteur de SAP contenu externe DMS.
      8. Sur le formulaire Informations d’identification, copiez la valeur du champ apiurl et stockez-la dans un emplacement sécurisé.
        Important :
        Votre administrateur du connecteur de contenu externe a besoin de cette URL de point de terminaison de collections de rôles lors de la configuration du SAP connecteur de contenu externe DMS.
      9. Sur le formulaire Informations d’identification, copiez la partie de la valeur du champ xsappname qui apparaît après la barre verticale | et stockez-le dans un endroit sûr.
        Par exemple, si la valeur du champ xsappname est 673dc63a-f785-4225-b974-de10815701fc !b23581|sdm-di-DocumentManagement-sdm_integration !b62497, la partie de la valeur à copier est sdm-di-DocumentManagement-sdm_integration !b62497.
    5. Créez une instance de service pour le service de gestion des documents, option Référentiel dans votre sous-compte.
      1. Connectez-vous à la SAP Business Technology Platform (BTP) à l’adresse à l’aide https://cockpit.btp.cloud.sap/ des informations d’identification de votre compte global.
      2. Dans l’onglet Sous-comptes, sélectionnez votre sous-compte.
      3. Accédez à la Place de marché des services.
      4. Recherchez et sélectionnez l’entrée Service de gestion des documents, option de référentiel .
      5. Sélectionnez Créer.
      6. Renseignez les champs du formulaire Nouvelle instance ou Abonnement.
        Champ Description
        Plan Sélectionnez Standard, puis l’option de clause de non-responsabilité.
        Environnement d’exécution Sélectionnez Cloud Foundry.
        Espace Saisissez le nom de l’espace Cloud Foundry que vous avez créé pour votre sous-compte. Si vous avez suivi les étapes de création de sous-compte à partir de Créer un sous-compte dans la SAP Business Technology Platform (BTP), ce nom est DMS.
        Nom d'instance Saisissez un nom de votre choix. Par exemple, vous pouvez saisir DMS-RO.
      7. Sélectionnez Créer.
        SAP BTP crée le service de gestion des documents, l’instance de service d’option de référentiel dans votre sous-compte.
    6. Créez une clé de service pour votre nouvelle instance de service de gestion des documents, option de référentiel.
      1. À partir de votre sous-compte, accédez à Instances et abonnements.
      2. Dans l’onglet Abonnements, dans la ligne de votre nouveau service de gestion des documents, instance de service d’option de référentiel, sélectionnez … > Créer une clé de service.
      3. Dans le formulaire Nouvelle clé de service, saisissez un nom pour votre nouvelle clé de service.
        Par exemple, vous pouvez saisir DMS-RO.
      4. Sélectionnez Créer.
        SAP BTP crée la clé de service Service de gestion des documents, option de référentiel dans votre sous-compte.
    7. Créez une instance de service pour le service d’autorisation et de gestion des approbations dans votre sous-compte.
      1. À partir de votre sous-compte, accédez à Services > Place de marché des services.
      2. Recherchez et sélectionnez l’entrée Service d’autorisation et de gestion des approbations .
      3. Sélectionnez Créer.
      4. Renseignez les champs du formulaire Nouvelle instance ou Abonnement.
        Champ Description
        Plan Sélectionnez apiaccess.
        Environnement d’exécution Sélectionnez Cloud Foundry.
        Espace Saisissez le nom de l’espace Cloud Foundry que vous avez créé pour votre sous-compte. Si vous avez suivi les étapes de création de sous-compte à partir de Créer un sous-compte dans la SAP Business Technology Platform (BTP), ce nom est DMS.
        Nom d'instance Saisissez un nom de votre choix. Par exemple, vous pouvez entrer des guichets automatiques.
      5. Sélectionnez Suivant.
      6. Dans le formulaire Nouvelle instance ou Abonnement, collez le code JSON suivant dans le champ de saisie de texte Configurer les paramètres d’instance, en remplaçant <nom-instance> par le nom de votre ServiceNow AI Platform instance. 
        {
  "xsappname": "dms-servicenow-client",
  "tenant-mode": "dedicated",
  "description": "XSUAA config for DMS API access via IAS",
  "oauth2-configuration": {
    "redirect-uris": [
      "https://<instance-name>.service-now.com/oauth_redirect.do"
    ],
    "grant-types": [
      "authorization_code",
      "client_credentials",
      "password",
      "refresh_token"
    ]
  },
  "scopes": [
    {
      "name": "$XSAPPNAME.DMSViewer",
      "description": "Read-only access to DMS repositories"
    },
    {
      "name": "$XSAPPNAME.DMSContributor",
      "description": "Create and modify documents in DMS"
    },
    {
      "name": "$XSAPPNAME.DMSAdministrator",
      "description": "Full administrative access to DMS"
    }
  ],
  "role-templates": [
    {
      "name": "DMSViewerRole",
      "description": "Role for viewing DMS documents",
      "scope-references": [
        "$XSAPPNAME.DMSViewer"
      ]
    },
    {
      "name": "DMSContributorRole",
      "description": "Role for contributing documents",
      "scope-references": [
        "$XSAPPNAME.DMSContributor"
      ]
    },
    {
      "name": "DMSAdministratorRole",
      "description": "Role for administering DMS",
      "scope-references": [
        "$XSAPPNAME.DMSAdministrator"
      ]
    }
  ],
  "authorities": [
    "$XSAPPNAME.DMSViewer",
    "$XSAPPNAME.DMSContributor",
    "$XSAPPNAME.DMSAdministrator"
  ]
}
      7. Sélectionnez Créer.
        SAP BTP crée l’instance de service pour le service d’autorisation et de gestion des approbations dans votre sous-compte.
    8. Créez une clé de service pour votre nouvelle instance de service Autorisation et gestion des approbations.
      1. À partir de votre sous-compte, accédez à Instances et abonnements.
      2. Dans l’onglet Abonnements, dans la ligne de votre nouvelle instance de service Authorization and Trust Management, sélectionnez … > Créer une clé de service.
      3. Dans le formulaire Nouvelle clé de service, saisissez un nom pour votre nouvelle clé de service.
        Par exemple, vous pouvez entrer des guichets automatiques.
      4. Sélectionnez Créer.
        SAP BTP crée la clé de service pour le service d’autorisation et de gestion des approbations dans votre sous-compte.
      5. Dans la section Clés de service, affichez votre nouvelle clé de service en sélectionnant … > Vue dans son entrée.
      6. Sur le formulaire Informations d’identification, copiez les valeurs clientid, clientsecret et url de la section clé de service et stockez-les dans un emplacement sécurisé.
        Important :
        Votre administrateur du connecteur de contenu externe a besoin de ces valeurs de paramètre client lors de la configuration du connecteur de SAP contenu externe DMS.
    9. Créez une nouvelle instance pour le service d’autorisation et de gestion des approbations avec le plan d’application dans votre SAP sous-compte BTP.
      1. À partir de votre sous-compte, accédez à Services > Instances et abonnements.
      2. Sélectionnez Créer.
      3. Renseignez les champs de la page Informations de base du formulaire Nouvelle instance ou Abonnement.
        Champ Description
        Service Sélectionnez Service d’autorisation et de gestion des approbations.
        Plan Sélectionnez une application.
        Environnement d’exécution Sélectionnez Cloud Foundry.
        Espace Sélectionnez DMS.
        Remarque :
        Il s’agit du nom de l’espace Cloud Foundry que vous avez créé pour votre SAP sous-compte BTP. Pour plus de détails sur cette procédure, reportez-vous à la section Créer un sous-compte dans la SAP Business Technology Platform (BTP).
        Nom d'instance Entrez un nom unique pour cette instance de service.
      4. Sélectionnez Suivant.
      5. Sur la page Paramètres du formulaire Nouvelle instance ou Abonnement, collez le code JSON suivant dans le champ de saisie de texte Configurer les paramètres d’instance, en remplaçant <service-name> par le nom que vous avez saisi pour la nouvelle instance de service d’autorisation et de gestion des approbations par le plan d’application à l’étape 9.c, <instance-name> par le nom de votre ServiceNow AI Platform instance, et <xsappname> par la sous-chaîne xsappname que vous avez copiée à l’étape 4.i. 
        {
  "xsappname": "<service-name>",
  "tenant-mode": "dedicated",
  "description": "XSUAA config for DMS API access via IAS",
  "oauth2-configuration": {
    "redirect-uris": [
      "https://<instance-name>.service-now.com/oauth_redirect.do"
    ],
    "grant-types": [
      "authorization_code",
      "client_credentials",
      "password",
      "refresh_token"
    ]
  },
  "scopes": [
    {
      "name": "$XSAPPNAME.DMSViewer",
      "description": "Read-only access to DMS repositories"
    },
    {
      "name": "$XSAPPNAME.DMSContributor",
      "description": "Create and modify documents in DMS"
    },
    {
      "name": "$XSAPPNAME.DMSAdministrator",
      "description": "Full administrative access to DMS"
    }
  ],
  "role-templates": [
    {
      "name": "DMSViewerRole",
      "description": "Role for viewing DMS documents",
      "scope-references": [
        "$XSAPPNAME.DMSViewer"
      ]
    },
    {
      "name": "DMSContributorRole",
      "description": "Role for contributing documents",
      "scope-references": [
        "$XSAPPNAME.DMSContributor"
      ]
    },
    {
      "name": "DMSAdministratorRole",
      "description": "Role for administering DMS",
      "scope-references": [
        "$XSAPPNAME.DMSAdministrator"
      ]
    }
  ],
  "authorities": [
    "$ACCEPT_GRANTED_AUTHORITIES",
    "<xsappname>.sdmadmin",
    "<xsappname>.sdmbusinessadmin"
  ],
  "foreign-scope-references": [
    "<xsappname>.sdmuser",
    "<xsappname>.sdmadmin",
    "<xsappname>.sdmbusinessadmin"
  ]
}
      6. Sélectionnez Créer.
        SAP BTP crée l’instance de service pour le service d’autorisation et de gestion des approbations avec le plan d’application dans votre sous-compte.
    10. Créez une clé de service pour votre nouvelle instance de service Autorisation et gestion des approbations avec le plan d’application.
      1. À partir de votre sous-compte, accédez à Instances et abonnements.
      2. Dans l’onglet Abonnements, dans la ligne de votre nouvelle instance de service Autorisation et gestion des approbations avec le plan d’application, sélectionnez … > Créer une clé de service.
      3. Dans le formulaire Nouvelle clé de service, saisissez un nom pour votre nouvelle clé de service.
        Par exemple, vous pouvez saisir ATMS-app-plan.
      4. Sélectionnez Créer.
        SAP BTP crée la clé de service pour l’instance de service d’autorisation et de gestion des approbations avec le plan d’application dans votre sous-compte.
      5. Dans la section Clés de service, affichez votre nouvelle clé de service en sélectionnant … > Vue dans son entrée.
      6. Sur le formulaire Informations d’identification, copiez les valeurs clientid et clientsecret de la section clé de service et stockez-les dans un emplacement sécurisé.
        Important :
        Votre administrateur du connecteur de contenu externe a besoin de ces valeurs de paramètre client lors de la configuration du connecteur de SAP contenu externe DMS.
    11. Copiez l’URL Web de base pour les documents dans votre SAP locataire DMS.
      1. Connectez-vous à votre SAP locataire DMS à l’aide des informations d’identification de votre compte global.
      2. Accédez à un référentiel de votre choix.
      3. Dans le référentiel, accédez à un dossier de votre choix qui contient un ou plusieurs documents.
      4. Sélectionnez ... dans n’importe quelle entrée de document, puis sélectionnez Afficher les propriétés dans le menu contextuel.
      5. Copiez le lien Web du document, puis extrayez l’URL Web de base et stockez-la dans un emplacement sécurisé.

        L’URL Web de base est la partie de l’URL du lien Web qui se termine par /open. Par exemple, si l’URL du lien Web est https://example.sap.com/cp.portal/site#user-display?sap-ui-app-id-hint=com.sap.ecm.sdm.user&/documents/v1/open/rep=ABCDE&obj=12345&vs=1, l’URL Web de base est https://example.sap.com/cp.portal/site#user-display?sap-ui-app-id-hint=com.sap.ecm.sdm.user&/documents/v1/open.

        Important :
        Votre administrateur du connecteur de contenu externe a besoin de cette URL Web de base lors de la configuration du connecteur de SAP contenu externe DMS.

    Que faire ensuite

    Fournissez les éléments suivants à votre administrateur de connecteur :
    • L’ID client, le secret client et l’URL du jeton d’accès que vous avez copiés à partir de la clé de service pour le service de gestion des documents, l’instance de service d’option d’intégration dans l’étape 4.f.
    • URL du point de terminaison ecmservice que vous avez copiée à partir de la clé de service pour le service de gestion des documents, instance de service d’option d’intégration dans l’étape 4.g.
    • URL du point de terminaison de collections de rôles que vous avez copiée à partir de la clé de service pour le service de gestion des documents, instance de service d’option d’intégration dans l’étape 4.h.
    • L’ID client, le secret client et l’URL du jeton d’accès que vous avez copiés à partir de la clé de service pour l’instance de service Gestion des autorisations et des approbations dans l’étape 8.f.
    • L’ID client et le secret client que vous avez copiés à partir de la clé de service pour l’instance de service Autorisation et gestion des approbations avec le plan d’application à l’étape 10.f.
    • L’URL Web de base que vous avez copiée à l’étape 11.e.

    Votre administrateur de connecteur a besoin de ces éléments pour configurer un SAP connecteur de contenu externe DMS afin de récupérer des documents et des principaux de sécurité à partir de votre SAP système source DMS.

    Pour plus d’informations sur la création et la configuration d’un SAP connecteur de contenu externe DMS, reportez-vous à la section Créer un SAP connecteur de contenu externe DMS.