1. 製品管理の実装
  2. ルールを使用したRESTサービスとの統合方法
機械翻訳について

ルールを使用したRESTサービスとの統合方法

ルールを使用して、Oracle Fusion Customer Relationship Managementアプリケーション・コンポーザに登録されているRESTサービスでGET操作をコールできます。

品目ルールからのREST GETのコール

これらの関数のいずれかを使用して、サービスを介したデータへのアクセス方法およびRESTサービスによるデータの問合せの処理方法に応じて、RESTサービスのGET操作をコールできます。

機能

関数を使用して次のことを行います: 

InvokeRestGet(
rest_service_name, 
map_of_query_parameters, 
return_value_expression, 
http_header_map)

GETのq問合せパラメータに、名前と値の任意の組合せを渡します。

RESTサービスがアプリケーション・コンポーザでURLにトークンなしで登録されている場合に使用します。 

InvokeRestGetWithTokens(
rest_service_name, 
token_value1, ... , token_value_n, 
return_value_expression)

属性を表すトークンの値を渡します。

RESTサービスがアプリケーション・コンポーザにURLのトークンで登録されている場合に使用します。

URLにトークンが含まれている場合、任意の問合せパラメータを渡すことはできません。

これらの機能の詳細は、品目ルール・ユーティリティ機能に関するトピックを参照してください。

次の点に注意してください。

  • ルールからRESTサービスを呼び出すには、次の項の説明に従って、まずサービス・アプリケーション・コンポーザを登録する必要があります。

  • 名前/値問合せパラメータ・ペアのマップをInvokeRestGet()に渡すには、内部関数ToMap()を使用します。

  • 特定の文字と単語のエスケープを必要とするInvokeRestGetWithTokens()にトークンを渡す、または特定のエスケープおよび書式設定を必要とするInvokeRestGet()をコールするときにqパラメータを渡すには、内部Replace()関数を使用して、属性値の"を"に置き換えるなど、文字エスケープを実行できます。

RESTサービスの登録

ルールからRESTサービスを呼び出す前に、そのサービスをアプリケーション・コンポーザに登録する必要があります。

RESTサービスの登録の詳細は、アプリケーション・コンポーザを使用したアプリケーションの構成ガイドに記載されています。 ステップのサマリーを次に示します:

  1. webサービスをアプリケーション・コンポーザに登録するには、サンドボックス内にいる必要があります。 サンドボックスを作成して入力するには、次の手順を実行します。

    1. アプリケーション実装コンサルタントの権限でサインインします。

    2. ナビゲーション・メニューの構成セクションから「サンドボックス」を選択します。

    3. 「サンドボックスの作成」をクリックします。 サンドボックスの作成ページで、すべてのツール・リストで「アプリケーション・コンポーザ」を選択します。 「作成して入力」をクリックしてサンドボックスを入力します。

  2. サンドボックスの内部で、ツール・メニューから「アプリケーション・コンポーザ」を選択します。

  3. 概要ページまたは左ペインの共通設定リストで、「Webサービス」リンクをクリックします。

  4. ツールバーの「Webサービス参照の作成」ボタンをクリックし、「接続タイプの選択」ダイアログ・ボックスでRESTを選択し、OKをクリックします。

  5. 「REST Webサービス接続の作成」ページで、新しいRESTサービスの名前を選択します。この名前を使用して、品目ルールからRESTサービスをコールすることに注意してください。

  6. 「REST Webサービス接続の作成」ページで、URLフィールドにRESTサービスのURLを入力します。 たとえば、次のURLを使用して、製品管理データ・セキュリティRESTサービスを登録できます: 

    https://vision.com/fscmRestApi/resources/latest/productManagementDataSecurities

  7. 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にトークンが含まれている場合、任意の問合せパラメータを渡すことはできません。

  8. 「REST Webサービス接続の作成」ページでは、RESTサービスを呼び出すために使用する認証スキームを選択できます。 製品管理RESTサービスの場合、このスキームは通常、「Basic認証によるコール」または「SAMLを使用したユーザー・アイデンティティの伝播」のいずれかです。

    • 「Basic認証によるコール」を選択した場合は、RESTサービスの呼出しに常に使用されるユーザー名とパスワードを設定します。 たとえば、ユーザー名とパスワードJSmithを設定し、xxyyzz99を常にRESTサービスのコールに使用できます。 その場合、製品情報管理作業領域にアプリケーション実装コンサルタントとしてログインし、品目を作成した場合でも、ユーザー名とパスワードJSmithおよびxxyyzz99を使用して、品目ルールからRESTサービスをコールします。

      「Basic認証によるコール」を選択する場合は、webサービスの呼出しに使用する資格証明を選択する必要があります。 「資格証明キー」フィールドの既存のエントリのいずれかを選択できます。 フィールドに正しい資格証明が存在しない場合は、「資格証明キーの作成」をクリックして、必要なユーザー名とパスワードで新しいキーを作成できます。

    • 「SAMLを使用したユーザー・アイデンティティの伝播」を選択した場合、ユーザーが製品情報管理作業領域で品目を作成または編集しようとすると、品目ルールからRESTサービスをコールしようとしたときに、その同じユーザーの資格証明が使用されます。 たとえば、品目の作成時にアプリケーション実装コンサルタントとしてログインした場合、アプリケーション実装コンサルタントにRESTサービスをコールする権限がない場合は、品目ルールからのRESTサービスの起動は失敗します。

  9. 「REST Webサービス接続の作成」ページの「リソースに対するメソッドの選択および構成」セクションで、このRESTサービスで使用される操作を設定します。 この操作は品目ルールからコールされるため、ここでGETチェック・ボックスを選択する必要があります。 品目ルールからGET操作をコールする場合、次の設定のみがサポートされます。

    設定

    値

    メソッド名

    GET

    書式

    JSON

    要求ペイロード

    スキーマURL

    応答ペイロード:

    コード・サンプル

    コード・サンプルを指定するには、RESTサービスのGET操作の出力からコピーされたサンプル・レスポンスを入力します。

  10. 「保存してクローズ」をクリックして、RESTサービスを保存します。

  11. RESTサービスがアプリケーション・コンポーザに登録されたら、RESTサービスが品目ルールからアクセスできるように、サンドボックスを公開する必要があります。 サンドボックスを公開するには、サンドボックス・メニューから「公開」を選択し、「公開」ボタンをクリックします。

関連トピック