1. 製造およびサプライ・チェーン資材管理の実装
  2. オペレーショナル・イベントへのREST APIの使用
機械翻訳について

操作イベントでのREST APIの使用

REST APIを使用すると、保守のために接続された資産のヘルスに関連するイベント、または製造工場の設備リソースによって実行される生産アクティビティの運用進捗に対応するイベントを作成できます。

次のように、外部システムまたはIIoT環境からスマート操作にイベントをポストするように認証メカニズムを構成しておく必要があります:

  • IIoT環境または外部システムは、スマート操作のデータをポストできるように、認証および認可にOAuth統合を使用する必要があります。
  • IIoT環境または外部システムには、Oracle Client ID、シークレット(マスク済)、スコープ、Oracle AUTHトークンURLおよびOracle Fusion CloudエンドポイントURLを取得するためのプロビジョニングが必要です。
  • IIoT環境または外部システムは、Oracle AUTHトークンURLをクライアントID、シークレットおよびスコープとともに起動してベアラー・トークンを取得できる必要があります。
  • IIoT環境または外部システムは、取得したベアラー・トークンを使用してOracle Fusion CloudエンドポイントURLにイベントをPOSTできる必要があります。
    ノート: サンプル・ペイロードの例については、REST API for Oracle Supply Chain Management Cloudガイドのオペレーショナル・イベントの作成を参照してください。

アイデンティティ・ドメイン・アプリケーションの作成および認可の構成

IIoT環境または外部システムでOAuth統合を構成するために使用できるクライアントIDおよびクライアント・シークレットを生成します。 統合ごとに1つ以上のアイデンティティ・ドメイン・アプリケーションを作成できます。

  1. Oracle Identity Cloud Serviceコンソールに管理者としてサインインします。

  2. ナビゲーション・メニューから、「アイデンティティ&セキュリティ」を選択します。

  3. 「アイデンティティ」で、「ドメイン」をクリックし、アイデンティティ・ドメインを選択します。

  4. 「統合アプリケーション」をクリックします。

  5. 「統合アプリケーション」ページで、「アプリケーションを追加」をクリックします。

  6. 「アプリケーションの追加」ダイアログで、「機密アプリケーション」を選択し、「ワークフローの起動」をクリックします。

  7. アプリケーションの名前を指定します。 たとえば、SMART_OPERATIONS_HTTP_CLIENTです。

  8. 「OAuthの構成」ステップで、「クライアント構成」の下の「このアプリケーションをクライアントとして今すぐ構成」を選択します。

  9. 「認可」で、「クライアント資格証明」を選択します。

  10. 「トークン発行ポリシー」で、「リソースの追加」を選択します。

  11. 「リソース」で、「スコープの追加」をクリックします。

  12. スコープspectra-scm-coreを検索します。

  13. 「スコープの選択」で、Urn:opc:resource:fusion:{namespace}:scm-core/api/scm-core/operational-dataを選択し、「追加」をクリックします。

    ここで、{namespace}はインスタンス・ネームスペースです。

  14. 「次」、「終了」の順にクリックします。
  15. 「アクティブ化」をクリックしてアプリケーションをアクティブ化します。

    クライアントIDおよびクライアント・シークレットは、「一般情報」セクションで取得できます。

クライアントIDへのジョブ・ロールの割当て

Smart Operations Serviceエージェント・ジョブ・ロール( ORA_SCM_SMO_SMART_OPERATIONS_SERVICE_AGENT_JOB)またはカスタム・ジョブ・ロールを機密アプリケーション・クライアントIDに関連付けます。 これにより、IIoT環境または外部システムのOAuth統合用に生成されたクライアントIDが、スマート操作にイベントをポストする権限が確保されます。

  1. 「セキュリティ・コンソール」で、「アプリケーション拡張」タブに切り替えます。
  2. 「カスタム」OAuth「クライアント・アプリケーション」で、アプリケーション名をクリックします。
  3. アプリケーション・ページで、「ロール」タブをクリックします。
  4. 「追加」をクリックして、ジョブ・ロールを追加します。
  5. 「ロールの追加」ダイアログで、ORA_SCM_SMO_SMART_OPERATIONS_SERVICE_AGENT_JOBを検索します。
  6. 「スマート・オペレーション・サービス・エージェント」ロールを選択して追加します。

イベント・ペイロード伝送の検証

Oracle AUTHトークンURLをクライアントID、シークレットおよびスコープとともに起動して、ベアラー・トークンを取得します。 Bearerトークンを使用して、イベントをOracle Fusion CloudエンドポイントURLにポストします。

ノート:

外部システムまたはIIoT環境は、イベントPOSTでSUCCESSレスポンスを取得できる必要があります。 レスポンスを受信しない場合、システムはイベントのPOSTを再試行できる必要があります。 また、外部システムまたはIIoT環境では、成功したPOSTイベントと失敗したPOSTイベントの両方のログを取得できる必要があります。

次に何をするか

スマート操作を使用すると、ユーザーはアセット・フォルト、アセット・ステータスおよび操作パラメータ・イベントの操作ルールを作成できます。 これらの操作ルールは、受信イベントを評価し、ルール条件が満たされた場合に自動ワークフロー・アクションを実行します。 スマート工程を使用して工程ルールを作成するには、製造および保守のユーザー・ガイドを参照してください。

スマート・オペレーションは、オペレーション実行の開始または停止、数量レポート・イベント、資産ステータス・イベント、オペレーション・パラメータ、メーター・リーディングなど、オペレーション・データとイベントのレコードを保持します。 受入済および否認済運用イベント・レコードを表示したり、処理に失敗した運用イベントを表示することもできます。 「作業実行」作業領域の「操作データ」タスクまたは処理を使用して、操作イベントを確認します。