ERP統合RESTサービス
Oracle Fusion Cloud Financialsの一部として使用可能なERP統合RESTサービスは、Oracle Fusion Cloud Supply Chain Planning製品とともに使用して、バルク・データのインポート、UCMサーバーへのファイルのアップロードおよびフラット・ファイルからのプランニング・データのロードを行います。 RESTリソース名はERP統合であり、複数のPOST操作をサポートします。
このトピックでは、Oracle Supply Chain Planning製品でのこれらのREST操作の使用方法に関する具体的なガイドラインを示します。 ERP統合RESTサービスに関するOracle Financialsドキュメントについては、Oracle Help CenterでREST API for Oracle Fusion Cloud FinancialsのマニュアルのERP統合タスクに関する項を参照してください。
バルク・データのインポート
- ファイル・コンテンツをUCMサーバーにアップロード
- データをプランニングのステージング表にロード
- 「ファイルからプランニング・データのロード」スケジュール済プロセスを起動
- 「プランニング・データ収集」ジョブ・セットを起動
この操作は単一のAPIコールで完了し、暗号化されたデータファイルを処理し、アップロードの一部として復号化します。
importBulkData REST操作で使用される特定のパラメータを次に示します。
- JobName: Oracle Supply Chain Planningのデータ・ロードの場合、このパラメータを次のように指定する必要があります。
JobName: /oracle/apps/ess/scm/advancedPlanning/collection/configuration/CSVController - Parameter List: このパラメータには、パラメータ値のカンマ区切りリストが含まれます。 これは、このRESTサービス操作の一部として起動される「ファイルからプランニング・データのロード」スケジュール済プロセスで使用されます。 次に、パラメータ・リストで使用されるパラメータを示します。
パラメータ
スケジュール済プロセス内部パラメータ このプロセスの表示パラメータへのマップ 予期される値 パラメータ詳細 パラメータ1 ソース・システム ソース・システム データがアップロードされているソース・システムのソース・システム・コード。 このコードは、ソース・システムの設定時に指定されます パラメータ2 収集タイプ 1または2 起動する収集のタイプ。 有効な値は次のとおりです。 - 1はターゲット収集タイプを示します
- 2はネット・チェンジ収集タイプを示します
パラメータ3 データ・ファイル Zipファイル名 アップロードするzipファイルの名前。 パラメータ4 非表示 未使用 #NULLとして指定します。 パラメータ5 非表示 文書ID (DId)の値 UCMにアップロードするzipファイルの文書ID。
importBulkData操作を使用する場合はオプションですが、submitEssJobRequest操作を使用する場合は必須です。
パラメータ6 非表示 インスタンスID パラメータ1 (インスタンス・コード)で指定されたソース・システムの内部ID。 これはMSC_APPS_INSTANCES.INSTANCE_IDとして内部的に格納され、次のSQL問合せを使用して導出できます。
SELECT instance_id FROM msc_apps_instances WHERE instance_code = '<instance code>'パラメータ7 非表示 アプリ・バージョン パラメータ1 (インスタンス・コード)で指定されたソース・システムのバージョンの内部値。 これはMSC_APPS_INSTANCES.APPS_VERとして内部的に格納され、次のSQL問合せを使用して導出できます。 SELECT apps_ver FROM msc_apps_instances WHERE instance_code = '<instance code>'パラメータ8 非表示 未使用 #NULLとして指定します。 パラメータ9 組織グループ 組織グループ これはオプションです。 ユーザーが特定の組織グループに対して収集を実行する場合にのみ必要です。 値は組織グループの名前です。 指定しない場合は、#NULLを使用します。
パラメータ・ファイル
ERP統合RESTサービスをOracle Supply Chain Planning製品とともに使用する場合は、ScpErpIntegrationServiceParamsImportTemplate.xlsmテンプレート・ファイルを使用して生成される特別なパラメータ・ファイルSupply Chain Planning ERP統合サービス・パラメータを含める必要があります。 このパラメータ・ファイルは、ERP統合フローにデータをロードするために、他のCSVファイルとともにzipファイルに含める必要があるメタデータを提供するファイルです。 このファイルには、次のパラメータが含まれています。
- ソース・システム・コード(パラメータ表のパラメータ1)
- 収集タイプ(パラメータ表のパラメータ9)
- 組織グループ(パラメータ表のパラメータ9)
入力zipファイルにScpErpIntegrationServiceParams.csvが含まれていない場合、収集のモードはネット・チェンジにデフォルト設定され、「フラット・ファイルからのプランニング・データのロード」スケジュール済プロセスでは、それぞれのデータファイルからインスタンス・コードの値が読み取られます。
ScpErpIntegrationServiceParams.csvメタ・データ・ファイルは、ERP統合importBulkData操作を使用してデータをロードする場合にのみ必要であり、「スケジュール済プロセス」ページまたはsubmitEssJobRequest操作を使用して「フラット・ファイルからのプランニング・データのロード」プロセスを発行する場合は不要です。
UCMへのファイルのアップロード
uploadfiletoUCM操作では、REST操作で指定された文書に基づいて、単一のステップでUCMサーバーにファイルがアップロードされます。
操作を完了するために使用するパラメータを次に示します。
DocumentAccount: Oracle Supply Chain Planningのデータ・ロードの場合、このパラメータを次のように指定する必要があります。
DocumentAccount":"scm$/planningDataLoader$/import$REST応答には、データ要素の1つとしてDocumentIdが含まれます。
フラット・ファイルからのプランニング・データのロード
submitEssJobRequest操作は、フラット・ファイルからプランニング・データをロードするために使用されます。 1つのステップで一連のパラメータを使用して収集ジョブ・セットを送信します。
Oracle Supply Chain Planning製品のデータをロードする場合は、次のパラメータとそれぞれのガイドラインを使用して操作を完了します。
- JobPackageName: このパラメータは、次のように指定する必要があります
JobPackageName:oracle/apps/ess/scm/advancedPlanning/collection/configuration - JobDefName: このパラメータは、次のように指定する必要があります
JobDefName: CSVController - DocumentId: uploadFileToUCM操作の応答からの文書IDを使用します。
-
ESSParameters: このパラメータには、importBulkData操作のParameter Listパラメータに指定された値のリストを含める必要があります。 次に例を示します。
ESSParameters:EX8,2,UOM.zip,#NULL,289568,300100110961358,3,#NULL,#NULL
REST応答には、データ要素の1つとしてRqstIdが含まれます。 このデータ要素は、送信済のスケジュール済プロセス(この場合は「ファイルからプランニング・データのロード」プロセス)のプロセスIDです。 このプロセスは、「プランニング・データの収集」ジョブ・セットを含む合計フローが起動されて完了した後にのみ完了します。
「データの公開」プロセスや「プランのリリース」プロセスなど、他のOracle Supply Chain Planningプロセスでは、Oracle Supply Chain PlanningグループでそれぞれのRESTサービスを使用し、submitEssJobRequest操作を使用しないことをお薦めします。 たとえば:
- 「データの公開」の場合: サプライ・チェーン・プランニング/サプライ・チェーン・プラン/データの公開を使用
- 「プランのリリース」の場合: サプライ・チェーン・プランニング/サプライ・チェーン・プラン/リリースを使用
- 「プランのアーカイブ」の場合: サプライ・チェーン・プランニング/サプライ・チェーン・プラン/アーカイブを使用