データのインポートと公開の自動化
SOAP webサービスとともにスケジュール済プロセスを使用して、データのインポートおよび公開のプロセスの一部を自動化できます。
データ・インポート
webサービスを使用して、品目データをプログラムでインポートできます。
この表は、自動品目データ・インポート・ソリューションの各部分と各要素が果たすロールを示しています。
ロール |
ピース |
---|---|
インポートするデータ |
インポート・ファイルを指定するマニフェスト・ファイルを使用して、Oracle WebCenter Contentリポジトリにアップロードされたファイル。 |
ソース・システムから品目データをインポートするスケジュール済プロセス |
製品アップロード・ジョブのスケジュール |
スケジュール済プロセスをプログラムで発行するSOAP webサービス |
詳細は、Oracle Financials CloudのSOAP Webサービス・ガイドを参照してください |
スケジュール済プロセスの現在のステータスをフェッチするSOAP webサービス。 |
詳細は、Oracle Fusion Cloud SCMを参照してください: SCM用SOAP Webサービス・ガイド。 |
インポート・サービス・リクエストのステータスおよび属性に関する情報を提供するSOAPサービス・データ・オブジェクト |
SOAPサービス・データ・オブジェクトの詳細は、Oracle Fusion Cloud SCMを参照してください: SCM用SOAP Webサービス・ガイド。 |
webサービスの呼出しに必要なセキュリティ権限 |
品目のインポート権限 権限の詳細は、Oracle Fusion Cloud SCMを参照してください: Product Managementのセキュリティ・リファレンス・ガイド。 |
-
1つ以上のソース・データ・ファイルをOracle WebCenter Contentリポジトリのコントリビューション・フォルダに配置します。
-
コントリビューション・フォルダで、マニフェスト・ファイルをCSV形式で指定します。 マニフェストは、アップロード・プロセスをソース・データ・ファイルにガイドします。 マニフェスト・ファイルには、次の列が含まれている必要があります:
-
テンプレート: データ・ソース・ファイルからのデータのアップロードに使用されるインポート・マップの名前。
-
ファイル・パス: アップロードする各データ・ソース・ファイルへのOracle WebCenterコンテンツの相対パス。
-
添付ファイル・パス: Oracle WebCenter Contentの相対パスで、品目にアタッチするファイルを含む各オプションの圧縮ファイルを指定します。
マニフェスト・ファイルの各行は、データ・ファイルを指定します。 マニフェスト・ファイルのサンプルを次に示します:
Template,File Path,Attachments File Path Product Map,/Contribution Folders/products.csv,/Contribution Folders/attachments.zip Structures Map,/Contribution Folders/structures.csv,
-
-
webサービス
ErpIntegrationService.submitESSJobRequest
を使用して、スケジュール済プロセスのスケジュール製品アップロード・ジョブをスケジュールし、マニフェストで指定されたソース・データ・ファイルをOracle WebCenter Contentから製品ハブのインタフェース表にインポートします。 このwebサービスを呼び出すインフラストラクチャの提供はユーザーの責任です。このサービス・コールのリクエスト・ペイロード要素は次のとおりです:
エレメント
値
jobPackageName
/oracle/apps/ess/scm/productHub/itemImport/
jobDefinitionName
ExtProductUploadSchedulingJobDef
paramList
文字列のリスト:
-
ManifestFileName(/Contribution Folders/ProductManifest.csv)
。ProductManifest.csv
はファイル名の例です。 -
インポート・ソース・システムのスポーク・システム・コード。
サービス・コールからのレスポンス・ペイロードは、スケジュール済プロセスのリクエストIDです。 (スケジュール済プロセス作業領域の概要ページで、このIDはプロセスIDと呼ばれます。) このIDを記録して、webサービス
ItemBatchMaintenanceService.getRequestStatus
のリクエスト・ペイロードで使用し、インポートの進行状況をモニターします。 -
-
スケジュール済プロセスを実行すると、マニフェスト・ファイルが読み取られ、指定したCSV、XMLまたは添付ファイルからProduct Hubインタフェース表にデータがアップロードされます。
-
このプロセスでは、積荷目録ファイルの各行に対して新規品目バッチが作成され、CSV、XMLまたは添付ファイルからインタフェース表にデータがアップロードされます。各品目バッチに従って、その行に指定されたインポート・マップが使用されます。
-
プロセスによって品目インポート・プロセスが実行され、インタフェース表から本番表にデータが移動されます。
インポートのモニタリング
webサービスを使用して、品目データのインポートをプログラムでモニターできます。
-
webサービス
ItemBatchMaintenanceService.getRequestStatus
のポーリングを設定します。 -
getRequestStatus
のリクエスト・ペイロードには、webサービスErpIntegrationService.submitESSJobRequest
をコールしたときに返されたリクエストIDが含まれている必要があります。 このIDをエレメントBINDREQUESTIDの値として渡します。 -
getRequestStatus
のレスポンス・ペイロードは、サービス・データ・オブジェクトProduct Upload Request Status
を含むサービス・データ・オブジェクトRequest Status
です。 これらのオブジェクトについては、Oracle Fusion Cloud SCMで説明: SCM用SOAP Webサービス・ガイド。 プロセスのステータスを説明する多くの属性が含まれています。 これらの属性を読み取ってユーザーに情報を提供するようにソリューションを設定できます。
スケジュール済プロセス作業領域の概要ページで、プロセスを手動でモニターすることもできます。
データ公開
webサービスを使用して、品目データをプログラムで公開できます。
この表は、自動品目データ公開ソリューションの各部分と、各要素が果たすロールを示しています。
ロール |
ピース |
---|---|
公開するデータ |
Product Hubの本番表からOracle WebCenter Contentのファイルに公開されるファイル。 |
ソース・システムに品目データを公開するスケジュール済プロセス |
製品ハブ公開ジョブ このスケジュール済プロセスの詳細は、Oracle Fusion Cloud SCMでProduct Hub Publication Jobスケジュール済プロセスのスケジュールおよびパラメータの定義に関するトピックを参照してください: 『Product Master Data Managementの使用』ガイド。 |
スケジュール済プロセスをプログラムで発行するSOAP webサービス |
|
スケジュール済プロセスの現在のステータスをフェッチするSOAP webサービス |
|
公開サービス・リクエストのステータスおよび属性に関する情報を提供するSOAPサービス・データ・オブジェクト |
SOAPサービス・データ・オブジェクトの詳細は、Oracle Fusion Cloud SCMを参照してください: SCM用SOAP Webサービス・ガイド。 |
webサービスの呼出しに必要なセキュリティ権限 |
品目の公開権限 権限の詳細は、Oracle Fusion Cloud SCMを参照してください: Product Managementのセキュリティ・リファレンス・ガイド。 |
-
データを公開するソース・システムを決定します。
-
webサービス
ErpIntegrationService.submitESSJobRequest
を使用して、スケジュール済プロセスの製品ハブ公開ジョブをスケジュールし、ソース・データをOracle WebCenter Contentのファイルに公開します。 このwebサービスを呼び出すインフラストラクチャの提供はユーザーの責任です。このサービス・コールのリクエスト・ペイロード要素は次のとおりです:
エレメント
値
jobPackageName
/oracle/apps/ess/scm/productModel/items/
jobDefinitionName
PimPublicationJobDef
paramList
『製品マスター・データ管理の使用』ガイドの製品ハブ公開スケジュール済プロセスに関するトピックで説明されているパラメータに対応する文字列のリスト。 必須パラメータはスポーク・システムおよびフォルダのロケーションです。
サービス・コールからのレスポンス・ペイロードは、スケジュール済プロセスからのリクエストIDです。 このIDを記録して、パブリッシュされたデータの識別に使用します。
-
製品ハブ公開ジョブ・プロセスでは、本番表からOracle WebCenter Contentのファイルにデータを公開します。
-
webサービス
ItemBatchMaintenanceService.getRequestStatus
を実行して、リクエスト・ペイロードのスケジュール済プロセスからリクエストIDを渡します。このファイルは、
ItemBatchMaintenanceService.getRequestStatus
によってレスポンス・ペイロードで返されるPublication Request Status
オブジェクトのPublicationDocumentId
およびPublicationFileName
属性によって識別されます。 これらの属性は、Oracle WebCenter Contentで公開されているドキュメントを識別します。 -
リポジトリ・ツールを使用して、公開済ファイルをダウンロードします。
公開のモニタリング
webサービスを使用して、品目データの公開をプログラムでモニターできます。
公開をモニタリングする手順は、インポートを監視する場合と同じです。ただし、webサービスItemBatchMaintenanceService.getRequestStatus
をコールする場合の違いは異なります:
-
インポートと同様に、
getRequestStatus
のレスポンス・ペイロードはサービス・データ・オブジェクトRequest Status
です。 -
ただし、公開のために、
Request Status
には、(Product Upload Request Status
ではなく)サービス・データ・オブジェクトPublication Request Status
が含まれます。 -
Publication Request Status
オブジェクトの属性は、次のものを提供します:-
スケジュールされた公開プロセスの
Request Id
-
Oracle WebCenter Contentで公開されているドキュメントの
PublicationDocumentId
およびPublicationFileName
。
-