ルールを使用したRESTサービスとの統合方法
ルールを使用して、Oracle Fusion Customer Relationship Managementアプリケーション・コンポーザに登録されているRESTサービスでGET操作をコールできます。
品目ルールからのREST GETのコール
これらの関数のいずれかを使用して、サービスを介したデータへのアクセス方法およびRESTサービスによるデータの問合せの処理方法に応じて、RESTサービスのGET操作をコールできます。
機能 |
関数を使用して次のことを行います: |
---|---|
|
GETのq問合せパラメータに、名前と値の任意の組合せを渡します。 RESTサービスがアプリケーション・コンポーザでURLにトークンなしで登録されている場合に使用します。 |
|
属性を表すトークンの値を渡します。 RESTサービスがアプリケーション・コンポーザにURLのトークンで登録されている場合に使用します。 URLにトークンが含まれている場合、任意の問合せパラメータを渡すことはできません。 |
これらの機能の詳細は、品目ルール・ユーティリティ機能に関するトピックを参照してください。
次の点に注意してください。
-
ルールからRESTサービスを呼び出すには、次の項の説明に従って、まずサービス・アプリケーション・コンポーザを登録する必要があります。
-
名前/値問合せパラメータ・ペアのマップを
InvokeRestGet()
に渡すには、内部関数ToMap()
を使用します。 -
特定の文字と単語のエスケープを必要とする
InvokeRestGetWithTokens()
にトークンを渡す、または特定のエスケープおよび書式設定を必要とするInvokeRestGet()
をコールするときにq
パラメータを渡すには、内部Replace()
関数を使用して、属性値の"
を"
に置き換えるなど、文字エスケープを実行できます。
RESTサービスの登録
ルールからRESTサービスを呼び出す前に、そのサービスをアプリケーション・コンポーザに登録する必要があります。
RESTサービスの登録の詳細は、アプリケーション・コンポーザを使用したアプリケーションの構成ガイドに記載されています。 ステップのサマリーを次に示します:
-
webサービスをアプリケーション・コンポーザに登録するには、サンドボックス内にいる必要があります。 サンドボックスを作成して入力するには、次の手順を実行します。
-
アプリケーション実装コンサルタントの権限でサインインします。
-
ナビゲーション・メニューの構成セクションから「サンドボックス」を選択します。
-
「サンドボックスの作成」をクリックします。 サンドボックスの作成ページで、すべてのツール・リストで「アプリケーション・コンポーザ」を選択します。 「作成して入力」をクリックしてサンドボックスを入力します。
-
-
サンドボックスの内部で、ツール・メニューから「アプリケーション・コンポーザ」を選択します。
-
概要ページまたは左ペインの共通設定リストで、「Webサービス」リンクをクリックします。
-
ツールバーの「Webサービス参照の作成」ボタンをクリックし、「接続タイプの選択」ダイアログ・ボックスでRESTを選択し、OKをクリックします。
-
「REST Webサービス接続の作成」ページで、新しいRESTサービスの名前を選択します。この名前を使用して、品目ルールからRESTサービスをコールすることに注意してください。
-
「REST Webサービス接続の作成」ページで、URLフィールドにRESTサービスのURLを入力します。 たとえば、次のURLを使用して、製品管理データ・セキュリティRESTサービスを登録できます:
https://vision.com/fscmRestApi/resources/latest/productManagementDataSecurities
-
webサービスURLでトークンを指定するには、
##TOKEN_NAME##
という形式を使用します。 これらのトークンの値は、RESTサービスをコールするときに渡すことができます。 たとえば、次のURLを使用してPIMデータ・セキュリティRESTサービスを登録できます:https://vision.com/fscmRestApi/resources/latest/productManagementDataSecurities?q=ObjectName=Item;Principal=Person;Name=##USER_NAME##;ItemClass=##ITEM_CLASS##;OrganizationCode=##ORG_CODE##
このサービスを品目ルールからコールする場合、ルールはすべてのトークンの値を渡す必要があります。 この例では、URLにトークンUSER_NAME、ITEM_CLASSおよびORG_CODEが含まれ、これによって、ルールで特定のユーザー名、品目クラスおよび組織のデータ付与を問い合せることができます。
ノート:-
REST URLにトークンが含まれていない場合、品目ルールはGET操作をコールし、名前と値の任意の組合せをGETの
q
問合せパラメータに渡すことができます。 -
REST URLにトークンが含まれている場合、品目ルールはGET操作の呼出し時にこれらのトークンの値のみを渡すことができます。 URLにトークンが含まれている場合、任意の問合せパラメータを渡すことはできません。
-
-
「REST Webサービス接続の作成」ページでは、RESTサービスを呼び出すために使用する認証スキームを選択できます。 製品管理RESTサービスの場合、このスキームは通常、「Basic認証によるコール」または「SAMLを使用したユーザー・アイデンティティの伝播」のいずれかです。
-
「Basic認証によるコール」を選択した場合は、RESTサービスの呼出しに常に使用されるユーザー名とパスワードを設定します。 たとえば、ユーザー名とパスワード
JSmith
を設定し、xxyyzz99
を常にRESTサービスのコールに使用できます。 その場合、製品情報管理作業領域にアプリケーション実装コンサルタントとしてログインし、品目を作成した場合でも、ユーザー名とパスワードJSmith
およびxxyyzz99
を使用して、品目ルールからRESTサービスをコールします。「Basic認証によるコール」を選択する場合は、webサービスの呼出しに使用する資格証明を選択する必要があります。 「資格証明キー」フィールドの既存のエントリのいずれかを選択できます。 フィールドに正しい資格証明が存在しない場合は、「資格証明キーの作成」をクリックして、必要なユーザー名とパスワードで新しいキーを作成できます。
-
「SAMLを使用したユーザー・アイデンティティの伝播」を選択した場合、ユーザーが製品情報管理作業領域で品目を作成または編集しようとすると、品目ルールからRESTサービスをコールしようとしたときに、その同じユーザーの資格証明が使用されます。 たとえば、品目の作成時にアプリケーション実装コンサルタントとしてログインした場合、アプリケーション実装コンサルタントにRESTサービスをコールする権限がない場合は、品目ルールからのRESTサービスの起動は失敗します。
-
-
「REST Webサービス接続の作成」ページの「リソースに対するメソッドの選択および構成」セクションで、このRESTサービスで使用される操作を設定します。 この操作は品目ルールからコールされるため、ここでGETチェック・ボックスを選択する必要があります。 品目ルールからGET操作をコールする場合、次の設定のみがサポートされます。
設定
値
メソッド名
GET
書式
JSON
要求ペイロード
スキーマURL
応答ペイロード:
コード・サンプル
コード・サンプルを指定するには、RESTサービスのGET操作の出力からコピーされたサンプル・レスポンスを入力します。
-
「保存してクローズ」をクリックして、RESTサービスを保存します。
-
RESTサービスがアプリケーション・コンポーザに登録されたら、RESTサービスが品目ルールからアクセスできるように、サンドボックスを公開する必要があります。 サンドボックスを公開するには、サンドボックス・メニューから「公開」を選択し、「公開」ボタンをクリックします。