Configurar SAP DMS para indexação de conteúdo externo

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 13 min. de leitura

    • Crie instâncias de serviço e chaves de serviço no SAP Conta global da Business Technology Platform (BTP) para permitir o. SAP Conector de conteúdo externo do DMS para acessar o. SAP Repositórios e documentos do DMS.

    Antes de Iniciar

    Você deve ser um administrador de conta global no SAP BTP. Sua conta global deve estar autorizada a acessar o. SAP Serviço de gestão de documentos.

    R SAP o administrador de conta global deve ter criado uma subconta no SAP Conta global do BTP, com estes direitos:
    • Serviço de gestão de documentos, opção de aplicação
    • Serviço de gestão de documentos, opção de integração
    • Serviço de gestão de documentos, opção de repositório
    • Ambiente de Fundição em nuvem
    • Serviço de gestão de confiança e autorização
    Se você ainda não tiver uma subconta com esses direitos em seu SAP Conta global do BTP, execute o. Crie uma subconta no SAP BTP (Business Technology Platform, plataforma de tecnologia de negócios) tarefa preliminar antes de executar esta tarefa.

    Função necessária: nenhuma

    Por Que e Quando Desempenhar Esta Tarefa

    . SAP O conector de conteúdo externo do DMS recupera documentos de repositórios em seu SAP Sistema de origem do DMS usando o serviço de gestão de documentos, opção de integração REST API.

    Para permitir que o conector acesse o. SAP Sistema de origem do DMS Por meio desta API, você deve configurar instâncias de serviço e chaves de serviço no SAP Plataforma de tecnologia de negócios (BTP) do DMS. Seu conector o administrador pode usar configurações copiadas de suas novas chaves de serviço para configurar o. SAP Conector externo do DMS para conexão adequada ao sistema de origem.

    Procedimento

    1. Crie uma instância de serviço para o serviço de gestão de documentos, opção de aplicação em sua subconta.
      1. Faça login no SAP BTP (Business Technology Platform, plataforma de tecnologia de negócios) em https://cockpit.btp.cloud.sap/ usando suas credenciais de conta global.
      2. Na guia Subcontas, selecione sua subconta.
      3. Navegar até Mercado de serviços.
      4. PESQUISE e selecione Serviço de gestão de documentos, opção de aplicação entrada.
      5. Selecione Criar.
      6. No formulário Nova instância ou assinatura, preencha os campos.
        Campo Descrição
        Plano Selecione padrão , em seguida, selecione a opção de isenção de responsabilidade.
        Ambiente de tempo de execução Selecione Cloud Foundry .
        Espaço Insira o nome do espaço do Cloud Foundry que você criou para sua subconta. Se você seguiu as etapas de criação de subconta de Crie uma subconta no SAP BTP (Business Technology Platform, plataforma de tecnologia de negócios), este nome é DMS .
        Nome da instância Insira um nome de sua escolha. Como exemplo, você pode inserir DMS-AO .
      7. Selecione Criar.
        SAP O BTP cria o serviço de gestão de documentos, instância de serviço de opção de aplicação em sua subconta.
    2. Crie uma chave de serviço para o seu novo serviço de gestão de documentos, instância de serviço de opção de aplicação.
      1. Em sua subconta, navegue até Assinaturas e instâncias.
      2. Na guia Assinaturas, na linha do novo serviço de gestão de documentos, instância do serviço de opção de aplicação, selecione … > Criar chave de serviço.
      3. No formulário Nova chave de serviço, insira um nome para sua nova chave de serviço.
        Como exemplo, você pode inserir DMS-AO .
      4. Selecione Criar.
        SAP O BTP cria o serviço de gestão de documentos, a chave de serviço de opção de aplicação na sua subconta.
    3. Crie uma instância de serviço para o serviço de gestão de documentos, opção de integração em sua subconta.
      1. Faça login no SAP BTP (Business Technology Platform, plataforma de tecnologia de negócios) em https://cockpit.btp.cloud.sap/ usando suas credenciais de conta global.
      2. Na guia Subcontas, selecione sua subconta.
      3. Navegar até Mercado de serviços.
      4. PESQUISE e selecione Serviço de gestão de documentos, opção de integração entrada.
      5. Selecione Criar.
      6. No formulário Nova instância ou assinatura, preencha os campos.
        Campo Descrição
        Plano Selecione padrão , em seguida, selecione a opção de isenção de responsabilidade.
        Ambiente de tempo de execução Selecione Cloud Foundry .
        Espaço Insira o nome do espaço do Cloud Foundry que você criou para sua subconta. Se você seguiu as etapas de criação de subconta de Crie uma subconta no SAP BTP (Business Technology Platform, plataforma de tecnologia de negócios), este nome é DMS .
        Nome da instância Insira um nome de sua escolha. Como exemplo, você pode inserir DMS-IO .
      7. Selecione Criar.
        SAP O BTP cria o serviço de gestão de documentos, instância do serviço de opção de integração na sua subconta.
    4. Crie uma chave de serviço para o seu novo serviço de gestão de documentos, instância do serviço de opção de integração e copie as configurações do cliente e o URL da API.
      1. Em sua subconta, navegue até Assinaturas e instâncias.
      2. Na guia Assinaturas, na linha do novo serviço de gestão de documentos, instância do serviço de opção de integração, selecione ... > Criar chave de serviço.
      3. No formulário Nova chave de serviço, insira um nome para sua nova chave de serviço.
        Como exemplo, você pode inserir DMS-IO .
      4. Selecione Criar.
        SAP O BTP cria o serviço de gestão de documentos, a chave de serviço de opção de integração na sua subconta.
      5. Na seção Chaves de serviço, exiba sua nova chave de serviço selecionando ... > Exibição em sua entrada.
      6. No formulário Credenciais, copie o. clientid , clientsecret e. url valores do uaa e armazene-os em um local seguro.
        Importante:
        O administrador do conector de conteúdo externo precisa desses valores de configuração de cliente ao configurar o. SAP Conector de conteúdo externo do DMS.
      7. No formulário Credenciais, copie o. url valor do campo da entrada ecmservice da seção de endpoints e armazene-o em um local seguro.
        Importante:
        O administrador do conector de conteúdo externo precisa deste URL de endpoint ao configurar o. SAP Conector de conteúdo externo do DMS.
      8. No formulário Credenciais, copie o. apiurl valor do campo e armazene-o em um local seguro.
        Importante:
        O administrador do conector de conteúdo externo precisa desta URL do endpoint de coleta de funções ao configurar o. SAP Conector de conteúdo externo do DMS.
      9. No formulário Credenciais, copie a parte do xsapappname valor do campo que aparece após o símbolo de tubo rígido | e o armazena em um local seguro.
        Por exemplo, se xsapappname o valor do campo é 673dc63a-f785-4225-b974-de10815701fc!b23581|sdm-di-Gestão de documentos-sdm_integration!b62497 , a parte do valor a ser copiado é sdm-di-DocumentManagement-sdm_integration!b62497 .
    5. Crie uma instância de serviço para a opção Serviço de gestão de documentos, Repositório na sua subconta.
      1. Faça login no SAP BTP (Business Technology Platform, plataforma de tecnologia de negócios) em https://cockpit.btp.cloud.sap/ usando suas credenciais de conta global.
      2. Na guia Subcontas, selecione sua subconta.
      3. Navegar até Mercado de serviços.
      4. PESQUISE e selecione Serviço de gestão de documentos, opção de repositório entrada.
      5. Selecione Criar.
      6. No formulário Nova instância ou assinatura, preencha os campos.
        Campo Descrição
        Plano Selecione padrão , em seguida, selecione a opção de isenção de responsabilidade.
        Ambiente de tempo de execução Selecione Cloud Foundry .
        Espaço Insira o nome do espaço do Cloud Foundry que você criou para sua subconta. Se você seguiu as etapas de criação de subconta de Crie uma subconta no SAP BTP (Business Technology Platform, plataforma de tecnologia de negócios), este nome é DMS .
        Nome da instância Insira um nome de sua escolha. Como exemplo, você pode inserir DMS-RO .
      7. Selecione Criar.
        SAP O BTP cria a instância do serviço de opção de repositório, serviço de gestão de documentos na sua subconta.
    6. Crie uma chave de serviço para o seu novo serviço de gestão de documentos, instância de serviço de opção de repositório.
      1. Em sua subconta, navegue até Assinaturas e instâncias.
      2. Na guia Assinaturas, na linha do novo serviço de gestão de documentos, instância do serviço de opção de repositório, selecione ... > Criar chave de serviço.
      3. No formulário Nova chave de serviço, insira um nome para sua nova chave de serviço.
        Como exemplo, você pode inserir DMS-RO .
      4. Selecione Criar.
        SAP O BTP cria o serviço de gestão de documentos, a chave de serviço de opção de repositório na sua subconta.
    7. Crie uma instância de serviço para o serviço de gestão de autorização e confiança em sua subconta.
      1. Em sua subconta, navegue até Serviços > Mercado de serviços.
      2. PESQUISE e selecione Serviço de gestão de confiança e autorização entrada.
      3. Selecione Criar.
      4. No formulário Nova instância ou assinatura, preencha os campos.
        Campo Descrição
        Plano Selecione apiaccess .
        Ambiente de tempo de execução Selecione Cloud Foundry .
        Espaço Insira o nome do espaço do Cloud Foundry que você criou para sua subconta. Se você seguiu as etapas de criação de subconta de Crie uma subconta no SAP BTP (Business Technology Platform, plataforma de tecnologia de negócios), este nome é DMS .
        Nome da instância Insira um nome de sua escolha. Como exemplo, você pode inserir CAIXAS ELETRÔNICOS .
      5. Selecione Avançar.
      6. No formulário Nova instância ou assinatura, cole o seguinte código JSON no campo de entrada de texto Configurar parâmetros de instância, substituindo <instance-name> com o nome do seu ServiceNow AI Platform instância. 
        {
  "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. Selecione Criar.
        SAP O BTP cria a instância de serviço para o serviço de gestão de autorização e confiança em sua subconta.
    8. Crie uma chave de serviço para sua nova instância de serviço de gestão de autorização e confiança.
      1. Em sua subconta, navegue até Assinaturas e instâncias.
      2. Na guia Assinaturas, na linha da sua nova instância de serviço de gestão de autorização e confiança, selecione ... > Criar chave de serviço.
      3. No formulário Nova chave de serviço, insira um nome para sua nova chave de serviço.
        Como exemplo, você pode inserir CAIXAS ELETRÔNICOS .
      4. Selecione Criar.
        SAP O BTP cria a chave de serviço para o serviço de gestão de autorização e confiança na sua subconta.
      5. Na seção Chaves de serviço, exiba sua nova chave de serviço selecionando ... > Exibição em sua entrada.
      6. No formulário Credenciais, copie o. clientid , clientsecret e. url valores da seção de chave de serviço e armazene-os em um local seguro.
        Importante:
        O administrador do conector de conteúdo externo precisa desses valores de configuração de cliente ao configurar o. SAP Conector de conteúdo externo do DMS.
    9. Crie uma nova instância para o serviço de gestão de autorização e confiança com o plano de aplicações em seu SAP Subconta de BTP.
      1. Em sua subconta, navegue até Serviços > Assinaturas e instâncias.
      2. Selecione Criar.
      3. Na página Informações básicas do formulário Nova instância ou assinatura, preencha os campos.
        Campo Descrição
        Serviço Selecione Serviço de gestão de confiança e autorização .
        Plano Selecione aplicação .
        Ambiente de tempo de execução Selecione Cloud Foundry .
        Espaço Selecione DMS .
        Nota:
        Este é o nome do espaço do Cloud Foundry que você criou para o. SAP Subconta de BTP. Para obter detalhes sobre este procedimento, consulte Crie uma subconta no SAP BTP (Business Technology Platform, plataforma de tecnologia de negócios).
        Nome da instância Insira um nome exclusivo para esta instância de serviço.
      4. Selecione Avançar.
      5. Na página Parâmetros do formulário Nova instância ou assinatura, cole o seguinte código JSON no campo de entrada de texto Configurar parâmetros de instância, substituindo <service-name> Com o nome que você inseriu para a nova instância do serviço de gestão de autorização e confiança com o plano de aplicações na etapa 9.c, <instance-name> com o nome do seu ServiceNow AI Platform instância, e. <xsappname> com o. xsapappname substring que você copiou na etapa 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. Selecione Criar.
        SAP O BTP cria a instância de serviço para o serviço de gestão de autorização e confiança com o plano de aplicações em sua subconta.
    10. Crie uma chave de serviço para sua nova instância de serviço de gestão de autorização e confiança com o plano do aplicativo.
      1. Em sua subconta, navegue até Assinaturas e instâncias.
      2. Na guia Assinaturas, na linha da sua nova instância de serviço de gestão de autorização e confiança com o plano do aplicativo, selecione ... > Criar chave de serviço.
      3. No formulário Nova chave de serviço, insira um nome para sua nova chave de serviço.
        Como exemplo, você pode inserir Plano-app-CAIXAS ELETRÔNICOS .
      4. Selecione Criar.
        SAP O BTP cria a chave de serviço para a instância do serviço de gestão de autorização e confiança com o plano de aplicações em sua subconta.
      5. Na seção Chaves de serviço, exiba sua nova chave de serviço selecionando ... > Exibição em sua entrada.
      6. No formulário Credenciais, copie o. clientid e. clientsecret valores da seção de chave de serviço e armazene-os em um local seguro.
        Importante:
        O administrador do conector de conteúdo externo precisa desses valores de configuração de cliente ao configurar o. SAP Conector de conteúdo externo do DMS.
    11. Copie o URL da web base para documentos em seu SAP Locatário do DMS.
      1. Faça login em SAP Locatário do DMS usando suas credenciais de conta global.
      2. Navegue até um repositório de sua escolha.
      3. No repositório, navegue até uma pasta de sua escolha que contém um ou mais documentos.
      4. Selecione ... em qualquer entrada de documento, selecione Mostrar propriedades no menu de contexto.
      5. Copie o. Link da web Para o documento, extraia o URL da web base e armazene-o em um local seguro.

        O URL da web base é a parte do Link da web URL que termina com /abrir . Por exemplo, se Link da web O URL é 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 , O URL da web base é https://example.sap.com/cp.portal/site#user-display?sap-ui-app-id-hint=com.sap.ecm.sdm.user&/documents/v1/open .

        Importante:
        O administrador do conector de conteúdo externo precisa deste URL da web de base ao configurar o. SAP Conector de conteúdo externo do DMS.

    O que Fazer Depois

    Forneça os itens a seguir para o. conector administrador:
    • O ID do cliente, o segredo do cliente e o URL do token de acesso que você copiou da chave de serviço para o serviço de gestão de documentos, instância do serviço de opção de integração na etapa 4.f.
    • O URL do endpoint ecmservice que você copiou da chave de serviço para o serviço de gestão de documentos, instância do serviço de opção de integração na etapa 4.g.
    • O URL do endpoint das coleções de funções que você copiou da chave de serviço para o serviço de gestão de documentos, instância do serviço de opção de integração na etapa 4.h.
    • O ID do cliente, o segredo do cliente e o URL do token de acesso que você copiou da chave de serviço para a instância do serviço de gestão de autorização e confiança na etapa 8.f.
    • O ID do cliente e o segredo do cliente que você copiou da chave de serviço para a instância do serviço de gestão de autorização e confiança com o plano de aplicações na etapa 10.f.
    • O URL da web base que você copiou na etapa 11.e.

    Seu conector o administrador precisa desses itens para configurar um SAP Conector de conteúdo externo do DMS para recuperar documentos e principais de segurança do SAP Sistema de origem do DMS.

    Para obter detalhes sobre como criar e configurar um SAP Conector de conteúdo externo do DMS, consulte Crie um SAP Conector de conteúdo externo do DMS.