B2B相互参照の管理

取引パートナとメッセージを交換する場合、Oracle applicationsの特定のデータ要素の値は、取引パートナが提供する値とは異なる場合があります。

B2B相互参照を使用して、都道府県、国、通貨などの要素のパートナ値に値をマップできるようになりました。 たとえば、取引パートナは略称MAを使用し、完全な名前Massachusettsを使用できますが、相互参照では両方の用語をマップできます。

この機能の利点の一部を次に示します:

  • ユーザビリティの向上: 新しいアプローチにより、マッピングの設定と保守が簡素化されます。これは、チームがB2Bメッセージング・システムで相互参照を直接管理できるためです。 相互参照レコードの作成、編集または検索を迅速に行えます。
  • 効率性の向上:ドメイン値マップをサプライヤまたは顧客に関連付けるには、サプライヤまたは顧客のB2Bプロパティを作成する必要がなくなりました。
  • 階層参照: 特に複数のクオリファイアと属性が関係する場合、値マッピングの柔軟性と精度が向上します。 このプロセスでは、相互参照が存在しないかぎり、エラーを返さずに一致を検出する可能性が最大化されます。
  • 柔軟な値マッピング: メッセージ変換中に、XSLT内で使用される関数は、相互参照データから入力コードおよび修飾子と値のペアに基づいてマッピング値を取得します。

有効化および構成ステップ

この機能にアクセスするには、「B2Bメッセージングの構成と処理の簡素化」機能または「B2B相互参照の管理」機能を有効にします。

オプト・インした後、次のステップを実行して、B2B相互参照を設定および使用します。

  1. B2B相互参照を定義します。B2B相互参照には、コード、名前および説明があり、クオリファイアおよび属性で構成されます。
  2. B2B相互参照修飾子を追加します。
  3. B2B相互参照属性を追加します。
  4. 相互参照値の構成: 相互参照の構造を定義した後、クオリファイアと属性の組合せごとに値を入力できます。
  5. 検証: 相互参照値: このツールを使用すると、入力したクオリファイアの一致する属性を検索できます。
  6. 相互参照値のアップロードおよびダウンロード: B2B相互参照値でレコードをアップロードおよびダウンロードできます。
  7. 「XSL: XSLファイルを更新してb2bCrossRefLookup()関数を含める」というメッセージで相互参照参照参照参照参照を指定します。

B2B相互参照の定義

  1. 「タスク」パネル・タブからB2B「相互参照」を選択します。
  2. 「追加」をクリックして、新しいB2B相互参照を定義します。
  3. 詳細を入力し、「保存」をクリックします。

新しいB2B相互参照の追加

新しいB2B相互参照の追加

B2B相互参照修飾子の追加

  1. 「修飾子」タブで、「コード」、「名前」および「レベル」を入力します。
  2. 「アクション」で、「作成」をクリックしてエントリを追加します。
  3. 詳細を入力し、「保存」をクリックします。

B2B相互参照クオリファイア

B2B相互参照クオリファイア

B2B相互参照属性の追加

  1. 「属性」タブで、「コード」、「名前」および「レベル」を入力します。
  2. 「アクション」で、「作成」をクリックしてエントリを追加します。
  3. 詳細を追加した後、「保存」および「送信」をクリックします。

B2B相互参照属性

B2B相互参照属性

相互参照値の構成

  1. B2B「相互参照」ページで、「相互参照値」をクリックします。

B2B「相互参照- 相互参照値」アイコン

B2B「相互参照: 相互参照値」アイコン

  1. 前に作成したクオリファイアと属性は、列ヘッダーとして表示されます。
  2. 「追加」をクリックします。
  3. 詳細を入力し、「保存」をクリックします。

B2B相互参照値

B2B相互参照値

相互参照値の検証

  1. B2B相互参照値ページで、「検証」をクリックします。
  2. クオリファイア・フィールドごとに値を入力します。 一致する属性値が存在する場合は、結果に表示されます。

検証

検証

相互参照値のアップロードおよびダウンロード

  1. 「ダウンロード」をクリックして、.csvを生成し、コンピュータに保存します。
  2. 変更するには、.csvを開いて目的の値を変更します。 IDセルを値を変更せずにテキストとして書式設定します。
  3. 新しい行を追加するには、クオリファイアと属性値を入力します。 IDセルは空白のままにします。
  4. .csvを保存します。

既存の行に変更があり、新しい行が追加されたCSVファイル

既存の行に変更があり、新しい行が追加された.csvファイル

  1. 「アップロード」をクリックします。 ページに値が表示されます。

更新されたB2B相互参照値

更新されたB2B相互参照値

