カスタム問合せを使用したOracle ERP Cloudデータの統合プロセスの説明

カスタム問合せを使用してOracle ERP Cloudからデータをフェッチして、Oracle Enterprise Performance Management Cloudにロードできます。カスタム問合せは、CSVフォーマット済データ・ファイルを作成するOracle Business Intelligence Publisherのレポートに対して実行され、そのデータがEPM Cloudにロードされます。この場合、データ統合ではレポートを実行してデータを抽出し、そのデータをEPM Cloudにロードします。

カスタム問合せを使用し、BI Publisherレポート抽出を使用してOracle ERP CloudからEPM Cloudにデータをロードするステップは、次のとおりです。

注:

EPM CloudとのカスタムOracle ERP Cloud統合定義を作成し、それをESSジョブとして登録するには、Oracle Enterprise Scheduler (ESS)ジョブとしてのBI Publisherレポートの登録を参照してください。
  1. Oracle ERP Cloud統合には、権限またはユーザー役割および統合されるすべてのERP元帳へのデータ・アクセス権が必要です。詳細は、Oracle ERP Cloudのセキュリティ役割の要件を参照してください。Oracle ERP CloudでのERPの保護を参照してください。

  2. Oracle ERP Cloudにナビゲートし、「新規プロセスのスケジュール」をクリックして、BI Publisherレポートを実行します。

    イメージは、「新規プロセスのスケジュール」が選択されたBI Publisherを示します。

  3. 「検索して選択」ページの「名前」で、レポートまたは抽出を選択し、「OK」をクリックします。

    BI PublisherレポートでCSVフォーマット・ファイルで出力ファイルが作成されている場合は、任意のレポートを選択できます。Fusionでは必ずしもすべてのレポートでCSVフォーマット・ファイルが作成されるわけではありません。

    イメージはレポート選択を示します

    たとえば、「試算」と入力して試算表レポートを検索します。

    イメージは「検索して選択」ページを示します

  4. 「プロセスの詳細」から、抽出またはレポートのパラメータを選択し、「送信」をクリックします。

    次の例では、「元帳」がVision Operations、「金額タイプ」がYTDまたはPTDです。

    「会計期間」を必ず指定してください。「会計期間」は、レポートを再利用できるようにデータ統合で設定されるパラメータです。

    注:

    Oracle ERP Cloud側で選択した抽出に、EPM Cloudから渡される1つ以上のバインド・パラメータがない場合、Oracle ERP CloudとEPM Cloudの統合は失敗します。バインド・パラメータは、SQL文の実際の値のプレースホルダです。バインド・パラメータは、チルダ文字(~~)で囲まれる必要があります。たとえば、"Period"をバインド・パラメータとして使用するには、~PERIOD~と指定します。名前は、SQL問合せで指定した名前と完全に一致する必要があります。

    そのためには、データ・モデル問合せで参照されないレポートに、バインド・パラメータを直接作成します。データ統合のレポート・パラメータ・リストで、レポート定義で作成したバインド・パラメータに渡されるランダム文字(ABCなど)を指定します。

    イメージは「検索して選択」ページを示します

    イメージは「プロセスの詳細」ページを示します。

    レポートが生成されると、「出力」セクションに送信の結果が表示されます。

    イメージはレポートの「出力」セクションを示します。

  5. 再発行をクリックし、レポート出力ページから「csv」をクリックします。

  6. CSV出力ファイルを選択して右クリックし、「開く」を選択します。

    イメージはレポートのCSV出力ファイルを示します。

  7. ファイル・システムにレポートをローカルに保存します。

    ダウンロードされた出力ファイルの名前をAppname.csv (Appnamは、データ統合の「データ・ソース」アプリケーションの対象アプリケーション名)に変更します。これは、BI Publisherレポート抽出を表します。

  8. 「データ統合」ホーム・ページの「アクション」から、「アプリケーション」を選択します。

  9. アプリケーション・ページで、イメージは「追加」ボタンを示します。(「追加」アイコン)をクリックします。

  10. 「カテゴリ」から、「データ・ソース」を選択します。

  11. 「タイプ」から、Oracle ERP Cloud (カスタム)を選択します。

    イメージは示します

  12. 「ファイル」から、イメージは「参照」アイコンを示しますをクリックしてCSVファイルを保存したフォルダに移動し、そのファイルを選択して「OK」をクリックします。

    イメージは示します

    レポートがターゲット・アプリケーションとして保存され、「アプリケーション名」は自動的に移入されます。

  13. 「接頭辞」で、アプリケーション名を一意にする接頭辞を指定します。

    接頭辞はファイル名と連結されて、一意のアプリケーション名を形成します。たとえば、アプリケーションに既存のアプリケーションと同じ名前を付ける場合は、接頭辞としてイニシャルを割り当てることができます。

  14. 「OK」をクリックします。

  15. 「保存」をクリックします。

    データ統合でアプリケーションが登録され、「ディメンションの詳細」のすべての列が返されます。

  16. アプリケーション・ページで、データ・ソース・アプリケーションの横にあるイメージは「選択」アイコンを示します。をクリックし、「アプリケーション詳細」を選択します。

  17. 「接続名」で、ソース・システムの名前を指定します。

    たとえば、ソース・システムの名前が「ERP Cloud」の場合は「ERP Cloud」と指定します。

    Oracle ERP CloudまたはGLソース・システム名を使用するか、新しい名前を定義することもできます。

  18. 実行方法 - ジョブを実行するための方法を指定します。

    有効なオプション:

    • BIPレポート - BI Publisherレポートを同期モードで実行します。これには、Oracle ERP Cloudインスタンス内で約5分のタイムアウト制限があります。この方法は、小規模なデータ・セットまたは短時間で実行される問合せに適しています。

    • ESSジョブ - BI Publisherレポートを非同期モードで実行します。実行時間の制限はありません。

  19. レポート名 - レポートの名前を入力し、実行方法が「BIPレポート」の場合はレポートのパスを入力します。たとえば、/Custom/MyReport.xdoと入力します。実行方法が「ESSジョブ」の場合は、このフィールドは空白のままにします。

    Oracle ERP Cloudでレポートの名前を見つける必要がある場合は、次のステップを実行します:

    1. Oracle ERP Cloudに移動してレポートを検索し、「レポートおよび分析」を選択してパラメータ情報を取得します。

      イメージは「レポートおよび分析」オプションの選択を示します

    2. 「カタログの参照」をクリックします。

    3. 抽出またはレポートを検索して選択します。

      イメージは試算表レポートの検索を示します。

    4. 「詳細」、「プロパティ」の順にクリックします。

      イメージは「プロパティ」画面を示します。

    5. 「カスタム・プロパティ」セクションで、「パス」フィールドまで下にスクロールします。

    6. データ統合にターゲット・アプリケーションを登録するとき、パス(および名前)をコピーして「レポート名」フィールドに貼り付けます。

  20. データ統合に戻り、レポート・パラメータ・リストで、カスタム問合せのレポート・パラメータを指定します。

    レポート・パラメータを識別する必要がある場合は、次のことを実行します:

    1. Oracle ERP Cloudに移動し、「概要」ページからレポートを選択して、再送信をクリックします。

      このステップにより、BI Publisherの抽出またはレポートで定義したレポート・パラメータを表示して取得できます。

      イメージは「概要」ページからのレポートの再送信を示します。

      レポート・パラメータのリストが生成されます。

      イメージはパラメータのリストを示します。

    2. 「警告」ウィンドウに表示されるレポート・パラメータをコピーします。

      注:

      #NULL (null)パラメータがBI PublisherパラメータとしてOracle ERP CloudからEPM Cloudに渡される場合、#NULLパラメータによってERPアダプタベースのフレームワークは失敗します。

      この問題を修正するには、パラメータのリストで#NULLの値を持つパラメータを削除し、値を空のままにして、空白を削除します。

      次に例を示します:

      現在のパラメータが次のような場合:

      argument1=30029384;argument2=#NULL;argument3=01-JAN-2022

      argument2=#NULLを次のように変更します:

      argument1=30029384;argument2=;argument3=01-JAN-2022

    3. データ統合に移動し、「警告」ウィンドウからカスタム問合せのレポート・パラメータ・リスト・フィールドにレポート・パラメータ・リストを貼り付けます。

      レポート・パラメータ・リストで、レポート定義で作成したバインド・パラメータに渡されるランダム文字(ABCなど)を指定していることを確認します。EPM Cloudから渡されるバインド・パラメータがない問合せを使用してレポートを作成すると、EPM Cloud側でプロセスが失敗します。

  21. データ統合で、インポート・フォーマットを作成することにより、Oracle ERP Cloudデータ・ソースとターゲット・アプリケーション間の統合マッピングを設定します。

    ディメンションのマッピングを参照してください。

  22. インポート・フォーマットの関連付けに使用するロケーションを定義します。

  23. メンバーをソースからターゲットにマップします。

    メンバーのマッピングを参照してください。

  24. ソースおよびターゲットのオプションを選択します。

    データ統合オプションの設定を参照してください。

  25. 統合を実行します。

    統合の実行を参照してください。