1. SCMの統合プレイブック
  2. REST API
機械翻訳について

REST API

Oracle Fusion Cloudサプライ・チェーン(SCM) & Manufacturingは、顧客およびシステム・インテグレータに、リアルタイム統合要件のレコードを表示、作成、更新または削除するための包括的なREST APIのセットを提供します。

REST APIは、ファイルベース・データ・インポート(FBDI)およびBusiness Intelligence Cloud Connector (BICC)を使用して、Oracle Fusion Cloud Applicationsから大量のデータをインポートおよびエクスポートするだけでなく、Oracle Cloud SCMアプリケーションと統合するための堅牢でスケーラブルなツールを提供します。

詳細は、「Oracle Fusion Cloud SCM用のREST API」を参照してください。

主な機能

  • REST APIは、インバウンド・フローとアウトバウンド・フローの両方に使用されます。
  • リアルタイム統合要件のサポート。
  • 単一品目とコレクションの両方でのCRUD操作のサポート。
  • 多くの製品チームは、オブジェクトに対するBATCH操作をサポートしているため、1回のコールで複数の更新、挿入、削除および取得操作を実行できます。
  • CRUD操作とともに、多くのOracle Cloud SCMアプリケーションでカスタム・アクションがサポートされます。
  • Oracle Cloud SCMアプリケーション全体にわたる広範なサポート
  • エンド・ツー・エンドのプロセス・オーケストレーションでは、REST APIを簡単に使用できます。
  • JSON形式のみをサポートします。

ベスト・プラクティス

  • RESTコール中に渡される様々なヘッダーについては、常にRESTドキュメント・ガイドを参照し、Oracle Cloud SCM製品チームが提供する例を確認してください。
  • データの取得時には、データ・ページ区切りに限度とオフセットを使用します。
  • データを取得する場合は、フィールドURIパラメータを使用して、関心のあるフィールドのみにレスポンスを制限します。
  • 問合せパラメータ「数量」を使用して、結果をフィルタおよび制限します。
  • 可能な場合は、複数のAPIリクエストを1つのリクエストに結合します。
  • onlyData=trueディレクティブを使用して、レスポンスからすべてのリンクを除外し、レスポンス・サイズを小さくします。
  • 500 (Internal Server Error)、502 (Bad Gateway)、503 (Service Unavailable)、504 (Gateway Timeout)などのHTTPエラー・コードのタイムアウト処理および再試行ロジックを実装します。 再試行中は、常に指数関数的なバックオフを使用してサーバーの圧倒を回避します。
  • 503 (Service Unavailable)エラーについては、レスポンス出力に「メンテナンス再試行」という単語があるかどうかを参照してください。 このような場合は、更新に長い時間がかかることがあるため、最大8時間までの合計遅延を考慮してください。
  • Oracle Supportに連絡する場合は、エラーおよび重要なトランザクション詳細をログに記録してください。 エラーを迅速に解決するには、RESTコールおよび入力および出力ペイロードの正確な時間が必要です。Oracle Support。
  • webアプリケーションのOracle Business Object REST APIフレームワーク・バージョンを指定して、新しいバージョンのREST APIフレームワークによって提供される新機能にオプト・インできます。
  • エンティティ・タグ(ETags)は、頻繁な更新を必要とする高い読取り/書込み比率のAPIに使用できます。 競合を回避し、キャッシュを改善するために、ETagsを使用してデータの検証、古いデータの検出などを行うことができます。 これにより、パフォーマンスと効率が向上します。

制約

  • 大量のデータ・インポート/エクスポートには適していません。
  • Oracle Cloud SCM REST APIのいずれも、1回のコールで500を超えるレコードを返せません。 RESTパラメータでオフセットと制限を使用して、セット全体をページ区切りできます。
  • 各フレームワーク・バージョンで導入された変更は、下位互換性がありません。 したがって、ビジネス要件を評価し、それらをサポートするフレームワーク・バージョンを使用します。
ノート: Oracle Cloud SCMアプリケーションとの統合を構築する場合は、ドキュメント化されていないREST APIを使用しないでください。 Oracleは、ドキュメント化されていないREST APIの下位互換性を保証するものではなく、正式な通知なしに非推奨になる可能性があります。

Microsoft ExcelのOracle Visual Builderアドイン

ExcelをRESTクライアントとして使用して、Oracle Visual Builder Add-in for Excelを使用してデータを取得、分析、編集およびロードできます。 詳細は、「Oracle Visual Builder Add-in for Excel、バージョン3.2.0」を参照してください。

関連トピック