外部コンテンツのインデックス作成用の SAP DMS の構成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：19分

    • SAP Business Technology Platform (BTP) グローバルアカウントでサービスインスタンスとサービスキーを作成して、SAP DMS 外部コンテンツコネクタが SAP DMS ドキュメントとリポジトリにアクセスできるようにします。

    始める前に

    SAP BTP のグローバルアカウントアドミニストレーターである必要があります。SAP ドキュメント管理サービスにアクセスするには、グローバルアカウントに権限が必要です。

    SAPグローバルアカウントアドミニストレーターは、次のエンタイトルメントを持つサブアカウントを SAP BTP グローバルアカウントに作成している必要があります。
    • ドキュメント管理サービス、アプリケーションオプション
    • ドキュメント管理サービス、統合オプション
    • ドキュメント管理サービス、リポジトリオプション
    • Cloud Foundry 環境
    • 認証と信頼管理サービス
    SAP BTP グローバルアカウントにこれらのエンタイトルメントを持つサブアカウントがまだない場合は、このタスクを実行する前にSAP Business Technology Platform (BTP) でのサブアカウントの作成予備タスクを実行してください。

    必要なロール：なし

    このタスクについて

    SAP DMS 外部コンテンツコネクタは、ドキュメント管理サービスの統合オプション REST API を使用して、SAP DMS ソースシステムのリポジトリからドキュメントを取得します。

    コネクタがこの API を介して SAP DMS ソースシステムにアクセスできるようにするには、 SAP DMS Business Technology Platform (BTP) でサービスインスタンスとサービスキーを設定する必要があります。コネクタアドミンは、新しいサービスキーからコピーした設定を使用して、ソースシステムに適切に接続できるように SAP DMS 外部コネクタを構成できます。

    手順

    1. サブアカウントで、ドキュメント管理サービスのアプリケーションオプションのサービスインスタンスを作成します。
      1. グローバルアカウントの認証情報を使用して、https://cockpit.btp.cloud.sap/ で SAP Business Technology Platform (BTP) にログインします。
      2. [サブアカウント] タブで、サブアカウントを選択します。
      3. 移動先 サービスマーケットプレイス.
      4. [ ドキュメント管理サービス] の [アプリケーションオプション ] エントリを検索して選択します。
      5. [Create] を選択します。
      6. [新しいインスタンス] または [サブスクリプション] フォームで、フィールドに入力します。
        フィールド 説明
        プラン [ 標準] を選択し、免責事項オプションを選択します。
        ランタイム環境 [ Cloud Foundry] を選択します。
        スペース サブアカウント用に作成した Cloud Foundry スペースの名前を入力します。SAP Business Technology Platform (BTP) でのサブアカウントの作成 のサブアカウントの作成手順に従った場合、この名前は DMS です。
        インスタンス名 任意の名前を入力します。たとえば、「 DMS-AO」と入力します。
      7. [Create] を選択します。
        SAP BTP は、サブアカウントにドキュメント管理サービスとアプリケーションオプションサービスインスタンスを作成します。
    2. 新しいドキュメント管理サービスのアプリケーションオプションサービスインスタンスのサービスキーを作成します。
      1. サブアカウントから、 インスタンスとサブスクリプション.
      2. [サブスクリプション] タブの新しいドキュメント管理サービスのアプリケーションオプションサービスインスタンスの行で、 … > サービスキーを作成.
      3. [新しいサービスキー] フォームで、新しいサービスキーの名前を入力します。
        たとえば、「 DMS-AO」と入力します。
      4. [Create] を選択します。
        SAP BTP は、サブアカウントにドキュメント管理サービス、アプリケーションオプションサービスキーを作成します。
    3. サブアカウントでドキュメント管理サービスの統合オプションのサービスインスタンスを作成します。
      1. グローバルアカウントの認証情報を使用して、https://cockpit.btp.cloud.sap/ で SAP Business Technology Platform (BTP) にログインします。
      2. [サブアカウント] タブで、サブアカウントを選択します。
      3. 移動先 サービスマーケットプレイス.
      4. [ ドキュメント管理サービス] の [統合オプション ] エントリを検索して選択します。
      5. [Create] を選択します。
      6. [新しいインスタンス] または [サブスクリプション] フォームで、フィールドに入力します。
        フィールド 説明
        プラン [ 標準] を選択し、免責事項オプションを選択します。
        ランタイム環境 [ Cloud Foundry] を選択します。
        スペース サブアカウント用に作成した Cloud Foundry スペースの名前を入力します。SAP Business Technology Platform (BTP) でのサブアカウントの作成 のサブアカウントの作成手順に従った場合、この名前は DMS です。
        インスタンス名 任意の名前を入力します。たとえば、「 DMS-IO」と入力します。
      7. [Create] を選択します。
        SAP BTP は、サブアカウントにドキュメント管理サービスの統合オプションサービスインスタンスを作成します。
    4. 新しいドキュメント管理サービスの統合オプションサービスインスタンスのサービスキーを作成し、そのクライアント設定と API URL をコピーします。
      1. サブアカウントから、 インスタンスとサブスクリプション.
      2. [サブスクリプション] タブで、新しいドキュメント管理サービスの [統合オプション] サービスインスタンスの行で、 … > サービスキーを作成.
      3. [新しいサービスキー] フォームで、新しいサービスキーの名前を入力します。
        たとえば、「 DMS-IO」と入力します。
      4. [Create] を選択します。
        SAP BTP は、サブアカウントにドキュメント管理サービスの統合オプションサービスキーを作成します。
      5. [サービスキー] セクションで、次を選択して新しいサービスキーを表示します … > 表示 そのエントリで。
      6. 認証情報フォームで、uaa セクションから clientid、clientsecret、および url の値をコピーし、安全な場所に保存します。
        重要:
        外部コンテンツコネクタアドミンは、 SAP DMS 外部コンテンツコネクタを構成するときにこれらのクライアント設定値を必要とします。
      7. 認証情報フォームで、エンドポイントセクションの ecmservice エントリから url フィールド値をコピーし、安全な場所に保存します。
        重要:
        外部コンテンツコネクタアドミンは、 SAP DMS 外部コンテンツコネクタを構成するときにこのエンドポイント URL を必要とします。
      8. 認証情報フォームで、 apiurl フィールドの値をコピーし、安全な場所に保存します。
        重要:
        外部コンテンツコネクタアドミンは、 SAP DMS 外部コンテンツコネクタを構成するときにこのロールコレクションエンドポイント URL を必要とします。
      9. 認証情報フォームで、パイプの後に表示される xsappname フィールド値の部分をコピーします。記号を作成し、安全な場所に保存してください。
        たとえば、 xsappname フィールドの値が 673dc63a-f785-4225-b974-de10815701fc!b23581|sdm-di-DocumentManagement-sdm_integration!b62497 の場合、コピーする値の部分は sdm-di-DocumentManagement-sdm_integration!b62497 です。
    5. サブアカウントでドキュメント管理サービスのリポジトリオプションのサービスインスタンスを作成します。
      1. グローバルアカウントの認証情報を使用して、https://cockpit.btp.cloud.sap/ で SAP Business Technology Platform (BTP) にログインします。
      2. [サブアカウント] タブで、サブアカウントを選択します。
      3. 移動先 サービスマーケットプレイス.
      4. [ ドキュメント管理サービス] の [リポジトリオプション ] エントリを検索して選択します。
      5. [Create] を選択します。
      6. [新しいインスタンス] または [サブスクリプション] フォームで、フィールドに入力します。
        フィールド 説明
        プラン [ 標準] を選択し、免責事項オプションを選択します。
        ランタイム環境 [ Cloud Foundry] を選択します。
        スペース サブアカウント用に作成した Cloud Foundry スペースの名前を入力します。SAP Business Technology Platform (BTP) でのサブアカウントの作成 のサブアカウントの作成手順に従った場合、この名前は DMS です。
        インスタンス名 任意の名前を入力します。たとえば、「 DMS-RO」と入力します。
      7. [Create] を選択します。
        SAP BTP は、サブアカウントにドキュメント管理サービスのリポジトリオプションサービスインスタンスを作成します。
    6. 新しいドキュメント管理サービスのリポジトリオプションサービスインスタンスのサービスキーを作成します。
      1. サブアカウントから、 インスタンスとサブスクリプション.
      2. [サブスクリプション] タブで、新しいドキュメント管理サービスのリポジトリオプションサービスインスタンスの行で、 … > サービスキーを作成.
      3. [新しいサービスキー] フォームで、新しいサービスキーの名前を入力します。
        たとえば、「 DMS-RO」と入力します。
      4. [Create] を選択します。
        SAP BTP は、サブアカウントにドキュメント管理サービスのリポジトリオプションサービスキーを作成します。
    7. サブアカウントで認証および信頼管理サービスのサービスインスタンスを作成します。
      1. サブアカウントから、 サービス > サービスマーケットプレイス.
      2. [ 認証と信頼の管理サービス] エントリを検索して選択します。
      3. [Create] を選択します。
      4. [新しいインスタンス] または [サブスクリプション] フォームで、フィールドに入力します。
        フィールド 説明
        プラン [ apiaccess] を選択します。
        ランタイム環境 [ Cloud Foundry] を選択します。
        スペース サブアカウント用に作成した Cloud Foundry スペースの名前を入力します。SAP Business Technology Platform (BTP) でのサブアカウントの作成 のサブアカウントの作成手順に従った場合、この名前は DMS です。
        インスタンス名 任意の名前を入力します。たとえば、「 ATMS」と入力します。
      5. [次へ] を選択します。
      6. [新しいインスタンス] または [サブスクリプション] フォームで、次の JSON コードを [インスタンスパラメーターの設定] テキスト入力フィールドに貼り付け、 <instance-name> を ServiceNow AI Platform インスタンスの名前に置き換えます。 
        {
  "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. [Create] を選択します。
        SAP BTP は、サブアカウントに Authorization and Trust Management サービスのサービスインスタンスを作成します。
    8. 新しい認証および信頼管理サービスインスタンスのサービスキーを作成します。
      1. サブアカウントから、 インスタンスとサブスクリプション.
      2. [サブスクリプション] タブの新しい認証と信頼管理サービスインスタンスの行で、 … > サービスキーを作成.
      3. [新しいサービスキー] フォームで、新しいサービスキーの名前を入力します。
        たとえば、「 ATMS」と入力します。
      4. [Create] を選択します。
        SAP BTP は、サブアカウントに Authorization and Trust Management サービスのサービスキーを作成します。
      5. [サービスキー] セクションで、次を選択して新しいサービスキーを表示します … > 表示 そのエントリで。
      6. [認証情報] フォームで、[サービスキー] セクションから clientid、 clientsecret、および url の値をコピーし、安全な場所に保存します。
        重要:
        外部コンテンツコネクタアドミンは、 SAP DMS 外部コンテンツコネクタを構成するときにこれらのクライアント設定値を必要とします。
    9. SAP BTP サブアカウントのアプリケーションプランを使用して、認証および信頼管理サービスの新しいインスタンスを作成します。
      1. サブアカウントから、 サービス > インスタンスとサブスクリプション.
      2. [Create] を選択します。
      3. [新しいインスタンスまたはサブスクリプション] フォームの [基本情報] ページで、フィールドに入力します。
        フィールド 説明
        サービス 認証 と信頼管理サービスを選択します。
        プラン アプリケーションを選択します。
        ランタイム環境 [ Cloud Foundry] を選択します。
        スペース [ DMS] を選択します。
        注:
        これは、 SAP BTP サブアカウント用に作成した Cloud Foundry スペースの名前です。この手順の詳細については、「SAP Business Technology Platform (BTP) でのサブアカウントの作成」を参照してください。
        インスタンス名 このサービスインスタンスの一意の名前を入力します。
      4. [次へ] を選択します。
      5. [新しいインスタンスまたはサブスクリプション] フォームの [パラメーター] ページで、次の JSON コードを [インスタンスパラメーターの設定] テキスト入力フィールドに貼り付け、<service-name> をステップ 9.c のアプリケーション計画で新しい認証および信頼管理サービスインスタンスに入力した名前に、<instance-name> をServiceNow AI Platformインスタンスの名前に、「<xsappname> をステップ 4.i でコピーした xsappname サブ文字列に置き換えます。 
        {
  "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. [Create] を選択します。
        SAP BTP は、サブアカウントのアプリケーションプランを使用して、認証および信頼管理サービスのサービスインスタンスを作成します。
    10. アプリケーションプランを使用して、新しい認証および信頼管理サービスインスタンスのサービスキーを作成します。
      1. サブアカウントから、 インスタンスとサブスクリプション.
      2. [サブスクリプション] タブで、アプリケーションプランを使用した新しい認証と信頼管理サービスインスタンスの行で、 … > サービスキーを作成.
      3. [新しいサービスキー] フォームで、新しいサービスキーの名前を入力します。
        たとえば、「 ATMS-app-plan」と入力します。
      4. [Create] を選択します。
        SAP BTP は、サブアカウントのアプリケーションプランを使用して、認証と信頼管理サービスインスタンスのサービスキーを作成します。
      5. [サービスキー] セクションで、次を選択して新しいサービスキーを表示します … > 表示 そのエントリで。
      6. 認証情報フォームで、[サービスキー] セクションから clientid と clientsecret の値をコピーし、安全な場所に保存します。
        重要:
        外部コンテンツコネクタアドミンは、 SAP DMS 外部コンテンツコネクタを構成するときにこれらのクライアント設定値を必要とします。
    11. SAP DMS テナント内のドキュメントのベース Web URL をコピーします。
      1. グローバルアカウント認証情報を使用して、 SAP DMS テナントにログインします。
      2. 任意のリポジトリに移動します。
      3. リポジトリで、1 つ以上のドキュメントを含む任意のフォルダーに移動します。
      4. 任意のドキュメントエントリで [... ] を選択し、コンテキストメニューから [ プロパティを表示 ] を選択します。
      5. ドキュメントの Web リンク をコピーし、ベース Web URL を抽出して安全な場所に保存します。

        ベース Web URL は、 Web リンク URL の末尾が 「/open」の部分です。たとえば、 Web リンク 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 の場合、ベース Web URL は https://example.sap.com/cp.portal/site#user-display?sap-ui-app-id-hint=com.sap.ecm.sdm.user&/documents/v1/open です。

        重要:
        外部コンテンツコネクタアドミンは、 SAP DMS 外部コンテンツコネクタを構成するときにこのベース Web URL を必要とします。

    次のタスク

    コネクタアドミンに次のアイテムを提供します。
    • ステップ 4.f でドキュメント管理サービスの統合オプションサービスインスタンスのサービスキーからコピーしたクライアント ID、クライアントシークレット、およびアクセストークン URL。
    • ステップ 4.g でドキュメント管理サービスの統合オプションサービスインスタンスのサービスキーからコピーした ecmservice エンドポイント URL。
    • ロールは、ステップ 4.h でドキュメント管理サービスのサービスキー、統合オプションサービスインスタンスからコピーしたエンドポイント URL を収集します。
    • ステップ 8.f で Authorization and Trust Management サービスインスタンスのサービスキーからコピーしたクライアント ID、クライアントシークレット、およびアクセストークンの URL。
    • ステップ 10.f のアプリケーション計画で Authorization and Trust Management サービスインスタンスのサービスキーからコピーしたクライアント ID とクライアントシークレット。
    • ステップ 11.e でコピーしたベース Web URL。

    コネクタアドミンは、SAP DMS ソースシステムからドキュメントとセキュリティプリンシパルを取得する SAP DMS 外部コンテンツコネクタを構成するために、これらのアイテムを必要とします。

    SAP DMS 外部コンテンツコネクタの作成と構成の詳細については、「SAP DMS 外部コンテンツコネクタの作成」を参照してください。