Oracle Fusion Applications Business Intelligenceパブリッシャ・レポート・サービスのコール
Oracle Fusion Applicationsは、Business Intelligence (BI)パブリッシャ・サービスのwebサービスを提供し、次のサービスを使用してレポートを同期してレスポンスを取得します。
- パブリック・サービス: SOAPエンベロープのペイロード/本文に資格証明が必要です。
- ReportService: runReportメソッド(「Oracle Business Intelligence Publisher開発者ガイド」のReportServiceを参照)
xmlpserver/services/v2/ReportService?wsdl
- ScheduleService: getDocumentDataメソッド(「Oracle Business Intelligence Publisher開発者ガイド」のScheduleServiceを参照)
xmlpserver/services/v2/ScheduleService?wsdl
- ReportService: runReportメソッド(「Oracle Business Intelligence Publisher開発者ガイド」のReportServiceを参照)
- 保護されたサービス: SOAPエンベロープのヘッダーの一部として資格証明が必要です。
ノート:
BIレポートに同期コールを使用する必要がある場合は、このサービスをお薦めします。- ExternalReportWSSService: runReportメソッド
xmlpserver/services/ExternalReportWSSService?wsdl
- ScheduleReportWSSService: getDocumentDataメソッド
xmlpserver/services/ScheduleReportWSSService?wsdl
- ExternalReportWSSService: runReportメソッド
SOAPアダプタがOracle Fusion Applications Business Intelligence Publisher (BIP)レポートを同期的に呼び出すと、レポート・データは、レスポンス内に常にbase64エンコードされた文字列として返されます。 これらのサービスでは、レスポンスでの添付はサポートされていません。 この場合、SOAPアダプタでMTOMサポートを構成する機能は動作しません。
BIレスポンスの処理
BIレスポンスは、次のアプローチと統合で解析できます:
- 推奨: decodeBase64ToReferenceマッパー関数を使用して、base64文字列をファイル参照に変換し、その後の処理のためにステージ・ファイル・アクション/FTPアダプタ読取りファイル操作のシナリオでファイル参照を使用します。
- 代替: 不透明なスキーマを使用して、ステージング・ファイル・アクション/FTPアダプタの書込みファイル操作のシナリオを使用するファイルにbase64文字列を書き込み、その後の処理のためにステージ・ファイル・アクション/FTPアダプタ・シナリオを使用してそのファイルを読み取ります。
ノート:
BIPレポートの同期をコールする際、BIP webサービスに送信されたリクエストはレポート生成を開始し、レポートが生成された後にレスポンスを送り返します。 これにより、Oracle Integration環境でレイテンシの問題が発生する可能性があります。前述の理由から、SOAPアダプタと同期してBIレポート・サービスを呼び出すことは、ショート・ランニングまたは小規模サイズのレポート(あるいはその両方)に推奨されます。 ペイロード・サイズの制限に注意してください。 「Oracle Integration Generation 2のプロビジョニングと管理」の「サービス制限」を参照してください。
これらの制限を超えた場合(つまり、長時間実行レポートまたは大規模レポート)、推奨されるアプローチは次のとおりです:
Oracle Universal Content Management(UCM)の使用
Oracle ERP CloudアダプタおよびSOAPアダプタの使用:
- BIPレポートを作成してスケジュール/実行し、レポート・レスポンスがUCMに振り込まれるようにレポートを構成します。
- カスタムESSジョブを作成し、ステップ3で送信されたBIPレポート・データを実行します。
- ErpIntegrationServiceを使用してOracle ERP Cloudアダプタ起動接続を作成し、exportBulkData操作を選択します。 jobNameがステップ2で作成されたカスタムESSジョブに設定されていることを確認します。jobOptionsはEnableEvent=Yに設定されています。 これにより、ジョブが完了したときにイベントが有効になります。
- Oracle ERP Cloudアダプタ・トリガー接続を作成して、ExportBulkDataEventをサブスクライブします。 これは、UCMに振り込まれるイベント・ペイロードにdocumentIdを提供します。
- 操作でUCM webサービス(GenericSoapService)およびGET_FILEコマンドを使用してSOAPアダプタ起動を作成し、BIPレポート・レスポンスを添付として取得します。
FTPの使用
- レポート・レスポンスをFTPに配置するようにBIレポートを構成します。
- Oracle Fusion ApplicationsでカスタムESSジョブを作成し、BIPレポートを実行します。
- ESS webサービスを使用してESSジョブを発行します。 「Oracle Enterprise Scheduler Webサービス・コールの実装」を参照してください。
- ジョブが完了し、コールバックが受信されると、FTPからアタッチメントとしてレスポンスを取得します。