JD Edwards EnterpriseOne Orchestratorクライアントでのサンプル・オーケストレーションの実行

目的

このOBEでは、JDE_ORCH_Sample_UpdateMeterReadingsサンプル・オーケ ストレーションを使用して、燃料および時間(ランタイム)メーター示度をInternet of Things (IoT)デバイスからEnterpriseOneメーター示度スピード入力(P12120U)アプリケーショ ンに送信するプロセスをシミュレートする方法を説明します。

完了までの時間

20分

背景

オラクル社では、お客様がJD Edwards IoTインプリメンテーションのテストや、独自のオーケストレーション作成用のテンプレートに使用できる JDE_ORCH_Sample_UpdateMeterReadingsサンプル・オーケストレーションを提 供しています。このOBEの手順に従う前に、このサンプル・オーケストレーションのコンポーネントについて理解 することが重要です。
JDE_ORCH_Sample_UpdateMeterReadingsサンプル・オーケストレーションは、 IoTオーケストレータがデータをサードパーティ・デバイスからEnterpriseOneに送信するために処 理する次の3つのコンポーネントから構成されています。

• オーケストレーション。サードパーティIoTデバイスから受信した入力が定義されているマスター・コン ポーネントです。このサンプル・オーケストレーションで事前に定義されている入力:
• EquipmentNumber
• NewFuelMeterReading
• NewHourMeterReading
• ホワイト・リスト。事前に定義されたキー入力からのデータのみをオーケストレーションに対して許可する ことで、初期の合否チェックを提供するオーケストレーションのコンポーネントです。このホワイト・リストに は、EquipmentNumberキー入力が含まれています。これは、IoTオーケストレータが有効な設 備番号を受信した場合にのみオーケストレーションを処理することを意味します。オーケストレーションのホワ イト・リストが無効な設備番号を受信した場合、オーケストレーションは終了します。
• サービス・リクエスト。EnterpriseOneでビジネス・トランザクションを呼び出して実行する 手順を提供するオーケストレーションのコンポーネントです。このサンプル・オーケストレーションでは、サー ビス・リクエストはメーター示度スピード入力アプリケーション(P12120U)を呼び出し、設備番号レ コードを実際のメーター示度で更新します。

前提条件(オプション)

注意: このOBEの手順はOrchestrator Studio 3.0用に記載されており、以前のバージョンのOrchestrator Studioでは動作しません。

このOBEの手順を実行する前に、次の前提条件を満たす必要があります。

• EnterpriseOne Tools 9.2.1以上がインストールされたテスト環境でEnterpriseOneが実行されていること。

• EnterpriseOne Orchestratorクライアントを実行するためのEnterpriseOne Application Interface Services (AIS)サーバー構成とEnterpriseOne Orchestrator Studio 3.0を実行するためのADFサーバーを必要とするEnterpriseOne IoT構成があること。

• このOBEで説明するJDE_ORC_Sample_UpdateMeterReadingsサンプル・オーケストレーションを含むサンプル・オーケストレーション・パッ ケージがあること。

• EnterpriseOne UDO機能セキュリティで制御されるOrchestrator Studio機能にアクセスできること。

これらの前提条件の実装方法は、JD Edwards EnterpriseOne Internet of Things Orchestratorガイドのはじめにを参照してく ださい。

メーター示度の更新サンプル・オーケストレーションには、EquipmentNumberをオーケストレー ションのキー入力として含むホワイト・リストが含まれています。サンプル・オーケストレーションを実行する前 に、これらの手順に従って、EnterpriseOneの相互参照(P952000)アプリケーションに、この ホワイト・リストで受け入れられる有効な設備番号を指定する相互参照レコードを追加します。後で JDE_ORCH_Sample_UpdateMeterReadingsサンプル・オーケストレーションの実 行をテストするときに、この設備番号を使用します。

1. EnterpriseOneで、ビジネス・サービス相互参照アプリケーション(略式コマンド: P952000)をオープンします。

2. 「ビジネス・サービス相互参照の処理」で、メニュー・バーの「追加」ボタン(「+」アイコン)をク リックして新規レコードを追加します。

3. ここで説明するようにフィールドの値を入力します。

   • 相互参照タイプ = AIS
   • 相互参照オブジェクト・タイプ = フィールドの検索ボタンをクリックして相互参照オブジェクト・タイプを選択します。これは、相互参照レコードの分類に使用されます。既存の相互参照オブジェクト・タイプを 選択するか、「設備」などの新しい相互参照オブジェクト・タイプを作成することができます。選択す るオブジェクト・タイプがシステムにない場合は、前のフォームで「フォーム」メ ニューの「オブジェクト・タイプ」をクリックして作成します。
   • サード・パーティ・アプリケーションID = ホワイトリスト(大文字と小文字を区別し、すべて大文字を使用)。ホワイト・リストの相互参照レコードの場合は、このフィールドに常に「ホワイトリスト」と入力する必要が あります。
   • サード・パーティ値 = 1001 (またはEnterpriseOneの別の有効な設備番号)。設備番号1001がEnterpriseOneプリスティン・データで使用可能になっている必要があります。 そうでない場合は、他の有効な設備番号を使用できます。後で使用するため、設備番号を記録しておい てください。このOBEで後述するように、この値はサンプル・オーケストレーションが燃料および時 間メーター示度を送信する実際の設備番号を表します。

   

   
   注意: 「EOne値」フィールドは、ドキュメントで説明されているオーケストレーションの相互参照コンポーネントに使用されます。このフィールドは、ホワイト・リストのレコード を追加するときに自動的に「NA」に設定されます。

   • 「OK」 (チェック・マーク・アイコン)をクリックしてレコードを追加します。次に、「取 消」(「X」アイコン)をクリック してフォームを閉じます。

   • 「ビジネス・サービス相互参照の処理」フォームで、次のスクリーンショットに示す検索条件を 入力し、「検索」をクリックして、設備がホワイト・リスト にあることを確認します。

     

   • 「取消」をクリックしてフォームを閉じます。

