Order ManagementとAccounts Receivableの間の独自のヘッダー属性の統合
この例では、オーダー管理のオーダー・ヘッダーの拡張可能フレックスフィールドを使用して、プライマリ営業担当を取得します。
次に、インタフェース明細のResourceSalesPersonId属性を介してその値を売掛管理に送信し、売掛管理が請求書に表示できるようにします。
仕組み
ノート
-
拡張可能フレックスフィールドは、「設定および保守」作業領域で作成します。
-
オーダー入力スペシャリストは、拡張可能フレックスフィールドを使用して、オーダー管理作業領域のオーダー・ヘッダーにプライマリ営業担当を設定します。
-
価格設定管理作業領域を使用して、サービス・マッピングを作成します。 マッピングでは、フレックスフィールドのビュー・オブジェクトとビュー属性を使用して、売掛管理にマップします。
-
価格設定管理作業領域を使用して、ペイロードを売掛管理に送信するときにフレックスフィールドから営業担当を含めるようにオーダー管理に指示する統合アルゴリズムを作成します。
-
売掛管理マネージャは請求作業領域を使用して販売オーダーの請求書を開き、営業担当属性で営業担当を表示します。
設定のサマリー
-
設定を準備します。
-
拡張可能フレックスフィールドを作成します。
-
ビュー・オブジェクトを識別します。
-
サービス・マッピングを編集します。
-
統合アルゴリズムの変更。
-
設定をテストします。
このトピックではサンプル値を使用します。 ビジネス要件によっては、別の値が必要になる場合があります。
設定の準備
-
ダウンストリーム統合用にカスタム・ペイロード使用可能機能の請求書オプションを有効にします。
詳細は、「オーダー管理と他のOracle Applicationsとの統合の開始」を参照してください。
-
サンド・ボックスを作成し、サンド・ボックスでサービス・マッピング・ツールとフレックスフィールド・ツールをアクティブ化します。
詳細は、「サービス・マッピングを編集できるようにサンドボックスを作成」を参照してください。
拡張可能フレックスフィールドの作成
オーダー・エントリ・スペシャリストがオーダー・ヘッダーでプライマリ営業担当を設定するために使用する拡張可能フレックスフィールドを作成します。
-
「設定および保守」作業領域で、タスクに移動します。
-
オファリング: オーダー管理
-
機能領域: オーダー
-
タスク: オーダーの拡張可能フレックスフィールドの管理
-
-
「オーダーの拡張可能フレックスフィールドの管理」ページで、値を検索します。
属性
値
名前
ヘッダー情報
これは、オーダー・ヘッダーで使用できる事前定義の拡張可能フレックスフィールドです。
-
検索結果で、「処理」>「編集」をクリックします。
-
コンテキストを作成します。
-
「拡張可能フレックスフィールドの編集」ページで、「コンテキストの管理」をクリックします。
-
「コンテキストの管理」ページで、「処理」>「作成」をクリックします。
-
「コンテキストの作成」ページで値を設定し、「保存してクローズ」をクリックします。
属性
値
表示名
プライマリ営業担当
コード
プライマリ営業担当
API名
primarySalesperson
使用可能
使用可能。
動作
単一行
-
コンテキスト使用領域で、「処理」>「作成」をクリックし、値を設定します。
属性
値
名前
追加ヘッダー情報
-
「保存」をクリックします。
-
コンテキスト依存セグメント領域で、「処理」>「作成」をクリックします。
-
「セグメントの作成」ページで値を設定し、「保存してクローズ」をクリックします。
属性
値
名前
プライマリ営業担当
コード
プライマリ営業担当
API名
primarySalesperson
使用可能
使用可能。
データ型
文字
表の列
利用可能なアドオンを選択してください。
値セット
30 文字
プロンプト
プライマリ営業担当
表示タイプ
値リスト
-
「拡張可能フレックスフィールドの編集」ページが表示されるまで、現在のページおよび後続ページで保存してクローズをクリックします。
-
カテゴリ領域で、表示名属性に追加ヘッダー情報がある「行」をクリックします。
-
追加ヘッダー情報の詳細領域の「関連コンテキスト」タブで、「処理」>「選択して追加」をクリックします。
-
プライマリ営業担当コンテキストを追加します。
-
「拡張可能フレックスフィールドの編集」ページで、「保存してクローズ」をクリックします。
-
「オーダーの拡張可能フレックスフィールドの管理」ページで、名前属性にヘッダー情報を含む検索結果で「メロディ」を選択し、「フレックスフィールドのデプロイ」をクリックします。
-
確認ダイアログで、デプロイメントが正常に終了したことを確認し、OKをクリックします。
-
ビュー・オブジェクトの識別
サービス・マッピングで必要なビュー・オブジェクトおよび属性の名前を取得します。
-
拡張可能フレックスフィールドをダウンロードして開きます。
-
「処理」>「フレックスフィールド・アーカイブのダウンロード」をクリックし、処理が終了するまで待機してから、確認ダイアログで「ダウンロード」をクリックします。
-
表示されるダイアログで、ファイルを目的のロケーションに保存します。
-
ブラウザのダウンロード機能を使用して、アーカイブに移動します。
たとえば、Firefoxを使用している場合は、上部バナーの「下向き矢印」をクリックし、
C:\Users\your_name\Downloads\10008_DOO_HEADERS_ADD_INFO.zip
などの10008_DOO_HEADERS_ADD_INFOファイルに移動します。 -
10008_DOO_HEADERS_ADD_INFO.zipを解凍します。
-
フォルダ
C:\Users\user_name \Downloads\ 10008_DOO_HEADERS_ADD_INFO.zip\oracle\apps\scm\doo\processOrder\flex\headerContextsB\view
に移動します。 -
XMLエディタを使用して、
HeaderEffBPrimary__Sales__RepresentativeprivateVO.xml
ファイルを開きます。
-
-
ビュー・オブジェクトの名前を指定します。
-
ビュー・オブジェクトの名前属性を検索し、その値を書き留めます。 これはコードの4行目になります。
<ViewObject xmlns="http://xmlns.oracle.com/bc4j" Name="HeaderEffBPrimary__Sales__RepresentativeprivateVO"
この例では、値は
HeaderEffBPrimary__Sales__RepresentativeprivateVO
です。
-
-
ビュー属性の名前属性を検索し、その値を書き留めます。
ViewAttribute Name="primarySalesperson"
この例では、値は
primarySalesperson
です。フレックスフィールド・アーカイブには多数の属性があるため、必ず正しい属性を指定してください。
サービス・マッピングの編集
オーダー管理が売掛管理との統合に使用するサービス・マッピングを編集します。
-
価格設定管理作業領域に移動します。
-
「タスク」をクリックし、Order Management Configurationの下の「サービス・マッピングの管理」をクリックします。
-
「サービス・マッピングの管理」ページの名前列で、FulfillmentIntegrationをクリックします。
-
拡張可能フレックスフィールドのエンティティを追加します。
-
「サービス・マッピングの編集」ページのエンティティ・タブで、「処理」>「行の追加」をクリックし、値を設定します。
属性
値
エンティティ
HeaderEFF_Custom
作成した新しいエンティティに
_Custom
サフィクスを含める必要があります。拡張可能フレックスフィールド用に作成する新しいエンティティには、
EFF_Custom
サフィクスを含める必要があります。説明
オーダー・ヘッダーに営業担当を格納する拡張可能フレックスフィールドです。
-
詳細領域で属性を追加し、「保存」をクリックします。
属性
タイプ
HeaderId_Custom
Long
SalesPersonId_Custom
Long
Allow Null属性を有効にします。 他のすべての属性は現在の値のままにします。
付加フレックスフィールドの対応する属性に指定する属性ごとに、同じタイプを使用する必要があります。 同じデータ型を使用しない場合、コンパイル時にサービス・マッピングが失敗しない可能性がありますが、ランタイム環境では失敗します。 エラーは発生しない可能性がありますが、設定が期待どおりに機能しない可能性があるため、ランタイム障害のトラブルシューティングが困難な場合があります。
-
-
ソースを変更します。
-
「ソース」をクリックします。
-
ソース・リストで、値を持つ「行」をクリックします。
属性
値
Source
InvoiceSources
-
InvoiceSourcesの詳細領域で、「表示」>「列」をクリックし、結合エンティティおよび結合エンティティ属性を有効にします。
-
「エンティティ・マッピング」タブで、「処理」>「行の追加」をクリックして値を設定し、「保存」をクリックします。
属性
値
エンティティ
HeaderEFF_Custom
タイプ
ビュー・オブジェクト
ビュー・オブジェクト
HeaderEffBPrimary__Sales__RepresentativeprivateVO
この値は、フレックスフィールド・アーカイブをダウンロードしたときにこの手順で前述したビュー・オブジェクトの名前です。
問合せタイプ
結合
問合せ属性
HeaderId
請求書サービスは主に履行明細を参照するため、履行明細からHeaderIdを問い合せます。 結合エンティティを使用してHeaderId問合せ属性と履行明細間の関係を作成し、結合エンティティ属性を使用して結合エンティティの識別方法を指定します。
結合エンティティ
FulfilLine
結合エンティティ属性
FulfilLineId
-
「属性マッピング」タブで、カスタム属性を追加し、「保存」をクリックします。
属性
ビュー・オブジェクト属性
HeaderId_Custom
HeaderId
SalesPersonId_Custom
primarySalesperson
この値は、フレックスフィールド・アーカイブをダウンロードしたときにこの手順で前述したViewAttributeの名前です。
-
「エンティティ・マッピング」タブで、エンティティ列にARInterfaceLineがある「行」をクリックします。
オーダー管理では、ARInterfaceLineエンティティを使用して、売掛管理に送信するペイロードの属性値を通信します。 この属性をソースに追加します。 後で、サービスにも追加します。
-
ARInterfaceLineの詳細領域で属性を追加し、「保存」をクリックします。
属性
値
属性
ResourceSalesrepId
ビュー・オブジェクト属性および式属性は空のままにします。 このトピックで設定する統合アルゴリズムでは、オーダー・ヘッダーの拡張可能フレックスフィールドを使用してこれらの値を決定します。
-
-
オーダー管理が売掛/未収金との通信に使用するサービスを変更します。
-
「サービス」をクリックします。
-
サービス・リストで、値を持つ「行」をクリックします。
属性
値
サービス
InvoiceService
-
InvoiceServiceの詳細領域で、「処理」>「行の追加」をクリックし、値を設定して、「保存」をクリックします。
属性
値
エンティティ
HeaderEFF_Custom
別名
空のままにします
読取
使用可能
書込み
使用可能
その他の属性はデフォルト値のままにします。
-
ページの下部にあるHeaderEFF_Customエンティティ領域で、オーダー管理がInvoiceServiceを介して通信できるようにカスタム属性を追加します。
属性
値
HeaderId_Custom
空のままにします
SalesPersonId_Custom
空のままにします
追加する各属性の読取り属性および書込み属性を有効にします。
-
InvoiceServiceの詳細領域で、エンティティ列にARInterfaceLineがある「行」をクリックします。
-
ARInterfaceLineエンティティ領域で、属性を追加します。
属性
値
属性
ResourceSalesrepId
-
「保存して閉じる」をクリックします
-
統合アルゴリズムの変更
必要なロジックを実装するには、別のヘルプ・トピックから統合アルゴリズムを変更します。
-
統合アルゴリズムを作成します。 詳細は、「統合アルゴリズムを使用した複雑なロジックの実装」を参照してください。
-
新しいデータ・セットを追加します。
属性
値
名前
HeaderEFF
変数パス
ARIntegration.HeaderEFF_Custom
プライマリ
使用不可
カーディナリティ
0または1つ
データ・セット結合
[HeaderId_Custom:(Fline.HeaderId)]
-
条件付きアクションにコードを追加します。 コードの最後に新しい行として追加します。
ARLine.ResourceSalesrepId=HeaderEFF.SalesPersonId_Custom
このコードは、HeaderEFFフレックスフィールドのSalesPersonId_Custom属性から営業担当の値を取得し、ARLineデータ・セットのResourceSalesrepId属性に格納するように指定します。
-
条件付きアクションに追加したコードをコピーし、デフォルトのアクションでコードの末尾を新しい行に貼り付けます。
変更するアルゴリズムには、カバレッジ品目を含むオーダー明細に対する条件付き処理と、対象品目を含む明細に対するデフォルト処理があります。 明細の品目がカバレッジ品目か対象品目かに関係なく、ARLineデータ・セットに移入する必要があるため、条件処理とデフォルト処理に同じコードを追加します。
このデータ・セットを使用して、オーダー・ヘッダーの拡張可能フレックスフィールドに必要な値があることを確認します。
-
アルゴリズムを公開します。
設定のテスト
-
販売オーダーを作成します。
-
オーダー管理作業領域に移動し、販売オーダーを作成し、オーダー明細を追加します。
-
オーダー・ヘッダーで、「処理」>「追加情報の編集」をクリックします。
作業領域に「追加情報」ダイアログが表示されます。 このダイアログには、オーダー・ヘッダーに作成した拡張可能フレックスフィールドがデフォルトで表示されます。
-
「追加情報」ダイアログに、フレックスフィールド・コンテキストである営業担当領域が表示され、この領域にプライマリ営業担当属性が表示されていることを確認します。
-
Primary Sales RepをDiane Choに設定します。
-
「送信」をクリックします。
オーダー番号が54758であるとします。
-
-
オーダー管理が売掛管理にデータを正しく送信することを確認します。
-
売掛管理の管理に必要な権限があることを確認します。 詳細は、「Order Managementの実装に必要な権限」を参照してください。
-
請求作業領域に移動し、「タスク」>「トランザクションの管理」をクリックします。
詳細は、「売掛/未収金クレジットの現金化の使用」に移動し、売掛/未収金トランザクションを完了するための要件を検索します。
-
「トランザクションの管理」ページで、トランザクションを検索します。
属性
値
ビジネス・ユニット
Vision Operations
トランザクション・ソース
分散オーダー・オーケストレーション
リファレンス
54758
-
「トランザクションのレビュー」ページの一般情報領域で、オーダー管理のオーダー・ヘッダーに設定した値と同じ値であるDiane Choが営業担当属性に含まれていることを確認します。
-