メッセージXSLでの相互参照参照の指定

  1. 「タスク」パネル・タブからB2B「メッセージ定義」を選択します。
  2. 「コラボレーション・メッセージ定義」で、メッセージの変換パッケージをエクスポートします。
  3. XSLフォルダにナビゲートし、ファイルを開きます。
  4. 次の更新を行います:
    1. 次のクラスをXSLの上部にあるネームスペース領域に追加する必要があります。

xmlns:b2bmessage="http://www.oracle.com/XSL/Transform/java/oracle.apps.cmk.model.B2BMessagingFunctions"

    1. b2bmessageをexclude-result-prefixesに追加する必要があります。

スタイルシート宣言領域

スタイルシート宣言領域

    1. 相互参照する必要があるdvm:lookupValueを探します。 たとえば、CURRENCY_CODEです。
    2. コメントアウト。
    3. b2bCrossRefLookup()関数を追加します。

<xsl:value-of select="b2bCrossRefLookup('DecisionCode','DefaultValue','AttributeCode','QualifierName1','QualifierValue1','QualifierName2','QualifierValue2',...)"/>

b2bCrossRefLookup()関数

b2bCrossRefLookup()関数

    1. XSLファイルの変更を保存します。
  2. B2B「メッセージ定義」> 「コラボレーション・メッセージ定義」タブで、変換パッケージをダウンロードしたメッセージの複製を作成します。 カスタマイズされたXSLをアップロードします。
  3. その他すべての詳細を追加した後、「発行」をクリックします。

重複メッセージ定義- カスタムXSLのアップロード

重複メッセージ定義- カスタムXSLのアップロード

  1. 次の残りの設定タスクに進みます。
    1. 事前定義済サービス・プロバイダの1つを使用しない場合は、プロバイダ(直接サービス・プロバイダおよびサービス・プロバイダ)を定義します。
    2. 配信方法を構成します。
    3. 事前定義済の接続を使用していない場合は、新しい接続を作成します。
    4. ドキュメント・プロパティを構成し、アウトバウンド・ドキュメントに接続を割り当てます。
  2. メッセージの処理後、変換されたファイルに属性の値が表示されます。

変換済メッセージ・ペイロード

変換済メッセージ・ペイロード

B2B相互参照値

B2B相互参照値- 構造

b2bCrossRefLookup()関数は、最初にFUSION_CURR_Q1=USD、FUSION_COUNTRY_Q2=USの一致を検索します。 見つからないため、最上位レベルの修飾子(FUSION_COUNTRY_Q2 = US)が削除されます。 この時点で、FUSION_CURR_Q1=USD (SUPPLIER_CURR_A1= USドル)の一致が検出されます。

b2bCrossRefLookup()関数

b2bCrossRefLookup()関数

ヒントと考慮事項

  • 修飾子は、同じように見えるエントリを区別するのに役立ちます。 相互参照に1つ以上の修飾子を追加することで、区別を明確にできます。
  • 属性は、修飾子によって導出された値を格納するために使用されるデータ要素です。
  • レベルは、参照操作中の階層または優先度を決定します。 上位レベルのクオリファイアおよび属性は、より具体的なものとみなされ、完全一致を見つけるために最初にチェックされます。
    • すべてのレベルを含む一致が検索されますが、存在しない場合、最上位レベルの修飾子は一致基準から削除されます。 これは、一致するものが見つかるまで続きます。 一致するものが見つからない場合は、関数で指定されたデフォルト値が返されます。
  • b2bCrossRefLookup()関数の引数は次のとおりです。
    • DecisionCode: 参照用のコンテキストまたはルール・セット。 たとえば、マップしようとしているのはCURRENCY、CARRIER、UOM_CODEなどです。
    • DefaultValue: 一致が見つからない場合に返される値。
    • AttributeCode: 値を必要とする特定のフィールド。
    • クオリファイア・ペア: 参照をさらに絞り込むために、クオリファイア名と値の1つ以上のペア。
  • SOA DVMは、元のXSL dvm:lookupValue実装を使用する場合でも機能します。
  • 同じB2B相互参照構造をアウトバウンド・メッセージとインバウンド・メッセージの両方に使用することはできません。 方向ごとに1つの設定が必要です。
  • B2B相互参照値タスクにエントリが追加されておらず、エントリを一括でアップロードする場合は、「ダウンロード」をクリックして空の.csvを生成します。 クオリファイアと属性値を入力し、IDを空白のままにします。

アクセス要件

次の権限を含む構成済ジョブ・ロールが割り当てられているユーザーは、この機能にアクセスできます。

  • Webサービスによるコラボレーション・メッセージ定義の管理(CMK_MANAGE_COLLAB_MESG_DEFINITION_WEB_SERVICE_PRIV)
  • Webサービスによるコラボレーション・メッセージ定義の表示(CMK_VIEW_COLLAB_MESG_DEFINITION_WEB_SERVICE_PRIV)

これらの権限は、この更新の前から使用可能でした。