目次

Search

  1. はじめに
  2. ビジネスエンティティサービスについて
  3. EJBビジネスエンティティサービス呼び出し
  4. REST ビジネスエンティティサービス呼び出し
  5. Data DirectorのREST API
  6. SOAPビジネスエンティティサービス呼び出し
  7. 相互参照レコードとBVT計算サービス
  8. 企業リンケージサービスのサポート
  9. データをクレンジング、分析、変換するための外部呼び出し
  10. 付録 A: REST APIを使用したレコードの追加
  11. 付録 B: REST APIを使用したファイルのアップロード
  12. 付録 C: REST APIを使用したレポートの管理

ビジネスエンティティサービスガイド

ビジネスエンティティサービスガイド

例: 外部呼び出しからサービス統合フレームワーク呼び出しを行う

例: 外部呼び出しからサービス統合フレームワーク呼び出しを行う

セキュリティ上の理由から、MDMはパスワードとペイロードの情報を外部呼び出しに渡しません。BESExternalCallWithSIFの例は、外部呼び出しからServices Integration Framework(SIF)呼び出しを行う方法を示しています。
この例の外部呼び出しは、次のカスタム検証を実行します。
  1. Personレコードの電話番号の内線番号に特殊文字が含まれているかどうかを確認します。
  2. 電話番号に特殊文字が含まれている場合は、電話番号を修正します。
  3. タイプPRIの電話番号が1つだけかどうかを確認します。
外部呼び出しがタイプPRIの電話番号が1つだけ存在すること検証した後に、外部呼び出しはSIF Put呼び出しを使用して更新を実行します。

要件

外部サービスからMDM Hubへの呼び出し用にアプリケーションユーザーを設定します。この例では、アプリケーションユーザーとしてe360を使用しています。このアプリケーションユーザーを、設定したユーザーに置き換えます。詳細については、『
Multidomain MDMのセキュリティガイド
』を参照してください。

外部呼び出しからのSIF呼び出しの実行

  1. bes-external-call.earファイルを作成してデプロイします。
  2. プロビジョニングツールで、WebサービスをSOAPサービスとして登録します。
    次の表に、SOAPサービスに対して設定できるプロパティを示します。
    プロパティ
    値の例
    名前
    besexternal
    URL
    https://<host>:<port>/bes-external-call/CustomLogicService?wsdl
  3. プロビジョニングツールで、外部呼び出しを登録します。
    次の表に、外部呼び出しに対して設定できるプロパティを示します。
    プロパティ
    値の例
    SOAP操作
    validate
    ビジネスエンティティ
    Person
    サービスフェーズ
    WriteCO.BeforeValidate
    • 操作: validate
    • ビジネスエンティティ: Person
    • サービスフェーズ: WriteCO.BeforeValidate
  4. 内線番号に特殊文字が含まれる電話番号を使用してPersonレコードを作成します。
    次のサンプルPOST要求には、内線電話番号に特殊文字@が含まれています。
    POST /cmx/cs/<ors>/Person?systemName=Admin { "firstName": "John", "TelephoneNumbers": { "item": [ { "phoneExtNum": "e@1", "phoneNum": "1234567", "phoneTypeCd":{ "phoneType":"PRI" } } ] } }
    次の応答は、検証エラーを表示します。
    <?xml version="1.0" encoding="UTF-8"?> <ns1:CsFault xmlns:ns1="urn:cs-base.informatica.mdm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <ns1:errorMessage>SIP-50022: Validation failed.</ns1:errorMessage> <ns1:errorCode>SIP-50022</ns1:errorCode> <ns1:details xsi:type="ns1:ValidationErrors"> <ns1:error> <ns1:code>CUSTOM-00001</ns1:code> <ns1:message>The Phone Ext Number has special symbols.</ns1:message> <ns1:field>Person.TelephoneNumbers.phoneExtNum</ns1:field> </ns1:error> </ns1:details> </ns1:CsFault>
    次のサンプルは、検証エラーを生成しない有効なPOST要求です。
    POST /cmx/cs/<ors>/Person?systemName=Admin { "firstName": "John", "TelephoneNumbers": { "item": [ { "phoneExtNum": "e1", "phoneNum": "1234567", "phoneTypeCd":{ "phoneType":"PRI" } } ] } }
  5. oなどの文字を含む電話番号を使用してPersonレコードを作成します。
    POST要求が実行されると、文字oが数字の0に置換されます。
    次のサンプルPOST要求には、文字oを使用した電話番号が含まれています。
    POST /cmx/cs/<ors>/Person?systemName=Admin { "firstName": "John", "TelephoneNumbers": { "item": [ { "phoneExtNum": "e1", "phoneNum": "123o4567", "phoneTypeCd":{ "phoneType":"PRI" } } ] } }
  6. POST要求に1つまたは複数の電話レコードが含まれているかどうかに応じて、電話タイプの値がどのように設定されるかを示す次のシナリオを考えてみましょう。
    • シナリオ1。このシナリオには、それぞれ1つの電話レコードを作成する2つのPOST要求が含まれます。次のPOST要求は、電話タイプがPRIの最初の電話レコードを作成します。
      POST /cmx/cs/<ors>/Person?systemName=Admin { "firstName": "John", "TelephoneNumbers": { "item": [ { "phoneExtNum": "e1", "phoneNum": "12304567", "phoneTypeCd":{ "phoneType":"PRI" } } ] } }
      次のPOST要求を実行して2番目の電話レコードを作成すると、2番目の電話レコードの電話タイプがPRIに設定され、最初のPOST要求の電話タイプがOTHに変更されます。
      POST /cmx/cs/<ors>/Person/rowidObject?systemName=Admin { "TelephoneNumbers": { "item": [ { "phoneExtNum": "e2", "phoneNum": "23045678", "phoneTypeCd":{ "phoneType":"PRI" } } ] } }
    • シナリオ2。このシナリオには、2つの電話レコードを作成する1つのPOST要求が含まれます。次のサンプルPOST要求には、電話タイプがPRIの2つの電話レコードが含まれています。
      POST /cmx/cs/<ors>/Person?systemName=Admin { "firstName": "John", "TelephoneNumbers": { "item": [ { "phoneExtNum": "e1", "phoneNum": "12304567", "phoneTypeCd":{ "phoneType":"PRI" } }, { "phoneExtNum": "e2", "phoneNum": "23045678", "phoneTypeCd":{ "phoneType":"PRI" } } ] } }
      このPOST要求が実行されると、最初の電話レコードの電話タイプがPRIに設定されます。2番目の電話レコードでは、電話タイプはOTHに設定されます。