目次

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を使用したレポートの管理

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

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

サービスフェーズ

サービスフェーズ

ビジネスエンティティサービスは複数のサービスフェーズで構成されます。外部呼び出しを行い、サポートされているイベントをトリガするようにサービスフェーズを設定できます。
サービスフェーズは次の順序でトリガされます。
  1. BeforeEverything。検証、ローカリゼーション、プロジェクションなどのサービスのロジックを実行する前に、外部呼び出しを行い、サポートされているイベントをトリガします。サンプルのユースケースは、このサービスフェーズを設定して、デフォルトのマージ動作を変更し、2つのビジネスエンティティの属性のマージを防止したい場合などです。例えば、2つ以上のPersonレコードのマージ中に、親Personレコードの子電話番号レコードのマージを防止することができます。
    プロジェクションは、特定のビジネスエンティティサービスの応答に相互参照情報を追加するプロセスです。プロジェクションは、特定のサービスフェーズの前後に発生する、可能な追加のステップと見なすことができます。
  2. BeforeValidate。入力データを検証する前に、外部呼び出しを行い、サポートされているイベントをトリガします。サンプルのユースケースは、ビジネスエンティティを保持するときに入力データを検証する前に、ロジックを検証するようにこのサービスフェーズを設定したい場合などです。例えば、Personレコードを保持する前に、外部のサードパーティサービスに対して行われる住所または電話番号の検証。
  3. AfterValidate。入力データを検証した後に、外部呼び出しを行い、サポートされているイベントをトリガします。サンプルのユースケースは、ビジネスエンティティを保持するときに入力データを検証した後に、ロジックを検証するようにこのサービスフェーズを設定したい場合などです。例えば、Personレコードを保持した後に、外部のサードパーティサービスに対して行われる住所または電話番号の検証。
    AfterValidateサービスがトリガされると、前のサービスフェーズでデータが変更または処理されたため、入力データが異なる場合があります。
  4. AfterEverything。検証、ローカリゼーション、プロジェクションなどのサービスのロジックを実行した後に、外部呼び出しを行い、サポートされているイベントをトリガします。サンプルのユースケースは、サービスがすべてのロジックを実行した後に通知をトリガするようにこのサービスフェーズを設定したい場合などです。例えば、2つ以上のPersonレコードのマージが成功した後に電子メール通知を送信します。
    AfterEverythingサービスフェーズがトリガされると、外部呼び出しは、入力データではなく、サービス応答からのデータにアクセスできます。

サービスフェーズをサポートするサービス

サービスフェーズをサポートする次の内部サービスを使用できます。
WriteCO
ビジネスエンティティを保持および更新します。WriteCOサービスは、次のサービスフェーズをサポートします。
  • BeforeEverything
  • BeforeValidate
  • AfterValidate
  • AfterEverything
これらのサービスフェーズは、ビジネスエンティティの保持前、保持中、および保持後にトリガされます。
WriteView
ビジネスエンティティビューを保持および更新します。WriteViewサービスは、次のサービスフェーズをサポートします。
  • BeforeEverything
  • BeforeValidate
  • AfterValidate
  • AfterEverything
これらのサービスフェーズは、ビジネスエンティティの保持前、保持中、および保持後にトリガされます。
WriteViewサービスは、サポートされているすべてのWriteCOサービスフェーズを次の順序でトリガします。
  1. WriteView.BeforeEverything
  2. WriteView.BeforeValidate
  3. WriteView.AfterValidate
  4. WriteCO.BeforeEverything
  5. WriteCO.BeforeValidate
  6. WriteCO.AfterValidate
  7. WriteCO.AfterEverything
  8. WriteView.AfterEverything
ReadCO
ビジネスエンティティを取得します。ReadCOサービスは、次のサービスフェーズをサポートします。
  • BeforeEverything
  • AfterEverything
これらのサービスフェーズは、ビジネスエンティティの読み取りの前後にトリガされます。
ReadView
ビジネスエンティティビューを取得しています。ReadViewサービスは、次のサービスフェーズをサポートします。
  • BeforeEverything
  • AfterEverything
これらのサービスフェーズは、ビジネスエンティティビューの読み取りの前後にトリガされます。
ReadViewサービスは、サポートされているすべてのReadCOサービスフェーズを次の順序でトリガします。
  1. ReadView.BeforeEverything
  2. ReadCO.BeforeEverything
  3. ReadCO.AfterEverything
  4. ReadView.AfterEverything
PreviewMergeCO
複数のビジネスエンティティのマージプレビュー結果を取得します。PreviewMergeCOサービスは、次のサービスフェーズをサポートします。
  • BeforeEverything
  • AfterEverything
これらのサービスフェーズは、マージされたビジネスエンティティのプレビューの生成の前後にトリガされます。
MergeCO
複数のビジネスエンティティをマージします。MergeCOサービスは、次のサービスフェーズをサポートします。
  • BeforeEverything
  • AfterEverything
これらのサービスフェーズは、ビジネスエンティティのマージの前後にトリガされます。