注意: 実行する前にOrchestrator Studioでサンプル・オーケストレーションを修正する必要はありません。

1. Orchestrator Studio 3.0にアクセスします。サインインするにはEnterpriseOneセキュリティ情報を入力する必要があります。

2. Orchestrator Studioのホーム・ページで、「オーケストレーショ ン」アイコンをクリックします。

3. オーケストレーションのリストで、 JDE_ORCH_Sample_UpdateMeterReadingsサンプル・オーケストレー ションを特定して選択し、検討します。

   Studioには、オーケストレーションを構成するコンポーネントのグラフィカル表現が表示されま す。



4. グラフィカル領域で、オーケストレーションを表すボックスをクリックして「オーケストレーション」設計 ページにアクセスします。

   オーケストレーションの入力に注目してください。

   • EquipmentNumber
   • NewFuelMeterReading
   • NewHourMeterReading

   このオーケストレーションで使用される他の2つのコンポーネント(ホワイト・リストとサービス・リク エスト)を示すグリッドの手順に注目してください。これらはグラフィカル表現にも示されています。

5. ページの上部にある「オーケストレーション」リンクをクリックして、サンプル・オーケストレーションの グラフィカル表現が表示された前のページに戻ります。
6. 「ホワイト・リスト」および「サービス・リクエスト」ボックスをクリックして、これらも検討します。

   「ホワイト・リスト」設計ページで、EquipmentNumberが入力キーとしてリストされてい ます。

   「サービス・リクエスト」設計ページで、「実行の順序」領域を検討します。ここには、 EnterpriseOneのメーター示度スピード入力アプリケーション(P12120U)を更新する ためにオーケストレーションに必要なタスクの順序が表示されます。

1. オーケストレーションを検討した後で、Orchestrator Studioの上部にある「ツー ル」リンクをクリックします。

2. Orchestrator Studioの「ツール」ページで、「Orchestrator クライアント」アイコンをクリックします。

3. Orchestratorクライアントの「サイン・イン」画面で、EnterpriseOneセキュ リティ情報を入力し、「ログイン」をクリックします。

4. Orchestratorクライアントで、オーケストレーション名ド ロップダウン・リストをクリックし、AISサーバーで使用可能なオーケストレーションのリストを参照し ます。

5. このリストから「JDE_ORCH_Sample_UpdateMeterReadings」オー ケストレーションを選択します。

   Orchestratorクライアントに、サンプル・オーケストレーションで定義されている3つの入 力が自動的に表示されます。



6. 次の値を入力して、サードパーティ・デバイスからの入力をシミュレートします。
   • EquipmentNumber = (設備番 号) この値は、ホワイト・リストのEnterpriseOne相互参照レコードに対して入力した設備番号と同じである必 要があります。
   • NewFuelMeterReading = 任意の数値。
   • NewHourMeterReading = 任意の数値。
7. 「実行」ボタンをクリックしてオーケストレーションを実行します。

   「出力」ボックスの右上にある緑色のチェック・マークまたは黄色の警告記号は、オーケストレーション が正常に実行されたことを示します。

   「入力」ボックスには、IoTオーケストレータが生成し、AISサーバーで実行されているオーケスト レーションに送信したJSONデータが表示されます。「出力」ボックスには、IoTオーケストレータが 返したJSONデータが表示されます。

   

8. 警告記号が表示される場合は、「出力」ボックスの下部にスクロールして警告メッセージを表示します。
   警告は、オーケストレーションの失敗を意味するのではなく、次の例のように不規則または予期しない入力を示 す場合があります。

   

EquipmentNumberに無効な部品番号を入力して、別のテストを実行します。

緑色のチェック・マークで示されるように、オーケストレーションが正常に実行されたことに注目してください。 ただし、部品番号が無効であるため、EnterpriseOneにレコードは作成されていません。これは、「出 力」領域のホワイト・リスト・エラー・メッセージで示されています。

1. JD Edwards EnterpriseOne Webクライアントを実行しているブラウザ・セッションに戻ります。しばらく非アクティブだった場合は、ログアウトして再度ログインすることが必要な場合があります。
2. メーター示度アプリケーション(略式コマンド: P12120)を起動します。
3. 「スキップ先設備」フィールドで、設備番号を入力します。
4. 「オドメータ」チェックボックスをクリア(選択解除)し、「燃 料メーター」および「時間メーター」チェック・ ボックスを選択します。
5. 「検索」をクリックし、燃料メーター示度および時間メーター示度に IoTオーケストレータ・クライアントから入力した値が表示されていることを確認します。

このOBEでは、EnterpriseOneに相互参照レコードを追加して、オーケストレーション・ホワイ ト・リストで許可される設備番号を指定しました。さらに、その設備のメーター示度をEnterpriseOne のメーター示度(P12120)アプリケーションに送信するIoTデバイスをシミュレートしました。

• JD Edwards EnterpriseOne Internet of Things Orchestratorガイド
• LearnJDE.com のInternet of Thingsに関するページ