376
Oracle XML Gateway ユーザーズ・ガイド リリース 11i 2003 3 部品番号:J07398-01

Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

  • Upload
    others

  • View
    5

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle XML Gateway

ユーザーズ・ガイド

リリース 11i

2003 年 3 月

部品番号:J07398-01

Page 2: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle XML Gateway ユーザーズ・ガイド , リリース 11i

部品番号:J07398-01

原本名:Oracle XML Gateway User’s Guide, Release 11i

原本部品番号:A90250-03

原本著者:Leslie Studdard

原本協力者:Janet Lee, Debbie Quezadaz, Bonnie Williams, Mark Craig, Rita Diwan, Fred Graham, Kevin Hudson, Adrian Hunt, Clara Jaeckel, Donna Ng, Sowmya Ramani, Vebhhav Singh, Veshaal Singh, Melanie Tai, Mildred Wang

Copyright © 2001, 2002, Oracle Corporation. All rights reserved.

Printed in Japan.

制限付権利の説明

プログラム(ソフトウェアおよびドキュメントを含む)の使用、複製または開示は、オラクル社との契約に記された制約条件に従うものとします。著作権、特許権およびその他の知的財産権に関する法律により保護されています。

当プログラムのリバース・エンジニアリング等は禁止されております。

このドキュメントの情報は、予告なしに変更されることがあります。オラクル社は本ドキュメントの無謬性を保証しません。

* オラクル社とは、Oracle Corporation(米国オラクル)または日本オラクル株式会社(日本オラクル)を指します。

危険な用途への使用について

オラクル社製品は、原子力、航空産業、大量輸送、医療あるいはその他の危険が伴うアプリケーションを用途として開発されておりません。オラクル社製品を上述のようなアプリケーションに使用することについての安全確保は、顧客各位の責任と費用により行ってください。万一かかる用途での使用によりクレームや損害が発生いたしましても、日本オラクル株式会社と開発元である Oracle Corporation(米国オラクル)およびその関連会社は一切責任を負いかねます。 当プログラムを米国国防総省の米国政府機関に提供する際には、『Restricted Rights』と共に提供してください。この場合次の Notice が適用されます。

Restricted Rights Notice

Programs delivered subject to the DOD FAR Supplement are "commercial computer software" and use, duplication, and disclosure of the Programs, including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR 52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065.

このドキュメントに記載されているその他の会社名および製品名は、あくまでその製品および会社を識別する目的にのみ使用されており、それぞれの所有者の商標または登録商標です。

Page 3: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

目次目次目次目次

はじめにはじめにはじめにはじめに ........................................................................................................................................................................... ix

対象読者 .............................................................................................................................................................. ix

このマニュアルの使用方法 .............................................................................................................................. ix

その他の情報ソース .......................................................................................................................................... xi

データベース・ツールによる Oracle Applications データの変更の禁止 .............................................. xvi

オラクル社について ........................................................................................................................................ xvi

1 Oracle XML Gateway の概要の概要の概要の概要

XML Gateway の概要の概要の概要の概要 ........................................................................................................................................... 1-1XML 標準 ......................................................................................................................................................... 1-1

XML Gateway の概要 .................................................................................................................................... 1-1

XML Gateway の機能 .................................................................................................................................... 1-2

XML Gateway のアーキテクチャ ................................................................................................................ 1-3

XML メッセージおよび EDI トランザクション ...................................................................................... 1-10

まとめ ............................................................................................................................................................. 1-10

2 Message DesignerMessage Designer の概要の概要の概要の概要 .................................................................................................................................... 2-1

Message Designer のメニュー ...................................................................................................................... 2-2

Message Designer のツールバー .................................................................................................................. 2-4

Message Designer のボタン .......................................................................................................................... 2-5

「File」>「Properties」メニュー ................................................................................................................ 2-5

i

Page 4: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer のウィザードのウィザードのウィザードのウィザード ...................................................................................................................... 2-13

「Data Definition Creation」ウィザードの処理フロー ........................................................................... 2-15

「Map Creation」ウィザードの処理フロー .............................................................................................. 2-16

「「「「Data Definition Creation」ウィザードの使用」ウィザードの使用」ウィザードの使用」ウィザードの使用 ............................................................................................. 2-18

「Data Definition Creation」ウィザードのステップ ............................................................................... 2-19

Message Designer の「Data Definition」ウィンドウ ............................................................................ 2-21

「「「「Map Creation」ウィザードの使用」ウィザードの使用」ウィザードの使用」ウィザードの使用 .................................................................................................................. 2-22「「「「Transaction Map」ウィンドウ」ウィンドウ」ウィンドウ」ウィンドウ ........................................................................................................................ 2-41

ソースの定義 ................................................................................................................................................. 2-41

トランザクション・マップ - ターゲットの定義 ..................................................................................... 2-50

トランザクション・マップ - 「Level Mapping」タブ .......................................................................... 2-58

トランザクション・マップ - 要素のマッピング ..................................................................................... 2-63

トランザクション・マップ - 処理 ............................................................................................................. 2-67

Map Action Editor ............................................................................................................................................... 2-70

概要 ................................................................................................................................................................. 2-71

Map Action Editor - 割当て : 変数値の割当て ......................................................................................... 2-76

Map Action Editor - 割当て : グローバル変数の作成 ............................................................................. 2-77

Map Action Editor - データベース機能 : 次の連番値の割当て ............................................................. 2-78

Map Action Editor - データベース機能 : WHERE 句の追加 ................................................................. 2-79

Map Action Editor - データベース機能 : データベース表への挿入 ..................................................... 2-82

Map Action Editor - 導出 : 事業所コードからの所在地 ID の導出 ....................................................... 2-82

Map Action Editor - 導出 : 事業所コードからの親 ID の導出 ............................................................... 2-84

Map Action Editor - 関数コール : 関数コールの実行 ............................................................................. 2-85

Map Action Editor - 算術関数 .................................................................................................................... 2-86

Map Action Editor - OAG DATETIME への変換 .................................................................................... 2-87

Map Action Editor - OAG OPERAMT への変換 ..................................................................................... 2-88

Map Action Editor - OAG QUANTITY への変換 ................................................................................... 2-90

Map Action Editor - OAG AMOUNT への変換 ..................................................................................... 2-91

Map Action Editor - OAG DATETIME からの変換 ................................................................................ 2-93

Map Action Editor - OAG OPERAMT からの変換 ................................................................................. 2-94

Map Action Editor - OAG の数量からの変換 .......................................................................................... 2-96

Map Action Editor - OAG AMOUNT からの変換 .................................................................................. 2-97

Map Action Editor - その他 : プログラムの終了 ..................................................................................... 2-99

Map Action Editor - 事前定義済変数値の取得 ........................................................................................ 2-99

Map Action Editor - プロシージャ・コール : プロシージャの実行 ................................................... 2-102

ii

Page 5: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor - リターン・エラー・メッセージ : エラー・メッセージの送信 ....................... 2-106

Map Action Editor - 文字列関数 : 連結の実行 ....................................................................................... 2-108

Map Action Editor - 文字列関数 : サブ文字列の実行 ........................................................................... 2-109

Map Action Editor - XSLT 変換 ................................................................................................................ 2-110

DTD の拡張方法の拡張方法の拡張方法の拡張方法 ................................................................................................................................................ 2-110引渡しメッセージのマッピング方法引渡しメッセージのマッピング方法引渡しメッセージのマッピング方法引渡しメッセージのマッピング方法 ............................................................................................................... 2-112API へのマッピング方法へのマッピング方法へのマッピング方法へのマッピング方法 ................................................................................................................................... 2-112メッセージ・マップおよびメッセージ・マップおよびメッセージ・マップおよびメッセージ・マップおよび DTD のロード方法のロード方法のロード方法のロード方法 ........................................................................................... 2-113

マップのロード ........................................................................................................................................... 2-113

DTD のロード ............................................................................................................................................. 2-115

3 XML Gateway の設定の設定の設定の設定

設定概要設定概要設定概要設定概要 ................................................................................................................................................................... 3-1システム・プロファイル値の定義システム・プロファイル値の定義システム・プロファイル値の定義システム・プロファイル値の定義 ....................................................................................................................... 3-2XML Gateway 職責の定義職責の定義職責の定義職責の定義 ................................................................................................................................... 3-3

UTL_FILE_DIR パラメータの定義パラメータの定義パラメータの定義パラメータの定義 ..................................................................................................................... 3-3「ハブ定義」フォーム「ハブ定義」フォーム「ハブ定義」フォーム「ハブ定義」フォーム ............................................................................................................................................. 3-4「「「「XML 標準の定義」フォーム標準の定義」フォーム標準の定義」フォーム標準の定義」フォーム ............................................................................................................................... 3-6「トランザクションの定義」フォーム「トランザクションの定義」フォーム「トランザクションの定義」フォーム「トランザクションの定義」フォーム ................................................................................................................ 3-7

「トランザクションの定義」フォームのフィールド ............................................................................... 3-10

トランザクション・タイプおよびトランザクション・サブタイプの命名規則 ................................. 3-11

OAG 標準での VERB および NOUN の設定 ........................................................................................... 3-13

参照値の定義参照値の定義参照値の定義参照値の定義 ......................................................................................................................................................... 3-14取引先の設定取引先の設定取引先の設定取引先の設定 ......................................................................................................................................................... 3-17

必要な通信データ ......................................................................................................................................... 3-25

静的および動的ルーティング ..................................................................................................................... 3-26

コード変換コード変換コード変換コード変換 ............................................................................................................................................................. 3-31コード・カテゴリ ......................................................................................................................................... 3-35

コード変換値へのアクセス ......................................................................................................................... 3-35

「標準コード変換」フォーム ....................................................................................................................... 3-39

「取引先コード変換」フォーム「取引先コード変換」フォーム「取引先コード変換」フォーム「取引先コード変換」フォーム ........................................................................................................................... 3-42

4 実行エンジン実行エンジン実行エンジン実行エンジン

実行エンジンの概要実行エンジンの概要実行エンジンの概要実行エンジンの概要 ............................................................................................................................................... 4-1XML Gateway エンベロープエンベロープエンベロープエンベロープ ............................................................................................................................... 4-5

iii

Page 6: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのための取引先の検証インバウンド・メッセージのための取引先の検証インバウンド・メッセージのための取引先の検証インバウンド・メッセージのための取引先の検証 ........................................................................................... 4-8

「取引先設定」フォームのデータに照らした検証 ................................................................................... 4-10

アウトバウンド・メッセージのための取引先の検証アウトバウンド・メッセージのための取引先の検証アウトバウンド・メッセージのための取引先の検証アウトバウンド・メッセージのための取引先の検証 ..................................................................................... 4-11OAG 確認ビジネス・オブジェクト文書の実装方法確認ビジネス・オブジェクト文書の実装方法確認ビジネス・オブジェクト文書の実装方法確認ビジネス・オブジェクト文書の実装方法 ...................................................................................... 4-12

確認メッセージの目的 ................................................................................................................................. 4-12

確認メッセージの構成 ................................................................................................................................. 4-12

XML Gateway のシードされた確認メッセージ・マップ ...................................................................... 4-12

E-Business Suite のシードされたイベントおよびイベント・サブスクリプション ........................... 4-13

シードされた確認メッセージを実装したり使用不可にする方法 ......................................................... 4-14

5 メッセージ・キューメッセージ・キューメッセージ・キューメッセージ・キュー

キューキューキューキュー ....................................................................................................................................................................... 5-1

アウトバウンド・キュー ............................................................................................................................... 5-2

インバウンド・キュー ................................................................................................................................... 5-3

Oracle Transport Agent のインバウンドの送信 HTML ページ .............................................................. 5-4

XML Gateway のメッセージ・フォーマット ............................................................................................ 5-6

6 Oracle XML Gateway とととと Oracle Workflow 業務イベント・システムの統合業務イベント・システムの統合業務イベント・システムの統合業務イベント・システムの統合

Oracle XML Gateway とととと Oracle Workflow 業務イベント・システムの統合業務イベント・システムの統合業務イベント・システムの統合業務イベント・システムの統合 ............................................. 6-1概要 ................................................................................................................................................................... 6-1

Oracle Workflow Builder - 項目タイプ項目タイプ項目タイプ項目タイプ ............................................................................................................. 6-4項目タイプのコンポーネント ....................................................................................................................... 6-4

XML Gateway 標準項目タイプ .................................................................................................................... 6-5

XML Gateway エラー・プロセス項目タイプ ............................................................................................ 6-6

E-Business Suite アプリケーションのモジュール固有項目タイプ ......................................................... 6-7

XML Gateway 標準項目タイプ標準項目タイプ標準項目タイプ標準項目タイプ ........................................................................................................................... 6-7

機能 ................................................................................................................................................................... 6-8

イベント ......................................................................................................................................................... 6-23

選択肢タイプ ................................................................................................................................................. 6-25

XML Gateway エラー・プロセス項目タイプエラー・プロセス項目タイプエラー・プロセス項目タイプエラー・プロセス項目タイプ ................................................................................................. 6-28属性 ................................................................................................................................................................. 6-28

プロセス ......................................................................................................................................................... 6-29

通知 ................................................................................................................................................................. 6-39

機能 ................................................................................................................................................................. 6-41

イベント ......................................................................................................................................................... 6-43

iv

Page 7: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

メッセージ ..................................................................................................................................................... 6-44

選択肢タイプ ................................................................................................................................................. 6-48

Oracle の作成済インバウンド・メッセージの構成の作成済インバウンド・メッセージの構成の作成済インバウンド・メッセージの構成の作成済インバウンド・メッセージの構成 ........................................................................................ 6-51Oracle の作成済アウトバウンド・メッセージの構成の作成済アウトバウンド・メッセージの構成の作成済アウトバウンド・メッセージの構成の作成済アウトバウンド・メッセージの構成 .................................................................................... 6-52

アプリケーション統合のためのアプリケーションアプリケーション統合のためのアプリケーションアプリケーション統合のためのアプリケーションアプリケーション統合のためのアプリケーション ......................................................................................... 6-55インバウンド・オプション ......................................................................................................................... 6-55

アウトバウンド・オプション ..................................................................................................................... 6-56

ワークフロー・プロセスの管理ワークフロー・プロセスの管理ワークフロー・プロセスの管理ワークフロー・プロセスの管理 ......................................................................................................................... 6-57

新規の業務イベントおよびイベント・サブスクリプションの登録 ..................................................... 6-57

シードされた項目タイプの指定 ................................................................................................................. 6-57

シードされた業務イベントおよび関連するイベント・サブスクリプションの指定 ......................... 6-57

シードされたイベント・サブスクリプションの構成または削除 ......................................................... 6-58

エラー通知に対する応答または特定の通知の検索 ................................................................................. 6-58

ワークフロー・プロセスのモニターワークフロー・プロセスのモニターワークフロー・プロセスのモニターワークフロー・プロセスのモニター ................................................................................................................. 6-58

トレース機能を使用したサブスクリプションのモニター ..................................................................... 6-58

トランザクション・ステータスのモニター ............................................................................................. 6-58

関数の生成により返される XML メッセージのレビュー ...................................................................... 6-58

エージェント・リスナーのオン / オフ .................................................................................................... 6-59

B2B 統合用カスタム・メッセージの開発ガイドライン統合用カスタム・メッセージの開発ガイドライン統合用カスタム・メッセージの開発ガイドライン統合用カスタム・メッセージの開発ガイドライン ................................................................................ 6-59アウトバウンド・メッセージの開発ガイドライン ................................................................................. 6-60

インバウンド・メッセージの開発ガイドライン ..................................................................................... 6-60

よくある質問よくある質問よくある質問よくある質問 ......................................................................................................................................................... 6-61

7 Oracle Transport AgentOracle Transport Agent の概要の概要の概要の概要 ........................................................................................................................... 7-1

認証方法認証方法認証方法認証方法 ................................................................................................................................................................... 7-2インプリメンテーション ............................................................................................................................... 7-3

イベントの順序 ............................................................................................................................................... 7-3

メッセージ配信ステータスメッセージ配信ステータスメッセージ配信ステータスメッセージ配信ステータス ................................................................................................................................... 7-7他のメッセージ・システムで XML メッセージ配信コールバックを使用する方法 ............................ 7-9

トラブルシューティングトラブルシューティングトラブルシューティングトラブルシューティング ....................................................................................................................................... 7-9

v

Page 8: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

A マップ分析のガイドラインマップ分析のガイドラインマップ分析のガイドラインマップ分析のガイドライン

マップ分析の概要マップ分析の概要マップ分析の概要マップ分析の概要 ................................................................................................................................................... A-2アウトバウンド・メッセージのマップ分析のガイドラインアウトバウンド・メッセージのマップ分析のガイドラインアウトバウンド・メッセージのマップ分析のガイドラインアウトバウンド・メッセージのマップ分析のガイドライン ........................................................................... A-2

アウトバウンド・メッセージのマップ分析のガイドラインのチェックリスト ................................... A-2

データベース・ビュー(ソース)と DTD(ターゲット)の比較 ......................................................... A-4

インバウンド・メッセージのマップ分析のガイドラインインバウンド・メッセージのマップ分析のガイドラインインバウンド・メッセージのマップ分析のガイドラインインバウンド・メッセージのマップ分析のガイドライン ............................................................................ A-11

インバウンド・メッセージのマップ分析のガイドラインのチェックリスト .................................... A-11

データベース・ビュー(ソース)と DTD(ターゲット)の比較 ...................................................... A-13

ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定 .................................................................................................... A-19レベルの縮小 ................................................................................................................................................ A-20

レベルの拡張 ................................................................................................................................................ A-21

DTD に関する追加または変更のに関する追加または変更のに関する追加または変更のに関する追加または変更の OAG への提案への提案への提案への提案 .......................................................................................... A-23カスタム・メッセージに関する特別な考慮事項カスタム・メッセージに関する特別な考慮事項カスタム・メッセージに関する特別な考慮事項カスタム・メッセージに関する特別な考慮事項 ............................................................................................ A-24

B XML Gateway シード済コード・カテゴリシード済コード・カテゴリシード済コード・カテゴリシード済コード・カテゴリ

XML Gateway シード済コード・カテゴリシード済コード・カテゴリシード済コード・カテゴリシード済コード・カテゴリ ....................................................................................................... B-2

C XML Gateway でサポートされている処理でサポートされている処理でサポートされている処理でサポートされている処理

XML Gateway でサポートされている処理でサポートされている処理でサポートされている処理でサポートされている処理 ...................................................................................................... C-2

D XML Gateway 命名規則命名規則命名規則命名規則

XML Gateway 命名規則の要約命名規則の要約命名規則の要約命名規則の要約 .......................................................................................................................... D-2

E XML Gateway の有効なタイム・ゾーン値の有効なタイム・ゾーン値の有効なタイム・ゾーン値の有効なタイム・ゾーン値

XML Gateway の有効なタイム・ゾーン値の有効なタイム・ゾーン値の有効なタイム・ゾーン値の有効なタイム・ゾーン値 ....................................................................................................... E-1

F XML Gateway APIXML Gateway API ................................................................................................................................................ F-2

ECX_STANDARD で定義されているで定義されているで定義されているで定義されている API ........................................................................................................ F-3setEventDetails ............................................................................................................................................... F-3getEventDetails ............................................................................................................................................... F-5

getEventSystem .............................................................................................................................................. F-6getReferenceID ................................................................................................................................................ F-7

vi

Page 9: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_DOCUMENT で定義されているで定義されているで定義されているで定義されている API ....................................................................................................... F-8get_delivery_attribs ....................................................................................................................................... F-8

ECX_CONDITIONS で定義されているで定義されているで定義されているで定義されている API .................................................................................................. F-11getLengthForString ...................................................................................................................................... F-11

getPositionInString ....................................................................................................................................... F-11getSubString .................................................................................................................................................. F-12

ECX_TRADING_PARTNER_PVT で定義されているで定義されているで定義されているで定義されている API .......................................................................... F-13get_receivers_tp_info ................................................................................................................................... F-13get_senders_tp_info ..................................................................................................................................... F-14get_sysadmin_email .................................................................................................................................... F-15

getEnvelopeInformation ............................................................................................................................. F-16getOAGLOGICALID ................................................................................................................................... F-18

ECX_ERRORLOG で定義されているで定義されているで定義されているで定義されている API ...................................................................................................... F-19getDoclogDetails .......................................................................................................................................... F-19external_system ............................................................................................................................................ F-22

ECX_ACTIONS で定義されているで定義されているで定義されているで定義されている API .......................................................................................................... F-23set_error_exit_program ............................................................................................................................... F-23

G トラブルシューティングトラブルシューティングトラブルシューティングトラブルシューティング

XML Gateway インストレーションのトラブルシューティングインストレーションのトラブルシューティングインストレーションのトラブルシューティングインストレーションのトラブルシューティング .................................................................. G-2

ecxver.sql スクリプトの実行 ....................................................................................................................... G-2

XML Gateway バージョンの検証バージョンの検証バージョンの検証バージョンの検証 ...................................................................................................................... G-6クライアント認証のインプリメントに関する一般的な問題クライアント認証のインプリメントに関する一般的な問題クライアント認証のインプリメントに関する一般的な問題クライアント認証のインプリメントに関する一般的な問題 .......................................................................... G-8

用語集用語集用語集用語集

索引索引索引索引

vii

Page 10: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

viii

Page 11: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

はじめにはじめにはじめにはじめに

対象読者対象読者対象読者対象読者このマニュアルは『Oracle XML Gateway ユーザーズ・ガイド リリース 11i』です。

次の実務知識を持つ読者を対象にしています。

� XML メッセージおよび XML 標準の原理を理解していること。

� 文書タイプ定義(DTD)の読み方を理解していること。

� Oracle E-Business Suite のグラフィカル・ユーザー・インタフェースに精通していること。

Oracle E-Business Suite のグラフィカル・ユーザー・インタフェースの詳細は、『Oracle Applications ユーザーズ・ガイド』を参照してください。

Oracle E-Business Suite 製品情報の詳細は、「その他の情報ソース」を参照してください。

このマニュアルの使用方法このマニュアルの使用方法このマニュアルの使用方法このマニュアルの使用方法このマニュアルには、Oracle XML Gateway を理解し、使用するために必要な情報が含まれています。

� 第 1 章「Oracle XML Gateway の概要」では、XML Gateway の機能およびアーキテクチャについて説明し、また各構成要素である Message Designer、XML Gateway の設定および実行エンジンについて紹介します。

� 第 2 章「Message Designer」では、Message Designer を使用して XML メッセージ・マップを作成する方法について説明します。

� 第 3 章「XML Gateway の設定」では、XML Gateway を設定に必要な手順について説明します。

� 第 4 章「実行エンジン」では、XML Gateway エンベロープ、およびインバウンド / アウトバウンド・メッセージに対する取引先の検証について説明します。

ix

Page 12: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

� 第 5 章「メッセージ・キュー」では、XML Gateway で使用されるキューについて説明します。

� 第 6 章「Oracle Workflow 業務イベント・システムの統合」では、XML Gateway とWorkflow BES とを統合する方法について説明します。

� 第 7 章「Oracle Transport Agent」では、Oracle Transport Agent について説明します。

� 付録 A「マップ分析のガイドライン」では、マップ分析の実行について順を追って説明します。

� 付録 B「XML Gateway シード済コード・カテゴリ」では、XML Gateway にシード済みのコード・カテゴリをリストしています。

� 付録 C「XML Gateway でサポートされている処理」では、要素のマッピング処理の一部として定義可能な処理をリストしています。

� 付録 D「XML Gateway 命名規則の要約」では、このガイド全体で推奨されているすべての命名規則の参照をリストしています。

� 付録 E「XML Gateway の有効なタイム・ゾーン値」では、「ECX: Server Timezone」プロファイル・オプションの有効値をリストしています。

� 付録 F「XML Gateway API」では、Message Designer で使用される特殊な用途のプロシージャおよび関数をリストしています。

� 付録 G「トラブルシューティング」では、XML Gateway のインストールのトラブルシューティングに関するヒントおよび手順を記載しています。

文書のユーザー補助文書のユーザー補助文書のユーザー補助文書のユーザー補助 オラクル社では、ハンディキャップのあるお客様にも Oracle の製品、サービスおよびサポート・マニュアルを簡単にご利用いただけることを目標としています。そのため、Oracleのマニュアルには、ユーザーが障害支援技術を使用して情報を利用できる機能が組み込まれています。このマニュアルには HTML 版も用意されており、ハンディキャップのあるお客様が簡単にアクセスできるマークアップをご利用いただけます。標準規格は改善されつつあります。オラクル社でも、Oracle のマニュアルをすべてのお客様がご利用できるように、市場をリードする他の技術ベンダーと積極的に連携して技術的な問題に対応しています。詳細は、Oracle Accessibility Program の Web サイト(http://www.oracle.com/accessibility/)を参照してください。

文書のコード例のユーザー補助文書のコード例のユーザー補助文書のコード例のユーザー補助文書のコード例のユーザー補助

Windows スクリーン・リーダーである JAWS では、この文書内のコーディング例を正しく読み上げられない場合があります。コードを記述するときの規則では、閉じ括弧のみを 1 行に記述する必要があります。ただし、JAWS は通常、大括弧または中括弧のみでなるテキスト行は読み上げません。

x

Page 13: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

文書内の外部文書内の外部文書内の外部文書内の外部 Web サイトへのリンクのユーザー補助サイトへのリンクのユーザー補助サイトへのリンクのユーザー補助サイトへのリンクのユーザー補助 この文書には、オラクル社が所有または管理していない企業や組織の Web サイトへのリンクが含まれています。オラクル社はそれらの Web サイトのユーザー補助に関しては、評価も言及もしません。

その他の情報ソースその他の情報ソースその他の情報ソースその他の情報ソースオンライン・マニュアル、研修およびサポート・サービスを含む多数の情報ソースを選択して、Oracle XML Gateway の知識と理解を増すことができます。

Oracle E-Business Suite の他のマニュアルを参照する場合は、それぞれのマニュアルのリリース 11i バージョンのみを使用してください。

オンライン・マニュアルオンライン・マニュアルオンライン・マニュアルオンライン・マニュアルOracle E-Business Suite のマニュアルは、すべてオンライン(HTML または PDF)で利用できます。

� オンライン・ヘルプオンライン・ヘルプオンライン・ヘルプオンライン・ヘルプ - HTML ヘルプの新機能に関する項では、11i の新機能について説明しています。 この情報は、Oracle XML Gateway が新しいリリースになるたびに更新されます。 新機能に関する項には、このマニュアルの出版時には使用できなかった機能についても記載されています。 たとえば、管理者がミニパックまたはアップグレードからソフトウェアをインストールした場合、このドキュメントには新機能に関する情報も記載されています。 オンライン・ヘルプ・パッチはオラクル・サポート・ホームページで使用できます。

� 『11i Features Matrix』: このマニュアルでは、パッチで入手可能な新機能をリストし、関連する新規マニュアルを特定しています。新機能マトリクスのマニュアルは、オラクル・サポート・ホームページで入手できます。

� Readme ファイルファイルファイルファイル : ダウンロード可能な新規マニュアルまたはマニュアル・パッチの詳細は、インストールしたパッチの readme ファイルを参照してください。

関連するユーザー・マニュアル関連するユーザー・マニュアル関連するユーザー・マニュアル関連するユーザー・マニュアルOracle XML Gateway は、ビジネス情報や設定情報を他の Oracle E-Business Suite 製品と共有しています。 したがって、XML Gateway の設定や使用に際して、他のユーザーズ・ガイドの参照が必要になることがあります。

xi

Page 14: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

これらのマニュアルをオンラインで参照するには、HTML ヘルプ・ウィンドウの拡張メニューから「ライブラリ」を選択するか、メディア・パックに含まれている Oracle E-Business Suite Document Library CD から読み込むか、あるいは Web ブラウザを使用してシステム管理者から提供される URL にアクセスします。

印刷されたマニュアルが必要な場合は、Oracle ストア(http://oraclestore.oracle.com )で購入できます。

すべての製品に関連するマニュアルすべての製品に関連するマニュアルすべての製品に関連するマニュアルすべての製品に関連するマニュアル

『『『『Oracle Applications ユーザーズ・ガイド』ユーザーズ・ガイド』ユーザーズ・ガイド』ユーザーズ・ガイド』

このマニュアルでは、このリリースの XML Gateway(およびその他の Oracle E-Business Suite 製品)で利用できるグラフィカル・ユーザー・インタフェース(GUI)を使用して、データの入力、問合せ、レポートおよびナビゲートを行う方法について説明します。さらにこのマニュアルには、ユーザー・プロファイルの設定、ならびにレポートおよびコンカレント・プロセスの実行および検討の詳細が含まれます。

また、このユーザーズ・ガイドは、任意の Oracle E-Business Suite ヘルプ・ファイルで「Oracle Applications スタート・ガイド」を選択してオンラインで利用できます。

この製品に関連するユーザー・マニュアルこの製品に関連するユーザー・マニュアルこの製品に関連するユーザー・マニュアルこの製品に関連するユーザー・マニュアル

『『『『Oracle Workflow ユーザーズ・ガイド』ユーザーズ・ガイド』ユーザーズ・ガイド』ユーザーズ・ガイド』

このマニュアルでは、既存の Oracle E-Business Suite 組込みワークフロー・プロセスをカスタマイズする方法と、新しいワークフロー・ビジネス・プロセスを定義する方法について説明します。ワークフロー対応プロセスを含む Oracle E-Business Suite 製品に必要な設定手順を完了するためにも、このマニュアルを使用します。

インストールおよびシステム管理者向けインストールおよびシステム管理者向けインストールおよびシステム管理者向けインストールおよびシステム管理者向け

『『『『Oracle Applications 概要』概要』概要』概要』

このマニュアルは、Oracle Applications リリース 11i の概念、機能、技術スタック、アーキテクチャおよび用語について説明します。 Oracle E-Business Suite をインストールする前に読む必要のある有益な入門書です。また、このマニュアルでは、ビジネス・インテリジェンス(BIS)、言語、文字セットおよび Self-Service Web Applications といったアプリケーション規模での機能の背景となるコンセプトを紹介します。

『『『『Oracle Applications のインストール』のインストール』のインストール』のインストール』

このマニュアルは、Oracle E-Business Suite 製品のインストールを管理する方法について説明します。 リリース 11i では、インストール・プロセスの大部分が、Oracle Rapid Install を使用して処理されます。必要なステップの多くが自動化されるため、Oracle E-Business Suite、Oracle 8 テクノロジ・スタックおよび Oracle 8i サーバー・テクノロジ・スタックの

xii

Page 15: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インストール所要時間が短縮されます。このマニュアルには、Oracle Rapid Install の使用のための指示を含めて、インストールを完了するために必要なタスクがリストされています。 このマニュアルは、各製品のユーザーズ・ガイドおよびインプリメンテーション・マニュアルと併用する必要があります。

『『『『Oracle Applications のアップグレード』のアップグレード』のアップグレード』のアップグレード』

このマニュアルは、Oracle Applications リリース 10.7 またはリリース 11.0 の製品をリリース 11i へアップグレードする場合に参照します。このマニュアルは、アップグレード・プロセスを説明し、データベース・アップグレード・タスクおよび製品固有のアップグレード・タスクをリストしています。

リリース 11i にアップグレードするには、リリース 10.7(NCA、SmartClient またはキャラクタ・モード)かリリース 11.0 のどちらかがインストール済みである必要があります。10.7以前のリリースから直接リリース 11i にアップグレードできません。

『『『『Oracle Applications の保守』の保守』の保守』の保守』

このマニュアルは、AutoUpgrade、AutoPatch、AD Administration、AD Controller、AD Relink、License Manager およびその他の様々な AD ユーティリティを実行する際に役立ちます。このマニュアルには、AD ユーティリティの実行に必要な操作手順、スクリーン・ショットおよびその他の情報が記載されています。また、このマニュアルでは、Oracle Applications ファイル・システムおよびデータベースの保守に関する情報を提供しています。

『『『『Oracle Applications システム管理者ガイド』システム管理者ガイド』システム管理者ガイド』システム管理者ガイド』

このマニュアルでは、Oracle Applications システム管理者向けに計画情報および参照情報を提供します。セキュリティの定義、メニューやオンライン・ヘルプのカスタマイズおよびコンカレント処理の管理に関する情報が記載されています。

『『『『Oracle Alert ユーザーズ・ガイド』ユーザーズ・ガイド』ユーザーズ・ガイド』ユーザーズ・ガイド』

このマニュアルでは、Oracle E-Business Suite データの状態をモニターする周期アラートとイベント・アラートの定義方法を説明します。

xiii

Page 16: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

その他の実装マニュアルその他の実装マニュアルその他の実装マニュアルその他の実装マニュアル

『『『『Oracle Applications 製品アップデート・ノート』製品アップデート・ノート』製品アップデート・ノート』製品アップデート・ノート』

このマニュアルは、Oracle E-Business Suite のインストレーションをアップグレードする際にリファレンスとして使用します。 リリース 11.0 からリリース 11i の各 Oracle E-Business Suite 製品の変更履歴が記載されています。この履歴には、両リリースの間にデータベース・オブジェクト、プロファイル・オプションおよびシード・データに適用された新機能、拡張機能および変更が含まれます。

『『『『Oracle Applications における複数報告通貨』における複数報告通貨』における複数報告通貨』における複数報告通貨』

複数報告通貨機能を使用して複数の通貨で取引を記録する場合は、XML Gateway を実装する前にこのマニュアルの手順に従ってください。 このマニュアルでは、この機能が付いたXML Gateway を実装する場合の追加ステップおよび設定に関する考慮事項について詳しく説明します。

『『『『Oracle Applications における複数組織』における複数組織』における複数組織』における複数組織』

このマニュアルでは、Oracle Applications の複数組織サポート機能が付いた XML Gatewayを設定および使用する方法について説明します。これにより、XML Gateway の単一インストレーションを実行するときに様々な組織体系を定義およびサポートできます。

『『『『Oracle Applications フレックスフィールド・ガイド』フレックスフィールド・ガイド』フレックスフィールド・ガイド』フレックスフィールド・ガイド』

このマニュアルでは、XML Gateway 実装チーム、ならびに Oracle Applications 製品データの継続的な保守を担当するユーザーを対象とした、フレックスフィールド計画、設定および参照情報を提供します。 また、このガイドでは、フレックスフィールド・データについてのカスタム・レポートの作成に関する情報を提供します。

Oracle eTechnical Reference Manuals各 eTechnical Reference Manual(eTRM)には、特定の Oracle E-Business Suite 製品のデータベース・ダイアグラムと、データベース表、フォーム、レポートおよびプログラムの詳細が記載されています。 この情報は、既存のアプリケーションからのデータの変換、Oracle E-Business Suite データと非 Oracle アプリケーションの統合、および Oracle E-Business Suite 製品のカスタム・レポートの作成に役立ちます。 Oracle eTRM は、オラクル・サポート・ホームページで入手できます。

xiv

Page 17: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

『『『『Oracle Manufacturing APIs and Open Interfaces Manual』』』』このマニュアルには、その他の Oracle Manufacturing アプリケーションおよびその他のシステムとの統合に関する最新の情報があります。 このドキュメントには、Oracle Manufacturing にある API およびオープン・インタフェースが含まれます。

『『『『Oracle Order Management Suite API およびオープン・インタフェース・マニュアル』およびオープン・インタフェース・マニュアル』およびオープン・インタフェース・マニュアル』およびオープン・インタフェース・マニュアル』

このマニュアルには、その他の Oracle Manufacturing アプリケーションおよびその他のシステムとの統合に関する最新の情報があります。 このドキュメントには、Oracle Order Management Suite にある API およびオープン・インタフェースが含まれます。

『『『『Oracle Applications メッセージ・リファレンス・ガイド』メッセージ・リファレンス・ガイド』メッセージ・リファレンス・ガイド』メッセージ・リファレンス・ガイド』

このマニュアルでは、すべての Oracle E-Business Suite メッセージについて説明します。 このマニュアルは、リリース 11i のドキュメント CD-ROM に HTML 版で用意されています。

研修およびサポート研修およびサポート研修およびサポート研修およびサポート

研修研修研修研修

オラクル社では、お客様とそのスタッフが Oracle XML Gateway を速やかに習得し、生産性を 100% まで高めるために役立つ研修コースを多数用意しています。これらのコースは、実用的な学習進路別に構成されているため、お客様の業務や職責範囲に応じたコースのみ受講できます。

教育環境にも選択肢があります。 Oracle University で提供されている、オラクル社の多数の研修センターのいずれかのコースに出席するか、お客様の施設に講師が出向いて研修を行うこともできます。また、Oracle University のオンライン教育ユーティリティである Oracle Learning Network(OLN)をご利用いただくこともできます。さらに、オラクル社の研修スタッフは、お客様のニーズに応じて標準コースをカスタマイズしたり、独自のカスタム・コースを作成することもできます。たとえば、お客様の施設で行われるカスタム研修コースに、お客様固有の組織構造、用語およびデータを例として使用できます。

サポートサポートサポートサポート

オン・サイトのサポートから中央サポートまで、当社の経験豊かな専門家チームが Oracle XML Gateway の実行に必要なヘルプと情報を提供します。 このチームには、お客様の技術担当者やアカウント・マネージャに加えて、お客様のビジネス分野、Oracle8i サーバーの管理、およびハードウェア・ソフトウェア環境に精通しているオラクル社の多数のコンサルタントとサポート・スペシャリストが含まれます。

xv

Page 18: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

データベース・ツールによるデータベース・ツールによるデータベース・ツールによるデータベース・ツールによる Oracle Applications データの変更の禁止データの変更の禁止データの変更の禁止データの変更の禁止マニュアルに指示がない限り、マニュアルに指示がない限り、マニュアルに指示がない限り、マニュアルに指示がない限り、SQL*Plus、、、、Oracle Data Browser、データベース・トリガー、データベース・トリガー、データベース・トリガー、データベース・トリガーまたは他のツールを使用して、または他のツールを使用して、または他のツールを使用して、または他のツールを使用して、Oracle Applications データを変更しないことをお薦めしまデータを変更しないことをお薦めしまデータを変更しないことをお薦めしまデータを変更しないことをお薦めします。す。す。す。

オラクル社は、Oracle データベースでの情報の作成、記憶、変更、検索または保守に使用できる強力なツールを提供します。しかし、SQL*Plus のような Oracle ツールを使用してOracle Applications データを変更すると、データの整合性が損われたり、データの変更を監査できなくなるおそれがあります。

Oracle Applications の表は相互に関連付けられているので、Oracle Applications を使用して表を変更すると、一度に多数の表が更新されます。しかし、Oracle Applications を使用せずに Oracle Applications データを変更すると、1 つの表のある行を変更した場合に、関連する表で反映させるべき変更が行われないことがあります。各表をお互いに同期させていないと、誤った情報を検索したり、Oracle Applications で予測できない結果が生ずるおそれがあります。

Oracle Applications を使用してデータを変更すると、その変更が有効であるかどうかがOracle Applications により自動的にチェックされます。Oracle Applications は、情報を変更したユーザーを記録することもできます。データベース・ツールを使用してデータベース表に情報を入力すると、無効な情報が格納されることがあります。また、SQL*Plus や他のデータベース・ツールを使用したときは、変更履歴が残らないため誰が情報を変更したのか追跡することができなくなります。

オラクル社についてオラクル社についてオラクル社についてオラクル社についてオラクル社は、財務管理、サプライ・チェーン管理、製造、プロジェクト・システム、人事管理および顧客関係管理の 160 を超すソフトウェア・モジュールの統合スイートであるOracle Applications のみでなく、データベース管理、アプリケーション開発、意思決定サポートおよびオフィス・オートメーションといった統合ソフトウェア製品ラインの開発と販売を行っています。

Oracle 製品は、メインフレーム、ミニコンピュータ、パーソナル・コンピュータ、ネットワーク・コンピュータおよびパーソナル・デジタル・アシスタントで使用可能で、組織は、様々なコンピュータ、オペレーティング・システム、ネットワークおよびデータベース管理システムを、単一かつ統一されたコンピューティングおよび情報リソースに統合できます。

オラクル社は、情報管理において世界最大のソフトウェア・サプライヤであり、ソフトウェア会社としても世界第 2 位の会社です。オラクル社は、世界 145 か国以上で、データベース、ツールおよびアプリケーション製品を、関連するコンサルティング、研修およびサポート・サービスとともに提供しています。

xvi

Page 19: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle XML Gateway の

1

Oracle XML Gateway の概要の概要の概要の概要

この章では、Oracle XML Gateway、特に次の項目について説明します。

� Oracle XML Gateway の機能

� Oracle XML Gateway のアーキテクチャ

� Oracle XML Gateway の構成要素 : Message Designer、XML Gateway の設定および実行エンジン

XML Gateway の概要の概要の概要の概要

XML 標準標準標準標準公開された文書タイプ定義(DTD)を持つ数多くの基準団体(OAG、Rosettanet、SOAP、iFX など)が存在しています。標準には、メッセージ内容を管理する場合に役立つものや、メッセージ内容およびその関連処理の両方を管理する場合に役立つものがあります。

Oracle XML Gateway では、すべての産業に対応できる包括的なビジネス・アプリケーションのソリューションを提供するために、すべての DTD に基づく XML 標準がサポートされています。Oracle E-Business Suite により配信されるメッセージの多くは、オープン・アプリケーション・グループ(OAG)標準を使用してマッピングされます。作成済メッセージは、XML Gateway Message Designer を使用して、選択した標準に再度マッピングされます。

XML Gateway の概要の概要の概要の概要Oracle XML Gateway は、Oracle E-Business Suite と容易に統合して、XML メッセージをサポートできる一連のサービスです。

Oracle E-Business Suite では、Oracle Workflow 業務イベント・システムを使用して、イベントに基づく XML メッセージの作成および消込がサポートされています。

概要 1-1

Page 20: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の概要

Oracle XML Gateway では、Oracle E-Business Suite で発生したイベントが処理され、処理対象のインバウンド・イベントがサブスクリプションされます。Oracle XML Gateway では、ビジネス・パートナとメッセージをやり取りするために、Oracle Advanced Queuing のメッセージ伝播機能を使用して、Oracle Transport Agent と統合します。

Oracle XML Gateway では、企業間(B2B)およびアプリケーション間(A2A)の両方の処理がサポートされています。B2B 処理には、ビジネス文書のやり取りおよび業界固有の市場への参入が含まれます。A2A 処理の例としては、様々なレガシー・システムとのデータ統合を挙げることができます。

Oracle XML Gateway サービスを使用すると、Oracle E-Business Suite と統合するときに、一貫した XML メッセージの実装を行うことができます。このため、企業の電子ビジネスの処理がサポートされ、かつ統合コストを削減し、メッセージの実装を促進できます。

XML Gateway の機能の機能の機能の機能Oracle XML Gateway の機能および用意されている統合は、次のとおりです。

� Message Designer

このウィザードで作業を進めるツールを使用して、RDBMS と XML、XML と XML のデータ変換を含むメッセージ・マップを定義します。

� 強固な実行エンジン強固な実行エンジン強固な実行エンジン強固な実行エンジン

実行エンジンは、Oracle Workflow 業務イベント・システムと統合されます。実行エンジンでは、イベントに基づくメッセージの作成および消込がサポートされています。

� 柔軟な取引先ディレクトリ・サービス柔軟な取引先ディレクトリ・サービス柔軟な取引先ディレクトリ・サービス柔軟な取引先ディレクトリ・サービス

このサービスを使用して、ハブ、ハブ上で取引を行うすべての取引先または特定のビジネス・パートナを定義します。この定義には、有効なメッセージ、確認の要求およびメッセージ・マップに関する情報、メッセージ転送プロトコルなどが含まれます。

� 柔軟なメッセージの設定柔軟なメッセージの設定柔軟なメッセージの設定柔軟なメッセージの設定

Oracle の内部トランザクション名および外部トランザクション名の間の相互参照など、Oracle コードを受信者または標準に基づくコードに柔軟に変換できます。

� Oracle Workflow エラー処理との統合エラー処理との統合エラー処理との統合エラー処理との統合

Oracle Workflow エラー処理によって、XML Gateway システム管理者または取引先担当は、動的なエラー通知を受け取ります。また、失敗した処理の " 再試行 " および " 再処理 " がサポートされています。

� Oracle Advanced Queuing との統合との統合との統合との統合

Oracle AQ では、持続格納とメッセージ伝播がサポートされています。

� サーブレット・ベースのサーブレット・ベースのサーブレット・ベースのサーブレット・ベースの Transport Agent の使用の使用の使用の使用

1-2 Oracle XML Gateway ユーザーズ・ガイド

Page 21: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の概要

サーブレット・ベースの Transport Agent では、SMTP プロトコル、HTTP プロトコルまたは HTTPS プロトコルを使用して、XML メッセージが送受信されます。

XML Gateway のアーキテクチャのアーキテクチャのアーキテクチャのアーキテクチャ

図図図図 1-1 XML Gateway のアーキテクチャ概要図のアーキテクチャ概要図のアーキテクチャ概要図のアーキテクチャ概要図

Oracle XML Gateway でサポートされるサービスは、次の 4 つの機能領域に分類されます。

� Message Designer

� XML Gateway の設定

� 実行エンジン

� Transport Agent

XML Gateway Message Designer

XML

Gateway�

実行��

エンジン�

XML Gatewayの設定�

� Transport Agent

E-Business Suite

Workflow BES �

AdvancedQueuing

Oracle XML Gateway の概要 1-3

Page 22: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の概要

図図図図 1-2 XML Gateway のアーキテクチャ詳細図のアーキテクチャ詳細図のアーキテクチャ詳細図のアーキテクチャ詳細図

Message DesignerXML Gateway Message Designer は、ウィザードで作業を進めるリポジトリ・ベースのツールで、メッセージ・マップを定義するために使用します。メッセージ・マップには、ソースのデータ要素とターゲットのデータ要素の関係が示されます。

XML Gateway Message Designer を使用して、次の機能を実行します。

データ・ソースおよびデータ・ターゲットの定義データ・ソースおよびデータ・ターゲットの定義データ・ソースおよびデータ・ターゲットの定義データ・ソースおよびデータ・ターゲットの定義

各メッセージ・マップは、データの送信元とマッピング先を表すデータ・ソースおよびデータ・ターゲットで構成されています。XML Gateway Message Designer でサポートされているソース・データとターゲット・データの定義の組合せは、次のとおりです。

XML Gateway Message Designer

XML Gateway実行エンジン�

メッセージ確認�の送信/受信�

XML Gateway Messageの設定�

mymap.xgm mydtd.dtd

マップの�ロード/削除�

DTDの�ロード/削除�

XML Gatewayリポジトリ�

エラー�の場合�

Workflowの�エラー処理�プロセス�

Workflowの�通知�

Oracle E-Business

Suite

イベント�が発生�

業務�イベント・�システム�

サブスク�リプション�

XMLメッセージを�送信するための�ワークフロー・�プロセス�

アウトバウンドXMLメッセージ

の作成

アウトバウンド・�キュー�

XML Msg

出力� XML GatewayTransport

Agent

SMTP

HTTP

HTTPS

インバウンド�・メッセージ�を処理する�ための�

ワークフロー・�プロセス�

サブスク�リプション�

業務�イベント・�システム�

イベント�が発生�

インバウンド�XMLメッセージ�

の処理�

イベント�が発生� XML Msg

XML Msg

入力�

インバウンド・�キュー�

XML Msg

1-4 Oracle XML Gateway ユーザーズ・ガイド

Page 23: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の概要

� RDBMS(ソース)から XML(ターゲット)

� XML(ソース)から RDBMS(ターゲット)

� XML(ソース)から XML(ターゲット)

RDBMS ベースのデータは、データベース表、データベース・ビュー、アプリケーション・オープン・インタフェース表またはアプリケーション API に基づいて定義されます。

XML ベースのデータは、XML 文書タイプ定義または本番の XML メッセージに基づいて定義されます。XML メッセージがサポートされている既存の実装またはレガシー・システムから Oracle E-Business Suite に移行する場合は、本番の XML メッセージをデータ・ソースまたはデータ・ターゲットとして使用することをお薦めします。

ソースのデータ構造のターゲットのデータ構造へのマッピングソースのデータ構造のターゲットのデータ構造へのマッピングソースのデータ構造のターゲットのデータ構造へのマッピングソースのデータ構造のターゲットのデータ構造へのマッピング

データ・ソースおよびデータ・ターゲットを定義した後、Message Designer を使用して、ソースのデータ構造をターゲットのデータ構造に関連付けます。

この処理は、ビジネス文書のデータ構造がアプリケーション・データ・モデルのデータ構造と異なる場合、特に重要です。たとえば、インバウンド・ビジネス文書が 3 つのレベルで表されているのに対し、アプリケーション・データ・モデルが 2 つのレベルで表されている場合は、ビジネス文書のデータをアプリケーション・データ・モデルに適合するように縮小する必要があります。逆に、インバウンド・ビジネス文書が 2 つのレベルで、アプリケーション・データ・モデルが 3 つのレベルで表されている場合は、着信データが拡張されます。

XML Gateway Message Designer では、階層の拡大および縮小がサポートされているため、Oracle E-Business Suite のデータ・モデルとデータを正しくやり取りすることができます。

ソースのデータ要素のターゲットのデータ要素へのマッピングソースのデータ要素のターゲットのデータ要素へのマッピングソースのデータ要素のターゲットのデータ要素へのマッピングソースのデータ要素のターゲットのデータ要素へのマッピング

データ・ソース、データ・ターゲット、ソースとターゲット間の階層を定義した後、Message Designer を使用して、ソースのデータ要素をターゲットのデータ要素にマッピングします。

Message Designer のユーザー・インタフェースによって、データ・ソースとデータ・ターゲットが隣接するウィンドウに表示されます。ソースのデータ要素とターゲットのデータ要素の間でドラッグ・アンド・ドロップすることによって、マッピングの関係を作成できます。ソースのデータ要素名がターゲットのデータ要素名の隣に表示され、マッピングの関係を識別できます。

Oracle XML Gateway の概要 1-5

Page 24: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の概要

データ変換関数とプロセス管理関数の識別データ変換関数とプロセス管理関数の識別データ変換関数とプロセス管理関数の識別データ変換関数とプロセス管理関数の識別

要素のマッピング処理の一部として、Message Designer を使用して、データ変換関数とプロセス管理関数を識別します。これらの関数は、ソースまたはターゲットで次のように定義できます。

� データ要素、文書またはルート・レベルで適用される。

� メッセージの作成または消込の前、最中、または後に適用される。

関数の適用は、条件によって限定されます。条件が定義されていない場合、関数は常に適用されます。XML Gateway でサポートされている関数のリストは、付録 C を参照してください。

一般的なデータ変換関数では、日付、営業金額、数量および金額値を表す Oracle と OAG のフォーマット間の変換が行われる以外に、算術関数や文字列操作が呼び出されます。

一般的なプロセス管理関数では、プロシージャやデータベース関数が呼び出され、Oracle E-Business Suite との統合が拡張されます。他の一般的なプロセス管理関数を使用すると、トランザクションのステータスを問い合せたり、ステータスに基づいてプロセス・フローを管理できます。重大なエラーの場合は、プロセスが中断され、XML Gateway システム管理者または取引先担当にエラー通知が送信されます。

作成したメッセージ・マップは、関連する DTD とともに XML Gateway リポジトリにロードされ、実行エンジンでアウトバウンド XML メッセージを作成したり、インバウンド XMLメッセージを消し込む場合に使用されます。

XML Gateway の設定の設定の設定の設定取引先との間でメッセージを実装するには、XML Gateway の設定機能を使用して、取引先またはハブ、コード変換値および内部トランザクション名から外部トランザクション名への相互参照を定義します。また、XML Gateway システム管理者を識別して、システムまたはプロセスのエラーを通知することもできます。

取引先またはハブの定義取引先またはハブの定義取引先またはハブの定義取引先またはハブの定義

E-Business は、ビジネス・パートナ(取引先)によって直接管理されるか、または Oracle Exchange などのハブを使用して管理されます。ハブには、多くの購買担当や販売担当が集まり、ここで電子商取引が行われます。

Oracle XML Gateway を使用すると、ハブまたは個々のビジネス・パートナを取引先として定義できます。ハブを取引先として定義した場合は、そのハブで取引を行うすべての購買担当と販売担当をハブに対する取引先として識別できます。

取引先またはハブの定義に含まれる処理は、次のとおりです。

� 取引先またはハブの名前の定義

� パートナの XML メッセージの有効化

� メッセージ確認要求の有効化

1-6 Oracle XML Gateway ユーザーズ・ガイド

Page 25: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の概要

� メッセージを作成するか、または消し込む場合に使用するメッセージ・マップの定義

� データ・エラーを通知する取引先担当の E メール・アドレスの定義

� 取引先固有のコード変換の定義

� 転送プロトコル(SMTP、HTTP、証明書と必要に応じてユーザー名およびパスワードを要求する HTTPS)の定義

コード変換の定義コード変換の定義コード変換の定義コード変換の定義

Oracle XML Gateway を使用すると、Oracle コードと受信者にとって意味のあるコードの間で相互参照できます。逆に、パートナから受信したコードと Oracle Application で意味のあるコードの間で相互参照することもできます。コード変換をする必要がある Oracle E-Business Suite コードの一般的な例として、単位と通貨コードを挙げることができます。

コード変換値は、すべての取引先およびメッセージに適用されるように定義できます。また、コード変換値は、特定の XML 標準または取引先に対して定義することもできます。

トランザクションの定義トランザクションの定義トランザクションの定義トランザクションの定義

Oracle XML Gateway を使用すると、Oracle のトランザクション名と外部トランザクション名の間に相互参照を定義できます。外部トランザクションには、受信者側で使用されるXML 標準で意味のある名前が付けられます。外部トランザクション名は、メッセージ転送をサポートするために、メッセージ・エンベロープに表示されます。

実行エンジン実行エンジン実行エンジン実行エンジンXML Gateway 実行エンジンでは、Oracle テクノロジとのやり取りによって、XML メッセージが処理され、このメッセージが B2B 統合の取引先または A2A 統合の企業の内部および外部の情報システムとの間で送受信されます。

関連する Oracle テクノロジは、次のとおりです。

� Oracle Workflow 業務イベント・システム

� Oracle E-Business Suite

� Oracle Advanced Queuing

� Oracle Workflow

Oracle Workflow 業務イベント・システム業務イベント・システム業務イベント・システム業務イベント・システム

Oracle XML Gateway では、Oracle Workflow 業務イベント・システムを使用して、関連のあるアプリケーション業務イベントが公開およびサブスクリプションされ、メッセージの作成または消込のトリガーが自動的に生成されます。

Oracle XML Gateway の概要 1-7

Page 26: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の概要

アウトバウンド・メッセージを送信したり、インバウンド・メッセージを消し込むための業務イベントおよびイベント・サブスクリプションは、すべての Oracle 作成済メッセージに対して配信されます。実装中にシード済イベント・サブスクリプションを構成すると、特定のビジネス要件を満たすためのアクティビティが実行されます。

Oracle E-Business SuiteXML Gateway 実行エンジンでは、業務イベントおよびイベント・サブスクリプションにより Oracle E-Business Suite と連動して、Oracle E-Business Suite の表からデータが抽出されたり、表にデータが挿入されます。

Oracle Advanced QueuingXML Gateway 実行エンジンでは、Oracle Advanced Queuing と連動して、アウトバウンドXML メッセージが処理されたり、処理するインバウンド XML メッセージが受信されます。

Oracle WorkflowXML Gateway 実行エンジンでは、Oracle Workflow と連動して、XML Gateway システム管理者にはシステムやプロセスのエラーが、取引先担当にはデータ・エラーが動的に通知されます。

XML Gateway システム管理者は、失敗したアウトバウンド・プロセスを " 再試行 " したり、失敗したインバウンド・プロセスを " 再処理 " できます。

XML Gateway 実行エンジンの内部機能は、次のとおりです。実行エンジンの内部機能は、次のとおりです。実行エンジンの内部機能は、次のとおりです。実行エンジンの内部機能は、次のとおりです。

取引先またはハブの検証取引先またはハブの検証取引先またはハブの検証取引先またはハブの検証

取引先が定義され、必要な文書が有効であることを確認します。

リポジトリからのメッセージ・マップの抽出リポジトリからのメッセージ・マップの抽出リポジトリからのメッセージ・マップの抽出リポジトリからのメッセージ・マップの抽出

取引先および必要な文書に関連付けられているメッセージ・マップを抽出します。

Oracle E-Business Suite に対するデータの抽出および挿入に対するデータの抽出および挿入に対するデータの抽出および挿入に対するデータの抽出および挿入

アウトバウンド・メッセージの場合は、メッセージ・マップに関する情報を使用して、Oracle E-Business Suite からアプリケーション・データを収集します。

インバウンド・メッセージの場合は、メッセージ・マップに関する情報を使用して、Oracle E-Business Suite にデータを設定します。

データ変換関数またはプロセス管理関数の適用データ変換関数またはプロセス管理関数の適用データ変換関数またはプロセス管理関数の適用データ変換関数またはプロセス管理関数の適用

メッセージ・マップで定義されたコード変換関数、データ変換関数およびプロセス管理関数を適用します。

1-8 Oracle XML Gateway ユーザーズ・ガイド

Page 27: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の概要

XML パーサーを使用したメッセージの検証パーサーを使用したメッセージの検証パーサーを使用したメッセージの検証パーサーを使用したメッセージの検証

アウトバウンド・メッセージの場合、XML パーサーを使用して、新しく作成されたメッセージを検証し、正常に構成され有効であることを確認します。正常に構成されていないメッセージまたは無効なメッセージは、配信用にエンキューされません。XML Gateway システム管理者にエラーの通知が送信されます。

インバウンド・キューからデキューされたインバウンド・メッセージは、XML パーサーを使用して検証し、正常に構成され有効であることを確認します。正常に構成されていないまたは無効なメッセージは、XML Gateway 実行エンジンで処理されません。取引先担当にエラー通知が送信されます。

XML メッセージのエンキューおよびデキューメッセージのエンキューおよびデキューメッセージのエンキューおよびデキューメッセージのエンキューおよびデキュー

アウトバウンド・メッセージは、Transport Agent によって配信するためにキューにエンキューされます。インバウンド・メッセージは、XML Gateway 実行エンジンによってデキューされて処理されます。

メッセージ確認の送受信メッセージ確認の送受信メッセージ確認の送受信メッセージ確認の送受信

取引先に対してアウトバウンド確認が有効化されている場合は、インバウンド要求に応答してアウトバウンド確認が送信されます。

取引先に対してインバウンド確認が有効化されている場合は、アウトバウンド要求に応答してインバウンド確認が送信されます。

A2A 統合での実行エンジンとの直接やり取り統合での実行エンジンとの直接やり取り統合での実行エンジンとの直接やり取り統合での実行エンジンとの直接やり取り

ワークフローのプロセスで使用するために用意されているシード済ワークフロー関数では、実行エンジンと直接やり取りを行って、アウトバウンド・メッセージが生成されたり、インバウンド・メッセージが消し込まれます。

XML Gateway 実行エンジンで生成されたアウトバウンド・メッセージは、下位のワークフローアクティビティの処理で使用することができます。実行エンジンでは、ワークフロープロセスによって渡されたインバウンド・メッセージが消し込まれます。

XML Gateway 実行エンジンでは、ワークフロープロセスにより XML メッセージが送信または生成されたり、インバウンド・メッセージがインバウンド・キューに着信したことを検知すると、処理が開始されます。

Oracle Transport AgentOracle Transport Agent では、Oracle Advanced Queuing と連動して、アウトバウンド・メッセージが配信されたり、インバウンド・メッセージが受信されます。

Transport Agent サーバーは、Java ベースのサーブレットです。Transport Agent サーバーでは、Transport Agent Messaging プロトコルを使用して、次の処理がサポートされています。

Oracle XML Gateway の概要 1-9

Page 28: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の概要

� 1 度で完了することが保証された配信

� メッセージの暗号化

� サーバー間の証明書による認証

XML メッセージおよびメッセージおよびメッセージおよびメッセージおよび EDI トランザクショントランザクショントランザクショントランザクションEDI トランザクションおよび XML メッセージは、各標準に基づく電子的なメッセージ処理の方法です。EDI トランザクションがよりバッチ指向であるのに対して、XML メッセージは、イベントに基づき、リアルタイムで、1 つのトランザクションに基づく傾向があります。

Oracle E-Business Suite と統合された Oracle E-Commerce Gateway では、フラット ASCIIファイルを使用して、従来の EDI トランザクションが抽出またはインポートされます。Oracle E-Business Suite と ASC X12 や EDIFACT などの EDI 標準との間でデータをマッピングする場合は、サード・パーティ製の EDI 変換プログラムが必要です。

Oracle E-Business Suite と統合された Oracle XML Gateway では、アプリケーション業務イベントに基づいて、XML メッセージが作成されたり、消し込まれます。Oracle XML Gateway では、変換プログラムを使用せずに、標準準拠の XML メッセージが作成されたり、消し込まれます。

まとめまとめまとめまとめOracle XML Gateway では、Oracle E-Business Suite の XML メッセージが有効化されます。このため、A2A および B2B メッセージ処理をサポートする企業の内部および外部で、一貫した XML メッセージの実装を実行することができます。

Oracle XML Gateway では、Oracle Workflow を使用して、主要な業務プロセスがリンクされ、Oracle Workflow 業務イベント・システムの公開およびサブスクリプション機能を使用して、メッセージの作成および消込が自動化されます。この組合せにより、サプライ・チェーン全体で、ビジネスに重要なデータをシームレスにコラボレーション、調整および通信できます。

1-10 Oracle XML Gateway ユーザーズ・ガイド

Page 29: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message De

2

Message Designer

この章では、XML Gateway Message Designer を使用して、新規メッセージ・マップを作成したり、Oracle の作成済みメッセージ・マップを変更する方法について説明します。この章では、特に、次の処理を行う方法について説明します。

� 「Data Definition Creation」ウィザードおよび「Map Creation」ウィザードを使用した、データ定義およびメッセージ・マップの作成

� 「Transaction Map」ウィンドウを使用した、ソースのデータ定義からターゲットのデータ定義への対応付けの実行

� 「Map Action Editor」を使用した、処理の適用

� メッセージ・マップおよび DTD のロード

Message Designer の概要の概要の概要の概要Message Designer は、ウィザードで作業を進めるリポジトリベースのツールで、XML メッセージ・マップを作成するために使用します。マップの作成では、データ・ソースとデータ・ターゲットの定義、ソース・データとターゲット・データの間の階層とデータ・マップの定義、およびデータ変換とプロセス管理の処理の定義を行います。

Message Designer は XML 標準には対応していませんが、W3C XML 仕様のバージョン 1.0に準拠しています。

Message Designer では、文書の形式が文書タイプ定義(DTD)に準拠している場合には、どのようなビジネス文書のマップ作成もサポートされます。

Message Designer を使用すると、次の処理を行うことができます。

� あらかじめ作成された Oracle のメッセージ・マップの修正

注意注意注意注意 : W3C XML 標準の詳細は、www.w3.org/XML/Activityを参照してください。

signer 2-1

Page 30: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer の概要

� 新規メッセージ・マップの作成

Message Designer を使用して新規メッセージ・マップを作成する場合は、Message Designerを使用する前にマップ分析を行う必要があります。詳細は、「マップ分析のガイドライン」

(A-1 ページ)を参照してください。マップ分析が完全に行われるかどうかによって、マップ作成が正常に行われるかどうかが決定されます。

作成したメッセージ・マップおよび関連する DTD を XML Gateway リポジトリにロードします。XML Gateway 実行エンジンおよび XML パーサーでは、このマップを使用して、アウトバウンド・メッセージが作成され、インバウンド XML メッセージが使用されます。

Message Designer のメニューのメニューのメニューのメニューMessage Designer には、「File」、「View」および「Help」メニューがあります。一部のメニュー機能には、ツールバー・アイコンからアクセスすることもできます。

「Message Designer のツールバー」(2-4 ページ)を参照してください。

「「「「File」メニュー」メニュー」メニュー」メニューMessage Designer を使用して、新規データ定義やトランザクション・マップを作成したり、既存のデータ定義やトランザクション・マップを修正します。

Message Designer では、次のファイル・タイプがサポートされています。

� ソースまたはターゲットのデータ定義用の .XGD ファイル

� トランザクション・マップ用の .XGM ファイル

.XGD ファイルと .XGM ファイルは、ブラウザおよび任意の XML エディタで開いて読むことができる XML ファイルです。.XGD ファイルと .XGM ファイルは、メッセージの構成および内容を記述するために使用します。トランザクション・マップ(.XGM)を使用して作成または使用する XML メッセージの内容は、実際のビジネス・データです。

次の表は、「File」メニュー・オプションを示します。

メニュー・オプションメニュー・オプションメニュー・オプションメニュー・オプション 説明説明説明説明

New 新規データ定義ファイルまたは新規トランザクション・マップ・ファイルを作成します。

Open 既存のファイルを開きます。ファイルは、.XGD 拡張子の付い

たデータ定義ファイル、または .XGM 拡張子の付いたトランザ

クション・マップ・ファイルです。

Close 開いているトランザクション・マップ・ファイルまたはデータ定義ファイルを閉じます。

Save 開いているファイルを保存します。データ定義ファイルは.XGD ファイルとして保存し、トランザクション・マップ・

ファイルは .XGM ファイルとして保存します。

2-2 Oracle XML Gateway ユーザーズ・ガイド

Page 31: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer の概要

「「「「View」メニュー」メニュー」メニュー」メニュー「View」メニューを使用すると、ソースまたはターゲットの定義をツリー形式のみ、表形式のみ、またはツリー形式と表形式の両方で表示できます。

次の表は、「View」メニュー・オプションを示します。

Properties 「Data Definition Creation」ウィザードまたは「Map Creation」ウィザードで入力したキー・プロパティ値にアクセスできます。このメニュー・オプションを使用すると、表示された任意の元のキー値を変更できます。このメニュー・オプションの詳細は、「「File」>「Properties」メニュー」(2-5 ページ)を参照してください。

Exit Message Designer を終了します。

メニュー・オプションメニュー・オプションメニュー・オプションメニュー・オプション 説明説明説明説明

Tree ソースまたはターゲットの定義をツリー形式でのみ表示します。

Table ソースまたはターゲットの定義を表形式でのみ表示します。

View Both ソースまたはターゲットの定義をツリー形式と表形式の両方で表示します。これは、デフォルトの表示オプションです。

メニュー・オプションメニュー・オプションメニュー・オプションメニュー・オプション 説明説明説明説明

Message Designer 2-3

Page 32: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer の概要

「「「「Help」メニュー」メニュー」メニュー」メニュー次の表は、「Help」メニュー・オプションを示します。

Message Designer のツールバーのツールバーのツールバーのツールバーMessage Designer のツールバーを使用すると、次のアイコンを使用して次のメニュー・オプションを複製できます。

メニュー・オプションメニュー・オプションメニュー・オプションメニュー・オプション 説明説明説明説明

Help Topics Message Designer のヘルプを表示します。

About Message Designer のバージョン情報を表示します。

「Create New Map」アイコン。「Map Creation」ウィザードを起動します。

「Open Map」アイコン。既存のマップを開きます。

「Save Map」アイコン。データ定義は .XGD ファイルとして保存し、トランザクション・マップは .XGM ファイルとして保存します。

「View Tree」アイコン。ツリー形式のみを表示します。

「View Table」アイコン。表形式のみを表示します。

「View Both Tree and Table」アイコン。ツリー形式と表形式の両方を表示します。

「Help」アイコン。Message Designer のヘルプを起動します。

2-4 Oracle XML Gateway ユーザーズ・ガイド

Page 33: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer の概要

Message Designer のボタンのボタンのボタンのボタン

「「「「File」>「」>「」>「」>「Properties」メニュー」メニュー」メニュー」メニュー「File」>「Properties」メニュー・オプションを使用すると、「Data Definition Creation」ウィザードまたは「Map Creation」ウィザードで入力したキー・プロパティ値にアクセスできます。表示されたキー・プロパティ値を変更するには、「Properties」ウィンドウを使用します。

「Add Sibling」ボタンでは、マップ上で選択した項目と同じ階層レベルに新規要素を追加します。

この機能の詳細は、次のセクションを参照してください。

ソースのデータ定義の詳細は、「(「Source Definition」タブ)Add Sibling」(2-46 ページ)を参照してください。

ソースのデータ定義の詳細は、「(「Target Definition」タブ)Add Sibling」(2-55 ページ)を参照してください。

「Add Child」ボタンでは、マップ上で選択した項目よりも低い階層レベルに新規要素を追加します。

この機能の詳細は、次のセクションを参照してください。

ソースのデータ定義の詳細は、「(「Source Definition」タブ)Add Child」(2-46 ページ)を参照してください。

ソースのデータ定義の詳細は、「(「Target Definition」タブ)Add Child」(2-55 ページ)を参照してください。

「Delete」ボタンでは、マップされていない要素を削除します。必要な要素を削除しないようにしてください。必要な要素を削除すると、パーサー違反が発生します。

関連する子要素が項目に存在する場合は、削除が行われる前に警告が表示されます。

注意注意注意注意 : DTD 拡張を削除する場合は、アプリケーションまたはユーザー用に作成された該当する拡張ファイルから、DTD 拡張を必ず削除してください。余分な情報が付加されていてもパーサー違反にはなりませんが、拡張ファイルをメッセージ・マップに一致させることをお薦めします。詳細は、「DTD の拡張方法」(2-110 ページ)を参照してください。

Message Designer 2-5

Page 34: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer の概要

「Property」タブおよび各タブに関連するフィールドは、「File」>「Properties」メニュー・オプションが起動される場所によって異なります。各ウィンドウで使用できるオプションは次のとおりです。

� Message Designer のメイン・ウィンドウ - 「General」タブ、「Database」タブ

� 「Data Definition」ウィンドウ - 「General」タブ、「Database」タブ、「Data」タブ

� 「Transaction Map」ウィンドウ - 「General」タブ、「Database」タブ、「Map」タブ、「Source」タブ、「Target」タブ

「「「「General」タブ」タブ」タブ」タブ

「General」タブを使用すると、出力ディレクトリを更新できます。出力ディレクトリは、Message Designer で作成したデータ定義ファイルおよびメッセージ・マップ・ファイルを格納するためのデフォルト・ディレクトリです。

「「「「Database」タブ」タブ」タブ」タブ

「Database」タブを使用すると、デフォルト・データベースの接続情報が入手できます。デフォルト値は、「Data Definition Creation」ウィザードと「Map Creation」ウィザードの他、プロシージャ・コール処理でも使用できます。

入力を要求されるデータベース接続フィールドは、次のとおりです。

� Username

� Connect to Database

� Host

Output Directory 「Browse」ボタンを使用してデフォルト・ディレクトリを選択するか、または有効なディレクトリ名を入力します。

2-6 Oracle XML Gateway ユーザーズ・ガイド

Page 35: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer の概要

� Port

� Schema Name

「「「「Data」タブ」タブ」タブ」タブ

「Data」タブを使用すると、「Data Definition Creation」ウィザードで入力したデータ値を更新できます。タブ上のフィールドは、データ定義のタイプによって異なります。

Message Designer 2-7

Page 36: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer の概要

次の表のフィールドは、すべてのデータ定義に関して表示されます。

データ定義のタイプが XML の場合は、次の表のフィールドが表示されます。

「「「「Map」タブ」タブ」タブ」タブ

このタブは、マップ・トランザクション・ファイル(.XGM)を参照している場合にのみ表示されます。

フィールドフィールドフィールドフィールド 説明説明説明説明

Data Definition Name 入力する名称に変更します。「Data Definition Creation」ウィ

ザードおよび「Map Creation」ウィザードで推奨される命名規

則に従ってください。命名規則の詳細は、「ソース / ターゲットのデータ定義の選択 /作成」(2-25 ページ)を参照してください。

Data Definition Description 説明を変更します。

注意注意注意注意 : データ定義の変更によって既存のマップが影響を受ける場合は、マップを変更して再ロードする必要があります。DTD 参照が変更された場合は、新規 DTD を再ロードする必要があります。「メッセージ・マップおよび DTD のロード方法」(2-113 ページ)を参照してください。

フィールドフィールドフィールドフィールド 説明説明説明説明

Root Element 入力するルート要素に更新します。入力するルート要素は、下記で入力する DTD のルート要素と一致する必要があります。

Runtime DTD Location 実行時の DTD の場所を新規サブディレクトリ名に更新します。

「Data Definition Creation」ウィザードおよび「Map Creation」ウィザードで推奨される命名規則に従ってください。命名規則の詳細は、「実行時の DTD の場所の識別」(2-39 ペー

ジ)を参照してください。

DTD File Name 「Browse」ボタンを使用して DTD を選択するか、または有効な

DTD ファイル名を入力します。入力されていたファイル名が、

選択または入力したファイル名に変更されます。DTD で定義す

るルート要素は、前述で入力したルート要素の値と一致する必要があります。

注意注意注意注意 : これらのプロパティ値を変更した場合は、メッセージ・マップを再ロードする必要があります。メッセージ・マップに関連する DTD を変更した場合は、DTD を再ロードする必要があります。詳細は、「メッセージ・マップおよび DTD のロード方法」(2-113 ページ)を参照してください。

2-8 Oracle XML Gateway ユーザーズ・ガイド

Page 37: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer の概要

フィールドフィールドフィールドフィールド 説明説明説明説明

Map Name 入力する名称に変更します。「Map Creation」ウィザードで推

奨される命名規則に従ってください。命名規則の詳細は、「マップ名の指定」(2-23 ページ)を参照し

てください。

Map Description 説明を変更します。

注意注意注意注意 : マップ名の変更によって既存の取引先定義が影響を受ける場合は、取引先定義を新規マップ名に更新してください。詳細は、「取引先の設定」

(3-17 ページ)を参照してください。

注意注意注意注意 : 新規名称を含むマップを XML Gateway リポジトリに再ロードする必要があります。詳細は、「メッセージ・マップおよび DTD のロード方法」(2-113 ページ)を参照してください。

Message Designer 2-9

Page 38: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer の概要

「「「「Source」タブ」タブ」タブ」タブ

次の表のフィールドは、すべてのデータ定義に関して表示されます。

フィールドフィールドフィールドフィールド 説明説明説明説明

Data Definition Name 入力する名称に変更します。「Data Definition Creation」ウィ

ザードおよび「Map Creation」ウィザードで推奨される命名規

則に従ってください。命名規則の詳細は、「ソース / ターゲットのデータ定義の名称

およびタイプの指定」(2-26 ページ)を参照してください。

Data Definition Description 説明を更新します。

注意注意注意注意 : データ定義の変更によって既存のマップが影響を受ける場合は、マップを変更して再ロードする必要があります。DTD 参照が変更された場合は、新規 DTD を再ロードする必要があります。「メッセージ・マップおよび DTD のロード方法」(2-113 ページ)を参照してください。

2-10 Oracle XML Gateway ユーザーズ・ガイド

Page 39: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer の概要

データ定義のタイプが XML の場合は、次の表のフィールドが表示されます。

フィールドフィールドフィールドフィールド 説明説明説明説明

Root Element 入力するルート要素に更新します。入力するルート要素は、下記で入力する DTD のルート要素と一致する必要があります。

Runtime DTD Location 実行時の DTD の場所を新規サブディレクトリ名に更新します。

「Data Definition Creation」ウィザードおよび「Map Creation」ウィザードで推奨される命名規則に従ってください。命名規則の詳細は、「実行時の DTD の場所の識別」(2-39 ペー

ジ)を参照してください。

DTD File Name 「Browse」ボタンを使用して DTD を選択するか、または有効な

DTD ファイル名を入力します。入力されていたファイル名が、

選択または入力したファイル名に変更されます。DTD で定義す

るルート要素は、前述で入力したルート要素の値と一致する必要があります。

注意注意注意注意 : これらのプロパティ値を変更した場合は、メッセージ・マップを再ロードする必要があります。メッセージ・マップに関連する DTD を変更した場合は、DTD を再ロードする必要があります。詳細は、「メッセージ・マップおよび DTD のロード方法」(2-113 ページ)を参照してください。

Message Designer 2-11

Page 40: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer の概要

「「「「Target」タブ」タブ」タブ」タブ

次の表のフィールドは、すべてのデータ定義に関して表示されます。

フィールドフィールドフィールドフィールド 説明説明説明説明

Data Definition Name 入力する名称に変更します。「Data Definition Creation」ウィ

ザードおよび「Map Creation」ウィザードで推奨される命名規

則に従ってください。命名規則の詳細は、「ソース / ターゲットのデータ定義の名称

およびタイプの指定」(2-26 ページ)を参照してください。

Data Definition Description 説明を変更します。

注意注意注意注意 : データ定義の変更によって既存のマップが影響を受ける場合は、マップを変更して再ロードする必要があります。DTD 参照が変更された場合は、新規 DTD を再ロードする必要があります。「メッセージ・マップおよび DTD のロード方法」(2-113 ページ)を参照してください。

2-12 Oracle XML Gateway ユーザーズ・ガイド

Page 41: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer のウィザード

データ定義のタイプが XML の場合は、次の表のフィールドが表示されます。

Message Designer のウィザードのウィザードのウィザードのウィザードMessage Designer には、マップ作成プロセスをガイドするための 2 つのウィザードがあります。これらの 2 つのウィザードは次のとおりです。

� 「Data Definition Creation」ウィザード

� 「Map Creation」ウィザード

「Data Definition Creation」ウィザードは、データ定義を行う場合に使用します。

データ定義とは、顧客プロファイルや請求書などのビジネス・オブジェクトを記述するために使用されるデータの集まりです。データ定義は、データベース・ビュー、データベース表、アプリケーション・オープン・インタフェース表、アプリケーション API、XML 文書タイプ定義(DTD)、本番の XML メッセージなどに基づいて作成できます。

フィールドフィールドフィールドフィールド 説明説明説明説明

Root Element 入力するルート要素に更新します。入力するルート要素は、下記で入力する DTD のルート要素と一致する必要があります。

Runtime DTD Location 実行時の DTD の場所を新規サブディレクトリ名に更新します。

「Data Definition Creation」ウィザードおよび「Map Creation」ウィザードで推奨される命名規則に従ってください。命名規則の詳細は、「実行時の DTD の場所の識別」(2-39 ペー

ジ)を参照してください。

DTD File Name 「Browse」ボタンを使用して DTD を選択するか、または有効な

DTD ファイル名を入力します。入力されていたファイル名が、

選択または入力したファイル名に変更されます。DTD で定義す

るルート要素は、前述で入力したルート要素の値と一致する必要があります。

注意注意注意注意 : これらのプロパティ値を変更した場合は、メッセージ・マップを再ロードする必要があります。メッセージ・マップに関連する DTD を変更した場合は、DTD を再ロードする必要があります。詳細は、「メッセージ・マップおよび DTD のロード方法」(2-113 ページ)を参照してください。

Message Designer 2-13

Page 42: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer のウィザード

メッセージ・マップは、次の図に示すようにソースのデータ定義とターゲットのデータ定義で構成されています。

「Data Definition Creation」ウィザードを使用して作成したデータ定義は、暫定メッセージ・マップを作成する場合に使用します。「Data Definition Creation」ウィザードは、取引先固有のメッセージを作成するための基礎となるマスター定義を作成する場合に最適です。

Message Designer では、次の表に示すように、ソースのデータ定義とターゲットのデータ定義に関して 3 通りの組合せがサポートされています。

データベース・ベースのデータ定義は、XML メッセージのサポートに必要となる Oracleデータ・モデルの記述を表しています。

ソースソースソースソース ターゲットターゲットターゲットターゲット 目的目的目的目的

データベース XML アウトバウンド XML メッセージ

XML データベース インバウンド XML メッセージ

XML XML あるバージョンの DTD を次のバージョンの同じ DTD に

変換します。

DTD が同じ業務機能に使用される場合にのみ、ある標準

の DTD を別の標準の DTD に変換します。

引渡し XML メッセージ

「引渡しメッセージのマッピング方法」(2-112 ページ)を

参照してください。

アプリケーション API へのマッピング

「API へのマッピング方法」(2-112 ページ)を参照し

てください。

ソースの�データ定義�

ターゲットの�データ定義�

メッセージ・�マップ�

2-14 Oracle XML Gateway ユーザーズ・ガイド

Page 43: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer のウィザード

XML ベースのデータ定義は、XML 文書タイプ定義(DTD)または本番の XML メッセージに基づいています。DTD を異なる業務目的に使用する場合、ある DTD から別の DTD へのXML 対 XML 変換は、次の 2 つのステップで行います。

1. データベースから XML へ

2. XML からデータベースへ

「Map Creation」ウィザードは、次の内容を定義する場合に使用します。

� ソースの定義

� ターゲットの定義

� 暫定メッセージ・マップ

ソースのデータ定義とターゲットのデータ定義は、新規に行ったり、「Data Definition Creation」ウィザードで以前作成した定義に基づいて行うこともできます。ソースのデータ定義とターゲットのデータ定義は、暫定メッセージ・マップの基礎となります。

Message Designer は、メッセージ・マップの作成時に、次の内容を定義するために使用します。

� レベルのマッピング

� 要素のマッピング

� 処理

レベルのマッピングとは、ソースのデータ構造をターゲットのデータ構造に関連付ける処理のことです。要素のマッピングとは、ソースのデータ要素をターゲットのデータ要素に関連付ける処理のことです。処理とは、データ要素、文書またはルート・レベルで適用できるプロセス管理やデータ変換の機能です。

「「「「Data Definition Creation」ウィザードの処理フロー」ウィザードの処理フロー」ウィザードの処理フロー」ウィザードの処理フローデータ定義は、次の一般的な 2 つのステップに従って行います。

ステップ 1: データ定義の名前の指定およびタイプの選択

ステップ 2: データ定義の詳細の指定

ステップ 2 を完了するために必要な作業は、ステップ 1 での選択内容によって異なります。

次の図は、「Data Definition Creation」ウィザードで表示される一連の画面を示します。データ定義名とタイプを指定すると(ステップ 1)、タイプにデータベースと XML のいずれを選択したかによって、それに対応する詳細情報を入力するよう求めるプロンプトが表示されます。

ステップ 2 が完了すると、要約画面が表示されます。ここでは、作業を完了するか、または前のステップに戻って編集することができます。「Finish」をクリックするとウィザードが閉じ、Message Designer の「Data Definition」ウィンドウが表示されます。

Message Designer 2-15

Page 44: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer のウィザード

「Data Definition Creation」ウィザードの処理フロー

「「「「Map Creation」ウィザードの処理フロー」ウィザードの処理フロー」ウィザードの処理フロー」ウィザードの処理フローマップの作成は、3 つの一般的なステップに従って行います。ウィザードでの選択内容によって、各ステップで行う作業が異なります。

ステップ 1: マップ名の指定

ステップ 2: ソースのデータ定義の選択および作成

ステップ 3: ターゲットのデータ定義の選択および作成

次の図は、「Map Creation」ウィザードで表示される一連の画面を示します。マップ名を指定すると(ステップ 1)、ソースのデータ定義を選択または作成するよう求めるプロンプトが表示されます(ステップ 2)。データ定義の作成作成作成作成を選択した場合、データ定義作成ステップに進みます(「Data Definition Creation」ウィザードのステップと同様)。

データ定義の名称�およびタイプの指定�

データベース� XML

データベース情報�の指定�

表またはビューの選択�

列の選択�

レベルの選択�

XMLファイルおよび�ルート要素の指定�

要約の検証�

データ定義の表示�

データベース�またはXML

2-16 Oracle XML Gateway ユーザーズ・ガイド

Page 45: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Message Designer のウィザード

ソースのデータ定義の作成が完了するか、または既存のデータ定義の選択選択選択選択を選択した場合、ターゲットのデータ定義を選択または作成するよう求めるプロンプトが表示されます(ステップ 3)。ターゲットのデータ定義のステップは、ソースのデータ定義のステップと同じです。

ステップ 3 が完了すると、要約画面が表示されます。ここでは、作業を完了するか、または前のステップに戻って編集することができます。

「Map Creation」ウィザードの処理フロー

マップ名の指定�

ソースの定義の�選択/定義�

選択�

作成�

ソースのデータ定義の�名称およびタイプの指定�

データベース� XML

ソースのデータ�ベース情報の指定�

ソースの表または�ビューの選択�

ソースの列の選択�

ソース・レベル�の指定�

ソースのXMLファイル�およびルート要素の指定�

作成�

選択�

要約の検証�

マップの表示�

ターゲットのデータ定義の�名称およびタイプの指定�

データベース� XML

ターゲットのデータ�ベース情報の指定�

ターゲットの表�またはビューの選択�

ターゲットの列の選択�

ターゲット・レベル�の指定�

ターゲットのXMLファイルおよび�ルート要素の指定�

ターゲットの�定義の選択/作成�

データベース�またはXML

データベース�またはXML

Message Designer 2-17

Page 46: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Data Definition Creation」ウィザードの使用

「「「「Data Definition Creation」ウィザードの使用」ウィザードの使用」ウィザードの使用」ウィザードの使用「Data Definition Creation」ウィザードでは、データ定義作成処理の手順が示されます。データ定義は .xgd ファイルとして保存され、マップを作成するときにターゲットまたはソースとして選択できます。

次のように選択し、「Data Definition Creation」ウィザードを起動します。

(M)「File」>「New」>「Data Definition」

ウィザードの最初のウィンドウが表示されます。

注意注意注意注意 : マップ作成処理を開始する前に、データ定義を作成する必要はありません。「Map Creation」ウィザードでは、既存のデータ定義を選択するか、新規定義を作成するかを選択できます。新規定義を作成する場合は、マップ作成処理の一部としてデータ定義作成ステップが示されます。

「「Map Creation」ウィザード」(2-22 ページ)を参照してください。

2-18 Oracle XML Gateway ユーザーズ・ガイド

Page 47: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Data Definition Creation」ウィザードの使用

ウィザードのすべてのステップで次のボタンが使用可能です。

� Cancel

ウィザードを終了し、完了したウィザードのステップをすべて取り消します。

� Back

ウィザードの前のステップに戻ります。

� Next

ウィザードの次のステップに進みます。「Next」ボタンは、ウィザードの現行のステップで要求される情報を入力した後にのみ使用可能になります。

「「「「Data Definition Creation」ウィザードのステップ」ウィザードのステップ」ウィザードのステップ」ウィザードのステップ「Map Creation」ウィザードで示される手順に従って、「Data Definition Creation」ウィザードの各手順を実行します。

データ定義の名称およびタイプの指定データ定義の名称およびタイプの指定データ定義の名称およびタイプの指定データ定義の名称およびタイプの指定

「ソース / ターゲットのデータ定義の名称およびタイプの指定」(2-26 ページ)を参照してください。

データベースを選択した場合データベースを選択した場合データベースを選択した場合データベースを選択した場合 ...

次のステップを実行します。

データベース情報の指定データベース情報の指定データベース情報の指定データベース情報の指定

「ソース / ターゲットの定義データベース情報の指定」(2-28 ページ)を参照してください。

表またはビューの選択表またはビューの選択表またはビューの選択表またはビューの選択

「ソース / ターゲットの表またはビューの選択」(2-30 ページ)を参照してください。

列の選択列の選択列の選択列の選択

「ソース / ターゲットの列の選択」(2-33 ページ)を参照してください。

ソースソースソースソース / ターゲットのレベルの指定ターゲットのレベルの指定ターゲットのレベルの指定ターゲットのレベルの指定

「ソース / ターゲットのレベルの指定」(2-35 ページ)を参照してください。

Message Designer 2-19

Page 48: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Data Definition Creation」ウィザードの使用

XML を選択した場合を選択した場合を選択した場合を選択した場合 ...

データ定義タイプとして XML を選択した場合は、XML 情報を入力するよう要求されます。

「ソース / ターゲットの XML ファイルおよびルート要素の指定」(2-37 ページ)を参照してください。

「「「「Data Definition Creation」ウィザード」ウィザード」ウィザード」ウィザード : 要約要約要約要約

「Finish」をクリックしてウィザードのステップを終了します。データ定義の設定で行った選択内容を変更する場合は、「Back」ボタンをクリックして該当するウィザードのウィンドウに戻ることができます。

2-20 Oracle XML Gateway ユーザーズ・ガイド

Page 49: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Data Definition Creation」ウィザードの使用

Message Designer の「の「の「の「Data Definition」ウィンドウ」ウィンドウ」ウィンドウ」ウィンドウ

作成したデータ定義は、「Data Definition」タブに表示されます。「Data Definition」ウィンドウを使用して定義を拡張し、次の処理を実行できます。

� デフォルト値を設定します。

� 「Add Sibling」ボタンを使用して、追加のノードおよび要素を作成します。

� 「Add Child」ボタンを使用して、フィールドを追加します。

� コード変換を可能にします。

� 追加のノードまたは要素に対する条件ノード・マッピング・ルールを定義します(ソースが DTD の場合)。

データ定義の完了後、「File」>「Save (Data Definition)」メニュー・オプションまたはツールバーの対応するオプションを選択します。必要に応じて、「File」>「Properties」メニューを使用してデフォルトのディレクトリを変更します。

Message Designer 2-21

Page 50: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

「「「「Map Creation」ウィザードの使用」ウィザードの使用」ウィザードの使用」ウィザードの使用「Map Creation」ウィザードでは、マップ作成処理の手順が示されます。ソースの定義およびターゲットの定義に基づいたマップを作成するための一連のウィンドウが表示されます。

次のように選択し、「Map Creation」ウィザードを起動します。

(M)「「「「File」>「」>「」>「」>「New」>「」>「」>「」>「Transaction Map」」」」

または、ツールバーの「「「「Create New Map」」」」アイコンをクリックします。ウィザードの最初のウィンドウが表示されます。

2-22 Oracle XML Gateway ユーザーズ・ガイド

Page 51: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

ウィザードのすべてのステップで次のボタンが使用可能です。

� Cancel

ウィザードを終了し、完了したウィザードのステップをすべて取り消します。

� Back

ウィザードの前のステップに戻ります。

� Next

ウィザードの次のステップに進みます。「Next」ボタンは、1 つのステップで必要となるすべてのデータを入力した後にのみ使用可能になります。

「Next」をクリックして続行します。「Specify a Map Name」ウィンドウが表示されます。

マップ名の指定マップ名の指定マップ名の指定マップ名の指定

Message Designer 2-23

Page 52: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

一意のマップ名を指定します。この名称は、作成するメッセージ・マップに割り当てられる名称です。また、この名称は、メッセージ・マップを取引先に関連付けるときにも使用されます。

Enter Map Name一意のマップ名を入力します。この名称は、マップ定義ファイルにマップ・コードとして保存されます。

一意であること以外に、この名称は、マップの使用目的をわかりやすく表している必要があります。次の命名規則を使用することをお薦めします。

� 製品のニーモニックまたはユーザー ID

� 「トランザクションの定義」フォームに入力したトランザクション・サブタイプ

� 使用する XML 標準およびバージョン(OAG、Rosettanet、iFX など)

� インバウンド・メッセージまたはアウトバウンド・メッセージ

お薦めする命名規則を使用したマップ名称の例は、次のとおりです。

� AR_INVO_OAG70_OUT_INVOICE

このマップ名は、OAG 標準のバージョン 7.0 の DTD を使用する Oracle Receivables のアウトバウンド請求書メッセージを表します。

� USER_ACK_OAG70_IN

このマップ名は、OAG 標準のバージョン 7.0 の DTD を使用する、ユーザー作成のインバウンド確認メッセージを表します。

Enter Map Descriptionマップの説明を入力します。

「Next」をクリックして続行します。「Select/Create a Source Data Definition」ウィンドウが表示されます。

注意注意注意注意 : 必要に応じて「File」>「Properties」メニュー・オプションを使用して、マップ名とマップの説明を変更できます。

注意注意注意注意 : 必要に応じて「File」>「Properties」メニュー・オプションを使用して、マップ名とマップの説明を変更できます。

2-24 Oracle XML Gateway ユーザーズ・ガイド

Page 53: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

ソースソースソースソース / ターゲットのデータ定義の選択ターゲットのデータ定義の選択ターゲットのデータ定義の選択ターゲットのデータ定義の選択 / 作成作成作成作成

既存のデータ定義ファイルを選択するか、または新規データ定義ファイルを作成します。

Create a new source/target data definition新規データ定義を作成する場合は、このオプションを選択します。ウィザードにより、新規.XGD ファイルの作成の手順が示されます。

Select an existing data definition既存の定義ファイルは、< ファイル名 >.XGD としてファイル・システムに保存されています。使用可能なデータ定義ファイルを表示するには、「Browse」ボタンを使用します。

Message Designer 2-25

Page 54: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

「「「「Next」をクリックして続行します」をクリックして続行します」をクリックして続行します」をクリックして続行します

� ソースのデータ定義ソースのデータ定義ソースのデータ定義ソースのデータ定義の場合は、選択内容に応じて次の処理を行います。

– 新規ソース・データ定義の作成作成作成作成を選択した場合は、「ソース / ターゲットのデータ定義の名称およびタイプの指定」(2-26 ページ)に進みます。

– 既存のソース・データ定義を選択選択選択選択した場合は、ターゲットのデータ定義に対してこのステップを繰り返します。

� ターゲットのデータ定義ターゲットのデータ定義ターゲットのデータ定義ターゲットのデータ定義の場合は、選択内容に応じて次の処理を行います。

– 新規ターゲット・データ定義の作成作成作成作成を選択した場合は、「ソース / ターゲットのデータ定義の名称およびタイプの指定」(2-26 ページ)に進みます。

– 既存のターゲット・データ定義を選択選択選択選択した場合は、「「Map Creation」ウィザードの要約」(2-40 ページ)に進みます。

ソースソースソースソース / ターゲットのデータ定義の名称およびタイプの指定ターゲットのデータ定義の名称およびタイプの指定ターゲットのデータ定義の名称およびタイプの指定ターゲットのデータ定義の名称およびタイプの指定

2-26 Oracle XML Gateway ユーザーズ・ガイド

Page 55: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

新規データ定義の場合は、データ定義の名称、説明およびタイプを入力します。

Enter Data Definition Nameデータ定義の内容を表すわかりやすい名称を入力します。

データ定義タイプとしてデータベースを選択した場合は、この名称が「Transaction Map」ウィンドウにルート・ノードとして表示されます。データ定義タイプとして XML を選択した場合は、ここで入力したデータ定義名称のかわりに、DTD ルート要素が「Transaction Map」ウィンドウにルート・ノードとして表示されます。

次の命名規則を使用することをお薦めします。

� 製品のニーモニックまたはユーザー ID

� 「トランザクションの定義」フォームに入力したトランザクション・サブタイプ

� 使用する XML 標準およびバージョン(OAG、Rosettanet、iFX など)

� データベースまたは XML のデータ定義タイプ

お薦めする命名規則を使用したデータ定義名の例は、次のとおりです。

� AR_INVO_OAG70_DB

この名称は、Oracle Receivables で作成した、OAG 標準のバージョン 7.0 の DTD を使用するアウトバウンド請求書メッセージを表します。このデータ定義は、「Database」のデータ定義タイプであり、アウトバウンド・メッセージのソースのデータ定義として使用されます。

� USER_ACK_OAG70_XML

この名称は、ユーザーが作成した、OAG 標準のバージョン 7.0 の DTD を使用するインバウンド確認メッセージを表します。このデータ定義は、「XML」のデータ定義タイプで、インバウンド・メッセージのソース・データ定義として使用されます。

必要に応じて「File」>「Properties」メニュー・オプションを使用して、データ定義名を変更します。

Enter Data Definition Descriptionデータ定義の説明を入力します。

必要に応じて「File」>「Properties」メニュー・オプションを使用して、データ定義の説明を変更します。

Select Data Definition Type次の値リストからデータ定義タイプを選択します。

� Database

� XML

Message Designer 2-27

Page 56: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

「次」をクリックして続行します。「次」をクリックして続行します。「次」をクリックして続行します。「次」をクリックして続行します。

後続のウィザードのステップは、選択したデータ定義タイプによって異なります。

� 「「「「Database」」」」を選択した場合は、「ソース / ターゲットの定義データベース情報の指定」(2-28 ページ)に進みます。

� 「「「「XML」」」」を選択した場合は、「ソース / ターゲットの XML ファイルおよびルート要素の指定」(2-37 ページ)に進みます。

ソースソースソースソース / ターゲットの定義データベース情報の指定ターゲットの定義データベース情報の指定ターゲットの定義データベース情報の指定ターゲットの定義データベース情報の指定

デフォルトのデータベース・アクセス情報は、「File」>「Properties」メニューの「Database」タブから表示します(2-6 ページを参照)。必要に応じて、パスワードを入力してデータベース・アクセス情報を変更します。

2-28 Oracle XML Gateway ユーザーズ・ガイド

Page 57: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

ソースまたはターゲットが DTD の場合、データベース・アクセスは必要とされないため、このステップは適用されません。

User Nameデータベース・スキーマにアクセスするためのユーザー名を入力します。

Passwordユーザー名のパスワードを入力します。

Connect Stringデータベースの接続文字列を入力します。

Hostデータベースのホスト名を入力します。

Portデフォルト値 "1521" が表示されます。必要な場合は、データベースにアクセスするための別の有効なポート値を入力します。

「Next」をクリックして続行します。「Select Source/Target Tables or Views」ウィンドウが表示されます。

注意注意注意注意 : この画面で行った変更はプロパティ・ファイルにコピーされません。この画面での入力は、現行のセッションにのみ使用されます。

Message Designer 2-29

Page 58: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

ソースソースソースソース / ターゲットの表またはビューの選択ターゲットの表またはビューの選択ターゲットの表またはビューの選択ターゲットの表またはビューの選択

データ定義タイプとして「Database」を選択した場合、メッセージに必要となるデータベース・スキーマ、データベース・ビューおよびデータベース表を入力するように要求されます。

すべてのアプリケーション・データベース・ビューは APPS スキーマに定義されます。関連付けられたデータベース表は、アプリケーション固有のデータベース・スキーマに定義されます。APPS スキーマにシノニムを定義することによって、アプリケーション固有のデータベース表へのアクセス権を付与する必要があります。

ビジネス文書を表すデータ・モデルで複数の階層レベルにわたって共有されているデータベース・ビューまたはデータベース表があるアプリケーションでは、データベース・ビューまたはデータベース表を 2 回目以降に使用する場合は、そのビューまたは表に別名が必要になります。これは、このウィザードのステップでは、「Available Tables/Views」リストから

2-30 Oracle XML Gateway ユーザーズ・ガイド

Page 59: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

データベース・ビューまたはデータベース表を選択すると、選択したビューまたは表が削除されるためです。

ソースまたはターゲットが DTD の場合、データベース情報は必要とされないため、このステップは適用されません。

Available Tables/ViewsAPPS データベース・スキーマ・ツリーを拡張して、使用可能なすべてのデータベース表とデータベース・ビューを表示します。

Selected Tables/Views左のウィンドウから目的のデータベース・ビューおよびデータベース表を選択し、右シャトル・ボタンをクリックして、選択したデータベース・ビューまたはデータベース表を

Message Designer 2-31

Page 60: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

「Available Tables/Views」から「Selected Tables/Views」に移動します。選択した各スキーマに必要となるすべてのデータベース・ビューおよびデータベース表を選択するまで、この処理を続行します。

メッセージに必要となるすべてのデータベース・ビューとデータベース表を選択した後、使用する XML 標準の特定の要件を満たすために定義した特別な XML Gateway データベース・ビューがある場合は、そのビューを選択します。

たとえば、OAG CNTROLAREA データ型にマップする ECX_OAG_CONTROLAREA_TP_V(以前は ECX_OAG_CONTROLAREA_V)データベース・ビューを選択します。

注意注意注意注意 : ECX_OAG_CONTROLAREA_TP_V ビューは、ECX_OAG_CONTROLAREA_V ビューのアップグレード・バージョンです。Oracle XML Gateway では、両方のバージョンのデータベース・ビューがサポートされています。

アップグレードされたビューには、USERNAME、SOURCE_TP_LOCATION_CODE、PARTY_ID、PARTY_SITE_ID および PARTY_TYPEに使用する新しいフィールドが追加されていることの他に、次の既存フィールドも変更されています。

REFERENCE_ID は、システム名、アプリケーション業務イベントによって定義されるイベント名およびイベント・キーに基づいています。REFERENCE_ID は、以前はデフォルトで "1" に設定されており、ECX_REFERENCE_ID シーケンスを使用して一意の数値を取得するように推奨されていました。このフィールドの用途は、メッセージ・マップによって異なります。

イベント詳細にアクセスするには、ワークフロー項目タイプに対してECX_EVENT_MESSAGE 項目属性を追加する必要があります。

CONFIRMATION は、「Define Trading Partners」ウィンドウを使用して入力された取引先およびビジネス文書に対して定義した設定に基づいています。CONFIRMATION は、以前は、デフォルトで "0" に設定されていました。

COMPONENT は、「Define Transactions」ウィンドウでビジネス文書に対して入力された内部トランザクション・タイプに基づいています。COMPONENT は、以前は、外部トランザクション・タイプに基づいていました。

TASK は、「Define Transactions」ウィンドウでビジネス文書に対して入力された内部トランザクション・サブタイプに基づいています。TASK は、以前は、外部サブタイプに基づいていました。

TRANSACTION_SUBTYPE は、「Define Transactions」ウィンドウで入力された内部トランザクション・サブタイプに基づいています。データベースに値が見つからない場合、TRANSACTION_SUBTYPE は、以前は、デフォルトで TRANSACTION_TYPE に設定されていました。

2-32 Oracle XML Gateway ユーザーズ・ガイド

Page 61: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

選択したデータベース・ビューまたはデータベース表を選択解除するには、右のウィンドウから目的のデータベース・ビューまたはデータベース表を選択し、左シャトル・ボタンをクリックして、「Selected Tables/Views」から「Available Tables/Views」に移動します。

「Next」をクリックして続行します。「Select Source/Target Columns」ウィンドウが表示されます。

ソースソースソースソース / ターゲットの列の選択ターゲットの列の選択ターゲットの列の選択ターゲットの列の選択

このウィンドウでは、前のステップで選択した各データベース・ビューまたは各データベース表に必要となる列を入力するように要求されます。

ソースまたはターゲットが DTD の場合、データベース情報は必要とされないため、このステップは適用されません。

Message Designer 2-33

Page 62: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

Available Columns各データベース・ビューおよび各データベース表を拡張して、データベース・ビューおよびデータベース表の使用可能列をすべて表示します。

Selected Columns左のウィンドウから目的のデータベース・ビュー列またはデータベース表の列を選択し、右シャトル・ボタンをクリックして、選択したデータベース・ビュー列またはデータベース表の列を「Available Columns」から「Selected Columns」に移動します。ビューまたは表のすべての列を移動するには、表またはビューを選択し、ダブル右シャトル・ボタンをクリックして、すべての列を「Available Columns」から「Selected Columns」に移動します。必要なすべてのデータベース・ビュー列とデータベース表列を選択するまで、この処理を続行します。

ウィザードの次のステップに進むには、選択した各データベース・ビューおよび各データベース表から少なくとも 1 つの列を選択する必要があります。必要に応じて、ウィザードの前のステップに戻り、データベース・ビューまたはデータベース表を選択解除して列の選択処理をやり直すことができます。

選択したデータベース・ビュー列またはデータベース表列を選択解除するには、右のウィンドウで目的の列をハイライト表示し、左シャトル・ボタンをクリックして、ハイライト表示した列を「Selected Columns」から「Available Columns」に移動します。表またはビューのすべての列を選択解除するには、「Selected Columns」で表またはビューの名前をハイライト表示して、ダブル左シャトル・ボタンをクリックして、すべての列を「Available Columns」領域に移動します。

「Next」をクリックして続行します。「Specify Source/Target Levels」ウィンドウが表示されます。

2-34 Oracle XML Gateway ユーザーズ・ガイド

Page 63: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

ソースソースソースソース / ターゲットのレベルの指定ターゲットのレベルの指定ターゲットのレベルの指定ターゲットのレベルの指定

データ定義タイプとして「Database」を選択した場合、ソースのデータ定義またはターゲットのデータ定義の階層を指定するように要求されます。このステップは、ソースのデータ定義またはターゲットのデータ定義に複数のレベルが含まれている場合にのみ必要になります。

レベルは、繰り返されるデータの集合を表します。たとえば、発注明細は、発注の 1 つのレベルを表します。これは、1 つの発注には複数の発注明細が存在するためです。

このステップの目的は、各データベース・ビューの親子関係を識別することです。マップ作成処理の一部として、ソース階層を使用してターゲット階層に関連付けます。

ソースまたはターゲットが DTD の場合、データベース情報は必要とされないため、このステップは適用されません。

Message Designer 2-35

Page 64: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

Available Tables/Views選択対象の使用可能なデータベース・ビューおよびデータベース表が表示されます。

Selected Tables/Viewsこのウィンドウでは、選択したデータベース・ビュー、選択したデータベース表、およびデータベース・データ・モデルを DTD データ・モデルに関連付けるために必要な特別なデータベース・ビューの親子関係を定義できます。

最初に親ノードを指定します。OAG の場合、親ノードは ECX_OAG_CONTROLAREA_TP_V ビュー(以前の ECX_OAG_CONTROLAREA_V)です。親ノードに兄弟ノードまたは子ノードを関連付けます。

兄弟と子の関係を定義するには、最初に「Selected Tables/Views」ウィンドウ(右側)で親ノードを指定します。「Available」ウィンドウから「Selected」ウィンドウに移動したデータベース・ビューまたはデータベース表は、常に選択した親ノードの最後の子として追加されます。

したがって、特定のノードに対して兄弟の関係を指定するには、まず「Selected Tables/Views」列(右のウィンドウ)で親ノードを選択します。次に、そのノードの兄弟として定義するデータベース・ビューまたはデータベース表を「Available Tables/Views」(左のウィンドウ)で選択します。右シャトル・ボタンをクリックします。選択したデータベース・ビューまたはデータベース表は、選択した親ノードの最後の子として、または目的のノードの兄弟として表示されます。

特定のノードに対して子の関係を定義するには、まず「Selected Tables/Views」列(右のウィンドウ)でノードを選択します。次に、そのノードの子として定義するデータベース・ビューまたはデータベース表を「Available Tables/Views」(左のウィンドウ)で選択し、右シャトル・ボタンをクリックします。選択したデータベース・ビューまたはデータベース表が、選択した親ノードの最後の子として表示されます。

使用可能なすべてのデータベース・ビューおよびデータベース表を「Selected Tables/Views」に移動するまで、この処理を続行します。

これでデータ定義処理は完了です。

「「「「Next」をクリックして続行します」をクリックして続行します」をクリックして続行します」をクリックして続行します

ソースのデータ定義が完了した場合は、「ソース / ターゲットのデータ定義の選択 / 作成」(2-25 ページ)に戻り、ターゲットのデータ定義を定義します。

注意注意注意注意 : ECX_OAG_CONTROLAREA_TP_V ビューは、ECX_OAG_CONTROLAREA_V ビューのアップグレード・バージョンです。Oracle XML Gateway では、両方のバージョンのデータベース・ビューがサポートされています。詳細は、「注意」(2-32 ページ)を参照してください。

2-36 Oracle XML Gateway ユーザーズ・ガイド

Page 65: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

ターゲットのデータ定義が完了した場合は、「「Map Creation」ウィザードの要約」(2-40ページ)に進みます。

ソースソースソースソース / ターゲットのターゲットのターゲットのターゲットの XML ファイルおよびルート要素の指定ファイルおよびルート要素の指定ファイルおよびルート要素の指定ファイルおよびルート要素の指定

データ定義タイプとして XML を選択した場合は、XML 情報を入力するように要求されます。DTD または本番の XML メッセージをデータ定義として使用できます。

XML Standard使用する XML 標準を入力します。

デフォルトは「OAG」(オープン・アプリケーション・グループの XML 標準)です。

Message Designer 2-37

Page 66: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

Select a DTD/XML File「Browse」ボタンをクリックすると表示される使用可能な DTD のリストから DTD を選択します。または、ファイル・パスを指定して特定の DTD を入力します。選択した DTD とそのファイル・パスが表示されます。

本番の XML メッセージに基づいたデータ定義を作成するには、XML メッセージのファイル・パスおよびファイル名を入力します。

DTD または本番の XML メッセージは、Message Designer の定義ツリーを作成するために使用されます。

このステップは、必要な DTD および関連付けられた外部参照 DTD ファイルがファイル・システムで使用可能であり、Message Designer からアクセスできることを前提にしています。たとえば、OAG 定義ファイルは次のとおりです。

– oagis_domains.dtd

– oagis_resources.dtd

– oagis_fields.dtd

– oagis_segments.dtd

Identify the XML Root ElementXML ルート要素を入力します。ルート要素の名称がわからない場合は、ブラウザまたはXML エディタを使用し、DTD または本番の XML メッセージをオープンして確認します。

必要に応じて「File」>「Properties」メニュー・オプションを使用して、ルート要素を変更します。

Enter DTD File Name前のステップで DTD を入力した場合は、DTD のファイル名が自動的に表示されます。

前のステップで本番の XML メッセージを入力した場合は、「Browse」ボタンをクリックし、使用可能な DTD のリストから対応する DTD を選択します。または、特定の DTD が使用可能な場合は、その DTD を入力します。

入力した DTD ファイル名は、アウトバウンド・メッセージを送信キューに入れる前、または受信キューからデキューしたメッセージを処理する前に、メッセージが整形式であり、かつ有効であることを確認するために、メッセージを検証するときに使用されます。

また、XML Gateway 実行エンジンからアクセスできるように、主要 DTD ファイルおよび関連付けられた定義ファイルを XML Gateway リポジトリにロードする必要があります。

注意注意注意注意 : ルート要素の表現は XML 標準によって異なるため、実行エンジンに対して DTD の読込み開始位置を通知するために、このステップを行うことが必要になります。

2-38 Oracle XML Gateway ユーザーズ・ガイド

Page 67: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

必要に応じて「File」>「Properties」メニュー・オプションを使用して、DTD のファイル名を変更します。

実行時の実行時の実行時の実行時の DTD の場所の識別の場所の識別の場所の識別の場所の識別

次の命名規則に従ったサブディレクトリ名を入力します。

< アプリケーション・コード >/xml/< 標準 >< 標準のバージョン >

例 :

ar/xml/oag62

ap/xml/oag70

実行時の DTD の場所と DTD のファイル名の組合せが、必要な DTD に対する一意の識別子となります。

必要に応じて「File」>「Properties」メニュー・オプションを使用して、実行時の DTD の場所を変更します。

「「「「Next」をクリックして続行します」をクリックして続行します」をクリックして続行します」をクリックして続行します

ソースのデータ定義が完了した場合は、「ソース / ターゲットのデータ定義の選択 / 作成」(2-25 ページ)に戻り、ターゲットのデータ定義を定義します。

ターゲットのデータ定義が完了した場合は、「「Map Creation」ウィザードの要約」(2-40ページ)に進みます。

注意注意注意注意 : 詳細は、「メッセージ・マップおよび DTD のロード方法」(2-113ページ)を参照してください。

注意注意注意注意 : 標準のバージョンを参照する場合は、ピリオド(.)を使用しないでください。

Message Designer 2-39

Page 68: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Map Creation」ウィザードの使用

「「「「Map Creation」ウィザードの要約」ウィザードの要約」ウィザードの要約」ウィザードの要約

「Finish」をクリックして「Map Creation」ウィザードを終了します。マップの定義で行った選択内容を変更する場合は、「Back」ボタンをクリックして該当するウィザードのウィンドウに戻ります。

レベルと要素のマッピング処理に進む前に、XML Gateway と XML パーサーにより、次の検証が行われます。

� XML メッセージに DOCTYPE タグがある場合は、参照されている DTD が正確であるかどうかが検証されます。

� XML ルート要素と指定された DTD が一致するかどうかが検証されます。本番の XMLメッセージが指定されている場合は、指定されたルート要素と DTD が本番の XMLメッセージに一致するかどうかが検証されます。

2-40 Oracle XML Gateway ユーザーズ・ガイド

Page 69: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

� 主要 DTD によって参照されている外部 DTD が使用可能であるかどうかが検証されます。

� 循環 DTD 参照の有無がチェックされます。最初のオカレンスが処理されて残りが切り捨てられ、ユーザーに対して、必要な繰返しオカレンスを手動で追加するように警告が出されます。

「「「「Transaction Map」ウィンドウ」ウィンドウ」ウィンドウ」ウィンドウ「Map Creation」ウィザードを終了すると、「Transaction Map」ウィンドウにソースの定義とターゲットの定義が表示されます。

「Transaction Map」ウィンドウは、Message Designer のバージョン番号と互換性のあるバージョン番号の既存のマップを選択した場合にも表示されます。

マップ(.xgm ファイル)のバージョン番号は、<ECX_MAJOR_VERSION> タグと <ECX_MINOR_VERSION> タグに記載されています。Message Designer のバージョン番号は、

「Help」>「About」メニューで確認できます。マップは、メジャー・バージョンがMessage Designer と同じで、マイナー・バージョンの番号が Message Designer の番号以下である場合に互換性があります。

「Transaction Map」ウィンドウには、次の 4 つのタブがあります。

� Source Definition

� Target Definition

� Level Mapping

� Element Mapping(このタブは、レベルがマッピングされている場合にのみ表示されます。)

ソースの定義ソースの定義ソースの定義ソースの定義「Map Creation」ウィザードを使用して選択または作成したソースの定義は、「Source

Definition」タブに表示されます。ソースの定義を拡張すると、次の項目を実行できます。

� デフォルト値を設定します。

� コード変換を可能にします。

� 「Add Sibling」ボタンを使用して、複数のノードまたは複数の要素を作成します。

� 「Add Child」ボタンを使用して、フィールドを追加します。

� 複数のノードまたは複数の要素(ソースが DTD の場合)に対する条件ノード・マッピング・ルールを定義します。

� オプションの確認ビジネス・オブジェクト文書(Business Object Document: BOD)を導入します。

Message Designer 2-41

Page 70: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

ソースのデータ定義が完了した後、他のメッセージ・マップで使用するためにこの定義を保存できます。「File」>「Save (Data Definition)」メニュー・オプションまたはツールバーを使用します。デフォルトのディレクトリまたはデータ定義のプロパティ値を変更する必要がある場合は、「File」>「Properties」メニューを使用します。

ソースのデータ定義をメッセージ・マップとは関係のないエンティティとして保存しない場合は、マッピング・プロセスを継続して、トランザクション・マップを要素のマッピング・プロセスの最後に保存します。

ソースの定義における注意点ソースの定義における注意点ソースの定義における注意点ソースの定義における注意点1. 引渡しトランザクションの開発に関するガイドラインは、「引渡しメッセージのマッピ

ング方法」(2-112 ページ)を参照してください。

2. オプションの確認メッセージの実装方法に関する詳細は、「OAG 確認ビジネス・オブジェクト文書の実装方法」(4-12 ページ)を参照してください。

2-42 Oracle XML Gateway ユーザーズ・ガイド

Page 71: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

「「「「Source Definition」タブ」タブ」タブ」タブ

Field「Field」では、要素、文書またはルートの名前を指定します。これらの名前は、データベース列名、または DTD の要素名に基づいています。

このフィールド名は必要に応じて変更できますが、変更による影響を十分考慮して行ってください。このフィールドはデータベースの列名、または DTD の要素名に基づいているため、Oracle E-Business Suite または DTD において、このことに対応した変更が必要になる場合があります。DTD では、USERAREA のみが変更可能です。詳細は、「DTD の拡張方法」

(2-110 ページ)を参照してください。

最初の行は、データ定義名(ソースがデータベース・ビューまたはデータベース表に基づいている場合)、またはルート要素名(ソースが DTD の場合)のために予約されています。

「Add Sibling」ボタンまたは「Add Child」ボタンを使用して兄弟または子の要素を追加した場合は、追加したフィールド名が表示されます。

Item Type「Item Type」(項目タイプ)では、フィールドを「Level」または「Element」として指定します。「Level」とは、親子関係における親のことです。「Element」とは、親子関係における子のことです。

最初の行の項目タイプは、デフォルトで「Level」に設定されています。この値は変更できません。

ソースがデータベース・ビューまたはデータベース表に基づいている場合、データベース・ビューまたはデータベース表の項目タイプのデフォルトは「Level」に設定されています。各データベース・ビューまたは各データベース表列の項目タイプは、デフォルトで

「Element」に設定されています。

ソースが DTD または本番の XML メッセージに基づいている場合、デフォルトの項目タイプは「Element」です。DTD ではレベルはサポートされていないため、項目タイプを

「Level」に設定することによって明示的に定義する必要があります。

繰り返しのデータの集合からなるノード(発注明細や出荷明細など)は、レベルを表します。このノードの項目タイプを「Level」に設定する必要があります。

OAG 標準により、レベルのマッピングに対応するために次の項目タイプを「Level」に変更してください。

� ルート

� CNTROLAREA

� DATAAREA

マップ分析プロセスにおいてデータ・レベルと識別されたその他の DTD データ型についても、同様の変更を行います。

Message Designer 2-43

Page 72: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

新しく作成した兄弟要素または子要素の項目タイプは、デフォルトで「Element」に設定されています。必要に応じて項目タイプの設定を変更してください。

Default必要に応じて、フィールドにデフォルト値を入力します。この値は、着信値が NULL の場合にアウトバウンド・メッセージまたはインバウンド・メッセージで使用されます。

デフォルト値が条件によって変化する場合は、変数値の割当て処理を使用してデフォルト値を設定します。「割当て : 変数値の割当て」(2-76 ページ)を参照してください。

項目タイプが「Level」の場合、この列は使用不可になっています。

Category有効なコード・カテゴリを入力することにより、フィールドをコード変換対象として使用可能にします。マップの定義に使用したデータベースとトランザクションを実行するデータベースが同じであるとは限らないため、実行時にコード・カテゴリの検証が行われます。シードされたコード・カテゴリのリストについては、「シード済コード・カテゴリ」(B-2ページ)を参照してください。

汎用または標準固有のコード変換値は、「コード変換の定義」フォームを使用して定義します。取引先固有のコード変換値は、「取引先コード変換」フォームを使用して定義します。

実行エンジンにより、次の順序でコード変換値が検索されます。

– 取引先

– 標準固有

– 汎用リスト

事前定義済変数値の取得処理を使用して、コード変換対象として使用可能になっているソース列に対するコード変換処理のステータスを調べます。

コード変換のリターン・ステータス、およびコード変換の相互参照値が見つからなかった場合に実行する処置の詳細は、「事前定義済変数値の取得」(2-99 ページ)を参照してください。

コード変換は、どの処理よりも前に適用されます。コード変換対象として使用可能になっているソース列に対して処理を定義する場合は、コード変換のリターン・ステータスを考慮してください。処理は、コード変換処理が成功した場合にのみ、コード変換された値に適用されます。

項目タイプがレベルの場合、この列は使用不可になっています。

2-44 Oracle XML Gateway ユーザーズ・ガイド

Page 73: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

Data Type各フィールドには、データ型が定義されています。XML Gateway 実行エンジンでサポートされているデータ型は、VARCHAR2、DATE、NUMBER、CHAR および CLOB です。

CLOB データ型は、サイズが 4GB までの大きなオブジェクトを取り扱うために使用します。CLOB は、解析を回避するために CDATA タグの間に表示されます。

ソースがデータベース・ビューまたはデータベース表に基づいている場合、データ型のデフォルトは、ビュー列または表列に定義されたデータ型になります。

ソースが DTD または本番の XML メッセージに基づいている場合、データ型のデフォルトは VARCHAR2 に設定されます。

新しく作成した兄弟要素または子要素のデータ型は、デフォルトで VARCHAR2 に設定されています。必要に応じてデータ型の設定を変更してください。

項目タイプが「Level」の場合、「Data Type」列は使用不可になっています。

DB Columnソースがデータベース・ビューまたはデータベース表に基づいている場合にのみ、「DB Column」(DB 列)を使用できます。

チェック・マークが付いている場合は、その列が Oracle E-Business Suite のデータ・モデルで定義されていることを意味します。この設定によって、Oracle E-Business Suite のデータ・モデルに対して要素を検証するかどうかが XML Gateway 実行エンジンに通知されます。

項目タイプが「Level」の場合、DB 列は使用不可になっています。

Node Type「Node Type」(ノード・タイプ)は、ソースが DTD の場合にのみ使用できます。デフォルトは DTD 設定です。

有効値は、「Element」または「Attribute」です。「Element」には、ビジネス・データが含まれています。「Attribute」には、ビジネス・データの意味を示すためのクオリファイアが含まれています。

注意注意注意注意 : XML の基準団体によって XML スキーマがサポートされ、データ型が有効に使用されるようになるまでは、DTD 要素のデータ型を変更する必要はありません。

Message Designer 2-45

Page 74: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

新しく作成した兄弟要素または子要素のノード・タイプは、デフォルトで「Element」に設定されています。必要に応じてノード・タイプの設定を変更してください。

項目タイプが「Level」の場合、この列は使用不可になっています。

Add Sibling(ボタン)(ボタン)(ボタン)(ボタン)

「Add Sibling」ボタンを使用すると、マップを完成させるために必要な新しいフィールドを追加できます。この機能を使用すると、PARTNER などの DTD ノードを複製することもできます。

ソースが DTD または本番の XML メッセージに基づいており、2 つの属性の間に兄弟を追加する場合は、新しく作成するフィールドのノード・タイプの設定を「Attribute」にします。デフォルトのノード・タイプである「Element」では、パーサー違反となります。

Add Child(ボタン)(ボタン)(ボタン)(ボタン)

「Add Child」ボタンを使用すると、既存の兄弟または子に子要素を追加できます。また、ソースまたはターゲットが DTD の場合は、「Add Child」ボタンを使用して、ルート要素の属性を定義することもできます。

この機能は、ソースがデータベース・ビューまたはデータベース表あるいは DTD の場合に使用できます。

ノード・タイプが「Attribute」の場合、「Add Child」ボタンは使用不可になっています。ある属性に対して属性を定義することはできません。

注意注意注意注意 : ルート・ノードに兄弟を追加することはできません。

注意注意注意注意 : DTD の拡張方法の詳細は、「DTD の拡張方法」(2-110 ページ)を参照してください。この項には、XML パーサーに DTD 拡張を認識させる場合に従う必要のある命名規則が記載されています。

注意注意注意注意 : DTD の拡張方法の詳細は、「DTD の拡張方法」(2-110 ページ)を参照してください。この項には、XML パーサーに DTD 拡張を認識させる場合に従う必要のある命名規則が記載されています。

2-46 Oracle XML Gateway ユーザーズ・ガイド

Page 75: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

不連続ノード不連続ノード不連続ノード不連続ノード

不連続ノードとは、レベルに属していてそのレベルの兄弟である、非レベル・ノードのことです。次の図に、このノードを示します。

この例では、レベル LINE DETAILS と LINE TERMS は、レベル LINE の子であり、相互に兄弟の関係にあります。LINE ノードの新しい要素が、LINE DETAILS と LINE TERMS の間に挿入されています。新しい要素は LINE ノードと連続していますが、この要素により、LINE DETAILS と LINE TERMS の間が分断されます。

新しい要素は、LINE DETAILS ノードの前で LINE ノードの最後の要素として配置します。ただし、基準団体によっては、既存の DTD の再構成に柔軟に対応していなかったり、下位互換性に積極的に対応していない場合もあります。理由は様々ですが、このような状況であるため、このことは XML Gateway によってサポートされています。

Oracle のデータ・モデルに基づいたデータ定義では、Message Designer の「Add Child」ボタンか「Add Sibling」ボタン、不連続ノードを定義するための「Transaction Map」ウィンドウを使用してください。ソースに追加された新しいノードが、複数のターゲット・レベルに分散(拡張)されているか、または 1 つのターゲット・レベルで一元管理されている(縮小)場合は、親ノードとともにターゲット定義に従ってマッピングされます。この場合、レベルの交差に対するルールも適用されます。

DTD に基づいたデータ定義では、「Transaction Map」ウィンドウ、項目タイプ列を使用して、データ・レベルを明示的に指定します。これにより、不連続ノードが作成されます。このノードは、次に示す無効なシナリオを定義しない限り、問題となることはありません。OAG DTD に対してサポートされている唯一のユーザー拡張は、USERAREA にあります。USERAREA 以外の DTD を修正(「Add Child」ボタンまたは「Add Sibling」ボタンを使用)すると、解析エラーが発生します。

新しい要素�

Message Designer 2-47

Page 76: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

Message Designer を使用すると、ソースまたはターゲットの定義の任意の場所に不連続ノードを定義できます。定義内容が有効かどうかは実行しない限りわかりません。このため、子ノードのあるノードを不連続ノードにしないようにする必要があります。

次の図に、無効な定義の例を示します。

前述の例では、HEADER.element3 は、HEADER ノードと連続しています。HEADER.element3 は、LINE ノードの子としても定義されています。HEADER.element3 には、LINE DETAILS という子ノードがあります。これは無効な定義です。

Delete(ボタン)(ボタン)(ボタン)(ボタン)

「Delete」ボタンを使用すると、マッピングされていない兄弟要素や子要素を削除できます。

兄弟または子に関連する子要素が兄弟または子に存在する場合は、削除が行われる前に警告が表示されます。

注意注意注意注意 : DTD 拡張を削除する場合は、アプリケーションまたはユーザー用に作成された該当する拡張ファイルから DTD 拡張を削除するようにしてください。余分な情報が付加されていてもパーサー違反にはなりませんが、拡張ファイルをメッセージ・マップに一致させることをお薦めします。詳細は、「DTD の拡張方法」(2-110 ページ)を参照してください。

2-48 Oracle XML Gateway ユーザーズ・ガイド

Page 77: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

「「「「Conditional Node Mapping」ウィンドウ」ウィンドウ」ウィンドウ」ウィンドウ

Condition.../Delete Condition同じ名前の複数のノードまたは複数の要素がある DTD に基づいたソースの定義の場合、

「Conditional Node Mapping」を使用して、ソースからターゲットへのマッピングが正しく実行されたことを確認します。複数のノードおよび複数の要素の順序は固定されていないため、この確認を行う必要があります。

DTD で頻繁に発生する複数のノードの例は、DATETIME、AMOUNT、OPERAMT およびQUANTITY です。たとえば、発注の場合、DATETIME の最初のオカレンスがオーダー日を表し、2 番目のオカレンスが納期を表すことがあります。

条件ノード・マッピングを使用すると、ソース・ノードとターゲット・ノードの関係をキー要素の値に基づいて定義できます。キー要素は、タグ名とノード値の組合せによって指定します。前述の発注の例では、オーダー日を表す DATETIME の最初のオカレンスは、タグ名が " クオリファイア " で、ノード値が "PO" です。DATETIME の 2 番目のオカレンスは、タグ名は同じ " クオリファイア " ですが、ノード値は納期を示す "PROMDELV" です。

キー値を定義するには、ソース DTD ノードを選択し、マウスの右ボタンをクリックして「Conditional Node Mapping」ウィンドウを表示します。次の処理が要求されます。

Tag Name 値リストからタグ名を選択します。

前述の例の場合、ノードおよびノードの意味を一意に識別する、DATETIME セグメントに関連付けられた " クオリファイア " 属性を選択します。

Node Value ノード値を入力します。

前述の例の場合、"PO" または "PROMDELV" を入力します。

Message Designer 2-49

Page 78: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

複数のノードおよび複数の要素それぞれに対してこの処理を繰り返します。Message Designer では、ノードまたは要素ごとに 1 つの条件を使用できます。

ノードに対する条件ノード・マッピング指示を削除するには、ノードを選択し、マウスの右ボタンをクリックして「Delete Condition」機能を起動します。

条件ノード・マッピングは、DTD または本番の XML メッセージに基づいたソース・データ定義に適用可能です。ソース・データ定義がデータベース・ビューまたはデータベース表に基づいている場合は適用されません。

トランザクション・マップトランザクション・マップトランザクション・マップトランザクション・マップ - ターゲットの定義ターゲットの定義ターゲットの定義ターゲットの定義「Map Creation」ウィザードを使用して選択または作成したターゲットの定義は、「Target

Definition」タブに表示されます。ターゲットの定義を拡張すると、次の項目を実行できます。

� デフォルト値を設定します。

� 「Add Sibling」ボタンを使用して、複製のノードや要素を作成します。

� 「Add Child」ボタンを使用して、フィールドを追加します。

� マッピングされていない未使用の DTD 要素を削除して、パーサー違反を回避します。

� オプションの確認ビジネス・オブジェクト文書(Business Object Document: BOD)を導入します。

ターゲット・データの定義が完了した後、他のメッセージ・マップで使用するためにこの定義を保存できます。このことを行うには、「File」>「Save (Data Definition)」メニュー・オプションまたはツールバーを使用します。デフォルトのディレクトリまたはデータ定義のプロパティ値を変更する必要がある場合は、「File」>「Properties」メニュー・オプションを使用します。

ターゲット・データの定義をメッセージ・マップとは関係のないエンティティとして保存しない場合は、マッピング・プロセスを継続して、トランザクション・マップを要素のマッピング・プロセスの最後に保存します。

2-50 Oracle XML Gateway ユーザーズ・ガイド

Page 79: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

ターゲットの定義における注意点ターゲットの定義における注意点ターゲットの定義における注意点ターゲットの定義における注意点1. 引渡しトランザクションの開発に関するガイドラインは、「引渡しメッセージのマッピ

ング方法」(2-112 ページ)を参照してください。

2. インバウンド・メッセージを(アプリケーション・オープン・インタフェース表にマッピングするのではなく)アプリケーション API にマッピングする方法のガイドラインは、「API へのマッピング方法」(2-112 ページ)を参照してください。

3. オプションの確認メッセージの実装方法に関する詳細は、「OAG 確認ビジネス・オブジェクト文書の実装方法」(4-12 ページ)を参照してください。

4. 発生識別子として "|" を使用して定義した DTD 要素については、選択リストから要素を 1 つ選択して、使用していない要素を削除します。パーサーによって、1 つの要素のみが使用されていることが検証されます。

5. 未使用のためマッピングされていないオプションの DTD のデータ型および要素を削除します。これらを削除しない場合は、これらの要素が空のタグとしてメッセージに表示されます。

6. 未使用のためマッピングされていない DTD のデータ型および要素を削除しない場合は、データ型または要素のデフォルト属性を「OTHER」にします。データ型または要素がオプションの場合でも、パーサーには属性が必要となります。

Message Designer 2-51

Page 80: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

「「「「Target Definition」タブ」タブ」タブ」タブ

Field「Field」では、要素、文書またはルートの名前を指定します。この名前は、アプリケーション・オープン・インタフェース表の列名、または DTD の要素名に基づいています。

このフィールド名は必要に応じて変更できますが、変更による影響を十分考慮して行ってください。このフィールドはデータベースの列名、または DTD の要素名に基づいているため、Oracle E-Business Suite または DTD において、このことに対応した変更が必要になる場合があります。DTD では、USERAREA のみが変更可能です。詳細は、「DTD の拡張方法」

(2-110 ページ)を参照してください。

最初の行は、データ定義名(ターゲットがアプリケーション・オープン・インタフェースに基づいている場合)、または DTD のルート要素名(ターゲットが DTD の場合)のために予約されています。

2-52 Oracle XML Gateway ユーザーズ・ガイド

Page 81: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

「Add Sibling」ボタンまたは「Add Child」ボタンを使用して兄弟または子の要素を追加した場合は、追加したフィールド名が表示されます。

Item Type「Item Type」(項目タイプ)では、フィールドを「Level」または「Element」として指定します。「Level」とは、親子関係における親のことです。「Element」とは、親子関係における子のことです。

最初の行の項目タイプは、デフォルトで「Level」に設定されています。このデフォルト値は変更できません。

ターゲットがアプリケーション・オープン・インタフェース表に基づいている場合、表の項目タイプのデフォルトは「Level」に設定されています。列の項目タイプは、デフォルトで

「Element」に設定されています。

ターゲットが DTD または本番の XML メッセージに基づいている場合、デフォルトの項目タイプは「Element」です。DTD ではレベルはサポートされていないため、項目タイプを

「Level」に設定することによって明示的に定義する必要があります。

繰り返しのデータの集合からなるノード(発注明細や出荷明細など)は、レベルを表します。このノードの項目タイプを「Level」に設定する必要があります。

OAG の基準により、レベルのマッピングに対応するために次の項目タイプを「Level」に変更してください。

� ルート

� CNTROLAREA

� DATAAREA

マップ分析プロセスにおいてデータ・レベルと識別されたその他の DTD データ型についても、同様の変更を行います。

新しく作成した兄弟要素または子要素の項目タイプは、デフォルトで「Element」に設定されています。必要に応じて項目タイプの設定を変更してください。

Default必要に応じて、フィールドにデフォルト値を入力します。このデフォルト値は、アウトバウンド・メッセージで使用されます。この値は、入力値が NULL であるインバウンド・メッセージでも使用されます。

ターゲットが DTD の場合は、この「デフォルト」列を使用して DTD の属性値を設定します。この値は、メッセージの作成時に、対応する属性タグとともに表示されます。

デフォルト値が条件によって変化する場合は、変数値の割当て処理を使用してデフォルト値を設定します。「割当て : 変数値の割当て」(2-76 ページ)を参照してください。

項目タイプがレベルの場合、この列は使用不可になっています。

Message Designer 2-53

Page 82: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

Data Type各フィールドには、データ型が定義されています。XML Gateway 実行エンジンでサポートされているデータ型は、VARCHAR2、DATE、NUMBER、CHAR および CLOB です。

CLOB データ型は、サイズが 4GB までの大きなオブジェクトを取り扱うために使用します。CLOB は、解析を回避するために CDATA タグの間に表示されます。

ターゲットがアプリケーション・オープン・インタフェース表に基づいている場合、データ型のデフォルトは、データベースの列に定義されたデータ型になります。

ターゲットが DTD または本番の XML メッセージに基づいている場合、データ型のデフォルトは VARCHAR2 に設定されます。

新しく作成した兄弟要素または子要素のデータ型は、デフォルトで VARCHAR2 に設定されています。必要に応じてデータ型の設定を変更してください。

項目タイプが「Level」の場合、データ型列は使用不可になっています。

DB Columnターゲットがアプリケーション・オープン・インタフェース表に基づいている場合にのみ、

「DB Column」(DB 列)を使用できます。

チェック・マークが付いている場合は、その列が Oracle E-Business Suite のデータ・モデルで定義されていることを意味します。この設定によって、Oracle E-Business Suite のデータ・モデルに対して要素を検証するかどうかが XML Gateway 実行エンジンに通知されます。

項目タイプが「Level」の場合、DB 列は使用不可になっています。

Node Type「Node Type」(ノード・タイプ)は、ターゲットが DTD の場合にのみ使用できます。デフォルトは DTD 設定です。

有効値は、「Element」または「Attribute」です。「Element」には、ビジネス・データが含まれています。また、「Attribute」には、ビジネス・データの意味を示すためのクオリファイアが含まれています。

新しく作成した兄弟要素または子要素のノード・タイプは、デフォルトで「Element」に設定されています。必要に応じてノード・タイプの設定を変更してください。

項目タイプが「Level」の場合、ノード・タイプ列は使用不可になっています。

注意注意注意注意 : XML の基準団体によって XML スキーマがサポートされ、データ型が有効に使用されるようになるまでは、DTD 要素のデータ型を変更する必要はありません。

2-54 Oracle XML Gateway ユーザーズ・ガイド

Page 83: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

Add Sibling(ボタン)(ボタン)(ボタン)(ボタン)

「Add Sibling」ボタンを使用すると、マップを完成させるために必要な新しいフィールドを追加できます。この機能を使用すると、PARTNER などの DTD ノードを複製することもできます。

ターゲットがアプリケーション・オープン・インタフェース表の場合でも、同様のことを実行できます。

ターゲットが DTD または本番の XML メッセージに基づいており、2 つの属性の間に兄弟を追加する場合は、新しく作成するフィールドのノード・タイプの設定を「Attribute」にします。デフォルトのノード・タイプである「Element」では、パーサー違反となります。

Add Child(ボタン)(ボタン)(ボタン)(ボタン)

「Add Child」ボタンを使用すると、既存の兄弟または子に子要素を追加できます。また、ソースまたはターゲットが DTD の場合は、「Add Child」ボタンを使用して、ルート要素の属性を定義することもできます。

この機能は、ターゲットがアプリケーション・オープン・インタフェース表または DTD の場合に使用できます。

ノード・タイプが「Attribute」の場合、「Add Child」ボタンは使用不可になっています。ある属性に対して属性を定義することはできません。

注意注意注意注意 : ルート・ノードに兄弟を追加することはできません。

注意注意注意注意 : DTD の拡張方法の詳細は、「DTD の拡張方法」(2-110 ページ)を参照してください。この項には、XML パーサーに DTD 拡張を認識させる場合に従う必要のある命名規則が記載されています。

注意注意注意注意 : DTD の拡張方法の詳細は、「DTD の拡張方法」(2-110 ページ)を参照してください。この項には、XML パーサーに DTD 拡張を認識させる場合に従う必要のある命名規則が記載されています。

Message Designer 2-55

Page 84: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

不連続ノード不連続ノード不連続ノード不連続ノード

不連続ノードとは、レベルに属していてそのレベルの兄弟である、非レベル・ノードのことです。次の図に、このノードを示します。

不連続ノード

この例では、レベル LINE DETAILS と LINE TERMS は、レベル LINE の子であり、相互に兄弟の関係にあります。LINE ノードの新しい要素が、LINE DETAILS と LINE TERMS の間に挿入されています。新しい要素は LINE ノードと連続していますが、この要素により、LINE DETAILS と LINE TERMS の間が分断されます。

新しい要素は、LINE DETAILS ノードの前で LINE ノードの最後の要素として配置します。ただし、基準団体によっては、既存の DTD の再構成に柔軟に対応していなかったり、下位互換性に積極的に対応していない場合もあります。理由は様々ですが、このような状況であるため、このことは XML Gateway によってサポートされています。

Oracle のデータ・モデルに基づいたデータ定義では、Message Designer の「Add Child」ボタンか「Add Sibling」ボタン、不連続ノードを定義するための「Transaction Map」ウィンドウを使用してください。ソースに追加された新しいノードが、複数のターゲット・レベルに分散(拡張)されているか、または 1 つのターゲット・レベルで一元管理されている(縮小)場合は、親ノードとともにターゲット定義に従ってマッピングされます。この場合、レベルの交差に対するルールも適用されます。

DTD に基づいたデータ定義では、「Transaction Map」ウィンドウ、項目タイプ列を使用して、データ・レベルを明示的に指定します。これにより、不連続ノードが作成されます。このノードは、次に示す無効なシナリオを定義しない限り、問題となることはありません。OAG DTD に対してサポートされている唯一のユーザー拡張は、USERAREA にあります。USERAREA 以外の DTD を修正(「Add Child」ボタンまたは「Add Sibling」ボタンを使用)すると、解析エラーが発生します。

新しい要素�

2-56 Oracle XML Gateway ユーザーズ・ガイド

Page 85: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

Message Designer を使用すると、ソースまたはターゲットの定義の任意の場所に不連続ノードを定義できます。定義内容が有効かどうかは実行しない限りわかりません。このため、子ノードのあるノードを不連続ノードにしないようにする必要があります。

次の図に、無効な定義の例を示します。

無効な不連続ノードの定義

前述の例では、HEADER.element3 は、HEADER ノードと連続しています。HEADER.element3 は、LINE ノードの子としても定義されています。HEADER.element3 には、LINE DETAILS という子ノードがあります。これは無効な定義です。

Delete(ボタン)(ボタン)(ボタン)(ボタン)

「Delete」ボタンを使用すると、マッピングされていない兄弟要素や子要素を削除できます。

兄弟または子に関連する子要素が兄弟または子に存在する場合は、削除が行われる前に警告が表示されます。

注意注意注意注意 : DTD 拡張を削除する場合は、アプリケーションまたはユーザー用に作成された該当する拡張ファイルから DTD 拡張を削除するようにしてください。余分な情報が付加されていてもパーサー違反にはなりませんが、拡張ファイルをメッセージ・マップに一致させることをお薦めします。詳細は、「DTD の拡張方法」(2-110 ページ)を参照してください。

Message Designer 2-57

Page 86: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

トランザクション・マップトランザクション・マップトランザクション・マップトランザクション・マップ - 「「「「Level Mapping」タブ」タブ」タブ」タブ

「Level Mapping」タブでは、ソース定義は左のウィンドウに表示され、ターゲット定義は右のウィンドウに表示されます。「Level Mapping」タブを使用して、ソース階層をターゲット階層に関連付けます。レベルとして定義されたエントリは、すべて太字で表示されます。

ソース・レベルを選択して、関連付けるターゲット・レベルにドラッグします。ターゲット・レベル名の右側に、ソース・レベル名とマッピング済アイコンが表示され、レベルがマッピングされていることが示されます。

このようにならない場合は、DTD エンティティの「Item Type」が「Level」に設定されていません。「Source Definition」タブまたは「Target Definition」タブに戻って適切な「Item Type」を設定してから、レベルのマッピングを再度実行します。

2-58 Oracle XML Gateway ユーザーズ・ガイド

Page 87: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

マッピング済レベルのマッピングを解除するには、ターゲット・ウィンドウ上でマッピング済レベルを選択して、ソース・レベルにドラッグして戻します。

OAG DTD におけるレベルのマッピングのガイドラインにおけるレベルのマッピングのガイドラインにおけるレベルのマッピングのガイドラインにおけるレベルのマッピングのガイドライン

1. OAG 標準のアウトバウンド・メッセージの場合は、ECX_OAG_CONTROLAREA_TP_V ビュー(以前は ECX_OAG_CONTROLAREA_V)を DTD CNTROLAREA データ型にマッピングします。インバウンド・メッセージの場合は、DTD CNTROLAREA の内容が Oracle E-Business Suite に格納されていないため、この手順を実行する必要はありません。

2. 1 つのメッセージに複数の文書が含まれている場合は、データベース・ヘッダー・ビューを OAG 文書ヘッダーのデータ型にマッピングします。1 つのメッセージに 1 つの文書が含まれている場合は、データベース・ヘッダー・ビューを OAG DATAAREAデータ型にマッピングします。

レベルの縮小におけるレベルのマッピングのガイドラインレベルの縮小におけるレベルのマッピングのガイドラインレベルの縮小におけるレベルのマッピングのガイドラインレベルの縮小におけるレベルのマッピングのガイドライン

1 つのターゲット・レベルに複数のソース・レベルをマッピングできます。一般的に、このことはレベルの縮小と呼ばれます。たとえば、ソースが 3 レベルでターゲットが 2 レベルの場合は、次の図のようにこれらのレベルを縮小できます。

正しいレベルの縮小方法正しいレベルの縮小方法正しいレベルの縮小方法正しいレベルの縮小方法 誤ったレベルの縮小方法誤ったレベルの縮小方法誤ったレベルの縮小方法誤ったレベルの縮小方法

前述の正しい例では、ソース・レベルが 3 つ、ターゲット・レベルが 2 つあります。ソース・レベル 1 はターゲット・レベル 1 にマッピングされています。ソース・レベル 2 と 3 は

注意注意注意注意 : ECX_OAG_CONTROLAREA_TP_V ビューは、ECX_OAG_CONTROLAREA_V ビューのアップグレード・バージョンです。Oracle XML Gateway では、両方のバージョンのデータベース・ビューがサポートされています。相違点の詳細は、この章の前半の「注意」(2-32 ページ)を参照してください。

ソース・�レベル1

ソース・�レベル2

ソース・�レベル3

ターゲット・�レベル1

ターゲット・�レベル2

ソース・�レベル1

ソース・�レベル2

ソース・�レベル3

ターゲット・�レベル1

ターゲット・�レベル2

Message Designer 2-59

Page 88: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

ターゲット・レベル 2 にマッピングされています。レベルを縮小すると、ソース・レベル 2と 3 のデータが連結されて、ターゲット・レベル 2 にマッピングされることになります。ソース・レベル 2 に行が 2 つあり、ソース・レベル 3 に行が 3 つある場合、ターゲット・レベル 2 には合計 6 つの行が作成されます。

誤ったレベルの縮小方法に示した例では、ソース・レベル 3 が、ターゲット・レベル 2 を交差してターゲット・レベル 1 にマッピングされています。

別のオプションとして、次に示す例のように、ソース・レベル 1 と 2 をターゲット・レベル1 に、ソース・レベル 3 をターゲット・レベル 2 に関連付ける方法があります(ターゲット・レベル 2 を交差してソース・レベル 1 と 3 をターゲット・レベル 1 にマッピングしないしないしないしないでくださいでくださいでくださいでください)。

正しいレベルの縮小方法正しいレベルの縮小方法正しいレベルの縮小方法正しいレベルの縮小方法 誤ったレベルの縮小方法誤ったレベルの縮小方法誤ったレベルの縮小方法誤ったレベルの縮小方法

いずれのオプションを選択する場合でも、下位レベルの詳細データを上位レベルのデータに昇格させることの意味を十分考慮してください。上位レベルで利用価値を持たせるには、下位レベルのデータを集約する必要がある場合があります。

レベルの拡張におけるレベルのマッピングのガイドラインレベルの拡張におけるレベルのマッピングのガイドラインレベルの拡張におけるレベルのマッピングのガイドラインレベルの拡張におけるレベルのマッピングのガイドライン

1 つのソース・レベルを複数のターゲット・レベルにマッピングできます。一般的に、このことはレベルの拡張と呼ばれます。たとえば、ソースが 2 レベルでターゲットが 3 レベルの場合は、次の図のようにこれらのレベルを拡張できます。

ソース・�レベル1

ソース・�レベル2

ソース・�レベル3

ターゲット・�レベル1

ターゲット・�レベル2

ソース・�レベル1

ソース・�レベル2

ソース・�レベル3

ターゲット・�レベル1

ターゲット・�レベル2

2-60 Oracle XML Gateway ユーザーズ・ガイド

Page 89: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

正しいレベルの拡張方法正しいレベルの拡張方法正しいレベルの拡張方法正しいレベルの拡張方法 誤ったレベルの拡張方法誤ったレベルの拡張方法誤ったレベルの拡張方法誤ったレベルの拡張方法

前述の正しい例では、ソース・レベル 1 はターゲット・レベル 1 にマッピングされ、ソース・レベル 2 はターゲット・レベル 2 と 3 にマッピングされています。レベルを拡張すると、ソース・レベル 2 のデータはターゲット・レベル 2 と 3 に分散してマッピングされることになります。ソース・レベル 2 に行が 2 つある場合は、ターゲット・レベル 2 とターゲット・レベル 3 に 2 つの行が作成されます。

誤ったレベルの拡張方法に示した例では、ソース・レベル 1 が、ターゲット・レベル 2 を交差してターゲット・レベル 1 とターゲット・レベル 3 にマッピングされています。

別のオプションとして、次に示す例のように、ソース・レベル 1 をターゲット・レベル 1 と2 に分散して、ソース・レベル 2 をターゲット・レベル 3 にマッピングする方法があります

(ターゲット・レベル 2 を交差してソース・レベル 1 をターゲット・レベル 1 と 3 にマッピングしないでくださいしないでくださいしないでくださいしないでください)。

正しいレベルの拡張方法正しいレベルの拡張方法正しいレベルの拡張方法正しいレベルの拡張方法 誤ったレベルの拡張方法誤ったレベルの拡張方法誤ったレベルの拡張方法誤ったレベルの拡張方法

いずれの方法を選択する場合でも、上位レベルから下位レベルに詳細データを降格させることの意味を十分考慮してください。下位レベルで利用価値を持たせるには、上位レベルのデータを集約解除する必要がある場合があります。

ソース・�レベル1

ソース・�レベル2

ターゲット・�レベル1

ターゲット・�レベル2

ターゲット・�レベル3

ソース・�レベル1

ソース・�レベル2

ターゲット・�レベル1

ターゲット・�レベル2

ターゲット・�レベル3

ソース・�レベル1

ソース・�レベル2

ターゲット・�レベル1

ターゲット・�レベル2

ターゲット・�レベル3

ソース・�レベル1

ソース・�レベル2

ターゲット・�レベル1

ターゲット・�レベル2

ターゲット・�レベル3

Message Designer 2-61

Page 90: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

不連続ノードのレベルの拡張不連続ノードのレベルの拡張不連続ノードのレベルの拡張不連続ノードのレベルの拡張

ターゲットの拡張されたレベルがすべて兄弟の関係にあるか、またはこれらのレベルがすべて前のノードの子である場合は、レベルの拡張がサポートされます。

有効なレベルの拡張の例

前述の例において、ターゲット・レベル 2 とターゲット・レベル 3 は、相互に兄弟の関係にあり、いずれもターゲット・レベル 1 の子です。

無効なレベルの拡張の例

前述の無効なレベル拡張の例において、ターゲット・レベル 2 とターゲット・レベル 3 は、相互に兄弟の関係にあり、いずれもターゲット・レベル 1 の子です。ターゲット・レベル 4は、ターゲット・レベル 1 と兄弟の関係にあり、ターゲット・レベル 2 とターゲット・レベル 3 とは関係していません。

不連続ノードの詳細は、「不連続ノード」(2-56 ページ)を参照してください。

ソース・レベル1 ターゲット・レベル1

ソース・レベル2ターゲット・レベル2

ターゲット・レベル3

ソース・�レベル1

ソース・�レベル2

ターゲット・レベル1

ターゲット・レベル2

ターゲット・レベル3

ターゲット・レベル4

2-62 Oracle XML Gateway ユーザーズ・ガイド

Page 91: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

トランザクション・マップトランザクション・マップトランザクション・マップトランザクション・マップ - 要素のマッピング要素のマッピング要素のマッピング要素のマッピング

「Element Mapping」タブが使用できない場合は、レベルのマッピング処理において、少なくとも 1 つのレベルのマッピングが完了していないことを意味します。

レベルのマッピング処理が完了すると、ソースの定義が左のウィンドウに表示され、ターゲットの定義が右のウィンドウに表示されます。「Level Mapping」タブで定義したソースの階層とターゲットの階層は、太字で表示されます。メッセージ・マップを作成するには、

「Element Mapping」タブを使用します。

ソース要素を選択して、ターゲット要素にドラッグします。定義されているノードの条件(条件ノード・マッピングなど)に対して注意を払い、複製されたノードが正しいターゲットのエンティティにマッピングされるようにします。ターゲット要素名の横に、ソース要素名とマッピング済アイコンが表示され、要素がマッピングされていることが示されます。

Message Designer 2-63

Page 92: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

マッピング済要素のマッピングを解除するには、ターゲット・ウィンドウ上でマッピング済要素を選択して、ソース要素にドラッグして戻します。

要素のマッピングのガイドライン要素のマッピングのガイドライン要素のマッピングのガイドライン要素のマッピングのガイドライン1. 下位レベルの要素を上位レベルの要素にマッピングしないでください。下位レベルの要

素値は、ヘッダー・レベルの要素の処理が完了するまでは使用できません。

2. 上位レベルの要素は、下位レベルの要素にマッピングできます。ただし、詳細レベルの要素の利用価値があるようにするために、上位レベルの要素値を修正する必要がある場合もあります。

たとえば、ヘッダー・レベルの要素が請求書の合計であり、明細レベルの要素が請求書明細の合計である場合、請求書明細におけるヘッダーの請求書の合計に利用価値を持たせるには、明細の額に基づいて、ヘッダーの請求書の合計を複数の請求書明細に分散させる必要があります。

3. 1 つのソース要素は、複数のターゲット要素にマッピングできます。

4. 条件ノード・マッピング指示が含まれているソース要素を確認します。ソース要素を条件に関連するターゲット要素にマッピングします。

OAG 標準のアウトバウンド・メッセージ(ソースがデータベース、ターゲットがDTD)の場合は、ECX_OAG_CONTROLAREA_TP_V ビュー(以前は ECX_OAG_CONTROLAREA_V)の列を DTD CNTROLAREA データ型要素にマッピングします。インバウンド・メッセージ(ソースが DTD、ターゲットがデータベース)の場合は、DTD CNTROLAREA の内容が Oracle E-Business Suite に格納されていないため、この手順を実行する必要はありません。

ビューの列名は DTD CNTROLAREA データ型の要素名と同じであるため、1 対 1 のマッピングとなります。マップを完成するには、次の必要な処理を追加します。

� OAG DATETIME への変換処理を使用して、Oracle のデータを CNTROLAREA DATETIME 要素に変換します。

� Where 句の追加処理を使用して、トランザクション・タイプとトランザクション・サブタイプを ECX_OAG_CONTROLAREA_V ビューにバインドします。ECX_OAG_CONTROLAREA_TP_V ビューを使用している場合は、Where 句の追加処理を使用して、トランザクション・タイプ、トランザクション・サブタイプ、パーティ ID、パーティ・サイト ID、パーティ・タイプを ECX_OAG_CONTROLAREA_TP_V ビューにバインドします。

注意注意注意注意 : ECX_OAG_CONTROLAREA_TP_V ビューは、ECX_OAG_CONTROLAREA_V ビューのアップグレード・バージョンです。Oracle XML Gateway では、両方のバージョンのデータベース・ビューがサポートされています。相違点の詳細は、この章の前半の「注意」(2-32 ページ)を参照してください。

2-64 Oracle XML Gateway ユーザーズ・ガイド

Page 93: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

「トランザクションの定義」フォームを使用して、メッセージで Oracle の名前となるトランザクションおよびトランザクション・サブタイプを定義します。外部タイプと外部サブタイプはメッセージの内部名と関連付けられており、XML 標準のメッセージ名を示します。

OAG の場合、外部サブタイプは BSR VERB に対応し、外部タイプは BSR NOUN に対応します。「トランザクションの定義」フォームで入力した名前はデータベースに格納され、ECX_OAG_CONTROLAREA_TP_V ビューによってアクセスされます。BSR VERB 要素および BSR NOUN 要素のデフォルト値として、これらの値が Message Designer に表示されます。

要素のマッピング・アイコン要素のマッピング・アイコン要素のマッピング・アイコン要素のマッピング・アイコンMessage Designer を使用すると、アイコン・グループによってマップの状態を簡単に確認することができます。アイコン・グループの構成部品は、次のとおりです。

注意注意注意注意 : ECX_OAG_CONTROLAREA_TP_V ビューは、ECX_OAG_CONTROLAREA_V ビューのアップグレード・バージョンです。Oracle XML Gateway では、両方のバージョンのデータベース・ビューがサポートされています。相違点の詳細は、この章の前半の「注意」(2-32 ページ)を参照してください。

「Mapped Element」アイコン

「Action Defined」アイコン

「Code Conversion Enabled」アイコン

各構成部品は、グループ・アイコン内にオンまたはオフ(グレイ・アウト)で表示され、要素の状態が示されます。機能および機能に対応するアイコン・グループの表示例は、次のとおりです。

要素がマッピングのみされた状態

要素がマッピングされ、処理が定義された状態

要素がマッピングされ、処理が定義され、コード変換が有効化された状態

Message Designer 2-65

Page 94: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

要素のマッピングおよび処理要素のマッピングおよび処理要素のマッピングおよび処理要素のマッピングおよび処理

データ変換およびプロセス管理の処理を要素のマッピング・プロセスの一部として定義できます。

次の 3 つのセクションは、参照用として使用できます。初めて使用する場合は、3 つのセクションすべてに目を通す必要があります。すでに使用したことがある場合は、「Map Action Editor」セクション、および必要な処理タイプを参照してください。

� トランザクション・マップ - 処理(2-67 ページ)

– XML Gateway でサポートされている処理の要約(C-2 ページ)

– ソースまたはターゲットの処理(2-68 ページ)

– 処理レベル(2-68 ページ)

– XML Gateway 実行エンジンの処理順序(2-68 ページ)

� Map Action Editor - 概要(2-71 ページ)

– Map Action Editor の起動方法(2-70 ページ)

– Map Action Editor の構成部品(2-71 ページ)

� Map Action Editor - 使用可能な処理(2-72 ページ)

要素のマッピング処理が完了した後、「File」>「Save (Transaction Map)」メニュー・オプションまたは「Save」アイコンを使用して、マップをファイル・システムに保存します。マップ・ファイル(.xgm)の名前は、簡単に参照できるようマップ名と同じにする必要があります。次のマップの命名規則に従ってください。

� 製品のニーモニックまたはユーザー ID

� 「トランザクションの定義」フォームに入力したトランザクション・サブタイプ

要素の処理が定義のみされた状態

要素のコード変換が有効化されただけの状態

要素の処理が定義され、コード変換が有効化された状態

要素がマッピングされ、コード変換が有効化された状態

2-66 Oracle XML Gateway ユーザーズ・ガイド

Page 95: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

� 使用する XML 標準およびバージョン(OAG、ロゼッタネット、iFX など)

� アウトバウンド・メッセージまたはインバウンド・メッセージ

マップ名の例

AR_INVO_OAG70_OUT

次のようなマップ・ファイル名を指定します。

AR_INVO_OAG70_OUT.xgm

必要に応じて「File」>「Properties」メニュー・オプションを使用して、デフォルトのディレクトリやマップ名を変更してください。

これで、トランザクション・マップおよび関連する DTD を XML Gateway リポジトリにロードできるようになりました。XML Gateway 実行エンジンでは、XML メッセージを作成または使用する場合、メッセージ・マップが使用されます。

Message Designer で作成されたメッセージ・マップ、およびそのメッセージ・マップに関連する DTD を XML Gateway リポジトリにロードする方法の詳細は、「メッセージ・マップおよび DTD のロード方法」(2-113 ページ)を参照してください。

トランザクション・マップトランザクション・マップトランザクション・マップトランザクション・マップ - 処理処理処理処理データ変換またはプロセス管理の処理を要素のマッピング・プロセスの一部として定義できます。

処理は、あらかじめ作成された機能と同様に、特定のアクティビティを実行するために呼び出すことができます。

Oracle XML Gateway では、算術関数、文字列操作、Oracle のデータ・フォーマットとOAG のデータ・フォーマットとのデータ変換など、データ変換の処理がサポートされています。

Oracle XML Gateway には、プロセス管理のためのあらかじめ定義された一連の処理も用意されています。この中には、Oracle E-Business Suite との統合を強化するユーザー定義のプロシージャおよび関数呼出しも含まれています。その他の共通プロセス管理処理を使用すると、トランザクションのステータスを問い合せたり、このステータスに基づいて処理フローを管理することができます。重大なエラーが発生した場合、Oracle Workflow プロセスを介してエラー・メッセージを送信元に返し、トランザクションを強制終了できます。

Oracle XML Gateway でサポートされている処理の詳細は、付録 C を参照してください。

Message Designer 2-67

Page 96: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

ソースまたはターゲットの処理ソースまたはターゲットの処理ソースまたはターゲットの処理ソースまたはターゲットの処理

ほとんどの処理は要素マップのターゲット側で定義されていますが、WHERE 句の追加処理タイプは例外となり、ソースがデータベースのビューまたは表に基づいている場合、この処理は要素マップのソース側で定義されます。

この処理およびこの処理の定義方法の詳細は、「Map Action Editor - WHERE 句の追加」(2-79 ページ)を参照してください。

処理レベル処理レベル処理レベル処理レベル

処理は、次の事項に対して定義できます。

� 要素

要素は、メッセージの最小単位です。要素レベルで定義された処理は、その要素にのみ適用されます。

� 文書

文書は、ビジネス文書を内容とする要素の集まりです。文書レベルで定義された処理は、その文書に適用されます。

� ルート

ルートは、文書の集まりです。ルート・レベルで定義された処理は、そのルートに属するすべての文書に適用されます。

一部の処理は要素にのみ適用されますが、文書にのみ適用される処理もあります。

XML Gateway 実行エンジンの処理順序実行エンジンの処理順序実行エンジンの処理順序実行エンジンの処理順序

次の表は、XML Gateway 実行エンジンによる 3 つのレベルの文書処理順序を示します。

処理ステージの詳細は、「「Pre Process」タブ、「In Process」タブ、「Post Process」タブ」(2-71 ページ)を参照してください。

2-68 Oracle XML Gateway ユーザーズ・ガイド

Page 97: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「Transaction Map」ウィンドウ

前述の処理順序では、ヘッダー・データは行データの前に処理され、行データは詳細データの前に処理されます。下位レベルのデータ要素に依存する上位レベルのデータ要素(請求明細の合計など)は、上位レベルで API コールを使用して処理する必要があります。上位レベルのデータの処理が終了すると、このデータにはいつでもアクセス可能ですが、更新はできなくなります。

レベルレベルレベルレベル ステージステージステージステージ

ルート 前処理

ルート 処理中

ヘッダー 前処理

ヘッダー 処理中

ヘッダー 後処理

行 前処理

行 処理中

行 後処理

行詳細 前処理

行詳細 処理中

行詳細 後処理

ルート 後処理

Message Designer 2-69

Page 98: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Map Action Editor

Map Action Editor の起動方法の起動方法の起動方法の起動方法

「Element Mapping」タブでエンティティ(要素、文書、ルート)を選択し、マウスの右ボタンをクリックして「Map Action Editor」ポップアップ・ウィンドウを起動します。Map Action Editor によって表示されるプロンプトは、選択した処理タイプによって異なります。

2-70 Oracle XML Gateway ユーザーズ・ガイド

Page 99: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

概要概要概要概要Map Action Editor には、次の共通コンポーネントがあります。

� 「Pre Process」タブ、「In Process」タブ、「Post Process」タブ

� Available Actions(左のウィンドウ)

� Selected Actions(右のウィンドウ)

� 右および左シャトル・ボタン

� 「Selected Actions」ウィンドウの上下矢印

� オプションの条件式

� 結果変数

� 処理オペランド - 「Element」ウィンドウ

� ウィンドウのボタン : 「OK」と「Cancel」

「「「「Pre Process」タブ、「」タブ、「」タブ、「」タブ、「In Process」タブ、「」タブ、「」タブ、「」タブ、「Post Process」タブ」タブ」タブ」タブ

次のメッセージ作成または消込の任意のステージで、処理が適用できます。

� Pre Process(前処理)

前処理は、メッセージの作成または消込の前に実行されます。

グローバル変数の作成処理は前処理の一例です。変数は、使用する前に定義する必要があります。

� In Process(処理中)

処理中処理は、メッセージの作成中または消込中に実行されます。

算術関数および文字列関数は、処理中処理の一例で、計算や値の操作を行う場合に使用します。

� Post Process(後処理)

後処理は、メッセージの作成または消込の後に実行されます。

データベース表への挿入処理は後処理の一例です。行は、その行のすべてのデータの処理が完了するまで、データベースに挿入されません。

選択したマップ・エンティティ(要素、文書、ルート)に対する適切な「Map Action Editor」ウィンドウのタブを選択してください。

Message Designer 2-71

Page 100: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Available Actions(左のウィンドウ)(左のウィンドウ)(左のウィンドウ)(左のウィンドウ)

選択した処理段階およびマップ・エンティティで使用可能な処理カテゴリが表示されます。各カテゴリを拡張して、使用可能な処理タイプをすべて表示します。

次の表は、処理レベルおよび処理ステージごとにソートされたすべての処理タイプを示します。Y となっているところは、処理レベルと処理ステージの組合せでその処理タイプが使用できます。N となっているところは、処理レベルと処理ステージの組合せでその処理タイプが使用できません。

Selected Actions(右のウィンドウ)(右のウィンドウ)(右のウィンドウ)(右のウィンドウ)

処理タイプを「Available Actions」から「Selected Actions」に移動するには、左のウィンドウで移動する処理タイプを選択し、右シャトル・ボタンをクリックします。

選択した処理タイプを選択解除するには、右のウィンドウで処理タイプを選択し、左シャトル・ボタンをクリックします。選択した処理タイプが、「Selected Actions」から「Available Actions」に戻ります。

処理カテゴリおよび処理カテゴリおよび処理カテゴリおよび処理カテゴリおよび摘要摘要摘要摘要

要素要素要素要素処理中処理中処理中処理中

文書文書文書文書前処理前処理前処理前処理

文書文書文書文書処理中処理中処理中処理中

文書文書文書文書後処理後処理後処理後処理

ルートルートルートルート前処理前処理前処理前処理

ルート処理中ルート処理中ルート処理中ルート処理中および後処理および後処理および後処理および後処理

割当て割当て割当て割当て : 変数値の割当て Y Y Y Y N Y

割当て割当て割当て割当て : グローバル変数の作

N N N N Y N

データベース機能データベース機能データベース機能データベース機能 : 次の連番

値の割当て

Y Y Y Y N Y

データベース機能データベース機能データベース機能データベース機能 : WHERE句の追加

N DB ソース N N N N

データベース機能データベース機能データベース機能データベース機能 : データ

ベース表への挿入

N N N Y N N

導出導出導出導出 Y N N N N N

関数呼出し関数呼出し関数呼出し関数呼出し Y Y Y Y N Y

算術関数算術関数算術関数算術関数 Y Y Y Y N Y

OAG の標準変換の標準変換の標準変換の標準変換 Y N N N N N

その他その他その他その他 : プログラムの終了 Y Y Y Y N Y

事前定義済変数事前定義済変数事前定義済変数事前定義済変数 Y Y Y Y N Y

プロシージャ・コールプロシージャ・コールプロシージャ・コールプロシージャ・コール Y Y Y Y N Y

リターン・エラー・メッセーリターン・エラー・メッセーリターン・エラー・メッセーリターン・エラー・メッセージジジジ

Y Y Y Y N Y

文字列関数文字列関数文字列関数文字列関数 Y Y Y Y N Y

XSLT 変換変換変換変換 N N N N N Y(後処理)

2-72 Oracle XML Gateway ユーザーズ・ガイド

Page 101: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

「「「「Selected Actions」ウィンドウの上下矢印」ウィンドウの上下矢印」ウィンドウの上下矢印」ウィンドウの上下矢印

選択されたエンティティ(要素、文書、ルート)には、1 つ以上の処理が定義されていることがあります。XML Gateway 実行エンジンでは、リストの最初から順に下に向かってリストの最後の処理タイプまで、定義された順に処理が処理されます。選択したエンティティに対する処理の順序の定義を変更する場合は、「Selected Actions」ウィンドウの上下矢印を使用します。必要に応じて、左シャトル・ボタンを使用して選択した処理を選択解除します。

オプションの条件式オプションの条件式オプションの条件式オプションの条件式If < オペランドオペランドオペランドオペランド 1>< 演算子演算子演算子演算子 >< オペランドオペランドオペランドオペランド 2>各処理は、条件付きの処理として定義できます(WHERE 句の追加とグローバル変数の作成の場合を除く)。条件は、2 つのオペランドで表現します。オペランドは、実行時に値が決定される変数(ソース変数、ターゲット変数またはグローバル変数)やリテラル値になります。

各条件オペランドについて、(...) アイコンをクリックしてオペランド・フィールドの右に移動し、「Element」ウィンドウを起動します。「Element」ウィンドウでは、変数を選択したり、リテラル値を設定することができます。

「Element」ウィンドウの詳細は、「処理オペランド - 「Element」ウィンドウ」(2-74 ページ)を参照してください。

次の表は、Oracle XML Gateway でサポートされている演算子のリストを示します。

条件式が必要な場合は、オペランドを 2 つ入力し、演算子を選択します。

複合条件を定義するには、2 つのオペランドを比較してその結果を変数(ソース、ターゲットまたはグローバル)に格納します。次に、変数の値を次の条件オペランドと比較します。

結果変数結果変数結果変数結果変数

結果変数が定義されている処理と定義されていない処理があります。結果変数が定義されていない処理では、処理オペランドの 1 つを結果変数として使用します。

演算子演算子演算子演算子 説明説明説明説明

= 等しい

!= 等しくない

> 超過

< 未満

>= 以上

<= 以下

Is NULL NULL

Is NOT NULL NULL 値でない

Message Designer 2-73

Page 102: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

結果変数は、処理オペランドの一番左のフィールドにあります。変換処理の場合は例外で、結果変数が一番右のフィールドにあります。ユーザー・インタフェース標準によって結果変数フィールドはグレー表示になっていますが、データ入力は可能です。

要素レベル処理の場合、選択したソース変数またはターゲット変数がデフォルトの結果変数として表示されます。変数名は、必要に応じて変更できます。

文書レベルまたはルートレベルの処理の場合、結果変数はブランクです。(...) アイコンをクリックしてフィールドの右に移動し、「Element」ウィンドウを起動します。結果変数として、ソース変数、ターゲット変数またはグローバル変数を選択します。結果変数の値は、実行時に決定されます。

結果変数をリテラル値にすることはできません。

「Element」ウィンドウの詳細は、「処理オペランド - 「Element」ウィンドウ」(2-74 ページ)を参照してください。

処理オペランド処理オペランド処理オペランド処理オペランド - 「「「「Element」ウィンドウ」ウィンドウ」ウィンドウ」ウィンドウ

処理には、オペランドが関連付けられている場合と関連付けられていない場合があります。

処理にオペランドが関連付けられている場合、オペランドの数は処理タイプによって異なります。(...) アイコンをクリックしてオペランド・フィールドの右側に移動し、「Element」ウィンドウを起動します。

2-74 Oracle XML Gateway ユーザーズ・ガイド

Page 103: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

「Element」ウィンドウでは、変数を選択したり、リテラル値を設定することができます。「Element」ウィンドウには、次の 4 つの部分があります。

� 「Literal」、「Variable」および「Global Variable」ラジオ・ボタン。

� オペランドがグレー表示になっている場合は、リテラル値を設定できません。

� リテラル値を設定するフィールド(「Literal」ラジオ・ボタンを選択した場合にのみ使用可能)。

� ソース変数およびターゲット変数用のウィンドウ表示。

� 「Element」ウィンドウのボタン : 「OK」、「Cancel」、「Clear」。

ラジオ・ボタンのデフォルト設定は「Variable」です。このデフォルトを変更するには、「Literal」(選択した処理タイプで使用可能な場合)、または「Global Variable」(定義されている場合)を選択します。

選択した処理タイプに対してリテラル値が適用可能であり、「Element」ウィンドウが「Result Variable」から起動されていない場合にのみ、「Literal」ラジオ・ボタンが有効になります。リテラル値を入力して「OK」をクリックします。

「Variable」ラジオ・ボタンが有効な場合は、ソース変数およびターゲット変数が表示されます。ソースまたはターゲットの変数名を選択し、「OK」をクリックします。選択した変数の値は、実行時に決定されます。

「Global Variable」ラジオ・ボタンは、メッセージ・マップに対してグローバル変数が定義されている場合にのみ有効になります。値のリストから「Global Variable」を選択して「OK」をクリックします。選択したグローバル変数の値は、実行時に決定されます。

「「「「Map Action Editor」ウィンドウのボタン」ウィンドウのボタン」ウィンドウのボタン」ウィンドウのボタン : 「「「「OK」、「」、「」、「」、「Cancel」、「」、「」、「」、「Clear」」」」「OK」ボタンは、必要なオペランド値がすべて使用可能になるまで使用できません。

「Cancel」ボタンをクリックすると、アクティビティが取り消され、ウィンドウがクローズします。

「Clear」ボタンを使用すると、ソース変数、ターゲット変数、グローバル変数またはオペランドに入力されたリテラルを削除できます。

Message Designer 2-75

Page 104: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Map Action Editor - 割当て割当て割当て割当て : 変数値の割当て変数値の割当て変数値の割当て変数値の割当て変数値の割当て処理により、識別された結果変数に値が割り当てられます。この値は、他の変数(ソース、ターゲットまたはグローバル変数)またはリテラル値に応じて変更できます。

通常適用するデフォルト値としてリテラル値を割り当てる場合(条件式は指定しない)、「Source Definition」または「Target Definition」タブの「Transaction Map」フォームを使用してデフォルト値を設定します。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

結果変数結果変数結果変数結果変数

割り当てられた値を保存するソース、ターゲットまたはグローバル変数を選択します。

処理オペランド処理オペランド処理オペランド処理オペランド

変数(ソース、ターゲットまたはグローバル変数)を選択するか、または結果変数に割り当てるリテラル値を入力します。

2-76 Oracle XML Gateway ユーザーズ・ガイド

Page 105: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Map Action Editor - 割当て割当て割当て割当て : グローバル変数の作成グローバル変数の作成グローバル変数の作成グローバル変数の作成グローバル変数の作成処理により、ソースおよびターゲットの両方で使用可能な変数を定義できます。変数には、デフォルト値を割り当てるか、または変数値の割当て処理を使用して値を取得するようにできます。

グローバル変数を定義すると、その値は「Element」ウィンドウの「Global Variable Name」値リストに表示されます。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

オプションの条件式は、グローバル変数の作成処理では使用できません。これは、この処理が前処理であり、この時点ではデータが使用可能ではないためです。

Global Variable Nameグローバル変数名を入力して、変数のデータ型を選択します。XML Gateway 実行エンジンでサポートされている有効なデータ型は、VARCHAR2、NUMBER、DATE および CHARです。

注意注意注意注意 : RANSACTION_TYPE、TRANSACTION_SUBTYPE、DOCUMENT_ID、TP_SITE_ID(PARTY_SITE_ID としても知られる)、TP_ID(PARTY_ID としても知られる)、PARTY_TYPE、PARAMETER1、PARAMETER2、PARAMETER3、PARAMETER4 および PARAMETER5は、グローバル変数の予約名です。

Message Designer 2-77

Page 106: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Default Value該当する場合はデフォルト値を入力します。

Map Action Editor - データベース機能データベース機能データベース機能データベース機能 : 次の連番値の割当て次の連番値の割当て次の連番値の割当て次の連番値の割当てOracle E-Business Suite では、PO または請求書番号などの文書番号のカウンタを保守するために、データベースの順序を定義します。Oracle のアプリケーション・オープン・インタフェース表に文書を挿入する場合は、次に使用可能な文書番号が必要となります。

次の連番値の割当て処理では、識別されたデータベース順序から次に使用可能な順序番号を検索し、その番号を結果変数に割り当てます。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

結果変数結果変数結果変数結果変数

識別された順序の次の値を保存するソース、ターゲットまたはグローバル変数を選択します。

注意注意注意注意 : 予約語や事前定義済み変数を含まない一意かつ意味のある名前を定義します。一度変数名を定義してマップに保存すると、変更することはできません。

ただし、必要に応じて、不正な変数名を含むグローバル変数の作成処理を削除して、正しい名前を含む新しい処理を追加できます。

注意注意注意注意 : 大きなオブジェクト(最大で 4GB)をサポートするように CLOBデータ型を定義した場合、XML Gateway 実行エンジンではサポートされますが、グローバル変数の作成処理ではサポートされません。

2-78 Oracle XML Gateway ユーザーズ・ガイド

Page 107: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Next Value of Sequenceデータベース順序の名前を指定します。この機能によって、順序の次の値が結果変数に割り当てられます。

Map Action Editor - データベース機能データベース機能データベース機能データベース機能 : WHERE 句の追加句の追加句の追加句の追加WHERE 句の追加処理は、アウトバウンド・メッセージの場合にのみ使用します。これは、トランザクション・マップで使用されるデータベース・ビューに文書選択基準を渡す場合に使用します。

WHERE 句の追加処理は、文書レベルで事前プロセス・アクティビティとしてソースに定義します。バインド変数およびバインド値は、文書が処理される前に設定します。データベース・ビューへの実際のバインドは、そのデータが使用可能になったときにインプロセス・アクティビティとして行われます。"where 1=1" のデフォルトの WHERE 句は、提供された選択基準に基づく WHERE 句が動的に構成されるように実行時に追加されます。

各 WHERE 句の追加処理は、バインド変数とバインド値のセットを 1 つ受け入れます。複数の選択基準を渡すには、複数の WHERE 句の追加処理を定義する必要があります。

文書の選択基準は、イベントおよびイベント・サブスクリプションで指定します。

ECX_OAG_CONTROLAREA_V ビューをマップで使用している場合、適切に実行するには、このビューの TRANSACTION_TYPE 列と TRANSACTION_SUBTYPE 列をバインドする必要があります。

ECX_OAG_CONTROLAREA_TP_V ビューをマップで使用している場合、適切に実行するには、このビューの TRANSACTION_TYPE、TRANSACTION_SUBTYPE、PARTY_ID、PARTY_SITE_ID および PARTY_TYPE の各列をバインドする必要があります。

注意注意注意注意 : ECX_OAG_CONTROLAREA_TP_V ビューの REFERENCE ID 列に格納したイベント詳細にアクセスするには、ECX_EVENT_MESSAGE品目属性をワークフロー項目タイプに追加する必要があります。

Message Designer 2-79

Page 108: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

次の表は例を示します。

プロセスをトリガーするイベントに関連しない他のソース変数は、Oracle E-Business Suiteデータベースから正しい文書が選択されるようにするためのバインド値として使用することができます。

キー値がわかっている場合は、WHERE 句で定義できます。この方法を使用すると、バインド変数やバインド値を使用する必要がなくなります。次の表は例を示します。

WHERE 句句句句 バインド変数バインド変数バインド変数バインド変数 バインド値バインド値バインド値バインド値

and ECX_OAG_CONTROLAREA_TP_V.TRANSACTION_TYPE=:TTYPE TYTPE TRANSACTION_TYPE

and ECX_OAG_CONTROLAREA_TP_V.TRANSACTION_SUBTYPE=:SUBTYPE

SUBTYPE TRANSACTION_SUBTYPE

and ECX_OAG_CONTROLAREA_TP_V.PARTY_ID=:PARTY_ID PARTY_ID TP_ID

and ECX_OAG_CONTROLAREA_TP_V.PARTY_SITE_ID=:PARTY_SITE_ID PARTY_SITE_ID TP_SITE_ID

and ECX_OAG_CONTROLAREA_TP_PARTY_TYPE=:PARTY_TYPE PARTY_TYPE PARTY_TYPE

and <APPS_HEADER_V>.<document id> =:DOCID DOCID document_id

注意注意注意注意 : この方法では、グローバル変数の作成処理を利用して変数を定義し、バインド値を保存します。グローバル変数を定義する場合は、パラメータを正確なスペルで指定してください。この例では、グローバル変数は、TRANSACTION_TYPE、TRANSACTION_SUBTYPE、TP_ID、TP_SITE_ID、PARTY_TYPE および DOCUMENT_ID です。

注意注意注意注意 : TRANSACTION_TYPE、TRANSACTION_SUBTYPE、DOCUMENT_ID、TP_SITE_ID(PARTY_SITE_ID としても知られる)、TP_ID(PARTY_ID としても知られる)、PARTY_TYPE、PARAMETER1、PARAMETER2、PARAMETER3、PARAMETER4 および PARAMETER5は、グローバル変数の予約名です。

2-80 Oracle XML Gateway ユーザーズ・ガイド

Page 109: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

オプションの条件式は WHERE 句の追加処理では使用できません。これは、この処理が前処理であり、この時点ではデータが使用可能ではないためです。

Where Clauseアウトバウンド・メッセージに使用されるデータベース・ビューをバインドする WHERE 句を指定します。この WHERE 句は、デフォルトの WHERE 句 "where 1=1" に添付されます。

同じデータベース・ビューに基づいた複数の選択基準がある場合は、それぞれの基準ごとにWHERE 句の追加処理を定義します。最初の WHERE 句の追加処理のフィールド(WHERE句、バインド変数およびバインド値)をすべて定義します。後続の WHERE 句の追加処理については、バインド変数およびバインド値のみを定義します(WHERE 句はブランクにしておきます)。

Bind VariableWHERE 句で使用されるバインド変数を指定します。

WHERE 句句句句バインドバインドバインドバインド変数変数変数変数 バインド値バインド値バインド値バインド値

and ECX_OAG_CONTROLAREA_TP_V.TRANSACTION_ TYPE ='POO'

N/A N/A

and ECX_OAG_CONTROLAREA_TP_V.TRANSACTION_ SUBTYPE ='POOB'

N/A N/A

and ECX_PO_HEADERV.PO_NUMBER ='A754739' N/A N/A

注意注意注意注意 : リテラル文字列は、一重引用符でバインドする必要があります。

Message Designer 2-81

Page 110: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Bind ValueWHERE 句で使用されるバインド変数に割り当てるバインド値を指定します。

バインド値は、実行時に決定されるグローバル変数、またはリテラル値です。

Map Action Editor - データベース機能データベース機能データベース機能データベース機能 : データベース表への挿入データベース表への挿入データベース表への挿入データベース表への挿入データベース表への挿入処理は後処理であり、メッセージ・マップで指定したアプリケーション・オープン・インタフェース表にデータを挿入するためにインバウンド・メッセージで使用されます。

この処理は、「Transaction Map」の「Level Mapping」タブで指定した各ターゲット・レベルに対して 1 回実行する必要があります。ターゲットに 3 つのレベル(ヘッダー、ラインおよび明細詳細)がある場合は、3 回実行する必要があります。

データベース表への挿入処理の条件を指定できます。この処理には、オペランドは必要ありません。

挿入は、XML Gateway 実行エンジンにより行われますが、文書全体の処理が完了するまでデータベースにコミットされません。これにより、文書の一部がデータベースに挿入される可能性がなくなります。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Map Action Editor - 導出導出導出導出 : 事業所コードからの所在地事業所コードからの所在地事業所コードからの所在地事業所コードからの所在地 ID の導出の導出の導出の導出事業所コードからの所在地 ID の導出処理は、インバウンド・メッセージでのみ使用されます。この処理では、ソース事業所コードおよびそれに関連付けられている所在地タイプを使用して、ターゲットの Oracle E-Business Suite モジュールにとって意味のある所在地 ID および組織 ID が導出されます。

ID は Oracle E-Business Suite のコンテキストでのみ有効です。送信者は、有効な所在地 IDまたは組織 ID を知ることができません。

アプリケーション・オープン・インタフェースに顧客または仕入先サイトの親表 ID も必要な場合は、事業所コードからの所在地 ID の導出処理を使用して導出します。

事業所コードは、一般的に、物理的な所在地で示される所在地サイトを参照する場合に使用されます。事業所コードを使用すると、XML メッセージに物理的な所在地を含める必要がなくなります。OAG メッセージの場合、事業所コードは、一般的に、PARTNER データ型の PARTNRID 要素内にあります。

注意注意注意注意 : データは、アプリケーション API を実行するプロシージャ・コール処理を使用して挿入することもできます。詳細は、「API へのマッピング方法」(2-112 ページ)を参照してください。

2-82 Oracle XML Gateway ユーザーズ・ガイド

Page 111: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

事業所コードからの所在地 ID の導出処理は、組織全体のすべての取引先事業所にアクセスして所在地 ID を導出します。複数の組織でソース事業所コードが検出された場合、この処理では、所在地 ID を一意に識別できないためエラーが生成されます。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Derive Target Address IDソース事業所コードから導出される所在地 ID を保存するためのターゲット変数を指定します。ターゲット変数の値は実行時に決定されます。

ターゲット変数は、複数のアプリケーション列に同じ値を指定するための一時変数としてターゲット変数を使用しない限り、グローバル変数にすることができません。ターゲット変数はリテラル値にすることはできません。

Derive Target ORG IDソース事業所コードから導出される組織 ID を保存するためのターゲット変数を指定します。ターゲット変数の値は実行時に決定されます。

ターゲット変数は、複数のアプリケーション列に同じ値を指定するための一時変数としてターゲット変数を使用しない限り、グローバル変数にすることができません。ターゲット変数はリテラル値にすることはできません。

From Source Location Code事業所コードが含まれるソース変数を指定します。ソース変数は、実行時に決定されるグローバル変数、またはリテラル値にすることができます。

With the Address Type of値リストから所在地タイプを選択します。有効な所在地タイプは、次のとおりです。

� Customer(顧客)

� Supplier(仕入先)

Message Designer 2-83

Page 112: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

� Internal Location(内部所在地)

� Bank Branch(銀行支店)

XML Gateway 実行エンジンでは、この所在地タイプを使用して、所在地 ID を導出するためにアクセスする適切な Oracle アドレスが決定されます。

Map Action Editor - 導出導出導出導出 : 事業所コードからの親事業所コードからの親事業所コードからの親事業所コードからの親 ID の導出の導出の導出の導出事業所コードからの親 ID の導出処理は、インバウンド・メッセージでのみ使用されます。この処理では、サイト・レベルのソース事業所コードに関連付けられている親 ID が導出されます。

たとえば、XML メッセージで売却先サイトを指定すると、この処理では、関連付けられている親顧客が導出されます。

ID は Oracle E-Business Suite のコンテキストでのみ有効です。送信者は、有効な親 ID を知ることができません。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Derive Target Parent IDサイト・レベルのソース事業所コードから導出される親 ID を保存するためのターゲット変数を指定します。ターゲット変数の値は実行時に決定されます。

ターゲット変数は、複数のアプリケーション列に同じ値を指定するための一時変数としてターゲット変数を使用しない限り、グローバル変数にすることができません。ターゲット変数はリテラル値にすることはできません。

From Source Location Code事業所コードが含まれるソース変数を指定します。ソース変数は、実行時に決定されるグローバル変数、またはリテラル値にすることができます。

2-84 Oracle XML Gateway ユーザーズ・ガイド

Page 113: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

With the Address Type of値リストから所在地タイプを選択します。有効な所在地タイプは、次のとおりです。

� Customer(顧客)

� Supplier(仕入先)

� Internal Location(内部所在地)

� Bank Branch(銀行支店)

XML Gateway 実行エンジンでは、この所在地タイプを使用して、所在地 ID を導出するためにアクセスする適切な Oracle アドレスが決定されます。

Map Action Editor - 関数コール関数コール関数コール関数コール : 関数コールの実行関数コールの実行関数コールの実行関数コールの実行関数コールの実行処理は、システム関数(たとえば、FND_GLOBAL.USER_ID)または任意のアプリケーション関数を呼び出してアクティビティを実行し、結果変数に結果を返します。

パラメータを指定した関数コールは、関数コールの実行処理ではサポートされていません。

特殊な目的に使用される関数のリストについては、「XML Gateway API」(F-2 ページ)を参照してください。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

注意注意注意注意 : プロシージャ・コールは、関数コールの実行処理ではサポートされていません。プロシージャを使用可能にする方法の詳細は、「Map Action Editor - プロシージャ・コール : プロシージャの実行」(2-102 ページ)を参照してください。

Message Designer 2-85

Page 114: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

結果変数結果変数結果変数結果変数

関数の戻り値を保存するためのソース、ターゲットまたはグローバル変数を選択します。

Value Returned by Function関数の名前を指定します。関数によって返される値は、結果変数に割り当てられます。

Map Action Editor - 算術関数算術関数算術関数算術関数Oracle XML Gateway では、加算、減算、乗算および除算という 4 つの基本的な算術関数がサポートされています。

各算術関数では、2 つのオペランドがサポートされています。下の例は、除算関数を示します。加算、減算、除算および乗算関数では、それぞれ適切なオペランドが表示されます。

数式に 2 つ以上のオペランドが必要とされる場合は、一度に 2 つのオペランドが計算されて、その結果が一時変数(ソース、ターゲットまたはグローバル)に保存され、一時変数内の値が結合されます。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

結果変数結果変数結果変数結果変数

計算の結果を保存するソース、ターゲットまたはグローバル変数を選択します。

処理オペランド処理オペランド処理オペランド処理オペランド

任意の 2 つのオペランドおよび必要な算術関数を指定します。

注意注意注意注意 : 関数コールまたはプロシージャ・コール処理は、複雑な計算を行うためにデータベース・レベル関数を使用する場合に使用します。

2-86 Oracle XML Gateway ユーザーズ・ガイド

Page 115: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

各オペランドは、実行時に決定される変数(定義されている場合は、ソース、ターゲットまたはグローバル変数)、または数値リテラル値にすることができます。

Map Action Editor - OAG DATETIME への変換への変換への変換への変換 OAG DATETIME への変換処理では、Oracle E-Business Suite の日付表記が OAG の日付表記に変換されます。

OAG の日付表記は、次のとおりです。

DATETIME(クオリファイア、タイプ、索引、YEAR、MONTH、DAY、HOUR、MINUTE、SECOND、SUBSECOND、TIMEZONE)

OAG DATETIME への変換処理では、Oracle E-Business Suite の単一列の日付が、次のような OAG DATETIME セグメントに変換されます。

� クオリファイア、タイプおよび索引の DATETIME 属性は、「Transaction Map」ウィンドウの「Target Definition」タブでデフォルト値として設定する必要があります。

� YEAR、MONTH、DAY、HOUR、MINUTE、SECOND および SUBSECOND のDATETIME 要素は、Oracle Application の日付値に基づいて導出されます。

� TIMEZONE の DATETIME 要素は、次のように決定されます。「ECX: サーバー・タイム・ゾーン」プロファイル・オプションで指定された値とともに、データベースから検索された日付および時間を使用して、グリニッジ標準時(GMT)の偏差が決定されます。この偏差は、XML Gateway によって生成される XML メッセージで使用されます。変換は行われません。

詳細は、「XML Gateway の有効なタイム・ゾーン値」(E-1 ページ)を参照してください。

注意注意注意注意 : ソースおよびターゲット要素は、この処理により暗黙的にマッピングされます。追加で要素をマッピングすると、元の処理指示が上書きされます。

Message Designer 2-87

Page 116: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Convert Source DatetimeOAG DATETIME 書式に変換するソース日付 / 時間要素を指定します。ソースは数値書式を使用して定義したリテラル値にすることができます(たとえば、2002 年 8 月 8 日の場合は20020808)。文字書式を使用して入力したリテラルの日付(たとえば、08-Aug-2002)は有効ではありません。

ターゲットおよびグローバル変数は、「Element」ウィンドウでは使用可能ですが、適用されません。

変換された値は、処理の起動時に選択されたターゲットの DATETIME 要素に割り当てられます。

Map Action Editor - OAG OPERAMT への変換への変換への変換への変換OAG OPERAMT への変換処理では、Oracle E-Business Suite の営業金額表記が OAG の営業金額表記に変換されます。

OAG の営業金額表記は、次のとおりです。

OPERAMT(クオリファイア、タイプ、VALUE、NUMOFDEC、SIGN、CURRENCY、UOMVALUE、UOMNUMDEC、UOM)

OAG OPERAMT への変換処理では、Oracle E-Business Suite の単一列の営業金額が、次のような OAG OPERAMT セグメントに変換されます。

� クオリファイアおよびタイプの OPERAMT 属性は、「Transaction Map」ウィンドウの「Target Definition」タブでデフォルト値として設定する必要があります。

� VALUE、NUMOFDEC、SIGN、UOMVALUE および UOMNUMDEC の OPERAMT 要素は、Oracle E-Business Suite の営業金額の値に基づいて導出されます。

� CURRENCY および UOM の OPERAMT 要素が要求されます。該当する Oracle E-Business Suite モジュール列が使用可能な場合は、その列の値を CURRENCY およびUOM 要素にマッピングできます。

注意注意注意注意 : ソースおよびターゲット要素は、この処理により暗黙的にマッピングされます。追加で要素をマッピングすると、元の処理指示が上書きされます。

2-88 Oracle XML Gateway ユーザーズ・ガイド

Page 117: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Convert Source Operating AmountOAG OPERAMT 書式に変換するソースの営業金額要素を指定します。ソースはリテラル値、またはグローバル変数に基づいた値にすることができます。

ターゲット変数は、「Element」ウィンドウで使用可能ですが、適用されません。

変換された値は、処理の起動時に選択されたターゲットの OPERAMT 要素に割り当てられます。

Source CurrencyOAG への変換処理で使用されるソースの通貨コード要素(使用可能な場合)またはリテラル値を指定します。

Oracle アプリケーション列が使用可能な場合は、その列の値を CURRENCY 要素にマッピングできます。

使用可能な Oracle アプリケーション列がない場合は、XML Gateway 実行エンジンにより要素はブランクのままになります。

ターゲットおよびグローバル変数は、「Element」ウィンドウでは使用可能ですが、適用されません。

Source Unit of MeasureOAG への変換処理で使用されるソースの単位コード要素(使用可能な場合)またはリテラル値を指定します。

Oracle アプリケーション列が使用可能な場合は、その列の値を UOM 要素にマッピングできます。

使用可能な Oracle アプリケーション列がない場合は、XML Gateway 実行エンジンにより、単位コードは、デフォルトで、OAG で推奨される EACH になります。

ターゲットおよびグローバル変数は、「Element」ウィンドウでは使用可能ですが、適用されません。

Message Designer 2-89

Page 118: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Map Action Editor - OAG QUANTITY への変換への変換への変換への変換OAG QUANTITY への変換処理では、Oracle E-Business Suite の数量表記が OAG の数量表記に変換されます。

OAG の数量表記は、次のとおりです。

QUANTITY(クオリファイア、VALUE、NUMOFDEC、SIGN、UOM)

OAG QUANTITY への変換処理では、Oracle E-Business Suite の単一列の数量が、次のような OAG QUANTITY セグメントに変換されます。

� クオリファイアの QUANTITY 属性は、「Transaction Map」ウィンドウの「Target Definition」タブでデフォルト値として設定する必要があります。

� VALUE、NUMOFDEC および SIGN の QUANTITY 要素は、Oracle E-Business Suite の数量値に基づいて導出されます。

� UOM の QUANTITY 要素が要求されます。該当する Oracle E-Business Suite モジュール列が使用可能な場合は、その列の値を UOM 要素にマッピングできます。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Convert Source QuantityOAG QUANTITY 書式に変換するソースの数量要素を指定します。ソースはリテラル値、またはグローバル変数に基づいた値にすることができます。

ターゲット変数は、「Element」ウィンドウで使用可能ですが、適用されません。

変換された値は、処理の起動時に選択されたターゲットの QUANTITY 要素に割り当てられます。

注意注意注意注意 : ソースおよびターゲット要素は、この処理により暗黙的にマッピングされます。追加で要素をマッピングすると、元の処理指示が上書きされます。

2-90 Oracle XML Gateway ユーザーズ・ガイド

Page 119: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Source Unit of MeasureOAG への変換処理で使用されるソースの単位コード要素(使用可能な場合)またはリテラル値を指定します。

Oracle アプリケーション列が使用可能な場合は、その列の値を UOM 要素にマッピングできます。

使用可能な Oracle アプリケーション列がない場合は、XML Gateway 実行エンジンにより要素はブランクのままになります。

ターゲットおよびグローバル変数は、「Element」ウィンドウでは使用可能ですが、適用されません。

Map Action Editor - OAG AMOUNT への変換への変換への変換への変換 OAG AMOUNT への変換処理では、Oracle E-Business Suite の金額表記が OAG の金額表記に変換されます。

OAG の金額表記は、次のとおりです。

AMOUNT (クオリファイア、タイプ、索引、VALUE、NUMOFDEC、SIGN、CURRENCY、DRCR)

OAG AMOUNT への変換処理では、Oracle E-Business Suite の単一列の金額が、次のようなOAG AMOUNT セグメントに変換されます。

� クオリファイア、タイプおよび索引の AMOUNT 属性は、「Transaction Map」ウィンドウの「Target Definition」タブでデフォルト値として設定する必要があります。

� VALUE、NUMOFDEC および SIGN の AMOUNT 要素は、Oracle E-Business Suite の金額値に基づいて導出されます。

� CURRENCY および DRCR の AMOUNT 要素が要求されます。該当する Oracle E-Business Suite 列が使用可能な場合は、その列の値を CURRENCY および DRCR 要素にマッピングできます。

注意注意注意注意 : ソースおよびターゲット要素は、この処理により暗黙的にマッピングされます。追加で要素をマッピングすると、元の処理指示が上書きされます。

Message Designer 2-91

Page 120: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Convert Source AmountOAG AMOUNT 書式に変換するソースの金額要素を指定します。ソースはリテラル値、またはグローバル変数に基づいた値にすることができます。

ターゲット変数は、「Element」ウィンドウで使用可能ですが、適用されません。

変換された値は、処理の起動時に選択されたターゲットの AMOUNT 要素に割り当てられます。

Source CurrencyOAG への変換処理で使用されるソースの通貨コード要素(使用可能な場合)またはリテラル値を指定します。

Oracle アプリケーション列が使用可能な場合は、その列の値を CURRENCY 要素にマッピングできます。

使用可能な Oracle アプリケーション列がない場合は、XML Gateway 実行エンジンにより要素はブランクのままになります。

ターゲットおよびグローバル変数は、「Element」ウィンドウでは使用可能ですが、適用されません。

Source Credit/DebitOAG への変換処理で使用されるソースのクレジット / デビット・フラグ(使用可能な場合)またはリテラル値を指定します。

Oracle アプリケーション列が使用可能な場合は、その列の値を DRCR 要素にマッピングできます。

使用可能な Oracle アプリケーション列がない場合は、XML Gateway 実行エンジンにより金額値に基づいた設定が導出されます。

2-92 Oracle XML Gateway ユーザーズ・ガイド

Page 121: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

ターゲットおよびグローバル変数は、「Element」ウィンドウでは使用可能ですが、適用されません。

Map Action Editor - OAG DATETIME からの変換からの変換からの変換からの変換OAG DATETIME からの変換処理では、OAG の日付表記が Oracle E-Business Suite の日付表記に変換されます。

OAG の日付表記は、次のとおりです。

DATETIME (クオリファイア、タイプ、索引、YEAR、MONTH、DAY、HOUR、MINUTE、SECOND、SUBSECOND、TIMEZONE)

OAG DATETIME からの変換処理では、OAG DATETIME セグメントが、次のような単一のOracle E-Business Suite 日付に変換されます。

� DATETIME クオリファイア属性を使用して、使用する適切な Oracle E-Business Suite 日付列を決定できます。

� タイプおよび索引の DATETIME 属性は、Oracle E-Business Suite では使用されません。

� YEAR、MONTH、DAY、HOUR、MINUTE、SECOND および SUBSECOND のDATETIME 要素を使用して、Oracle E-Business Suite の日付値が構成されます。

� TIMEZONE の DATETIME 要素は、次のように決定されます。着信メッセージのタイム・ゾーンがプロファイル・オプション「ECX: サーバー・タイム・ゾーン」で指定されたタイム・ゾーンと異なる場合は、着信日および時間が変換されます。

詳細は、「XML Gateway の有効なタイム・ゾーン値」(E-1 ページ)を参照してください。

注意注意注意注意 : ソースおよびターゲット要素は、この処理により暗黙的にマッピングされます。追加で要素をマッピングすると、元の処理指示が上書きされます。

Message Designer 2-93

Page 122: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Convert OAG DatetimeOracle E-Business Suite 書式に変換するソースの DATETIME 要素を指定します。ソースはリテラル値にすることはできません。

ターゲットおよびグローバル変数は、「Element」ウィンドウでは使用可能ですが、適用されません。

変換された値は、処理の起動時に選択されたアプリケーション(ターゲット)の日付要素に割り当てられます。

Map Action Editor - OAG OPERAMT からの変換からの変換からの変換からの変換OAG OPERAMT からの変換処理では、OAG の営業金額表記が Oracle E-Business Suite の営業金額表記に変換されます。

OAG の営業金額表記は、次のとおりです。

OPERAMT (クオリファイア、タイプ、VALUE、NUMOFDEC、SIGN、CURRENCY、UOMVALUE、UOMNUMDEC、UOM)

OAG OPERAMT からの変換処理では、OAG OPERAMT セグメントが、次のような単一のOracle E-Business Suite 金額列に変換されます。

� OPERAMT クオリファイア属性を使用して、使用する適当な Oracle E-Business Suite モジュールの金額列を決定できます。

� OPERAMT タイプ属性は、Oracle E-Business Suite では使用されません。

� VALUE、NUMOFDEC、SIGN、UOMVALUE および UOMNUMDEC の OPERAMT 要素を使用して、Oracle E-Business Suite の営業金額の値が構成されます。

� CURRENCY および UOM の OPERAMT 要素は、該当する列が使用可能な場合、Oracle E-Business Suite に保存できます。

注意注意注意注意 : ソースおよびターゲット要素は、この処理により暗黙的にマッピングされます。追加で要素をマッピングすると、元の処理指示が上書きされます。

2-94 Oracle XML Gateway ユーザーズ・ガイド

Page 123: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Convert OAG Operating AmountOracle E-Business Suite 書式に変換するソースの OPERAMT 要素を指定します。ソースはリテラル値にすることはできません。

ターゲットおよびグローバル変数は、「Element」ウィンドウでは使用可能ですが、適用されません。

変換された値は、処理の起動時に選択されたアプリケーション(ターゲット)の営業金額要素に割り当てられます。

Target Currencyソースの OPERAMT 値は、サブコンポーネントの集まりとして示されます。通貨コードを保存するアプリケーション(ターゲット)要素を指定します。リテラル値は使用できません。

アプリケーション(ターゲット)要素を指定すると、OAG からの変換処理により、その要素にソースの通貨コードが移されます。

アプリケーション(ターゲット)を指定しないと、ソースの通貨コードは無視されます。

Target Unit of Measureソースの OPERAMT 値は、サブコンポーネントの集まりとして示されます。単位コードを保存するアプリケーション(ターゲット)要素を指定します。リテラル値は使用できません。

アプリケーション(ターゲット)要素を指定すると、OAG からの変換処理により、その要素にソースの単位コードが移されます。

アプリケーション(ターゲット)を指定しないと、ソースの単位コードは無視されます。

Message Designer 2-95

Page 124: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Map Action Editor - OAG の数量からの変換の数量からの変換の数量からの変換の数量からの変換OAG QUANTITY からの変換処理では、OAG の数量表記が Oracle E-Business Suite の数量表記に変換されます。

OAG の数量表記は、次のとおりです。

QUANTITY(クオリファイア、VALUE、NUMOFDEC、SIGN、UOM)

OAG QUANTITY からの変換処理では、OAG QUANTITY セグメントが、次のような単一の Oracle アプリケーション数量列に変換されます。

� QUANTITY クオリファイア属性を使用して、使用する適切な Oracle E-Business Suite 数量列を決定できます。

� VALUE、NUMOFDEC および SIGN の QUANTITY 要素を使用して、Oracle E-Business Suite の数量値が構成されます。

� UOM の QUANTITY 要素は、該当する列が使用可能な場合、Oracle E-Business Suite に保存できます。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Convert OAG QuantityOracle E-Business Suite 書式に変換するソースの QUANTITY 要素を指定します。ソースはリテラル値にすることはできません。

ターゲットおよびグローバル変数は、「Element」ウィンドウでは使用可能ですが、適用されません。

注意注意注意注意 : ソースおよびターゲット要素は、この処理により暗黙的にマッピングされます。追加で要素をマッピングすると、元の処理指示が上書きされます。

2-96 Oracle XML Gateway ユーザーズ・ガイド

Page 125: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

変換された値は、処理の起動時に選択されたアプリケーション(ターゲット)の数量要素に割り当てられます。

Target Unit of Measureソースの QUANTITY 値は、サブコンポーネントの集まりとして示されます。単位コードを保存するアプリケーション(ターゲット)要素を指定します。リテラル値は使用できません。

アプリケーション(ターゲット)要素を指定すると、OAG からの変換処理により、その要素にソースの単位コードが移されます。

アプリケーション(ターゲット)を指定しないと、ソースの単位コードは無視されます。

Map Action Editor - OAG AMOUNT からの変換からの変換からの変換からの変換OAG AMOUNT からの変換処理では、OAG の金額表記が Oracle E-Business Suite の金額表記に変換されます。

OAG の金額表記は、次のとおりです。

AMOUNT (クオリファイア、タイプ、索引、VALUE、NUMOFDEC、SIGN、CURRENCY、DRCR)

OAG AMOUNT からの変換処理では、OAG AMOUNT セグメントが、次のような単一のOracle E-Business Suite 金額列に変換されます。

� AMOUNT クオリファイア属性を使用して、使用する適切な Oracle E-Business Suite 金額列を指定できます。

� タイプおよび索引の AMOUNT 属性は、Oracle E-Business Suite では使用されません。

� VALUE、NUMOFDEC および SIGN の AMOUNT 要素を使用して、Oracle E-Business Suite の金額値が構成されます。

� CURRENCY および DRCR の AMOUNT 要素は、該当する列が使用可能な場合、Oracle E-Business Suite に保存できます。

注意注意注意注意 : ソースおよびターゲット要素は、この処理により暗黙的にマッピングされます。追加で要素をマッピングすると、元の処理指示が上書きされます。

Message Designer 2-97

Page 126: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Convert OAG AmountOracle E-Business Suite 書式に変換するソースの AMOUNT 要素を指定します。ソースはリテラル値にすることはできません。

ターゲットおよびグローバル変数は、「Element」ウィンドウでは使用可能ですが、適用されません。

変換された値は、処理の起動時に選択されたアプリケーション(ターゲット)の金額要素に割り当てられます。

Target Currencyソースの AMOUNT 要素は、サブコンポーネントの集まりとして示されます。通貨コードを保存するアプリケーション(ターゲット)要素を指定します。リテラル値は使用できません。

アプリケーション(ターゲット)要素を指定すると、OAG からの変換処理により、その要素にソースの通貨コードが移されます。

アプリケーション(ターゲット)を指定しないと、ソースの通貨コードは無視されます。

Target Credit/Debitソースの AMOUNT 要素は、サブコンポーネントの集まりとして示されます。クレジット /デビット・フラグを保存するアプリケーション(ターゲット)要素を指定します。リテラル値は使用できません。

アプリケーション(ターゲット)要素を指定すると、OAG からの変換処理により、その要素にソースのクレジット / デビット・フラグが移されます。

アプリケーション(ターゲット)を指定しないと、ソースのクレジット / デビット・フラグは無視されます。

2-98 Oracle XML Gateway ユーザーズ・ガイド

Page 127: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Map Action Editor - その他その他その他その他 : プログラムの終了プログラムの終了プログラムの終了プログラムの終了プログラムの終了処理は、プロシージャ・コールや関数コールの実行結果、または事前定義済み変数の値の検索結果に基づいて実行できます。

プログラムの終了処理では、現行のトランザクションをロールバックして、XML Gateway実行エンジンを終了します。

プログラムの終了処理には、追加のオペランドはありません。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Map Action Editor - 事前定義済変数値の取得事前定義済変数値の取得事前定義済変数値の取得事前定義済変数値の取得事前定義済変数値の取得処理では、次の事項に対して事前定義されている変数が保守されます。

� インバウンド・メッセージ・エンベロープ

� コード変換ステータス

� トランザクション・ステータス

これらの事前定義済みの変数の値は、XML Gateway 実行エンジンによって保守され、アプリケーション・オープン・インタフェース表の列またはアプリケーション API パラメータの照会およびマッピングで使用可能です。

事前定義済みの変数に保存されている値に基づいて、処理フローを制御できます。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

結果変数結果変数結果変数結果変数

選択した事前定義済みの変数の値を保存するソース変数、ターゲット変数またはグローバル変数を選択します。

Message Designer 2-99

Page 128: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

事前定義済変数事前定義済変数事前定義済変数事前定義済変数

値を取得する事前定義済みの変数を選択します。XML Gateway 実行エンジンによって公開されている変数は、次のとおりです。

コード変換のリターン・ステータスコード変換のリターン・ステータスコード変換のリターン・ステータスコード変換のリターン・ステータス

コード変換対象として使用可能なソース列を選択します。コード変換処理では、取引先固有のコード変換が検索され、次に標準固有リストが検索されます。その後、汎用リストが検索されます。

コード変換のステータスは、結果変数に割り当てられます。次の表は、リターン・ステータス・コードを示します。

内部制御番号内部制御番号内部制御番号内部制御番号

内部制御番号は、システムで生成される番号で、処理対象の XML メッセージを一意に識別します。この番号は、確認の送信、文書の監査、文書のアーカイブおよびトラブルシューティングを行う場合に役立ちます。

内部制御番号の値は、処理に対して識別されている結果変数に割り当てられます。

リターン・リターン・リターン・リターン・ステータス・コードステータス・コードステータス・コードステータス・コード 説明説明説明説明

0 コード変換が成功しました。

1 コード変換処理でソース列との一致の検出に失敗しました。ソース値はターゲット列にコピーされます。

これは単なる警告であり、XML Gateway 実行エンジンは停止しません。

ただし、このステータスに基づいて処理フローを制御するための処理を実行できます。

この失敗の原因としては、コード変換 API に渡されたコード・カテゴリ

が無効であるか、またはコード変換の相互参照が見つからないことが考えられます。

ソース列に対して識別されているコード・カテゴリが有効であること(「シード済コード・カテゴリ」(B-2 ページ)を参照)、およびコード変

換の相互参照が取引先固有リスト、標準固有リストまたは汎用リストに定義されていることを確認してください。このエラーの再発を防ぐために必要な訂正を行ってください。

2 コード変換処理で予期せぬエラーが発生し、セッションが終了しました。

処理のログ・ファイルで詳細をチェックし、必要な訂正を行った後、メッセージを再処理してください。

2-100 Oracle XML Gateway ユーザーズ・ガイド

Page 129: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

内部制御番号は、エンベロープ情報を取得するために使用できます。詳細は、「ECX_TRADING_PARTNER_PVT.getEnvelopeInformation API」(F-16 ページ)を参照してください。

リターン・コードリターン・コードリターン・コードリターン・コード

リターン・コードは、エラー・メッセージに関連付けられたエラー・コードです。エラー・メッセージの送信処理を使用して、エラー・メッセージを取引先担当または XML Gatewayシステム管理者に返すことができます。

複数のリターン・コードを単一の事前定義済みの変数に連結できます。「リターン・コード」の値は、結果変数に割り当てられます。

次の表は、可能なリターン・コードを示します。

リターン・メッセージリターン・メッセージリターン・メッセージリターン・メッセージ

リターン・メッセージは、リターン・コードに関連付けられたテキストです。エラー・メッセージの送信処理を使用して、エラー・メッセージをエラー取引先担当または XML Gateway システム管理者に返すことができます。

複数のリターン・メッセージを単一の事前定義済みの変数に連結できます。「リターン・メッセージ」の値は、結果変数に割り当てられます。

受信側取引先受信側取引先受信側取引先受信側取引先 ID

受信側取引先 ID は、XML メッセージの受信者を示す一意の識別子です。この ID を使用して、取引先の名前やその他の関連データを取り出すことができます。

受信側取引先 ID に関連付けられたパーティ ID、パーティ・サイト ID、組織 ID、管理者 Eメール・アドレスを取り出すには、ECX_TRADING_PARTNER_PVT.get_receivers_tp_infoプロシージャを使用します。詳細は、「XML Gateway API」(F-2 ページ)を参照してください。

受信側取引先 ID は、アウトバウンド・メッセージおよび引渡しメッセージに関して保守されます。

受信側取引先 ID は、結果変数に割り当てられます。

送信元取引先送信元取引先送信元取引先送信元取引先 ID

送信元取引先 ID は、XML メッセージの送信者を示す一意の識別子です。この ID を使用して、取引先の名前やその他の関連データを取り出すことができます。

リターン・コードリターン・コードリターン・コードリターン・コード 説明説明説明説明

0 成功。

1 警告。XML Gateway 実行エンジンは停止しません。

2 失敗。処理のログ・ファイルで詳細をチェックし、必要な訂正を行った後、メッセージを再処理してください。

Message Designer 2-101

Page 130: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

送信元取引先 ID に関連付けられたパーティ ID、パーティ・サイト ID、組織 ID、管理者 Eメール・アドレスを取り出すには、ECX_TRADING_PARTNER_PVT.get_senders_tp_infoプロシージャを使用します。詳細は、「XML Gateway API」(F-2 ページ)を参照してください。

送信元取引先 ID は、インバウンド・メッセージおよび引渡しメッセージに関して保守されます。

送信元取引先 ID の値は、結果変数に割り当てられます。

組織組織組織組織 ID

実行エンジンによって、送信元取引先 ID または受信側取引先 ID に関連付けられた組織 IDが取り出されます。組織 ID と送信元取引先 ID または受信側取引先 ID との組合せにより、Oracle E-Business Suite において取引先が一意に識別されます。

Map Action Editor - プロシージャ・コールプロシージャ・コールプロシージャ・コールプロシージャ・コール : プロシージャの実行プロシージャの実行プロシージャの実行プロシージャの実行プロシージャの実行処理では、アクティビティを実行するプロシージャをコールします。入力(送信)パラメータと出力(リターン)パラメータを持つプロシージャもあれば、パラメータがないプロシージャもあります。

プロシージャの実行処理では、データベースへの接続が行われ、選択できる使用可能なプロシージャのリストが表示されます。プロシージャを選択すると、パラメータ値の入力を求められます。

ファンクション・コールはプロシージャの実行処理のサポート対象ではありません。

特殊な目的に使用されるプロシージャのリストについては、「XML Gateway API」(F-2 ページ)を参照してください。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

「Assign Parameter Value」ボタンをクリックし、「Get Procedure Parameters」ウィンドウを表示します。

2-102 Oracle XML Gateway ユーザーズ・ガイド

Page 131: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

デフォルトのデータベース・アクセス情報は「File」>「Properties」メニューの「Database」タブ(2-6 ページ)から表示します。この画面でデフォルトを上書きできます。この画面で行った変更は、プロパティ・ファイルにコピーされません。変更は、現行のセッションにのみ使用されます。

Message Designer 2-103

Page 132: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

データベースに接続すると、プロシージャのすべての署名が表示されます。「+」をクリックしてすべての署名を拡張します。拡張したリストからプロシージャを選択し、「OK」をクリックします。

2-104 Oracle XML Gateway ユーザーズ・ガイド

Page 133: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

パラメータ値を入力します。

プロシージャでパラメータがどのように定義されているかにかかわらず、パラメータ・タイプがインバウンドである各パラメータに対して、値が(XML Gateway 実行エンジンによって)要求されます。ただし、プロシージャにデフォルト値が用意されている場合は除きます。デフォルト値はソース変数、ターゲット変数、グローバル変数(定義されている場合)またはリテラル値に基づいています。ソース変数、ターゲット変数またはグローバル変数の値は、実行時に決定されます。

デフォルト値が定義されているパラメータに対して、デフォルト値を上書きする場合は、別の変数またはリテラル値を指定できます。

必要なすべてのパラメータ値を入力した後、「OK」をクリックして「Map Action Editor」ウィンドウに戻ります。

Message Designer 2-105

Page 134: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

選択したプロシージャが「Procedure Name」フィールドに表示されます。入力したパラメータ値を確認するには、「View Parameters」ボタンをクリックします。パラメータ値を検証し、必要であれば値を訂正した後、「OK」をクリックして「Map Action Editor」ウィンドウに戻ります。

変数を返すプロシージャ(パラメータ・タイプがアウトバウンド)については、一時変数を定義するか、既存の変数(ソース、ターゲットまたはグローバル)を使用します。ステータスの戻り値を使用して、重要度に基づく処理フローのリダイレクトを実行できます。返されるエラー・コードとエラー・メッセージは、エラー・メッセージの送信処理を使用して、XML Gateway システム管理者または取引先担当に送信できます。

XML Gateway 実行エンジンは、データ型が VARCHAR2、DATE、NUMBER、CHAR および CLOB であるパラメータをサポートしています。必須プロシージャにサポート対象外のデータ型が含まれている場合、この処理を使用するには、パラメータ値をサポート対象のデータ型に変換する必要があります。

Map Action Editor - リターン・エラー・メッセージリターン・エラー・メッセージリターン・エラー・メッセージリターン・エラー・メッセージ : エラー・メッセージのエラー・メッセージのエラー・メッセージのエラー・メッセージの送信送信送信送信

エラー・メッセージの送信処理では、ECX_SYS_ADMIN_EMAIL システム・プロファイルで識別されている取引先担当または XML Gateway システム管理者にエラー・メッセージを送信します。

エラー・メッセージの送信処理は、プロセスの終了を必要としない警告に使用します。プロセスの終了が必要となるより重大なエラーには、ECX_ACTIONS.set_error_exit_program API を使用します。使用方法の詳細は、「set_error_exit_program」(F-23 ページ)を参照してください。

エラー・メッセージは、次のソースから取得できます。

� プロシージャ・コールのリターン・パラメータ

� 関数コールのステータス

エラー・メッセージを含む Workflow 通知は、送信先プロンプトで識別されているパーティに送信されます。

この処理は、標準のエラー処理および通知処理の補強のために提供されています。詳細は、「XML Gateway エラー・プロセス項目タイプ」(6-28 ページ)を参照してください。

2-106 Oracle XML Gateway ユーザーズ・ガイド

Page 135: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

Send Error Message送信するエラー・メッセージを含む変数を指定します。エラー・メッセージはリテラルで表現できます。

この処理をプロシージャ・コール処理と組み合せて使用する場合、変数はリターン・パラメータまたはリテラル値とすることができます。

この処理を関数コール処理と組み合せて使用する場合、変数は関数の戻り値か、またはXML Gateway 実行エンジンによって保守されるリターン・メッセージ変数に含まれる値にすることができます。

リターン・メッセージ内の値のような複数の文字列をリテラル値と連結し、完全なメッセージを作成できます。

Toエラー・メッセージの受信者を指定します。有効なオプションは、ECX_SYS_ADMIN_EMAIL システム・プロファイルで識別されている取引先担当または XML Gateway システム管理者です。

Message Designer 2-107

Page 136: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Map Action Editor - 文字列関数文字列関数文字列関数文字列関数 : 連結の実行連結の実行連結の実行連結の実行連結の実行処理では、2 つのオペランド内の値を連結します。実行時に値が決定される変数に基づくオペランド、またはリテラル値に基づくオペランドを連結できます。

3 つ以上のオペランドを連結するには、最初に 2 つのオペランドを連結し、結果を変数(ソース、ターゲットまたはグローバル)に保存します。次に、この変数内の値を次のオペランドと連結します。

連結の実行処理は、任意のデータ型のフィールドに適用できます。これは、処理の実行前に、XML Gateway 実行エンジンによって値が VARCHAR2 に変換されるためです。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

結果変数結果変数結果変数結果変数

連結された結果文字列を保存するためのソース変数、ターゲット変数またはグローバル変数を選択します。

第第第第 1 オペランドオペランドオペランドオペランド

第 1 オペランドを指定します。

オペランドは、実行時に値が決定される変数(ソース変数、ターゲット変数または定義されている場合はグローバル変数)またはリテラル値にすることができます。

Concatenated With第 1 オペランドと連結する第 2 オペランドを指定します。

オペランドは、実行時に値が決定される変数(ソース変数、ターゲット変数または定義されている場合はグローバル変数)またはリテラル値にすることができます。

連結された値は結果変数に割り当てられます。

2-108 Oracle XML Gateway ユーザーズ・ガイド

Page 137: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Map Action Editor

Map Action Editor - 文字列関数文字列関数文字列関数文字列関数 : サブ文字列の実行サブ文字列の実行サブ文字列の実行サブ文字列の実行サブ文字列の実行処理では、指定された文字列を開始位置から解析し、指定された桁数の文字を取り込みます。結果のサブ文字列が返されます。

サブ文字列の実行処理は、任意のデータ型のフィールドに適用できます。これは、処理の実行前に XML Gateway 実行エンジンによって値が VARCHAR2 に変換されるためです。

追加のサブ文字列関数の詳細は、「ECX_CONDITIONS で定義されている API」(F-11 ページ)を参照してください。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

結果変数結果変数結果変数結果変数

結果サブ文字列を保存するためのソース変数、ターゲット変数またはグローバル変数を選択します。

Elementサブ文字列処理が必要なオペランドを指定します。

オペランドは、実行時に値が決定される変数(ソース変数、ターゲット変数または定義されている場合はグローバル変数)またはリテラル値にすることができます。

Start Position0 より大きく、要素の最大長よりも小さい開始位置を入力します。

With Length0 より大きく、要素から開始位置を引いた最大長以下の長さを入力します。

サブ文字列関数によって、開始位置から指定の長さまでの要素が処理され、結果のサブ文字列が結果変数に割り当てられます。

Message Designer 2-109

Page 138: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

DTD の拡張方法

Map Action Editor - XSLT 変換変換変換変換XML Gateway では、インバウンド・メッセージおよびアウトバウンド・メッセージの両方の XSLT 変換がサポートされています。取引先に配信する XML メッセージをエンキューする前に、XML メッセージに XSLT スタイル・シートを適用できます。同様に、インバウンド・メッセージに対しても、メッセージをデキューした後、Oracle E-Business Suite によって処理される前に、スタイル・シートを適用できます。

XSLT スタイル・シートを含むファイルは、ECX_UTL_XSLT_DIR システム・プロファイルで定義されているディレクトリに保存する必要があります。XML パーサーは、アウトバウンド・メッセージの送信前に実行する最後の処理として、またはインバウンド・メッセージを処理する前の最初の処理として、変換を適用します。

ウィンドウの共通コンポーネントの詳細は、「Map Action Editor - 概要」(2-71 ページ)を参照してください。

XSLT Style Sheet変換手順を含むスタイル・シートの名前を入力します。

DTD の拡張方法の拡張方法の拡張方法の拡張方法XML Gateway Message Designer は、DTD および既存の XML メッセージとの間のマッピングをサポートします。既存の本番の XML メッセージを使用すると、すべての DTD 拡張、および実際のビジネス文書をサポートするために必要となる重複ノードや要素を表示することができます。既存の XML メッセージが使用できない場合は、DTD を使用する必要があります。DTD を使用するには、追加データに適合するように重複ノード、新しいセグメント、または要素を追加する必要があります。

Oracle の作成済みメッセージ・マップを変更する場合、または DTD 拡張に必要となる新規メッセージ・マップを作成する場合は、次に示す DTD 拡張に関するガイドラインに従ってください。オープン・アプリケーション・グループ(OAG)には、DTD 拡張に関する非常に厳密なガイドラインがあります。

2-110 Oracle XML Gateway ユーザーズ・ガイド

Page 139: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

DTD の拡張方法

DTD 拡張は、USERAREA でのみ許可されています。OAG で定義された適切な USERAREAに要素を追加したり、OAG で定義された USERAREA に新規 USERAREA を作成できます。

『Open Application Group's Integration Specification』のセクション 2.11「USERAREA Extensions」の OAG に関するガイドラインを参照してください

(http://www.openapplications.orgから入手可能)。

付加フレックスフィールドおよび他の拡張をサポートするには、USERAREA を使用します。

OAG に関するガイドラインは、次のとおりです。

Oracle の OAG に関するガイドラインへの適合状況は、次のとおりです。

XML Gateway には、アプリケーション固有の DTD 拡張を作成するための基礎として使用されるテンプレートが用意されています。テンプレートでは、"attribute*" という名前の汎用フレックスフィールドが定義されています。ここで、* は表に対して定義されている属性の数です。アプリケーション固有の DTD 拡張ファイルは、特定のアプリケーションによりソース管理されます。

アプリケーション固有の DTD 拡張ファイルは、次のように更新できます。

� 付加フレックスフィールドを含むアプリケーション表を表す最上位レベルのUSERAREA 名

� 付加フレックスフィールド名

最上位レベル名最上位レベル名最上位レベル名最上位レベル名 < 仕入先 . トランザクション . コンテキスト .USERAREA>

要素名要素名要素名要素名 < 仕入先 . 要素名 >

参照ファイル名参照ファイル名参照ファイル名参照ファイル名 < 仕入先プリフィクス >_< 製品 >_< バージョン >.dtd

付加フレックスフィールド拡付加フレックスフィールド拡付加フレックスフィールド拡付加フレックスフィールド拡張の最上位レベル名張の最上位レベル名張の最上位レベル名張の最上位レベル名

<Oracle. トランザクション . フレックスフィールド名.USERAREA>例 : Oracle.ARInvoice.ARLINES.USERAREA

要素名要素名要素名要素名 <Oracle. 属性 n>この場合、n は表に対して定義された属性の数

その他の拡張の最上位レベルその他の拡張の最上位レベルその他の拡張の最上位レベルその他の拡張の最上位レベル名名名名

<Oracle. トランザクション . 製品 _ プリフィクス .USERAREA>例 : Oracle.ARInvoice.AR.USERAREA

要素名要素名要素名要素名 <Oracle. 要素名 >

参照ファイル名参照ファイル名参照ファイル名参照ファイル名 Oracle_< アプリケーション短縮名 >DTDExtensions_< バージョ

ン >.dtd例 : Oracle_ARDTDExtensions_001.dtd

Message Designer 2-111

Page 140: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

引渡しメッセージのマッピング方法

� その他の拡張の最上位レベル USERAREA 名

� その他の拡張の要素名

更新は、既存の USERAREA タグの後ろに追加する必要があります。

フレックスフィールドまたはアプリケーション拡張の正しいグループに対してマッピングが行われるようにするには、条件ノード・マッピングおよび最上位レベル USERAREA 名のキーを使用します。

メッセージ・マップから拡張の定義を削除するには、参照ファイルから拡張の定義を削除してください。

DTD 拡張として導入された新しいフィールドが組み込まれるように、メッセージ・マップを更新します。更新されたメッセージ・マップおよび DTD 拡張ファイルは、XML Gateway実行エンジンがアクセスできるように、XML Gateway リポジトリにロードする必要があります。詳細は、「メッセージ・マップおよび DTD のロード方法」(2-113 ページ)を参照してください。

引渡しメッセージのマッピング方法引渡しメッセージのマッピング方法引渡しメッセージのマッピング方法引渡しメッセージのマッピング方法引渡しメッセージは、Oracle Exchange でコード変換(必要な場合)用に受信された後に最終宛先にルーティングされるメッセージです。Oracle Exchange は、これらのメッセージのルーティング・ハブとして機能します。

引渡しメッセージのマッピングは、次のように定義されます。

� 最高レベルのみをマップします。OAG DTD 内の最高レベルは CNTROLAREA です。

� 処理のためにメッセージ・マップを XML Gateway リポジトリにロードします。詳細は、「メッセージ・マップおよび DTD のロード方法」(2-113 ページ)を参照してください。

� Exchange ハブを取引先として定義し、XML メッセージを引渡し取引として使用可能にします。「取引先の設定」(3-17 ページ)を参照してください。

� Oracle XML Gateway または Oracle Exchange に必要なコード変換を定義します。「コード変換」(3-31 ページ)を参照してください。

API へのマッピング方法へのマッピング方法へのマッピング方法へのマッピング方法このセクションでは、アプリケーション・オープン・インタフェース表のかわりに API にマッピングする方法について説明します。インバウンド XML メッセージのデータは、アプリケーション・オープン・インタフェース表と呼ばれる一連のステージ表にコピーされます。これらのステージ表のデータは、ビジネス・ルールが格納されたアプリケーション・オープン・インタフェース API を使用して検証されます。有効なデータは、アプリケーション実表に移動されます。無効なデータには参照用マークが付けられます。

2-112 Oracle XML Gateway ユーザーズ・ガイド

Page 141: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

メッセージ・マップおよび DTD のロード方法

ステージ表および検証ルールが同じコード内(通常はアプリケーション API と呼ばれる)に埋め込まれている場合は、インバウンド XML メッセージのデータはアプリケーション APIのパラメータにマッピングされます。

アプリケーション API に直接マッピングするには、マップを次のように定義する必要があります。

� ソースおよびターゲットのデータ定義タイプを XML にする必要があります。

� ソースとターゲットの DTD およびバージョンを同じにする必要があります。

� ソースのレベルをターゲットのレベルにマッピングします。

� アプリケーション API を参照するプロシージャの実行のターゲット処理をプロシージャ名として定義します。文書レベルでは、この処理は後処理アクティビティとして定義されます。ソースの変数を API パラメータにマッピングします。API リターン・ステータスをチェックする処理を含めます。

文書レベルごとにこの方法を適用します。文書に 3 つのレベルがある場合は、この方法を 3 回適用します。

� メッセージ・マップおよび対応する DTD を処理するために XML Gateway リポジトリにロードします。マップを XML Gateway リポジトリにロードする方法については、

「メッセージ・マップおよび DTD のロード方法」(2-113 ページ)を参照してください。

� 取引先を定義し、XML メッセージを使用可能にします。

� 必要なすべてのコード変換を定義します。

Message Designer では、複数の文書レベルで構成されるアプリケーション API はサポートされません。Message Designer は、一度に 1 つの文書レベルのデータを処理するように設計されています。

メッセージ・マップおよびメッセージ・マップおよびメッセージ・マップおよびメッセージ・マップおよび DTD のロード方法のロード方法のロード方法のロード方法

マップのロードマップのロードマップのロードマップのロードOracle メッセージ・マップは、$APPLTOP ディレクトリに配信およびインストールされます。マップは LoadMap プログラムを使用して、XML Gateway リポジトリに自動的にロードされます。マップは、DeleteMap プログラムを使用して削除できます。

Oracle の作成済みメッセージ・マップを変更するか、または Message Designer を使用して新規メッセージ・マップを作成した場合、これらのマップはローカル・ファイル・システムに保存されます。マップを XML Gateway リポジトリにロードして、XML Gateway 実行エンジンで使用できるようにするには、次のステップを実行します。

1. <mymap>.xgm ファイルをローカル・ファイル・システムから中間層に移動します。$APPLTOP にインストールされたマップを含む apps.zipファイルは、中間層にインストールされています。

Message Designer 2-113

Page 142: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

メッセージ・マップおよび DTD のロード方法

2. java LoadMap<DBユーザー名 ><DBパスワード ><ホスト名 >:<ポート>:<SID><mymap.xgm>を実行して、メッセージ・マップを XML Gateway リポジトリにロードします。LoadMap により、既存のマップが同じ名前のマップで置き換えられます。

例 : java LoadMap User1 welcome ap999sun.us.oracle.com:1521:ORA1151<mymap.xgm>

マップは、次のように DeleteMap プログラムを使用して削除できます。

1. java DeleteMap <DBユーザー名 ><DBパスワード ><ホスト名 ><:<ポート>:<SID><マップコード >を実行して、XML Gateway リポジトリからメッセージ・マップを削除します。LoadMap により、既存のマップが同じ名前のマップで置き換えられますが、名前が異なる廃止マップは手動で削除する必要があります。

<マップコード >は、Message Designer に入力されたマップ名です。

例 : java DeleteMap User1 welcome ap222sun.us.oracle.com:1521:ORA1151<mapcode>

注意注意注意注意 : LoadMap プロセスでは、マップのバージョンがエンジンのバージョンと互換性がある場合に、マップがロードされます。マップのバージョンは、マップ・ファイル(.xgm)の <ECX_MAJOR_VERSION> および <ECX_MINOR_VERSION> タグに格納されます。エンジンのバージョンは WF_RESOURCES に格納されます。メジャー・バージョンが同じで、かつマップのマイナー・バージョンがエンジンのマイナー・バージョン以下の場合、マップはエンジンと互換性があります。

2-114 Oracle XML Gateway ユーザーズ・ガイド

Page 143: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

メッセージ・マップおよび DTD のロード方法

DTD のロードのロードのロードのロード各メッセージ・マップは、一連の DTD(メイン DTD およびその参照 DTD)に関連付けられます。メッセージ・マップと同様、Oracle の作成済みメッセージ・マップに関連付けられた DTD は、$APPLTOP に配信およびインストールされます。これらの DTD は、LoadDTDToClob プログラムによって、自動的に XML Gateway データベースにロードされます。DTD は、DeleteDTDFromClob プログラムを使用して削除できます。

既存のメッセージ・マップ内で参照されている DTD を変更するには、Message Designer の「File」>「Properties」メニュー・オプションを使用して、必要な変更を行います。更新されたメッセージ・マップは、LoadMap を使用して XML Gateway にロードする必要があります(「マップのロード」(2-113 ページ)を参照)。また、次の手順に従って、使用される新規 DTD を XML Gateway データベースにロードする必要があります。

1. <mydtd>.dtd ファイルをローカル・ファイル・システムから中間層に移動します。$APPLTOP にインストールされた DTD を含む apps.zipファイルは、中間層にあります。

2. java LoadDTDToClob<DBユーザー名 ><DBパスワード ><ホスト名 >:<ポート>:<SID><mydtd.dtd><ルート要素名 ><場所 >を実行して、DTD を XML Gatewayデータベースにロードします。LoadDTDToClob により、既存の DTD が同じ名前のDTD で置き換えられます。

<ルート要素名 >は、Message Designer に入力された XML ルート要素です。

<場所 >は、ウィザードの「XML File and Root Element」ウィンドウに入力されたサブディレクトリ名です。

DTD は、次のように DeleteDTDFromClob プログラムを使用して削除できます。

java DeleteDTDFromClob <DBユーザー名 ><DBパスワード ><ホスト名 >:<ポート >:<SID><mydtd.dtd><ルート要素名 ><場所 >を実行して、XML Gateway データベースから DTD を削除します。LoadDTDToClob により、既存の DTD が同じ名前のDTD で置き換えられますが、異なる名前の廃止 DTD は手動で削除する必要があります。

<ルート要素名 >は、Message Designer に入力された XML ルート要素です。

<場所 >は、ウィザードの「XML File and Root Element」ウィンドウに入力されたサブディレクトリ名です。

LoadMap および LoadDTDToClob は、様々な組合せの変更をサポートする 2 つの個別のプログラムとして用意されています。マップおよび DTD が同期化されるようにするには、常に LoadMap および LoadDTDToClob をペアとして実行します。

Message Designer 2-115

Page 144: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

メッセージ・マップおよび DTD のロード方法

2-116 Oracle XML Gateway ユーザーズ・ガイド

Page 145: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の

3

XML Gateway の設定の設定の設定の設定

この章には、次の項目が含まれます。

� インプリメンテーション・ステップのリスト

� XML Gateway 設定フォームの説明

設定概要設定概要設定概要設定概要

インプリメンテーション・チェックリストインプリメンテーション・チェックリストインプリメンテーション・チェックリストインプリメンテーション・チェックリスト

XML Gateway の設定には、10 段階の手順があります。

XML Gateway のフォームのフォームのフォームのフォーム

XML Gateway には、設定手順を完了するために使用するフォームが 7 つあります。

� システム・プロファイル値(3-2 ページ)

手順手順手順手順 完了済完了済完了済完了済 作業作業作業作業

1 システム・プロファイル値の定義(3-2 ページ)

2 XML Gateway 職責の定義(3-3 ページ)

3 utl_file_dirパラメータの定義(3-3 ページ)(DBA が実行)

4 ハブの定義(3-4 ページ)

5 XML 標準の定義(3-6 ページ)

6 トランザクションの定義(3-7 ページ)

7 参照値の定義(3-14 ページ)

8 取引先の定義(3-17 ページ)

9 取引先コード変換の設定(3-42 ページ)

10 標準コード変換の定義(3-39 ページ)

設定 3-1

Page 146: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

システム・プロファイル値の定義

� ハブ定義(3-4 ページ)

� XML 標準の定義(3-6 ページ)

� トランザクションの定義(3-7 ページ)

� Oracle XML Gateway 参照(3-14 ページ)

� 取引先設定の定義(3-17 ページ)

� コード変換の定義(3-39 ページ)

システム・プロファイル値の定義システム・プロファイル値の定義システム・プロファイル値の定義システム・プロファイル値の定義「システム・プロファイル値」フォームでは、次の情報を指定します。

� XML メッセージおよび処理ログ・ファイルのディレクトリ・パス

� XSLT スタイル・シートのディレクトリ・パス

� XML Gateway システム管理者の E メール・アドレス

� 送信者の情報システムの指定

� データベース・サーバーのタイム・ゾーンの設定

次の表は、システム・プロファイル・オプションをリストしています。

システム・プロファイル・システム・プロファイル・システム・プロファイル・システム・プロファイル・オプションオプションオプションオプション

説明説明説明説明 必須必須必須必須 デフォルトデフォルトデフォルトデフォルト値値値値

ECX: ログ・ファイル・パス XML メッセージおよびランタイム・

ログの保存先ログ・ファイル・パス

YES なし

ECX: XSLT ファイル・パス XSLT スタイル・シートの保存先

XSLT パス

YES なし

ECX: システム管理者

E メール・アドレス

XML Gateway システム管理者の Eメール・アドレス

YES なし

ECX_OAG_LOGICALID 送信者の情報システムの識別子 NO なし

ECX: サーバー・タイム・

ゾーン

データベース・サーバーが実行されているタイム・ゾーン

YES NULL

注意注意注意注意 : 「ECX: サーバー・タイム・ゾーン」の有効な値は、付録 E にリストされています。このプロファイル・オプションが設定されていない場合、タイム・ゾーン ID はデフォルトでグリニッジ標準時(GMT)に設定されます。

3-2 Oracle XML Gateway ユーザーズ・ガイド

Page 147: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

UTL_FILE_DIR パラメータの定義

XML Gateway 職責の定義職責の定義職責の定義職責の定義Oracle XML Gateway のデータベースおよびフォームにアクセスする場合は、Oracle XML Gateway の職責をユーザーに割り当てるよう Oracle Applications のシステム管理者に依頼します。職責の割当てには、標準の手順を使用します。

UTL_FILE_DIR パラメータの定義パラメータの定義パラメータの定義パラメータの定義このステップは、データベース管理者(DBA)と協力して実行します。

INIT.ORA ファイルでのファイルでのファイルでのファイルでの UTL_FILE_DIR パラメータの定義パラメータの定義パラメータの定義パラメータの定義

Oracle XML Gateway を使用するには、最初に XML メッセージ処理ログおよび XSLT スタイル・シートを保存するディレクトリを作成する必要があります。Oracle XML Gateway では、UTL_FILEパッケージを使用してサーバーに対する読み書きが実行されます。

UTL_FILEは、アクセス可能なディレクトリにのみ書き込むことができます。アクセス可能なディレクトリは、init<SID>.oraファイルの utl_file_dirパラメータで定義します。このファイルは、通常、$ORACLE_HOME/dbsディレクトリにあります。このファイル内では、アクセス可能な各ディレクトリが次のような行によって示されます。

utl_file_dir = directory_name

directory_name の仕様は、オペレーティング・システムによって異なります。オペレーティング・システムで大文字小文字が区別される場合、directory_name も大文字小文字が区別されます。

directory_name の値は、物理ディレクトリである必要があります。変数、論理ディレクトリまたは別名とすることはできません。また、directory_name の値は、ECX_UTL_LOG_DIRファイル・パス(ECX: ログ・ファイル・パス)および ECX_UTL_XSLT_DIR ファイル・パス(ECX: XSLT ファイル・パス)の Oracle XML Gateway プロファイルで定義されている値に一致する必要があります。

詳細は、「システム・プロファイル値の定義」(3-2 ページ)を参照してください。

例例例例 : UNIX オペレーティング・システムオペレーティング・システムオペレーティング・システムオペレーティング・システム

次に、UNIX オペレーティング・システムに対する入力例を示します。

utl_file_dir = /d1/XML/logs/d1/XML/xslt

追加情報追加情報追加情報追加情報 : プロファイル・オプションの設定の詳細は、『Oracle Applications システム管理者ガイド』を参照してください。

追加情報追加情報追加情報追加情報 : 『Oracle Applications システム管理者ガイド』を参照してください。

XML Gateway の設定 3-3

Page 148: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「ハブ定義」フォーム

この形式のデータベース・セキュリティの他に、オペレーティング・システム・セキュリティも検討する必要があります。UTL_FILEを使用して実行するファイル I/O 操作は、Oracle ユーザーによって実行されます(Oracle ユーザーはデータベースの実行に使用されるファイルの所有者であり、データベース・インスタンスを構成するプロセスの所有者でもあります)。このため、Oracle ユーザーには、アクセス可能なすべてのディレクトリに対する読取りおよび書込みのオペレーティング・システム権限が必要です。アクセス可能なディレクトリに対する権限が Oracle ユーザーにない場合は、そのディレクトリ内でのすべての操作がオペレーティング・システムによって禁止されます。

指定したディレクトリでのファイルの作成、削除、名前変更、読取りおよび書込みがオペレーティング・システム・セキュリティによって Oracle ユーザーに確実に許可されるように、DBA は、CHMOD 777コマンドを発行してオペレーティング・システム・レベルでディレクトリおよびファイルのアクセス権限を付与する必要があります。これは UNIX のみでの例です。環境に応じた適切なオペレーティング・システム・コマンドを使用してください。

init<SID>.oraファイルに対する変更を有効にするには、Oracle インスタンスを停止して再開始する必要があります。

「ハブ定義」フォーム「ハブ定義」フォーム「ハブ定義」フォーム「ハブ定義」フォームXML Gateway 職責から「設定」>「ハブの定義」を選択して「ハブ定義」フォームにナビゲートします。

ハブは、ユーザーのネットワーク(イントラネットまたはインターネット)内の統合ポイントです。ハブは、通常、取引先間での文書のルーティングに使用されます。ハブの例としてOracle Exchange があります。私設のハブをイントラネット内に作成し、そのハブを使用してすべての ERP システム間での通信を行うこともできます。

「ハブ定義」フォームを使用して、ハブおよびハブ経由でビジネスを実行する承認済ユーザーを定義します。このフォームに入力したハブ・ユーザーは、「取引先設定」フォーム

(3-17 ページ)に表示されます。

3-4 Oracle XML Gateway ユーザーズ・ガイド

Page 149: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「ハブ定義」フォーム

名称(必須)名称(必須)名称(必須)名称(必須)

ハブ名を入力します。

プロトコル・タイプ(必須)プロトコル・タイプ(必須)プロトコル・タイプ(必須)プロトコル・タイプ(必須)

プロトコル・タイプは、ハブに関連付けられている通信プロトコルです(SMTP や HTTP など)。値リストから値を選択します。プロトコル・タイプの摘要が表示されます。

プロトコル・アドレスプロトコル・アドレスプロトコル・アドレスプロトコル・アドレス プロトコル・タイプが HTTP または HTTPS の場合は、プロトコル・アドレスを入力するように要求されます。

XML Gateway の設定 3-5

Page 150: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「XML 標準の定義」フォーム

プロトコル・アドレスとは、Transport Agent により XML 文書が転記される完全な URL(サービスまたはサーブレットを含む)です。

プロトコル・タイプが SMTP の場合、プロトコル・アドレスは E メール・アドレスです。

ハブ・ユーザーハブ・ユーザーハブ・ユーザーハブ・ユーザー

ユーザー名(必須)ユーザー名(必須)ユーザー名(必須)ユーザー名(必須)

ハブ経由でビジネスを実行する取引先のユーザー名を入力します。

パスワード(必須)パスワード(必須)パスワード(必須)パスワード(必須)

このユーザーのパスワードを入力します。パスワードは暗号化されてデータベースに保存されます。パスワードを入力するとき、パスワードは表示されません。同じフィールドでパスワードを確認するように要求されます。

ハブ・エンティティ・コード(必須)ハブ・エンティティ・コード(必須)ハブ・エンティティ・コード(必須)ハブ・エンティティ・コード(必須)

このユーザーのハブ・エンティティ・コードを入力します。

ハブ・エンティティ・コードには、「取引先設定」フォーム(3-17 ページ)のソース取引先事業所コード(3-24 ページ)と同じ機能があります。ソース取引先事業所コードは、メッセージのソースを識別するための、XML エンベロープに存在するコードです。

取引先との間でメッセージを送受信する場合は、メッセージの方向に応じて、ユーザーの事業所コードや取引先の事業所コードを混合して使用することになります。たとえば、メッセージを送信する場合は、ユーザーが XML メッセージの送信元であるため、ソース取引先事業所コードはユーザーの事業所コードになります。メッセージを受信する場合は、取引先が XML メッセージの送信元になるため、ソース取引先事業所コードは取引先の事業所コードになります。

インバウンド・メッセージの場合、取引先の検証時にこのコードが確認されます。このコードをアウトバウンド・メッセージに配置する場合は、受信者がこのコードを有効なソース所在地コードとして検証します。

ハブ・エンティティ・コードは、XML Gateway エンベロープのパーティ ID フィールドに配置されます。

「「「「XML 標準の定義」フォーム標準の定義」フォーム標準の定義」フォーム標準の定義」フォームXML Gateway 職責から「設定」>「XML 標準の定義」を選択して、「XML 標準の定義」フォームにナビゲートします。

このフォームでは、XML メッセージに使用する標準のボディ(OAG など)を定義します。

このフォームでの「標準コード」への入力は、次のフォームで「標準コード」フィールドの値リストに表示されます。

3-6 Oracle XML Gateway ユーザーズ・ガイド

Page 151: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「トランザクションの定義」フォーム

� 「トランザクションの定義」フォーム(3-7 ページ)

� 「取引先コード変換」フォーム(3-42 ページ)(「取引先設定」フォームからアクセス可能)

� 「標準コード変換」フォーム(3-39 ページ)

「トランザクションの定義」フォームでは、DTD の作成元組織を特定し、XML メッセージ構造を特定します。「XML 標準の定義」フォームで入力した値は、「トランザクションの定義」フォームの「標準コード」フィールドの値リストになります。

「取引先コード変換」フォームおよび「標準コード変換」フォームでは、この値はコード変換表にアクセスするための検索キーの一部として使用されます。

また、「標準コード」が「トランザクションの定義」フォームの項目に割り当てられる場合、「標準コード」は標準コード変換表の検索で使用されるデフォルトの標準コードになります。

標準コード(必須)標準コード(必須)標準コード(必須)標準コード(必須)

このフィールドは、XML メッセージに使用する標準のボディの名称またはコードです。

このフォームには、UNIVERSAL という値以外の XML 標準のみを入力します。シードされた値である UNIVERSAL は、ISO コードなどの汎用的に使用されるコードを指定するために、「標準コード変換」フォームで必要となります。

標準タイプ標準タイプ標準タイプ標準タイプ 「標準タイプ」は、ユーザーが選択する適切な任意の値です。

摘要摘要摘要摘要

標準の摘要を入力します。

「トランザクションの定義」フォーム「トランザクションの定義」フォーム「トランザクションの定義」フォーム「トランザクションの定義」フォーム XML Gateway 職責から「設定」>「トランザクションの定義」を選択して、「トランザクションの定義」フォームにナビゲートします。

XML Gateway の設定 3-7

Page 152: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「トランザクションの定義」フォーム

「トランザクションの定義」フォームを使用して、XML Gateway 実行エンジンで使用するトランザクションを定義します。定義したトランザクションは、「取引先設定」フォームで取引先と関連付けます。

「トランザクションの定義」フォームでは、次の情報を指定します。

� 外部トランザクション識別子と内部 Oracle トランザクション識別子の間の相互参照

� インバウンド・メッセージを抽出するキューの指定

相互参照トランザクション識別子相互参照トランザクション識別子相互参照トランザクション識別子相互参照トランザクション識別子

このフォームでは、内部 Oracle トランザクション識別子を表す「トランザクション・タイプ」と「トランザクション・サブタイプ」、および「外部トランザクション・タイプ」と

「外部トランザクション・サブタイプ」との相互参照を指定します。

たとえば、OAG PROCESS_INVOICE_003 は、パーティ・タイプが「顧客」のインバウンド・メッセージの例です。このメッセージは外部トランザクション・タイプが「プロセス」で、外部トランザクション・サブタイプが「請求書」です。インバウンドの方向は XML Gateway によって決定されます。

外部トランザクション・タイプ「プロセス」と外部トランザクション・サブタイプ「請求書」は、「トランザクションの定義」フォームに定義するときに、AP および INI に相当するトランザクション・タイプおよびトランザクション・サブタイプに関連付けられます。メッセージ・マップでは、この取引先に対して Oracle Payables のどの表にインバウンド・データを配置するかを定義します。

別の例として、パーティ・タイプが「仕入先」のアウトバウンド・メッセージがあります。

Oracle Receivables の請求書トランザクションは、トランザクション・タイプが「AR」で、トランザクション・サブタイプが「INO」です。アウトバウンドの方向は、XML Gatewayによって決定されます。

このトランザクション・タイプとトランザクション・サブタイプは、指定した取引先に対して「トランザクションの定義」フォームで定義した、外部トランザクション・タイプの「請求書」と外部トランザクション・サブタイプの「プロセス」に関連付けられます。メッセージ・マップでは、この取引先に対して Oracle Receivables から抽出するデータを指定します。

パーティ・タイプ、トランザクション・タイプおよびトランザクション・サブタイプは、メッセージ作成またはメッセージ使用のトリガーとなる Workflow 業務イベント・システム

注意注意注意注意 : 「外部トランザクション・タイプ」と「外部トランザクション・サブタイプ」からなるデータ要素の対、および「トランザクション・タイプ」と「トランザクション・サブタイプ」からなるデータ要素の対は、類似したデータ要素名による 1 対 1 の相互参照ではなく、XML メッセージの外部表現を識別する有効な各対の組合せです。または、Oracle Application に対してトランザクションを識別する内部表現です。

3-8 Oracle XML Gateway ユーザーズ・ガイド

Page 153: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「トランザクションの定義」フォーム

(Business Event System: BES)との統合のために Oracle E-Business Suite で使用されるキー・コードです。

キューキューキューキュー

アプリケーションからの様々なトランザクションに対して、または転送対象 XML メッセージに対して、異なるキューを定義できます。このフォームを使用して、トランザクションにキュー名を割り当てます。

「メッセージ・キュー」(5-1 ページ)を参照してください。

XML Gateway の設定 3-9

Page 154: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「トランザクションの定義」フォーム

「トランザクションの定義」フォームのフィールド「トランザクションの定義」フォームのフィールド「トランザクションの定義」フォームのフィールド「トランザクションの定義」フォームのフィールド

パーティ・タイプ(必須)パーティ・タイプ(必須)パーティ・タイプ(必須)パーティ・タイプ(必須)

「パーティ・タイプ」では、取引先のタイプを定義します。仕入先、顧客、銀行、内部事業所(倉庫など)です。値リストから値を選択します。

トランザクション・タイプ(必須)トランザクション・タイプ(必須)トランザクション・タイプ(必須)トランザクション・タイプ(必須)

「トランザクション・タイプ」は、トランザクションに関連付けられている基本 Oracle Application 製品の短縮名です。たとえば、Oracle Receivables の場合は "AR" です。「トランザクション・タイプおよびトランザクション・サブタイプの命名規則」(3-11 ページ)を参照してください。

OAG 標準を使用する場合は、「OAG 標準での VERB および NOUN の設定」(3-13 ページ)を参照してください。

トランザクション・サブタイプ(必須)トランザクション・サブタイプ(必須)トランザクション・サブタイプ(必須)トランザクション・サブタイプ(必須)

「トランザクション・サブタイプ」は、「トランザクション・タイプ」で指定したアプリケーション内での特定のトランザクションを示すコードです。コードの末尾がトランザクションの方向を表します。"I" はインバウンド、"O" はアウトバウンドです。

「トランザクション・タイプおよびトランザクション・サブタイプの命名規則」(3-11 ページ)を参照してください。

トランザクション・タイプとトランザクション・サブタイプの組合せによって、このメッセージを関連付ける Oracle トランザクションを識別します。このデータは「取引先設定」フォームに表示されます。

OAG 標準を使用する場合は、「OAG 標準での VERB および NOUN の設定」(3-13 ページ)を参照してください。

トランザクション摘要トランザクション摘要トランザクション摘要トランザクション摘要

トランザクションの摘要を入力します。

標準コード(必須)標準コード(必須)標準コード(必須)標準コード(必須)

このトランザクションに使用する XML 標準です。「標準コード」は「XML 標準の定義」フォーム(3-6 ページ)で設定します。値リストからコードを選択します。

方向(必須)方向(必須)方向(必須)方向(必須)

「方向」は、メッセージがインバウンドかアウトバウンドかを示します。インバウンド・メッセージの場合は「IN」を、アウトバウンド・メッセージの場合は「OUT」を値リストから選択します。

3-10 Oracle XML Gateway ユーザーズ・ガイド

Page 155: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「トランザクションの定義」フォーム

外部トランザクション・タイプ(必須)外部トランザクション・タイプ(必須)外部トランザクション・タイプ(必須)外部トランザクション・タイプ(必須)

「外部トランザクション・タイプ」は、XML メッセージの一次外部識別子です。

外部トランザクション・タイプと外部トランザクション・サブタイプの組合せは、「トランザクション・タイプ」および「トランザクション・サブタイプ」で指定した Oracle 内部トランザクションに対して、このメッセージを相互参照する必要があります。

外部トランザクション・サブタイプ(必須)外部トランザクション・サブタイプ(必須)外部トランザクション・サブタイプ(必須)外部トランザクション・サブタイプ(必須)

「外部トランザクション・サブタイプ」は、XML メッセージの二次外部識別子です。

外部トランザクション・タイプと外部トランザクション・サブタイプの組合せは、「トランザクション・タイプ」および「トランザクション・サブタイプ」で指定した Oracle 内部トランザクションに対して、このメッセージを相互参照する必要があります。

キュー(インバウンド・メッセージの場合は必須)キュー(インバウンド・メッセージの場合は必須)キュー(インバウンド・メッセージの場合は必須)キュー(インバウンド・メッセージの場合は必須)

キューは、処理対象のトランザクションがステージングされるデータベース内の表です。インストール時にデフォルトのキューが定義されます。値リストからキューを選択します。

このフィールドは、アウトバウンド・メッセージに対しては使用不可です。

「メッセージ・キュー」(5-1 ページ)を参照してください。

トランザクション・タイプおよびトランザクション・サブタイプの命名規則トランザクション・タイプおよびトランザクション・サブタイプの命名規則トランザクション・タイプおよびトランザクション・サブタイプの命名規則トランザクション・タイプおよびトランザクション・サブタイプの命名規則監査証跡の読取りを容易にするため、および複数のアプリケーションにまたがるトラブルシューティングを可能にするために、トランザクション・タイプおよびトランザクション・サブタイプの命名規則が必要になります。

「トランザクション・タイプ」コードおよび「トランザクション・サブタイプ」コードでは、インプリメントする標準 XML メッセージに基づいた命名規則に焦点を合せないようにしてください。アプリケーションのある特定のトランザクションが取引先基本契約に基づいて複数の XML 標準にマップされる場合があります。インバウンド・メッセージの場合も同様です。

次の命名規則を使用することをお薦めします。

トランザクション・タイプトランザクション・タイプトランザクション・タイプトランザクション・タイプ

トランザクション・タイプは、基本 Oracle Application 製品の短縮名です。次の表は、Oracle Application 製品の短縮名の例を示します。

注意注意注意注意 : 接頭辞が ECX であるキューのみが値リストに表示されます。

トランザクション・タイプトランザクション・タイプトランザクション・タイプトランザクション・タイプ アプリケーションアプリケーションアプリケーションアプリケーション

AP Payables

XML Gateway の設定 3-11

Page 156: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「トランザクションの定義」フォーム

トランザクション・サブタイプトランザクション・サブタイプトランザクション・サブタイプトランザクション・サブタイプ

「トランザクション・サブタイプ」は、「トランザクション・タイプ」で指定したアプリケーション内での特定のトランザクションを示すコードです。サブタイプ・コードの末尾がトランザクションの方向を表します。"I" はインバウンド、"O" はアウトバウンドです。

命名規則は XXXXI または XXXXO です。XXXX は、アプリケーションおよびアプリケーションの機能に対して意味を持ちます。たとえば、Receivables および Payables に対する請求などです。

カスタム・トランザクションの場合は、Oracle 提供のトランザクションとカスタム・トランザクションを区別する接頭辞を追加します。

次の表は、トランザクション・タイプとトランザクション・サブタイプの一般的な組合せを示します。

実際のトランザクション詳細は、トランザクション・タイプとトランザクション・サブタイプの一意の組合せによって認識されます。トランザクション・サブタイプは、複数のアプリケーションにわたって一意である必要はありませんが、「トランザクション・タイプ」で指定したアプリケーション内でのみ一意である必要があります。

AR Receivables

OM Order Management

PO Purchasing

SS Supplier Scheduling

RLM Release Management

CUSTOM (ユーザー定義のメッセージ用)

トランザクション・トランザクション・トランザクション・トランザクション・タイプタイプタイプタイプ(アプリケーション)(アプリケーション)(アプリケーション)(アプリケーション)

トランザクション・トランザクション・トランザクション・トランザクション・サブタイプサブタイプサブタイプサブタイプ(トランザクション)(トランザクション)(トランザクション)(トランザクション)

トランザクション・トランザクション・トランザクション・トランザクション・タイプで処理するタイプで処理するタイプで処理するタイプで処理するアプリケーションアプリケーションアプリケーションアプリケーション

トランザクション・タイプでトランザクション・タイプでトランザクション・タイプでトランザクション・タイプで処理するアプリケーション処理するアプリケーション処理するアプリケーション処理するアプリケーション(トランザクション・コード(トランザクション・コード(トランザクション・コード(トランザクション・コードと方向)と方向)と方向)と方向)

PO POCO Purchasing 発注変更、アウトバウンド

PO POO Purchasing 発注、アウトバウンド

PO POAI Purchasing 発注確認、インバウンド

OM POI Order Management 発注、インバウンド

OM POCI Order Management 発注変更、インバウンド

OM POAO Order Management 発注確認、アウトバウンド

OM POCAO Order Management 発注変更確認、アウトバウンド

AR INO Receivables 請求書、アウトバウンド

AP INI Paybables 請求書、インバウンド

トランザクション・タイプトランザクション・タイプトランザクション・タイプトランザクション・タイプ アプリケーションアプリケーションアプリケーションアプリケーション

3-12 Oracle XML Gateway ユーザーズ・ガイド

Page 157: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「トランザクションの定義」フォーム

これにより、購買およびオーダー管理の両方のアプリケーションで同じトランザクション・サブタイプ(たとえば POI)を使用できます。両方ともなんらかのタイプの発注をインポートする場合があるためです。たとえば、オーダー管理で顧客からのオーダーをロードし、購買で別の購買アプリケーションからロードする場合があります。

トランザクション・サブタイプの追加接尾辞トランザクション・サブタイプの追加接尾辞トランザクション・サブタイプの追加接尾辞トランザクション・サブタイプの追加接尾辞

異なるデータベース・ビューを使用して異なるタイプのトランザクション・データ(包括オーダーと標準オーダーなど)を抽出するか、または包括オーダーと標準オーダーなどのトランザクションに異なる XML メッセージが必要な場合は、Message Designer を使用して異なるメッセージ・マップを作成できます。また、このようなトランザクションを区別する場合は、トランザクションの設定で異なるトランザクション・サブタイプを定義する必要があります。

適切な場合は、基本トランザクション・サブタイプの XXXXI または XXXXO の後に続けて接尾辞を付加し、XML Gateway 内でトランザクションをさらに区別できます。フォームでの問合せの場合は、問合せ時にトランザクション・サブタイプが互いに連続するように、同じ基本トランザクション・サブタイプ XXXXI または XXXXO を維持することをお薦めします。

これにより、接尾辞の命名規則は XXXXI-yyyy および XXXXO-yyyy となります(yyyy は接尾辞)。

次の表は、接尾辞を使用したトランザクション・サブタイプの命名規則を示します。

たとえば、Purchasing アプリケーションでは、すべてのタイプのアウトバウンド発注を一般サブタイプ POO で開始し、様々なタイプの発注を表す修飾子を付けることができます。たとえば、包括、標準、解除などです。これらのサブタイプ・コードは、処理別にそれぞれPOO-BLK、POO-STD、POO-REL です。命名規則を簡潔にするため、-BLANKET、-STANDARD、-RELEASE のような長い接尾辞は使用しないでください。この例は説明のみを目的としたものです。

OAG 標準での標準での標準での標準での VERB およびおよびおよびおよび NOUN の設定の設定の設定の設定このトピックでは、OAG CNTROLAREA のデータのソースについて説明します。

VERB および NOUN は、OAG CNTROLAREA データ型に必要なキー値です。XML Gateway には、トランザクション表のキー・データを表示するデータベース・ビューがあり

トランザクション・トランザクション・トランザクション・トランザクション・タイプタイプタイプタイプ(アプリケーション)(アプリケーション)(アプリケーション)(アプリケーション)

トランザクション・トランザクション・トランザクション・トランザクション・サブタイプサブタイプサブタイプサブタイプ(トランザクション)(トランザクション)(トランザクション)(トランザクション)

トランザクション・トランザクション・トランザクション・トランザクション・タイプで処理するタイプで処理するタイプで処理するタイプで処理するアプリケーションアプリケーションアプリケーションアプリケーション

トランザクション・タイプでトランザクション・タイプでトランザクション・タイプでトランザクション・タイプで処理するアプリケーション処理するアプリケーション処理するアプリケーション処理するアプリケーション(トランザクション・コード(トランザクション・コード(トランザクション・コード(トランザクション・コードと方向)と方向)と方向)と方向)

PO POO-BLK Purchasing 包括発注、アウトバウンド

PO POO-REL Purchasing 発注リリース、アウトバウンド

PO POO-STD Purchasing 標準発注、アウトバウンド

XML Gateway の設定 3-13

Page 158: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

参照値の定義

ます。属性値は、アウトバウンド・メッセージ・マップの作成に使用した DTD に設定されているデフォルト値です。

データベース・ビューを使用して、次に示す VERB 要素と NOUN 要素にデータを設定します。

OAG のののの CNTROLAREA でのでのでのでの VERB およびおよびおよびおよび NOUN

<NOUN value = "INVOICE"> INVOICE </NOUN>

<VERB value = "PROCESS"> PROCESS </VERB>

外部トランザクション・タイプおよび外部トランザクション・サブタイプを「トランザクションの定義」フォームからトランザクション表に入力する場合は、データベース・ビューECX_OAG_CONTROLAREA_TP_V(以前の ECX_OAG_CONTROLAREA_V)を使用して、NOUN 値フィールドおよび VERB 値フィールドにそれぞれマッピングします。「トランザクション・マップ - 要素のマッピング」(2-63 ページ)を参照してください。

参照値の定義参照値の定義参照値の定義参照値の定義XML Gateway 職責で「Oracle XML Gateway 参照」フォームへナビゲートするには、「設定」>「参照値の定義」を選択します。

「Oracle XML Gateway 参照」フォームを使用すると、シードされたデータの入力、表示ができます。これは、Oracle Application Object Library の標準フォームです。

上のセクションで「タイプ」を選択すると、シードされた値がフォームの「参照の詳細」セクションに表示されます。

注意注意注意注意 : ECX_OAG_CONTROLAREA_TP_V ビューは、ECX_OAG_CONTROLAREA_V ビューのアップグレード・バージョンです。Oracle XML Gateway では、両方のバージョンのデータベース・ビューがサポートされています。これらのビューの違いの詳細は、Message Designer の章にある「注意」(2-32 ページ)を参照してください。

注意注意注意注意 : OAG CNTROLAREA 内では、フィールドの順序は、メッセージ内の VERB、次に NOUN の順です。「トランザクションの定義」フォームでは、フィールドの順序は、外部トランザクション・タイプの NOUN、次に外部トランザクション・サブタイプの VERB です。データの順序を逆にしないように注意してください。

3-14 Oracle XML Gateway ユーザーズ・ガイド

Page 159: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

参照値の定義

タイプ(必須)タイプ(必須)タイプ(必須)タイプ(必須)

タイプは、シードされた表に格納された要素のキー・コードです。

次の表は、Oracle XML Gateway でシードされている参照タイプのリストを示します。

タイプタイプタイプタイプ 説明説明説明説明 サンプル値サンプル値サンプル値サンプル値

COMM_METHOD 通信方法 HTTP、HTTP-OXTA、HTTP-WM、

HTTPS、HTTPS-OMB、HTTPS-OXTA、

HTTPS-WM、IAS、ITG03、SMTP、NONE

CONFIRMATION_CODE

確認コード 0、1、2

DOCUMENT 文書 / トランザクション CBODI および CBODO は Oracle XML Gateway によってシードされています。

CBODI は OAG のインバウンド確認、

CBODO は OAG のアウトバウンド確認で

す。

XML Gateway の設定 3-15

Page 160: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

参照値の定義

ユーザー名(必須)ユーザー名(必須)ユーザー名(必須)ユーザー名(必須)

ユーザー名は、データの入力時にユーザーが定義します。

アプリケーション(必須)アプリケーション(必須)アプリケーション(必須)アプリケーション(必須)

このタイプの責任を持つアプリケーションのテキスト名称。

説明説明説明説明

タイプの説明

アクセス・レベルアクセス・レベルアクセス・レベルアクセス・レベル

アクセス・レベルでは、参照タイプに対して可能な変更を制限します。可能なレベルは、次のとおりです。

� システム - 参照コードへの変更を行うことはできません。

� 拡張可能 - 参照コードの新規追加が可能です。シード済参照コードの修正を行うことはできません。

� ユーザー - 任意の参照コードは変更可能です。

参照の詳細参照の詳細参照の詳細参照の詳細

コード(必須)コード(必須)コード(必須)コード(必須)

参照用のシード済コード

内容(必須)内容(必須)内容(必須)内容(必須)

参照コードの内容

説明説明説明説明

参照コードの説明

MESSAGE_STANDARD XML メッセージ標準 OAG、ORCL、RN、UNIVERSAL

MESSAGE_TYPE メッセージ・タイプ XML、EDI、FF(フラット・ファイル用)

PARTY_TYPE パーティ・タイプ B(銀行)、C(顧客)、S(仕入先)、I(社内事

業所)、E(交換)、CARRIER(運送業者)

TRANSACTION_CODE トランザクション・コード

BOD の確認に使用する CBOD は、XML Gateway でシードされたトランザクション・

コードです。

タイプタイプタイプタイプ 説明説明説明説明 サンプル値サンプル値サンプル値サンプル値

3-16 Oracle XML Gateway ユーザーズ・ガイド

Page 161: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

タグタグタグタグ

未使用

有効開始日有効開始日有効開始日有効開始日

参照コードの有効な開始日。

有効終了日有効終了日有効終了日有効終了日

参照コードの失効日。終了日はオプションです。

有効化チェックボックス有効化チェックボックス有効化チェックボックス有効化チェックボックス

コードを使用可能にする場合、ボックスにチェックを付けます。コードを無効にするにはチェックを外します。

取引先の設定取引先の設定取引先の設定取引先の設定XML Gateway 職責から「設定」>「取引先の定義」を選択して、「取引先設定の定義」フォームにナビゲートします。

「取引先設定」フォームは、次の処理を行う場合に使用します。

� 内部トランザクション・タイプ、外部トランザクション・タイプ、トランザクション・サブタイプ・コードおよびメッセージに関連付けられている XML 標準を指定することによって、取引先に対してメッセージを使用可能にします。

� 「取引先コード変換」フォームにアクセスします。

� 取引先のメッセージ・マップを選択します。

� メッセージの通信プロトコルおよびアドレスを指定します。オプションで、ハブからユーザーを選択できます。

このコンポーネントによって、XML Gateway エンジンを介したメッセージの処理が可能になります。XML Gateway では、取引先という用語は、特定のアドレスでメッセージを交換する顧客、仕入先、銀行支店または内部事業所などのエンティティのことを表します。指定したエンティティには、複数の事業所が存在するため、顧客所在地、仕入先サイトまたは銀行支店のそれぞれに対して、Oracle XML Gateway によるトランザクションの処理に必要となる 1 つの取引先を定義する必要があります。

メッセージの処理中、取引先データは、次の処理を行うために使用されます。

� Oracle E-Business 製品内の特定の所在地事業所を Gateway の取引先定義にリンクします。

� 使用する取引先のメッセージ・マップを実行エンジンに指示する手段を提供します。

� 取引先に対して特定のトランザクションを使用可能にします。

� メッセージの配信方法を決定します。

XML Gateway の設定 3-17

Page 162: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

このフォームでは、取引先設定のためのパラメータを定義します。この設定には、取引先サイトの指定、そのサイトに対して使用可能になっているメッセージおよび配信メカニズムが含まれています。

「取引先設定」フォームには、取引先に関連付けられているトランザクション・タイプおよびトランザクション・サブタイプをそれぞれ入力する必要があります。

「取引先設定」フォームには、取引先を定義するための次のデータが含まれています。

注意注意注意注意 : 複数組織を考慮複数組織を考慮複数組織を考慮複数組織を考慮 XML Gateway での取引先設定は、組織に依存しています。表示される取引先および取引先サイトのリストは、ログオン職責の組織に定義されている取引先に限定されます。

3-18 Oracle XML Gateway ユーザーズ・ガイド

Page 163: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

取引先タイプ(必須)取引先タイプ(必須)取引先タイプ(必須)取引先タイプ(必須)

「取引先タイプ」は、仕入先、顧客、銀行または内部所在地などの取引先タイプを定義します。値リストから取引先タイプを選択すると、その取引先タイプに関連付けられている取引先名および取引先サイトが、次に示す「取引先名」および「取引先サイト」の値リストに表示されます。

取引先名(必須)取引先名(必須)取引先名(必須)取引先名(必須)

取引先タイプを選択すると、該当する取引先名が「取引先名」値リストに表示されます。たとえば、取引先タイプが顧客の場合は、顧客名が表示されます。表示される取引先は、ログオン職責の組織に関連付けられている取引先に限定されます。該当する取引先名を選択します。

取引先サイト(必須)取引先サイト(必須)取引先サイト(必須)取引先サイト(必須)

取引先名を選択すると、該当する取引先サイトが値リストに表示されます。該当する取引先サイトを選択します。

会社管理者会社管理者会社管理者会社管理者 E メール(必須)メール(必須)メール(必須)メール(必須)

警告およびエラーに関する E メールを受信する管理担当の E メール・アドレスです。これらの通知は、Oracle Workflow、または Message Designer を使用してメッセージ・マップに定義した処理によって開始されます。ユーザーは、エラー・ログをチェックする必要があります。

「コード変換」ボタン「コード変換」ボタン「コード変換」ボタン「コード変換」ボタン

「コード変換」ボタンを使用して、「取引先コード変換」フォームにアクセスします。

参照 : 「コード変換」(3-31 ページ)

「取引先コード変換」フォーム(3-42 ページ)

取引先詳細取引先詳細取引先詳細取引先詳細「パーティ・タイプ」(取引先タイプ)、「取引先名」、「取引先サイト」、「トランザクション・タイプ」および「トランザクション・サブタイプ」の組合せにより、アウトバウンド・トランザクションを一意に識別します。

「外部トランザクション・タイプ」、「外部トランザクション・サブタイプ」、「標準コード」および「ソース取引先事業所コード」の組合せにより、インバウンド・トランザクションを一意に識別します。

「取引先設定」フォームには、次に示す各メッセージの詳細が含まれています。

トランザクション・タイプ(必須)トランザクション・タイプ(必須)トランザクション・タイプ(必須)トランザクション・タイプ(必須)

「トランザクション・タイプ」は、基本 Oracle Application に対する標準製品の短縮コードです。これらの値は、「トランザクションの定義」フォームで定義します。値リストには、

XML Gateway の設定 3-19

Page 164: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

「トランザクション・タイプ」、「トランザクション・サブタイプ」、「標準コード」、「外部トランザクション・タイプ」、「内部トランザクション・タイプ」および「方向」の使用可能な組合せが表示されます。使用する組合せを選択します。

これらの値は、XML Gateway で内部的にのみ使用されます。詳細は、「「トランザクションの定義」フォーム」(3-7 ページ)を参照してください。

トランザクション・サブタイプトランザクション・サブタイプトランザクション・サブタイプトランザクション・サブタイプ 「トランザクション・サブタイプ」は、「トランザクション・タイプ」で指定したアプリケーション内での特定のトランザクションのコードです。コードの末尾がトランザクションの方向を表します。I はインバウンド、O はアウトバンドです。

「パーティ・タイプ」(取引先タイプ)、「トランザクション・タイプ」および「トランザクション・サブタイプ」の組合せによって、このメッセージに関連付ける Oracle トランザクションを識別します。これらの値は、「トランザクションの定義」フォームで定義します。

これらの値は、XML Gateway の内部でのみ使用されます。詳細は、「「トランザクションの定義」フォーム」(3-7 ページ)を参照してください。

標準コード標準コード標準コード標準コード 上記で選択したトランザクション・タイプに関連付けられている標準コードが表示されます。

標準コードは、「XML 標準の定義」フォーム( 3-6 ページ)で設定します。

外部トランザクション・タイプ外部トランザクション・タイプ外部トランザクション・タイプ外部トランザクション・タイプ 上記で選択したトランザクション・タイプに関連付けられている外部トランザクション・タイプが表示されます。

「外部トランザクション・タイプ」は、XML メッセージの一次外部識別子です。これらの値は、「トランザクションの定義」フォーム(3-7 ページ)で定義され、XML Gateway エンベロープ(4-5 ページ)に含まれています。

「外部トランザクション・タイプ」および「外部トランザクション・サブタイプ」の組合せによって、Oracle E-Business Suite へのこの外部メッセージを識別します。

外部トランザクション・サブタイプ外部トランザクション・サブタイプ外部トランザクション・サブタイプ外部トランザクション・サブタイプ

上記で選択したトランザクション・タイプに関連付けられている外部トランザクション・サブタイプが表示されます。

「外部トランザクション・サブタイプ」は、XML メッセージの二次外部識別子です。これらの値は、「トランザクションの定義」フォーム(3-7 ページ)で定義され、XML Gateway エンベロープ(4-5 ページ)に含まれています。

「外部トランザクション・タイプ」および「外部トランザクション・サブタイプ」の組合せによって、Oracle E-Business Suite へのこの外部メッセージを識別します。

3-20 Oracle XML Gateway ユーザーズ・ガイド

Page 165: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

方向方向方向方向

上記で選択したトランザクション・タイプに関連付けられている方向が表示されます。

このコードは、トランザクションの方向を指定します。値 IN はインバウンド・メッセージ、値 OUT はアウトバウンド・メッセージをそれぞれ指定します。

マップ(必須)マップ(必須)マップ(必須)マップ(必須)

(メッセージ)マップは、Message Designer を使用して作成するマップの名前です。

値リストから該当するマップを選択します。

メッセージ・マップの命名規則は、トランザクション・タイプ、トランザクション・サブタイプ、標準とリリースおよび方向の 4 つのコンポーネントで構成されています。たとえば、"PO_POO_OAG70_OUT" は、OAG 標準、リリース 7.0 のアウトバウンドの Oracle Purchasing の発注を示します。方向コード OUT によって、リスト内でのメッセージ方向が明確になります。

命名規則の詳細は、「Message Designer」(2-1 ページ)を参照してください。

使用するマップが値リストに表示されない場合、マップは XML Gateway データベースにロードされていません。詳細は、「メッセージ・マップおよび DTD のロード方法」(2-113ページ)を参照してください。

XML Gateway の設定 3-21

Page 166: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

接続接続接続接続 / ハブ(アウトバウンド・メッセージの場合にのみ必須)ハブ(アウトバウンド・メッセージの場合にのみ必須)ハブ(アウトバウンド・メッセージの場合にのみ必須)ハブ(アウトバウンド・メッセージの場合にのみ必須)

「DIRECT」接続およびハブは、メッセージとの通信を行うための方法です。XML メッセージは、取引先に直接送信したり、ハブを経由して取引先に送信できます。ハブにより、取引先にメッセージが伝達されます。

「DIRECT」を選択して取引先と直接に取引を行うか、または値リストからハブを選択します。ハブを選択する場合は、そのハブから取引先を選択します。

ハブを定義する場合は、「「ハブ定義」フォーム」(3-4 ページ)を参照してください。

プロトコル・タイプ、ユーザー名、パスワードおよびプロトコル・アドレスの入力が必要かどうかは、「DIRECT」またはハブのどちらを選択したかによって決定されます。

「DIRECT」を選択した場合は、次のようにフィールドに入力します。

3-22 Oracle XML Gateway ユーザーズ・ガイド

Page 167: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

� プロトコル・タイプ(必須)プロトコル・タイプ(必須)プロトコル・タイプ(必須)プロトコル・タイプ(必須)

値リストからプロトコル・タイプを選択します。このデータは、XML Gateway によってシードされます。

プロトコル・タイプ「NONE」の場合、この取引先に対するアウトバウンド・メッセージが使用不可になります。

� ユーザー名ユーザー名ユーザー名ユーザー名

サーバー・アドレスで指定されたサーバーの受信サーバーにログインするための宛先ユーザー名を入力します。

プロトコル・タイプ「HTTP」および「HTTPS」の場合、ユーザー名およびパスワードは必須フィールドになります。

� パスワードパスワードパスワードパスワード

宛先ユーザー名のパスワードを入力します。パスワードは、入力時にエコーされません。同じフィールドで、パスワードを確認するように要求されます。

プロトコル・タイプ「HTTP」および「HTTPS」の場合、ユーザー名およびパスワードは必須フィールドになります。

� プロトコル・アドレスプロトコル・アドレスプロトコル・アドレスプロトコル・アドレス

プロトコル・アドレスとは、Transport Agent により XML 文書が転記される完全なURL(サービスまたはサーブレットを含む)です。

プロトコル・タイプ「SMTP」の場合、プロトコル・アドレスは E メール・アドレスとなります(必須)。

ハブを選択した場合は、次のようにフィールドに入力します。

� プロトコル・タイププロトコル・タイププロトコル・タイププロトコル・タイプ

「プロトコル・タイプ」のデフォルトは、ハブ定義からの値になります。

� ユーザー名ユーザー名ユーザー名ユーザー名

ハブ定義の値リストからユーザー名を選択します。「プロトコル・タイプ」が「SMTP」の場合、ユーザー名は必須ではありません。その他のプロトコル・タイプの場合は、このフィールドは必須です。

� パスワードパスワードパスワードパスワード

このフィールドは、デフォルトで、選択したユーザー名に関連付けられているパスワードになります。ユーザー名およびパスワードの組合せは、ハブの定義によって指定されます。「プロトコル・タイプ」が「SMTP」の場合は、このフィールドは必須ではありません。

� プロトコル・アドレスプロトコル・アドレスプロトコル・アドレスプロトコル・アドレス

「プロトコル・アドレス」のデフォルトは、ハブ定義からの値になります。

XML Gateway の設定 3-23

Page 168: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

ソース取引先事業所コード(必須)ソース取引先事業所コード(必須)ソース取引先事業所コード(必須)ソース取引先事業所コード(必須)

ソース取引先事業所コードは、XML Gateway エンベロープに含まれるコードであり、メッセージのソースを識別します。これは、メッセージのソース取引先のコードです。

取引先との間でメッセージを送受信する場合は、メッセージの方向に応じて、ユーザーの事業所コードや取引先の事業所コードを混合して使用することになります。たとえば、メッセージを送信する場合は、ユーザーが XML メッセージの送信元であるため、ソース取引先事業所コードはユーザーの事業所コードになります。メッセージを受信する場合は、取引先が XML メッセージの送信元になるため、ソース取引先事業所コードは取引先の事業所コードになります。

取引先の検証の場合、インバウンド・メッセージのこのコードが確認されます。このコードをアウトバウンド・メッセージに配置する場合は、受信者が有効なソースまたは送信元事業所を確認します。

このフィールドは、XML Gateway エンベロープのパーティ・サイト ID に配置されます。

参照 : XML Gateway エンベロープ(4-5 ページ)

目的取引先事業所コード目的取引先事業所コード目的取引先事業所コード目的取引先事業所コード

XML Gateway には、静的ルーティングと動的ルーティングの 2 つのタイプのルーティングがあります。動的ルーティングでは、メッセージの最初の受信者から最終受信者へのメッセージの再ルーティングが可能です。静的ルーティングの詳細は、次の「ルーティング」フィールドを参照してください。

目的取引先事業所コードは、XML メッセージの最終受信者を示すコードになります。このコードは、このメッセージを作成する XML Gateway では必要ありません。ただし、メッセージを最後に受信する取引先を識別するためにメッセージを受信する、ハブまたは最終取引先には必要となります。このコードは、ハブまたは最初の取引先が、メッセージを最終取引先を識別するためのコードです。

アウトバウンド・メッセージの場合、目的取引先事業所コードで指定された最終受信者の事業所コードは、XML Gateway エンベロープの「ATTRIBUTE3」に配置されます。

インバウンド・メッセージの場合、このコードは XML Gateway エンベロープの「ATTRIBUTE3」に含まれます。「ATTRIBUTE3」を読み込む方法を示す図は、「静的ルーティングおよび動的ル―ティング」(3-26 ページ)を参照してください。

文書確認文書確認文書確認文書確認

「文書確認」は、取引先が確認を送信したり受信する確認レベルを示します。

0 は、確認を送信しないことを意味します。

1 は、エラーが発生した場合にのみ確認を送信することを意味します。

2 は、確認を常に送信することを意味します。

3-24 Oracle XML Gateway ユーザーズ・ガイド

Page 169: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

これにより、確認 XML メッセージの生成または受信の条件が定義されます。アウトバウンド・メッセージでは、インバウンド確認を受信します。インバウンド・メッセージでは、アウトバウンド確認を生成します。

ルーティングルーティングルーティングルーティング

「ルーティング」フィールドを使用して、メッセージがルーティングされる他の取引先を指定します。値リストからアウトバウンド・トランザクションの取引先を選択します。インバウンド・メッセージは、アウトバウンド・メッセージとして、「ルーティング」フィールドで指定した取引先に転送されます。

XML Gateway には、静的ルーティングおよび動的ルーティングが用意されています。ルーティングは、静的ルーティング方法の使用時にアウトバウンド・メッセージをルーティングするアドレスです。動的ルーティングの詳細は、前述の「目的取引先事業所コード」(3-24ページ)フィールドを参照してください。

参照 : 静的ルーティングおよび動的ルーティング(3-26 ページ)

必要な通信データ必要な通信データ必要な通信データ必要な通信データ

アウトバウンド・メッセージに必要な通信アウトバウンド・メッセージに必要な通信アウトバウンド・メッセージに必要な通信アウトバウンド・メッセージに必要な通信

DIRECT または取引先がハブから選択されているかどうかによって、異なるデータが必要になります。

DIRECT が選択されている場合、アウトバウンド・メッセージについて、ユーザーは次の各データ・フィールドをプロトコル・タイプに従って入力します。

� プロトコル・タイプ(必須)

� プロトコル・アドレス(必須)

� ユーザー名(プロトコル・タイプに依存)

� パスワード(プロトコル・タイプに依存)

� メッセージの送信者を特定するための、ソース取引先所在地コード(必須)

ハブを介してメッセージが送信される場合は、ハブを選択後、表示されたリストの中からユーザー名を 1 つ選択します。アウトバンド・メッセージについて、次のデータ・フィールドが取り出されます。

� ハブ定義のユーザー名から、次のデータ・フィールドがコピーされます。

– プロトコル・タイプ

– プロトコル・アドレス

XML Gateway の設定 3-25

Page 170: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

– ハブ・エンティティ・コード(DIRECT 通信のソース取引先ロケーション・コードと同様に機能する)

– パスワード(オプション、プロトコル・タイプに依存)

ハブによって動的ルーティングを使用してメッセージが別の取引先に再ルーティングされる場合は、次のデータが必要になります。このデータは、XML Gateway エンベロープの

「ATTRIBUTE3」に配置されます。

� 目的取引先事業所コード

参照 : XML Gateway エンベロープ(4-5 ページ)

インバウンド・メッセージに必要な通信データインバウンド・メッセージに必要な通信データインバウンド・メッセージに必要な通信データインバウンド・メッセージに必要な通信データ

インバウンド・メッセージでは、次の要素が必須です。

� メッセージの送信者を特定するための、ソース取引先事業所コード

静的および動的ルーティング静的および動的ルーティング静的および動的ルーティング静的および動的ルーティングメッセージは、静的ルーティング機能または動的ルーティング機能を使用して、中間取引パーティを介して渡されます。この方法は、引渡しとも呼ばれます。

次の図は、動的ルーティング機能または静的ルーティング機能を使用したメッセージのルーティング・フローを示します。このプロセスは、インバウンド・メッセージに関連付けられた取引パーティの詳細のレビューから開始されます。

データが XML Gateway エンベロープの「ATTRIBUTE3」フィールドに存在しない場合、トランザクションは、静的ルーティングのルールに従って処理されます。まず、メッセージは、取引先のインバウンド・メッセージ・マップに従って処理されてから、このメッセージの最終受信者である取引先に再ルーティングされます。最終受信者の取引先詳細は、

「ATTRIBUTE3」フィールドで指定されている取引先に対するアウトバウンド・メッセージとして「取引先詳細」に含まれます。

データが XML Gateway エンベロープの「ATTRIBUTE3」フィールドに存在せず、インバウンド・メッセージの「取引先詳細」の「ルーティング」フィールドに存在する場合、トランザクションは、動的ルーティングのルールに従って処理されます。

まず、メッセージは、取引先のインバウンド・メッセージ・マップに従って処理されてから、このメッセージの最終受信者である取引先に再ルーティングされます。最終受信者の取引先詳細は、そのインバウンド・メッセージに関して「ルーティング」フィールドで指定されている取引先として「取引先詳細」に含まれます。

データが XML Gateway エンベロープの「ATTRIBUTE3」フィールドにあり、インバウンド・メッセージの「取引先詳細」の「ルーティング」フィールドにもデータがある場合は、

「ATTRIBUTE3」がデータのルーティングに使用されます。

3-26 Oracle XML Gateway ユーザーズ・ガイド

Page 171: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

データが XML Gateway エンベロープの「ATTRIBUTE3」フィールドに存在せず、インバウンド・メッセージの「取引先詳細」の「ルーティング」フィールドにもデータが存在しない場合は、メッセージは他の取引先には再ルーティングされません。

動的ルーティングおよび静的ルーティングの両方で、最終受信者のアウトバウンド・メッセージを構築する前に、メッセージのデータには、取引先レベルでコード変換が適用されている場合があります。取り出されたコード変換値は XML メッセージに代入され、これにより、適用される値を最終取引者が受信できるようになります。

インバウンド�

ATTRIBUTE3はエンベロープに�含まれているか。�

いいえ�

動的ルーティング�

現行の取引先詳細レコードに�ルーティングは存在するか。�

静的ルーティング�

はい�

はい�

現行の取引先詳細レコードの�「ルーティング」列から�ルーティング取引先詳細レコードを�取得する。�

文書を取引先にルーティングする。�

- 目的取引先のエンベロープを作成する。�- 元の取引先から目的取引先への� コード変換を実行する。�

いいえ�

ルーティング終了�

次の項目に基づいて取引先詳細レコードを�取得する。�

- 外部タイプ�- 外部サブタイプ�- エンベロープのparty_site_idと一致する� ソース事業所コード�

アウトバウンド�アウトバウンド�

次の項目に基づいて取引先詳細�レコードを取得する。�

- アウトバウンド・トランザクション�- 同じ外部トランザクション/サブタイプ�- ソース事業所コード = ATTRIBUTE3

XML Gateway の設定 3-27

Page 172: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

引渡しメッセージの静的ルーティングおよび動的ルーティングを説明するために、次の 3 つの取引先が定義されています。

� パーティ 1: メッセージの起動側

� パーティ 2: メッセージの最初の受取者(ハブの場合がある)

� パーティ 3: メッセージの最終受信者

パーティ 1 はパーティ 2 にメッセージを送信します。パーティ 2 はパーティ 3 にメッセージを再ルーティングします。

静的ルーティング静的ルーティング静的ルーティング静的ルーティング

静的ルーティングを使用すると、「取引先設定」フォームの自分のエントリから、他の XML Gateway 取引先の詳細レコードを選択できます。同じ取引先内または表示されているいずれの取引先からでも、取引先を選択できます。この取引先およびトランザクションに対するメッセージが受信されるたびに、メッセージは、「ルーティング」列で定義されている取引先に自動的にルーティングされます。

静的ルーティングは、次の条件で行われます。

� メッセージの起動側(パーティ 1)は、メッセージに最終の目的取引先事業所コードを含めない。含めない。含めない。含めない。

� 指定したトランザクションおよび取引先に関して、メッセージの最初の受信者(パーティ 2)は、メッセージを自動転送する取引先を「ルーティング」フィールドで選択する。

このためには、次のことが必要になります。

� 最終受信者として適切な取引先設定が、パーティ 2 の環境で「取引先設定」に入力されている必要があります。

静的ルーティングの説明静的ルーティングの説明静的ルーティングの説明静的ルーティングの説明

次の説明では、この例での各パーティに必要な取引先設定を確認します。

パーティパーティパーティパーティ 1: メッセージの起動側メッセージの起動側メッセージの起動側メッセージの起動側

1. 静的ルーティングでは、メッセージの最初の起動側は、設定時に最終の目的取引先事業所コードを指定しませんしませんしませんしません。XML Gateway エンベロープの「ATTRIBUTE3」には、データは表示されません。次の表は、このことについて説明しています。

取引先取引先取引先取引先 方向方向方向方向 外部外部外部外部トランザクション・トランザクション・トランザクション・トランザクション・タイプタイプタイプタイプ

外部外部外部外部トランザクション・トランザクション・トランザクション・トランザクション・サブタイプサブタイプサブタイプサブタイプ

プロトコルプロトコルプロトコルプロトコル ソースソースソースソース取引先取引先取引先取引先事業所事業所事業所事業所コードコードコードコード

ルーティングルーティングルーティングルーティング 目的取引先目的取引先目的取引先目的取引先事業所事業所事業所事業所コードコードコードコード

(「(「(「(「ATTRIBUTE3」内)」内)」内)」内)

(1) パーティ2

OUT INVOICE ADD HTTP パーティ1

N/A N/A

3-28 Oracle XML Gateway ユーザーズ・ガイド

Page 173: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

パーティパーティパーティパーティ 2: メッセージの最初の受信者メッセージの最初の受信者メッセージの最初の受信者メッセージの最初の受信者

パーティ 2 は、インバウンド取引先、およびメッセージが再ルーティングされるアウトバウンド取引先の両方のメッセージを定義している必要があります。

2. パーティ 2 は、パーティ 1 からメッセージを受信しました。メッセージは、パーティ 2へのインバウンド請求書です。次の表のエントリ(2)を参照してください。

3. パーティ 2 のパーティ 1 に対する取引先設定の「ルーティング」フィールドにはパーティ 3 に対する取引先設定が保存されているため、パーティ 2 はパーティ 3 にメッセージを再ルーティングします。「ルーティング」フィールドの取引先の取引先設定データは、新規メッセージおよび XML Gateway エンベロープを作成するために使用されます。次の表のエントリ(3)を参照してください。

動的ルーティング動的ルーティング動的ルーティング動的ルーティング

次に示す方法は、メッセージを起動した最初のパーティが、最終取引先によりメッセージが受信されるように目的取引先事業所コードを指定しているため、動的です。

動的ルーティングは、次の条件で行われます。

� メッセージの起動側(パーティ 1)は、XML Gateway エンベロープの「ATTRIBUTE3」に最終の目的取引先事業所コードを含める。

� メッセージの最初の受信者(パーティ 2)は、自分の取引先設定の「ATTRIBUTE3」で取引先コードを指定できる。

このためには、次のことが必要になります。

� パーティ 1 の XML プロセスは、最終取引先を XML Gateway エンベロープの「ATTRIBUTE3」に書き込むように設定されている必要があります。XML Gateway では、「取引先設定」フォームの「目的取引先事業所コード」フィールドを使用します。

� 適切な取引先設定が、「ATTRIBUTE3」に作用するパーティ 2 のプロセスに入力されている必要があります。XML Gateway の場合、これは、「取引先設定」フォームの「ソース取引先事業所コード」フィールドにあります。

取引先取引先取引先取引先 方向方向方向方向 外部外部外部外部トランザクション・トランザクション・トランザクション・トランザクション・タイプタイプタイプタイプ

外部外部外部外部トランザクション・トランザクション・トランザクション・トランザクション・サブタイプサブタイプサブタイプサブタイプ

プロトコルプロトコルプロトコルプロトコル ソースソースソースソース取引先取引先取引先取引先事業所事業所事業所事業所コードコードコードコード

ルーティングルーティングルーティングルーティング 目的取引先目的取引先目的取引先目的取引先事業所事業所事業所事業所コードコードコードコード

(2) パーティ1

IN INVOICE ADD N/A パーティ 1

(アウトバウンド・メッセージのパーティ 3 を指

す)

N/A

(3) パーティ3

OUT(OUT に

設定)

INVOICE(同じ外

部トランザクション・タイプを使用)

ADD (同じ外部トランザクション・サブタイプを使用)

HTTP パーティ 2

N/A N/A

XML Gateway の設定 3-29

Page 174: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

取引先の設定

動的ルーティングの説明動的ルーティングの説明動的ルーティングの説明動的ルーティングの説明

次の説明では、この例での各パーティに必要な取引先設定を確認します。

パーティパーティパーティパーティ 1: メッセージの起動側メッセージの起動側メッセージの起動側メッセージの起動側

1. 動的ルーティングでは、メッセージの最初の起動側(パーティ 1)は、「ATTRIBUTE3」の目的取引先コードを、メッセージの最初の受信者(パーティ 2)に渡します。

このコードは、メッセージの最初の受信者によって定義されるため、メッセージの転送先となる取引先を識別できます。目的取引先コードは、XML Gateway エンベロープの

「ATTRIBUTE3」にコピーされます。次の表を参照してください。

パーティパーティパーティパーティ 2: メッセージの最初の受信者メッセージの最初の受信者メッセージの最初の受信者メッセージの最初の受信者

この 2 つ目のパーティは、インバウンド取引先およびアウトバウンド取引先の両方のメッセージを定義している必要があります。

2. パーティ 2 は、パーティ 1 からメッセージを受信しました。メッセージは、パーティ 2へのインバウンド請求書です。パーティ 2 の「取引先設定」の表のエントリ(2)を参照してください。

パーティ 2 は、インバウンド・メッセージの取引先としてパーティ 1 を検証します。次の表にデータを示します。

3. パーティ 2 は、パーティ 3 にメッセージを再ルーティングします。メッセージは、パーティ 2 からのアウトバウンド請求書になります。次のエントリ(3)を参照してください。

パーティ 2 は、メッセージの転送先となる取引先の取引先参照も実行します。方向は、「OUT」に変更されます。「外部トランザクション・タイプ」と「外部トランザクション・サブタイプ」は、インバウンド・メッセージからコピーされます。次の表は、参照に含まれるデータを示します。

取引先取引先取引先取引先 方向方向方向方向

外部外部外部外部トランザクトランザクトランザクトランザクション・タイプション・タイプション・タイプション・タイプ

外部外部外部外部トランザクトランザクトランザクトランザクション・サブション・サブション・サブション・サブタイプタイプタイプタイプ プロトコルプロトコルプロトコルプロトコル

ソースソースソースソース取引先取引先取引先取引先事業所事業所事業所事業所コードコードコードコード ルーティングルーティングルーティングルーティング

目的取引先目的取引先目的取引先目的取引先事業所事業所事業所事業所コードコードコードコード(「(「(「(「ATTRIBUTE3」内)」内)」内)」内)

(1) パーティ2

OUT INVOICE ADD HTTP パーティ1

N/A パーティ 3

方向方向方向方向外部トランザクション・外部トランザクション・外部トランザクション・外部トランザクション・タイプタイプタイプタイプ 外部トランザクション・サブタイプ外部トランザクション・サブタイプ外部トランザクション・サブタイプ外部トランザクション・サブタイプ

IN INVOICE ADD

3-30 Oracle XML Gateway ユーザーズ・ガイド

Page 175: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

コード変換

次の表は、パーティ 2 の「取引先設定」を示します。

パーティパーティパーティパーティ 3: メッセージの最終受信者メッセージの最終受信者メッセージの最終受信者メッセージの最終受信者

4. パーティ 3 は、パーティ 2 からメッセージを受信しました。メッセージは、インバウンド請求書です。次の表にデータを示します。

コード変換コード変換コード変換コード変換Oracle XML Gateway のコード変換機能により、Oracle E-Business Suite で定義されているコードから、取引先が使用しているコード、XML 標準またはその他の標準コードをトランザクション内で相互参照する方法が提供されます。

たとえば、ABC Corporation が発注書を XYZ Corporation に転送するとします。XYZ Corporation は、独自の Oracle 値(単位、通貨、運送業者など)を使用して着信データを処理しますが、XYZ は ABC のコードを返す必要があります。このように、元のトランザクションを作成した取引先は、その取引先独自の値を使用している応答トランザクションを受信します。

方向方向方向方向外部トランザクション・外部トランザクション・外部トランザクション・外部トランザクション・タイプタイプタイプタイプ 外部トランザクション・サブタイプ外部トランザクション・サブタイプ外部トランザクション・サブタイプ外部トランザクション・サブタイプ

OUT INVOICE ADD

取引先取引先取引先取引先 方向方向方向方向 外部外部外部外部トランザクション・トランザクション・トランザクション・トランザクション・タイプタイプタイプタイプ

外部外部外部外部トランザクション・トランザクション・トランザクション・トランザクション・サブタイプサブタイプサブタイプサブタイプ

プロトコルプロトコルプロトコルプロトコル ソースソースソースソース取引先取引先取引先取引先事業所事業所事業所事業所コードコードコードコード

ルーティングルーティングルーティングルーティング 目的取引先目的取引先目的取引先目的取引先事業所事業所事業所事業所コードコードコードコード

(「(「(「(「ATTRIBUTE3」内)」内)」内)」内)

(2) パーティ1

IN INVOICE ADD N/A パーティ1

N/A N/A

(3) パーティ3

OUT(OUTに設定)

INVOICE(同じ外

部トランザクション・タイプを使用)

ADD (同じ外部トランザクション・サブタイプを使用)

HTTP パーティ2

N/A N/A

取引先取引先取引先取引先 方向方向方向方向 外部外部外部外部トランザクション・トランザクション・トランザクション・トランザクション・タイプタイプタイプタイプ

外部外部外部外部トランザクション・トランザクション・トランザクション・トランザクション・サブタイプサブタイプサブタイプサブタイプ

プロトコルプロトコルプロトコルプロトコル ソースソースソースソース取引先取引先取引先取引先事業所事業所事業所事業所コードコードコードコード

ルーティングルーティングルーティングルーティング 目的取引先目的取引先目的取引先目的取引先事業所事業所事業所事業所コードコードコードコード(「(「(「(「ATTRIBUTE3」」」」内)内)内)内)

(4) パーティ3

IN INVOICE ADD N/A パーティ2

N/A N/A

XML Gateway の設定 3-31

Page 176: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

コード変換

コード変換の機能は、次のとおりです。

1. XML 標準で定義されている XML 標準コード変換値を定義します。これらのコードは、すべての取引先によって使用されます。

2. ISO、X12、EDIFACT などの他の標準化組織によって定義され、汎用的に使用されているコード変換値を定義します。これらのコードは、すべての取引先によって使用されます。

3. 取引先固有のコード変換値を定義します。取引先固有のコードにより、XML 標準コード変換値またはその他の汎用的に使用されているコード変換値を上書きできます。

XML Gateway のフォーム間のコード変換設定のフォーム間のコード変換設定のフォーム間のコード変換設定のフォーム間のコード変換設定

「XML 標準の定義」フォームでは、メッセージ標準を表す OAG などの標準コードを入力します。後述するように、"UNIVERSAL" と呼ばれる特別な目的の標準コードがあります。

「「XML 標準の定義」フォーム」(3-6 ページ)を参照してください。

「XML 標準の定義」フォームの項目は、XML Gateway に対してトランザクションを定義する「トランザクションの定義」フォームの値リストに表示されます。このフォームでは、

「外部プロセス」にリストされた各トランザクションに対し 1 つの標準コードを関連付けます。「「トランザクションの定義」フォーム」(3-7 ページ)を参照してください。

実際のコード変換値は、「標準コード変換」フォームおよび「取引先コード変換」フォームで入力します。コード変換フォームでは、Oracle 値から外部値への 1 対 1 のコード変換を指定します。外部コードは、OAG のコードなどの XML 標準コード、ISO コードなどのユニバーサル・コードまたは取引先固有のコードの場合があります。次に、これらのコードについて説明します。

取引先対象のマークが付くコード変換値取引先対象のマークが付くコード変換値取引先対象のマークが付くコード変換値取引先対象のマークが付くコード変換値

取引先コード変換値には、「取引先設定」フォームからアクセスします。詳細は、「取引先の設定」(3-17 ページ)を参照してください。「取引先設定」フォームで「コード換算」ボタンを押して「取引先コード変換」フォームにアクセスします。

取引先のコード値に関連付けられた値は、コード変換時に最初に確認されるコード・セットです。

取引先固有の表に入力する前に、必要な場合は最初に標準コード変換値を更新します。標準コード変換表への入力は「取引先コード変換」フォームに表示され、上書きされる可能性があるので、このことは重要です。

次の表は、取引先のメッセージ・マップからコード変換へのリンクを示します。

3-32 Oracle XML Gateway ユーザーズ・ガイド

Page 177: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

コード変換

� 「取引先設定」フォーム(「取引先詳細」の下)でこの取引先サイトにメッセージ・マップを割り当てます。

� 「取引先設定」フォームからコード変換にアクセスします。

� Message Designer でメッセージ・マップを作成するときに、データ・フィールドにカテゴリ・コードが割り当てられます。

重複項目が見つからない重複項目が見つからない重複項目が見つからない重複項目が見つからない

重複した Oracle 値をコード変換表に入力することはできないため、取引先は有効にしたすべてのトランザクションに対して常に同じ " 宛先取引先値 " を使用する必要があります。次の表は、このルールを示します。

取引先取引先取引先取引先 メッセージ・マップメッセージ・マップメッセージ・マップメッセージ・マップ

取引先に対する取引先に対する取引先に対する取引先に対するコード変換値をコード変換値をコード変換値をコード変換値を作成するか作成するか作成するか作成するか ?

メッセージ・マップのメッセージ・マップのメッセージ・マップのメッセージ・マップの単位(単位(単位(単位(UOM)フィールドが)フィールドが)フィールドが)フィールドがあるかあるかあるかあるか ?

メッセージ処理時にメッセージ処理時にメッセージ処理時にメッセージ処理時にアクセスされるアクセスされるアクセスされるアクセスされる取引先コード変換値取引先コード変換値取引先コード変換値取引先コード変換値

Acme Corp(アトランタ)

PROCESS_PO Acme(アトラン

タ)に対して作成する。

あり。したがって、フィールドでコード変換のカテゴリ UOM を入力する。

UOM カテゴリ・コードに

対して、Acme(アトラン

タ)コード変換値にアクセスしてメッセージ・マップPROCESS_PO と照合す

る。

Acme Corp(シカゴ)

PROCESS_PO Acme(シカゴ)に

対して作成する。

あり。したがって、フィールドでコード変換のカテゴリ UOM を入力する。

UOM カテゴリ・コードに

対して、Acme(シカゴ)

コード変換値にアクセスしてメッセージ・マップPROCESS_PO と照合す

る。

Acme Corp(アトランタ)

ADD_INVOICE Acme(アトラン

タ)に対して作成する。

あり。したがって、フィールドでコード変換のカテゴリ UOM を入力する。

UOM カテゴリ・コードに

対して、Acme(アトラン

タ)コード変換値にアクセスしてメッセージ・マップADD_INVOICE と照合す

る。

Acme Corp(シカゴ)

ADD_INVOICE Acme(シカゴ)に

対して作成する。

あり。したがって、フィールドでコード変換のカテゴリ UOM を入力する。

UOM カテゴリ・コードに

対して、Acme(シカゴ)

コード変換値にアクセスしてメッセージ・マップADD_INVOICE と照合す

る。

XML Gateway の設定 3-33

Page 178: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

コード変換

� Oracle 値値値値 - 値 "EACH" の複数のオカレンスをキーにすることはできません。

� 送信元取引先値送信元取引先値送信元取引先値送信元取引先値 - 値 "PC" の複数のオカレンスをキーにすることはできません。

� 宛先取引先値宛先取引先値宛先取引先値宛先取引先値 - 値 "PC" の複数のオカレンスをキーにすることはできません。

標準コードとしてマークが付くコード変換値標準コードとしてマークが付くコード変換値標準コードとしてマークが付くコード変換値標準コードとしてマークが付くコード変換値

前述のようにコード変換を設定すると、各メッセージに標準コードが関連付けられます。標準コードは、与えられた XML メッセージを処理するためのコード値のソース組織(たとえば OAG など)です。

その標準組織のコード値に関連付けられた値は、コード変換時に 2 番目に確認されるコード・セットです。

UNIVERSAL のマークが付くコード変換値のマークが付くコード変換値のマークが付くコード変換値のマークが付くコード変換値

XML メッセージを定義した標準以外のすべての標準には、まとめて UNIVERSAL というマークが付きます。XML Gateway では、他のコード変換値は ISO コードや X12 コードなどの各標準の名称では保存されません。ユーザーがこれらのコード・セットにアクセスする順序は、XML Gateway では判別できません。たとえば、ISO コードにアクセスしてから X12コードにアクセスするのか、その逆なのかは不明です。このため、これらのコードは一般名称で保存されます。

UNIVERSAL コード値に関連付けられた値は、コード変換時に 3 番目に確認されるコード・セットです。

次の表は、すべての取引先で使用できる ISO 国コードの例を示します。これらのコードは、「標準コード変換」フォームで 1 回のみ入力します。

UNIVERSAL として入力する必要がある 2 つのコード間に競合がある場合は、競合しているコードを、そのコードを必要とする各取引先の取引先コード変換として入力することにより、競合を解決できます。

Oracle 値値値値 説明説明説明説明 送信元取引先値送信元取引先値送信元取引先値送信元取引先値 宛先取引先値宛先取引先値宛先取引先値宛先取引先値

Each 各 EA EA

Piece ピース PC PC

Each 各 PC PC

標準コード標準コード標準コード標準コード Oracle 値値値値 説明説明説明説明 送信元取引先値送信元取引先値送信元取引先値送信元取引先値 宛先取引先値宛先取引先値宛先取引先値宛先取引先値

UNIVERSAL アメリカ アメリカ US US

UNIVERSAL イギリス イギリス UK UK

3-34 Oracle XML Gateway ユーザーズ・ガイド

Page 179: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

コード変換

各取引先で競合または重複しているコード値のみを入力する必要があります。競合が発生しない複数の項目は、UNIVERSAL として同時に入力できます。

コード・カテゴリコード・カテゴリコード・カテゴリコード・カテゴリカテゴリ・コードは、コード変換表内の項目セットのラベルです。たとえば、CARRIER は、運送業者に関連付けられたコード変換値のカテゴリ・コードです。

トランザクション処理時には、コード変換表でカテゴリ・コードが割り当てられている項目のみがアクセスされ、指定されたデータ要素が検索されます。

シードされたリストは、付録 B を参照してください。

コード変換値へのアクセスコード変換値へのアクセスコード変換値へのアクセスコード変換値へのアクセス

キー・アクセスキー・アクセスキー・アクセスキー・アクセス

アウトバウンド・トランザクションとインバウンド・トランザクションでは、コード変換表の異なるキーを使用してコードにアクセスします。

� アウトバウンド・トランザクションでは、Oracle 値および標準コードは、トランザクションで書き込む宛先取引先値を判別するためにこの表にアクセスするキーになります。

� インバウンド・トランザクションでは、送信元取引先値および標準コードは、Oracle Application 表に渡す Oracle 値を判別するために表にアクセスするキーになります。

表検索の順序表検索の順序表検索の順序表検索の順序

すべてのトランザクションでは、コード変換値表項目が見つかるまで、次に示す順序で表検索が実行されます。

1. 取引先コード変換表にアクセスします。

この表でコードが見つからない場合は、2 番目の検索を実行します。

2. XML メッセージの標準コード(OAG など)を使用して、標準コード変換表にアクセスします。この標準コードは、「トランザクションの定義」フォームで定義したトランザクション表のトランザクションと関連付けられています。

この表でコードが見つからない場合は、3 番目の検索を実行します。

3. 標準コード UNIVERSAL を使用して、標準コード変換表にアクセスします。ユニバーサル項目は、ISO コードまたはその他の標準を表します。

インバウンド・トランザクションの場合インバウンド・トランザクションの場合インバウンド・トランザクションの場合インバウンド・トランザクションの場合 : 前述の 3 回の検索で表内にコードが見つからない場合は、" 送信元取引先値 " がメッセージ・マップのターゲット・フィールドにコピーされます。

XML Gateway の設定 3-35

Page 180: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

コード変換

アウトバウンド・トランザクションの場合アウトバウンド・トランザクションの場合アウトバウンド・トランザクションの場合アウトバウンド・トランザクションの場合 : 前述の 3 回の検索で表内にコードが見つからない場合は、"Oracle 値 " がメッセージ・マップのターゲット・フィールドにコピーされます。

次の表は、表および標準コード値の検索順序を示します。

アウトバウンド・トランザクション・コード変換表へのアクセスアウトバウンド・トランザクション・コード変換表へのアクセスアウトバウンド・トランザクション・コード変換表へのアクセスアウトバウンド・トランザクション・コード変換表へのアクセス

アウトバウンド・トランザクションの場合、コード変換表内の Oracle 値および標準コードは、宛先取引先値を抽出してトランザクションに設定するためのキーです。最初に取引先コードが検索されます。項目が見つからない場合は、次に標準コード変換表で標準コードおよびユニバーサル・コードが検索されます。

前述の 3 回の検索で表内にコードが見つからない場合は、Oracle 値がメッセージ・マップのターゲット・フィールドにコピーされます。それ以外の場合は、" 宛先取引先値 " がメッセージ・マップのターゲット・フィールドにコピーされます。

注意注意注意注意 : コード変換値が表内に見つからない場合でも、エラーではありません。あるデータ要素の選択値のみにコード変換が必要な場合があります。すべての値にコード変換表項目が存在するように要求すると、必要のない余分な数のコード変換を入力することになる可能性があります。

検索順序検索順序検索順序検索順序 コード変換フォームコード変換フォームコード変換フォームコード変換フォーム 標準コード標準コード標準コード標準コード 目的目的目的目的

1 取引先コード変換 CUSTOM 取引先固有のコード変換を定義する。これには、「標準コード変換」フォームから表示される標準のコード変換値またはユニバーサル・コード変換値に対する上書きも含まれる。取引先コード変換値は、その取引先に対するすべてのトランザクションで使用される。

2 標準コード変換の定義 例 :OAGROSETTANET (ROS)

ある特定の XML 標準について、すべての取引先で使

用される標準コード変換値を定義する。これらの値は、「取引先コード変換」フォームで特定の取引先を対象に上書きできる。

「標準コード」フィールドは XML メッセージに関連

付けられたデフォルトの XML 標準である。

3 標準コード変換の定義 UNIVERSAL すべての取引先で使用され、XML 標準に関連付けら

れていない標準コード変換値を定義する。これらの値は、「取引先コード変換」フォームで特定の取引先を対象に上書きできる。 これらの項目には、すべての XML メッセージで使用

できる汎用的に使用されているコード・リスト(ISO、X12、EDIFACT など)を格納する。

3-36 Oracle XML Gateway ユーザーズ・ガイド

Page 181: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

コード変換

次の表は、カテゴリ・コード UOM を使用したアウトバウンド・トランザクションに対するコード変換の概念を示します。アウトバウンド検索キーは、変換表、標準コードおよびOracle 値の値で構成されます。宛先取引先値は抽出されたデータです。

次の表は、カテゴリ・コード UOM に対するアウトバウンド・トランザクション・コード変換の例を示します。アウトバウンド検索キーは、変換表、標準コードおよび Oracle 値の値で構成されます。宛先取引先値は抽出されたデータです。

インバウンド・トランザクション・コード変換表へのアクセスインバウンド・トランザクション・コード変換表へのアクセスインバウンド・トランザクション・コード変換表へのアクセスインバウンド・トランザクション・コード変換表へのアクセス

インバウンド・トランザクションの場合、コード変換表内の送信元取引先値および標準コードは、Oracle 値を抽出するためのキーです。最初に取引先コードが検索されます。項目が見つからない場合は、標準コード変換表で標準コードとその次にユニバーサル・コードが検索されます。

前述の 3 回の検索で表内にコードが見つからない場合は、" 送信元取引先値 " がメッセージ・マップのターゲット・フィールドにコピーされます。それ以外の場合は、"Oracle 値 " がメッセージ・マップのターゲット・フィールドにコピーされます。

次の表は、カテゴリ・コード UOM を使用したインバウンド・トランザクションに対するコード変換の概念を示しています。インバウンド検索キー 1 は、変換表および標準コードの値で構成されます。Oracle 値は抽出されたデータです。送信元取引先値がインバウンド検索キー 2 です。

変換表変換表変換表変換表 標準コード標準コード標準コード標準コード Oracle 値値値値 説明説明説明説明 送信元取引先値送信元取引先値送信元取引先値送信元取引先値 宛先取引先値宛先取引先値宛先取引先値宛先取引先値

取引先または標準

第 1、第 2、第 3 の

検索の適切なコード

Each 各 (ここでは値を無視する。アウトバウンド・トランザクションには関係しない。)

EA(このコードを導出してトランザクションに設定する。)

変換表変換表変換表変換表 標準コード標準コード標準コード標準コード Oracle 値値値値 説明説明説明説明 送信元取引先値送信元取引先値送信元取引先値送信元取引先値 宛先取引先値宛先取引先値宛先取引先値宛先取引先値

取引先 Box 箱 (ここでは値を無視する。) BX

取引先 CUSTOM Each 各 (ここでは値を無視する。) EA

標準 OAG Box 箱 (ここでは値を無視する。) BX

標準 OAG Each 各 (ここでは値を無視する。) EA

標準 UNIVERSAL Box 箱 (ここでは値を無視する。) BX

XML Gateway の設定 3-37

Page 182: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

コード変換

次の表は、カテゴリ・コード UOM のインバウンド・トランザクション・コード変換の例を示します。インバウンド検索キー 1 は、変換表および標準コードの値で構成されます。Oracle 値は抽出されたデータです。送信元取引先値がインバウンド検索キー 2 です。

1 つの内部コードから複数の外部コードへつの内部コードから複数の外部コードへつの内部コードから複数の外部コードへつの内部コードから複数の外部コードへ

Message Designer の変数値の割当て処理を使用して、1 つの Oracle 内部コードに対して複数の外部コードを割り当てることができます。この場合、内部コードに対して条件を設定します。新しいコードが必要なため、Message Designer でメッセージを更新する必要があります。

変換表変換表変換表変換表(インバウンド(インバウンド(インバウンド(インバウンド検索キー検索キー検索キー検索キー 1))))

標準コード標準コード標準コード標準コード(インバウンド(インバウンド(インバウンド(インバウンド検索キー検索キー検索キー検索キー 1))))

Oracle 値値値値(抽出)(抽出)(抽出)(抽出)

説明説明説明説明 送信元取引先値送信元取引先値送信元取引先値送信元取引先値(インバウンド(インバウンド(インバウンド(インバウンド検索キー検索キー検索キー検索キー 2))))

宛先取引先値宛先取引先値宛先取引先値宛先取引先値

取引先または標準

第 1、第 2、第 3の検索の適切なコード

Each(このコードを導出して Oracle 表

に設定する。)

各 EA (ここでは値を無視する。インバウンド・トランザクションには関係しない。)

変換表変換表変換表変換表(インバウンド(インバウンド(インバウンド(インバウンド検索キー検索キー検索キー検索キー 1))))

標準コード標準コード標準コード標準コード(インバウンド(インバウンド(インバウンド(インバウンド検索キー検索キー検索キー検索キー 1))))

Oracle 値値値値(抽出)(抽出)(抽出)(抽出) 説明説明説明説明

送信元取引先値送信元取引先値送信元取引先値送信元取引先値(インバウンド(インバウンド(インバウンド(インバウンド検索キー検索キー検索キー検索キー 2)))) 宛先取引先値宛先取引先値宛先取引先値宛先取引先値

取引先 Box 箱 BX (ここでは値を無視する。)

取引先 CUSTOM Each 各 EA (ここでは値を無視する。)

標準 OAG Box 箱 BX (ここでは値を無視する。)

標準 OAG Each 各 EA (ここでは値を無視する。)

標準 UNIVERSAL Box 箱 BX (ここでは値を無視する。)

標準 UNIVERSAL Each 各 EA (ここでは値を無視する。)

3-38 Oracle XML Gateway ユーザーズ・ガイド

Page 183: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

コード変換

たとえば、SHIP_VIA 列に保存されている運送業者を表す 1 つの Oracle 内部コードから、2つの外部コード(運送業者と輸送モードなど)を相互参照することが必要な場合があります。次に例を示します。

SHIP_VIA = 'TRUCK-LAND' の場合

'TRUCK' を CARRIER に移動します。

SHIP_VIA = 'TRUCK-LAND' の場合

'L' を TRANSPORTATION_METHOD に移動します。

SHIP_VIA = 'TRUCK-AIR' の場合

'TRUCK' を CARRIER に移動します。

SHIP_VIA = 'TRUCK-AIR' の場合

'A' を TRANSPORTATION_METHOD に移動します。

「標準コード変換」フォーム「標準コード変換」フォーム「標準コード変換」フォーム「標準コード変換」フォームXML Gateway 職責から「設定」>「コード変換の定義」を選択して、「標準コード変換」フォームにナビゲートします。

「標準コード変換」フォームでは、コードが取引先固有のコード値でオーバーライドされない限り、すべての取引先で使用するコード値の一覧が表示されます。取引先固有のコードについては、「「取引先コード変換」フォーム」(3-42 ページ)を参照してください。

注意注意注意注意 : アウトバウンド・トランザクションの場合アウトバウンド・トランザクションの場合アウトバウンド・トランザクションの場合アウトバウンド・トランザクションの場合

SHIP_VIA ソース・データをファイルに 2 回書き込んだ場合は、2 つのフィールドを別々に変換するようにコード変換を実行できます。つまり、運送業者コードを導出するために 1 回、輸送方法を導出するために 1 回実行します。

XML Gateway の設定 3-39

Page 184: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

コード変換

カテゴリ・コードカテゴリ・コードカテゴリ・コードカテゴリ・コード

カテゴリ・コードを選択して、フォームの「カテゴリ値」の値リストを表示します。カテゴリ・コードは、追加または削除できません。

説明説明説明説明

カテゴリ・コードの説明。

3-40 Oracle XML Gateway ユーザーズ・ガイド

Page 185: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

コード変換

カテゴリ値カテゴリ値カテゴリ値カテゴリ値

標準コード(必須)標準コード(必須)標準コード(必須)標準コード(必須)

標準コードでは、次のいずれかが識別されます。

� OAG など、コード値の提供団体。XML メッセージを処理するために使用されます。

� UNIVERSAL という語。ISO、X12、EDIFACT など上記以外の団体を識別するためのシード済コード。

値の一覧から標準コードを選択します。

必要に応じて標準コードを新しく追加するには、「XML 標準の定義」(3-6 ページ)フォームを使用してください。

Oracle 値(必須)値(必須)値(必須)値(必須)

Oracle 値とは、インバウンド・トランザクションであるかアウトバウンド・トランザクションであるかにかかわらず Oracle E-Business Suite で定義されるコードのことです。「Oracle値」では、大文字 / 小文字が区別されます。

説明説明説明説明

Oracle 値の説明。

送信元取引先値(インバウンド・トランザクションで使用)送信元取引先値(インバウンド・トランザクションで使用)送信元取引先値(インバウンド・トランザクションで使用)送信元取引先値(インバウンド・トランザクションで使用)

" 送信元取引先値 " とは、取引先の視点からデータを表したメッセージ内のコードのことです。このコードは、ソース・インバウンド・トランザクション内にあります。

宛先取引先値(アウトバウンド・トランザクションで使用)宛先取引先値(アウトバウンド・トランザクションで使用)宛先取引先値(アウトバウンド・トランザクションで使用)宛先取引先値(アウトバウンド・トランザクションで使用)

" 宛先取引先値 " とは、アウトバウンド・メッセージに記述されるコードのことです。このコードは、取引先が受信する予定のデータを表しています。このフィールドにデータを入力することはできません。このコード値は、常に、「送信元取引先値」からコピーされた同じ値となります。

「標準」チェックボックス「標準」チェックボックス「標準」チェックボックス「標準」チェックボックス

「標準」チェックボックスは、「標準コード変換」フォーム内のすべての入力に対してオンになります。

注意注意注意注意 : 「トランザクションの定義」フォームでは、XML 標準と非 XML 標準の UNIVERSAL のみを定義してください。このプロセスでは、フォームに ISO や EDIFACT を入力することはできますが、これらの標準コードを認識することはできません。

XML Gateway の設定 3-41

Page 186: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「取引先コード変換」フォーム

コード変換値表項目の「標準」チェックボックスがオンになっている場合、「取引先コード変換」表の変換値を後で上書きすると、「取引先コード変換」フォーム内のこのチェックボックスは " オフ "(ブランク)になります。

このチェックボックスのオン / オフは、システムによって制御されます。

「シード済データ」チェックボックス「シード済データ」チェックボックス「シード済データ」チェックボックス「シード済データ」チェックボックス

XML Gateway では、データベースにデータをシードできます。データがシード済の場合は、このチェックボックスがオンになります。データがシード済としてマーク付けされている場合は、該当フォームでそのデータを変更することはできません。

「全て元に戻す」ボタン「全て元に戻す」ボタン「全て元に戻す」ボタン「全て元に戻す」ボタン

このフォームでは、「全て元に戻す」ボタンは使用できません。このボタンは、コードをすべて、標準コード変換表の標準コード値で最後に保存したエントリまで戻すために、「取引先コード変換」フォームで使用するためのものです。

「標準」チェックボックス、「シード済データ」チェックボックスおよび「宛先取引先値」以外のすべてのフィールドは、変更できます。

「元に戻す」ボタン「元に戻す」ボタン「元に戻す」ボタン「元に戻す」ボタン

このフォームでは、「元に戻す」ボタンは使用できません。このボタンは、標準コード変換表の標準コード値で最後に保存したエントリまでコードを戻すために、「取引先コード変換」フォームで使用するためのものです。

「取引先コード変換」フォーム「取引先コード変換」フォーム「取引先コード変換」フォーム「取引先コード変換」フォーム「取引先コード変換」フォームを使用すると、特定の取引先のコード値を入力したり、表示することができます。

このフォームを表示するには、「取引先設定の定義」フォーム(「XML Gateway 職責」>「設定」>「取引先の定義」) の「コード換算」ボタンをクリックします。

「取引先コード変換」フォームには、次のソースのデータが表示されます。

� このフォームに入力された取引先固有のすべてのコード値。

� 「標準コード変換」フォームに入力されたすべてのコード。このフォームの「標準」チェックボックスによって、「標準コード変換」フォームにデータが入力されたかどうかが示されます。標準コード変換値は変更できます。

3-42 Oracle XML Gateway ユーザーズ・ガイド

Page 187: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「取引先コード変換」フォーム

カテゴリ・コードカテゴリ・コードカテゴリ・コードカテゴリ・コード

カテゴリ・コードを選択して、フォームの「カテゴリ値」の値リストを表示します。コード・カテゴリは、追加または削除できません。

説明説明説明説明

カテゴリ・コードの説明。

XML Gateway の設定 3-43

Page 188: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「取引先コード変換」フォーム

カテゴリ値カテゴリ値カテゴリ値カテゴリ値

標準コード標準コード標準コード標準コード

取引先固有のコード変換値を追加すると、このフィールドに CUSTOM がデフォルトで表示されます。

Oracle 値値値値

Oracle 値とは、インバウンド・トランザクションであるかアウトバウンド・トランザクションであるかにかかわらず Oracle E-Business Suite で定義されるコードのことです。「Oracle値」では、大文字 / 小文字が区別されます。

説明説明説明説明

Oracle 値の説明。

送信元取引先値(インバウンド・トランザクションで使用)送信元取引先値(インバウンド・トランザクションで使用)送信元取引先値(インバウンド・トランザクションで使用)送信元取引先値(インバウンド・トランザクションで使用)

" 送信元取引先値 " とは、取引先の視点からデータを表したメッセージ内のコードのことです。このコードは、ソース・インバウンド・トランザクション内にあります。

宛先取引先値(アウトバウンド・トランザクションで使用)宛先取引先値(アウトバウンド・トランザクションで使用)宛先取引先値(アウトバウンド・トランザクションで使用)宛先取引先値(アウトバウンド・トランザクションで使用)

" 宛先取引先値 " とは、アウトバウンド・メッセージに記述されるコードのことです。このコードは、取引先が受信する予定のデータを表しています。このフィールドにデータを入力することはできません。このコード値は、常に、「送信元取引先値」からコピーされた同じ値となります。

「標準」チェックボックス「標準」チェックボックス「標準」チェックボックス「標準」チェックボックス

「標準」チェックボックスは、「標準コード変換」フォーム内のすべての入力に対してオンになります。

コード変換値表項目の「標準」チェックボックスがオンになっている場合、「取引先コード変換」表の変換値を後で上書きすると、「取引先コード変換」フォーム内のこのチェックボックスは " オフ "(ブランク)になります。

このチェックボックスのオン / オフは、システムによって制御されます。

「シード済データ」チェックボックス「シード済データ」チェックボックス「シード済データ」チェックボックス「シード済データ」チェックボックス

XML Gateway では、データベースにデータをシードできます。データがシード済の場合は、このチェックボックスがオンになります。データがシード済としてマーク付けされている場合は、該当フォームでそのデータを変更することはできません。

「全て元に戻す」ボタン「全て元に戻す」ボタン「全て元に戻す」ボタン「全て元に戻す」ボタン

「取引先コード変換」フォームの「すべて元に戻す」ボタンをクリックすると、最後に保存された項目までのすべてのコードが標準コード変換表内の標準コード値に戻ります。

3-44 Oracle XML Gateway ユーザーズ・ガイド

Page 189: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「取引先コード変換」フォーム

「標準」チェックボックス、「シード済データ」チェックボックスおよび「宛先取引先値」以外のすべてのフィールドは、変更できます。

「元に戻す」ボタン「元に戻す」ボタン「元に戻す」ボタン「元に戻す」ボタン

「取引先コード変換」フォームの「元に戻す」ボタンをクリックすると、最後に保存された項目までのコードが標準コード変換表内の標準コード値に戻ります。

更新可能な内容更新可能な内容更新可能な内容更新可能な内容カスタム・コードを追加している場合は、「標準」チェックボックスおよび「シード済データ」チェックボックス以外のすべてのフィールドを変更できます。

標準コードが "CUSTOM" でない場合は、「送信元取引先値」および「宛先取引先値」のみを変更できます。「標準」チェックボックスがオンになります。

注意注意注意注意 : 「元に戻す」ボタンは、この特定の取引先に対して選択した項目にのみ適用されます。

XML Gateway の設定 3-45

Page 190: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

「取引先コード変換」フォーム

3-46 Oracle XML Gateway ユーザーズ・ガイド

Page 191: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

実行エンジ

4

実行エンジン実行エンジン実行エンジン実行エンジン

この章では、実行エンジンの機能について説明します。具体的には、次の点について説明します。

� 実行エンジンによるメッセージの処理方法の概要を説明します。

� XML Gateway エンベロープについて説明します(XML メッセージはこのエンベロープに配置されて、検索されます)。

� メッセージの取引先の検証方法について説明します。

� OAG 確認ビジネス・オブジェクト文書の実装方法について説明します。

実行エンジンの概要実行エンジンの概要実行エンジンの概要実行エンジンの概要XML Gateway には、Message Designer、設定および実行エンジンの 3 つのコンポーネントが含まれています。XML Gateway は、次の Oracle 製品と連動します。

� Oracle Transport Agent(メッセージ配信用)。

� Oracle Advanced Queuing(メッセージ伝播およびキュー管理用)。

� Oracle Workflow 業務イベント・システム(業務イベントの公開およびサブスクリプション用)。Workflow によって、XML Gateway 実行エンジン、Advanced Queuing

(AQ)または Transport Agent によって検出されたエラーを報告するための有効な電子メール通知も提供されます。

次の図は、上記のコンポーネントをすべて使用して XML Gateway 実行エンジンを経由して送信される XML メッセージのプロセス・フローを示します。XML Gateway 実行エンジンの詳細は、次のとおりです。

ン 4-1

Page 192: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

実行エンジンの概要

XML Gateway 実行エンジンでメッセージを適切に処理するには、次の設定が必要になります。

� メッセージ・マップを作成し、関連づけられた DTD とともにリポジトリにロードします。

� 取引先を定義します。

� コード変換を定義します。

� 取引を定義します。

� Oracle Workflow 業務イベント・システム・イベントが Oracle E-Business Suite によって公開され、これらのイベントに対するサブスクリプションが定義されます。

� エンジンおよびリスナーを開始します。

XML Gateway Message Designer

XML Gateway実行エンジン�

メッセージ確認の�送信/受信�

XML Gateway Messageの設定�

mymap.xgm mydtd.dtd

マップの�ロード/�削除�

DTDの�ロード/�削除�

XML Gatewayリポジトリ�

エラー�の場合�

Workflowの�エラー処理�プロセス�

Workflowの�通知�

Oracle E-Business

Suite

イベント�が発生�

業務�イベント・�システム�

サブスクリ�プション�

XMLメッセージを�送信するための�ワークフロー・�プロセス�

アウトバウンド�XMLメッセージ�

の作成�

アウトバウンド・�キュー�

XML Msg

XML Msg

出力�

XML Gateway Transport

Agent

インバウンド・�メッセージを�処理するための�ワークフロー・�プロセス�

サブスクリ�プション�

業務�イベント・�システム�

イベント�が発生�

インバウンド�XMLメッセージ�

の処理�

インバウンド・�キュー�

イベント�が発生� XML Msg

XML Msg

入力�

SMTPHTTP

HTTPS

4-2 Oracle XML Gateway ユーザーズ・ガイド

Page 193: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

実行エンジンの概要

XML Gateway リスナーによって、関連するイベントに対するポーリングがアクティブに実行されます。Oracle Workflow 業務イベント・システムにより処理対象のアウトバンド・トランザクションが検出されるか、またはインバウンド・メッセージがキューに着信すると、実行エンジンの処理が開始されます。

XML Gateway 実行エンジンでは、次の処理が実行されます。

� (インバウンド・メッセージ)インバウンド・キューからのメッセージのデキュー(インバウンド・メッセージ)インバウンド・キューからのメッセージのデキュー(インバウンド・メッセージ)インバウンド・キューからのメッセージのデキュー(インバウンド・メッセージ)インバウンド・キューからのメッセージのデキュー

� XML パーサーによるメッセージの検証パーサーによるメッセージの検証パーサーによるメッセージの検証パーサーによるメッセージの検証

(インバウンド・メッセージ)XML パーサーを使用してインバウンド・メッセージを検証し、(DTD ディレクトリに格納された DTD に基づいて)インバウンド・メッセージが正常に構成され、有効であることを確認してから、処理を継続します。

(アウトバウンド・メッセージ)XML パーサーを使用して新規作成したメッセージを検証し、そのメッセージが正常に構成され、有効であることを確認します。(DTD ディレクトリに格納された DTD に基づいて)正常に構成されていないメッセージまたは無効なメッセージは、アウトバウンド・キューにエンキューされません。

� 取引先またはハブの検証取引先またはハブの検証取引先またはハブの検証取引先またはハブの検証

インバウンド・メッセージが正常に構成され、有効である場合は、実行エンジンによって、取引先および文書が定義されていることが検証されます。取引先が定義されていないか、または文書が取引先用に定義されていない場合には、XML メッセージの処理が継続されません。

� リポジトリからのメッセージ・マップの取得リポジトリからのメッセージ・マップの取得リポジトリからのメッセージ・マップの取得リポジトリからのメッセージ・マップの取得

取引先に関連付けられたメッセージ・マップが XML Gateway リポジトリで使用できない場合は、XML メッセージの処理が継続されません。

� メッセージ・マップの実行メッセージ・マップの実行メッセージ・マップの実行メッセージ・マップの実行

– (アウトバウンド・メッセージ)アプリケーション・データの収集(アウトバウンド・メッセージ)アプリケーション・データの収集(アウトバウンド・メッセージ)アプリケーション・データの収集(アウトバウンド・メッセージ)アプリケーション・データの収集

取引先が有効で、リポジトリ内にメッセージ・マップが格納されている場合は、実行エンジンによって、メッセージ・マップで指定されたデータベースのビューおよび列を使用して、Oracle E-Business Suite からアプリケーション・データが収集されます。

– (インバウンド・メッセージ)マップ・データ(インバウンド・メッセージ)マップ・データ(インバウンド・メッセージ)マップ・データ(インバウンド・メッセージ)マップ・データ

取引先が有効で、リポジトリ内にメッセージ・マップが格納されている場合は、実行エンジンによって、XML メッセージ内のデータが、メッセージ・マップで指定された Oracle E-Business Suite の表および列のターゲット・データ・フィールドにマッピングされます。これらの表は、通常、アプリケーション・オープン・インタフェース表です。

– コード変換の適用コード変換の適用コード変換の適用コード変換の適用

コード変換が有効化されているソース列にコード変換を適用します。

実行エンジン 4-3

Page 194: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

実行エンジンの概要

– 処理の適用処理の適用処理の適用処理の適用

定義されている処理(文書、要素、ルート・レベルなど)を適用します。

(インバウンド・メッセージ)処理コードによって、アプリケーション・オープン・インタフェース表にデータが挿入され、次に、アプリケーション・オープン・インタフェース API が実行されて、ベース・アプリケーション表が設定されます。

– (アウトバウンド・メッセージ)(アウトバウンド・メッセージ)(アウトバウンド・メッセージ)(アウトバウンド・メッセージ)XML メッセージの作成メッセージの作成メッセージの作成メッセージの作成

上記のメッセージ・マップおよびアプリケーション・データを使用して、XMLメッセージを作成します。

� 処理エラーの検出およびレポート処理エラーの検出およびレポート処理エラーの検出およびレポート処理エラーの検出およびレポート

Oracle XML Gateway の実行エンジン、Oracle Advanced Queuing、Oracle Workflowまたは Oracle Transport Agent によって、エラーが検出されることがあります。エラーに関する情報は、エラー・キューにエンキューされます。Oracle Workflow を使用して電子メール通知が送信され、取引先(データ・エラーの場合)、または XML Gatewayシステム管理者(システム・エラーや処理エラーの場合)に通知されます。

また、システム・エラーや処理エラーの場合は、XML メッセージのコピーが XML メッセージ・ディレクトリに格納され、レポートされたエラーのトラブルシューティングに使用されます。取引先関連のデータ・エラーの場合、取引先は、XML メッセージのコピーを参照できます。

� XML メッセージのコピーメッセージのコピーメッセージのコピーメッセージのコピー

システム・エラーや処理エラーの場合は、XML メッセージのコピーが XML メッセージ・ディレクトリに格納され、レポートされたエラーのトラブルシューティングに使用されます。取引先関連のデータ・エラーの場合、取引先は、XML メッセージのコピーを参照できます。

� (アウトバウンド・メッセージ)メッセージのアウトバウンド・キューへのエンキュー(アウトバウンド・メッセージ)メッセージのアウトバウンド・キューへのエンキュー(アウトバウンド・メッセージ)メッセージのアウトバウンド・キューへのエンキュー(アウトバウンド・メッセージ)メッセージのアウトバウンド・キューへのエンキュー

正常に構成された有効なメッセージをアウトバンド・キューにエンキューします。Oracle Transport Agent によって、アウトバウンド・キューからメッセージがデキューされ、取引先に配信されます。

� 確認メッセージの作成または消込確認メッセージの作成または消込確認メッセージの作成または消込確認メッセージの作成または消込

(インバウンド・メッセージ)確認メッセージが取引先に対して有効化され、かつアウトバウンド・メッセージで確認が要求されているか、または取引先に対してデフォルトが設定されている場合は、確認メッセージを受信します。

(アウトバウンド・メッセージ)確認メッセージが取引先に対して有効化され、かつインバウンド・メッセージで確認が要求されているか、または取引先に対してデフォルトが設定されている場合は、確認メッセージを作成します。

4-4 Oracle XML Gateway ユーザーズ・ガイド

Page 195: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エンベロープ

XML Gateway エンベロープエンベロープエンベロープエンベロープXML ペイロードにおける発注や請求書などのビジネス文書の他、一連のメッセージ属性が伝送されます。これらの属性をまとめて、XML Gateway エンベロープと呼びます。

このセクションでは、インバウンド・メッセージの検証処理における XML Gateway エンベロープとそのデータ、またはアウトバウンド・メッセージ用に作成するためのデータのソースについて説明します。「取引先設定」フォームに入力したデータは、取引先表のデータと言います。「トランザクションの定義」フォームに入力したデータは、トランザクション表のデータと言います。

データ要素の大半は、取引先表またはトランザクション表から XML Gateway エンベロープにコピーされます。

トランザクションの方向は、XML Gateway によって決定されます。XML Gateway で使用される方向の値は、次のとおりです。

� IN(インバウンド・メッセージの場合)

� OUT(アウトバウンド・メッセージの場合)

次の表は、XML Gateway エンベロープで使用されるデータを示します。

属性属性属性属性 目次目次目次目次 サンプル値サンプル値サンプル値サンプル値 データ・ソースデータ・ソースデータ・ソースデータ・ソース

MESSAGE_TYPE ペイロードのメッセージ・フォーマット

XML ハード・コーディングされた "XML"

MESSAGE_STANDARD

メッセージ・フォーマット標準

OAG トランザクション表

TRANSACTION_TYPE

そのビジネス文書の外部トランザクション・タイプ

INVOICE 取引先表

TRANSACTION_SUBTYPE

そのビジネス文書の外部トランザクション・サブタイプ

PROCESS 取引先表

DOCUMENT_NUMBER

ビジネス文書番号(請求書番号など)

(未使用) N/A

PARTYID (未使用) 取引先表。XML Gatewayでは未使用。

PARTY_SITE_ID ソース取引先事業所コード

ACME_CHICAGO 取引先表の SOURCE TP LOCATION(再作成しな

い場合)または TARGET TP LOCATION CODE

(再作成する場合)

PARTY_TYPE (未使用) (未使用)

PROTOCOL_TYPE 通信プロトコル SMTP, HTTP, HTTP-WM

取引先表

実行エンジン 4-5

Page 196: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エンベロープ

MESSAGE_TYPEペイロードのメッセージ・フォーマット。"XML" とハード・コーディングされています。

MESSAGE_STANDARDOAG などのメッセージ・フォーマット標準で「トランザクションの定義」フォームに表示され、「XML 標準の定義」フォームで入力できます。

TRANSACTION_TYPE取引先表のビジネス文書の外部トランザクション・タイプ。

TRANSACTION_SUBTYPE取引先表のビジネス文書の外部トランザクション・サブタイプ。

DOCUMENT_NUMBERユーザーが発注や請求書番号などのトランザクションを認識するための文書の識別子。XML Gateway ではこのフィールドは使用されませんが、インバウンド・メッセージにこのフィールドを受け渡すことはできます。

PROTOCOL_ADDRESS

通信アドレス [email protected], http://www.co.com:5555

取引先表

USERNAME ユーザー名 接続が "DIRECT" の場合

は取引先表、"HUB" の場

合はハブの定義。

PASSWORD パスワード 接続が "DIRECT" の場合

は取引先表、"HUB" の場

合はハブの定義。

ATTRIBUTE1 (アプリケーションで決まる)

N/A N/A

ATTRIBUTE2 (アプリケーションで決まる)

N/A N/A

ATTRIBUTE3 再ルーティングの場所(メッセージを再ルーティングする場合のみ使用)

取引先表の TARGET TP LOCATION CODE

ATTRIBUTE4 (アプリケーションで決まる)

N/A N/A

ATTRIBUTE5 (アプリケーションで決まる)

N/A N/A

PAYLOAD XML ビジネス文書 (XML メッセージ)

属性属性属性属性 目次目次目次目次 サンプル値サンプル値サンプル値サンプル値 データ・ソースデータ・ソースデータ・ソースデータ・ソース

4-6 Oracle XML Gateway ユーザーズ・ガイド

Page 197: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エンベロープ

PARTY_SITE_ID取引先表の目的取引先事業所コードにデータがない場合のソース取引先事業所コード。

PROTOCOL_TYPE取引先表で定義された通信プロトコル。

PROTOCOL_ADDRESS取引先表で定義された通信アドレス。

USERNAME取引先表で定義された USERNAME。

PASSWORD取引先表で定義された USERNAME に関連付けられたパスワード。

ATTRIBUTE3アウトバウンド・メッセージの場合、取引先表の目的取引先事業所コードからこのフィールドの値が取得されます。

インバウンド・メッセージの場合、この値に基づいて、取引先表の目的取引先事業所コードに指定された取引先に送信される XML メッセージが生成されます。XML メッセージを最終受信者に転送するには、この値がハブで認識できる必要があります。詳細は、「XML Gateway の設定」(3-1 ページ)を参照してください。

PAYLOADXML メッセージ。

アプリケーションで定義されるパラメータアプリケーションで定義されるパラメータアプリケーションで定義されるパラメータアプリケーションで定義されるパラメータ

次のパラメータは、基本アプリケーションで定義することができます。

� ATTRIBUTE1

� ATTRIBUTE2

� ATTRIBUTE4

� ATTRIBUTE5

未使用のパラメータ未使用のパラメータ未使用のパラメータ未使用のパラメータ

次のパラメータは使用しません。

� PARTYID

� PARTYTYPE

実行エンジン 4-7

Page 198: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのための取引先の検証

インバウンド・メッセージのための取引先の検証インバウンド・メッセージのための取引先の検証インバウンド・メッセージのための取引先の検証インバウンド・メッセージのための取引先の検証

Oracle Workflow 業務イベント・システムで発生するイベント業務イベント・システムで発生するイベント業務イベント・システムで発生するイベント業務イベント・システムで発生するイベント Oracle Workflow 業務イベント・システムは、Oracle E-Business Suite と統合することにより、イベントベースの XML メッセージの作成および消込を可能にするためのツールです。

XML Gateway でのメッセージ処理前でのメッセージ処理前でのメッセージ処理前でのメッセージ処理前 :

取引先から送信されたメッセージは、メッセージ・キューにキューイングされます。Oracle Workflow のリスナーは、メッセージ・キューのメッセージをデキューし、XML Gateway に処理開始のイベントを発行します。

詳細は、「メッセージ・キュー」(5-1 ページ)を参照してださい。

XML Gateway でのメッセージ処理後でのメッセージ処理後でのメッセージ処理後でのメッセージ処理後 :

取引先に関連するメッセージ・マップの指示に従って、XML Gateway でのデータ処理が完了すると、インバウンド・メッセージの処理が完了したことを Oracle E-Business Suite に通知するためのイベントが、XML Gateway によって発行されます。このイベントを待ち受ける Oracle E-Business Suite のモジュールは、サブスクリプションを登録してトランザクションを続行します。

XML Gateway の処理の処理の処理の処理

インバウンド・メッセージには、次の 2 種類があります。

� 標準の XML メッセージ

XML Gateway エンベロープの ATTRIBUTE3 が NULL の場合、XML メッセージはメッセージ・マップに従って処理されます。

� パス・スルー・メッセージ

XML Gateway エンベロープの ATTRIBUTE3 にデータが設定されている場合、インバウンド・メッセージは、ATTRIBUTE3 で指定した取引先用のメッセージ・マップに従ってアウトバウンド・メッセージとして再作成されます。このトランザクションは、パス・スルー・メッセージと呼ばれ、ダイナミック・ルーティングを持つメッセージとして定義されます。詳細は、「静的ルーティングおよび動的ルーティング」(3-26 ページ)を参照してください。

4-8 Oracle XML Gateway ユーザーズ・ガイド

Page 199: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのための取引先の検証

標準の標準の標準の標準の XML メッセージメッセージメッセージメッセージ

次の表は、標準の XML メッセージを特定するために XML Gateway エンベロープで必要なデータを示します。インバウンド・メッセージのためにこのデータが検証される方法は、次のとおりです。

パス・スルーパス・スルーパス・スルーパス・スルー XML メッセージメッセージメッセージメッセージ

XML Gateway では、基本 Oracle Application にトランザクションをロードせずにメッセージが再作成され、他の取引先にルーティングされます。この処理は、インバウンド・メッセージ中の XML Gateway エンベロープの ATTRIBUTE3 に取引先コードが設定されている場合に可能となります。

取引先事業所コードがインバウンド・メッセージの ATTRIBUTE3 に設定されている場合、次の処理が行われます。

� アウトバウンド・メッセージ用の取引先設定表のエントリのうち、TRANSACTION_TYPE および TRANSACTION_SUBTYPE の一致するエントリが、ATTRIBUTE3 に設定された取引先のために設定されています。ATTRIBUTE3 の値は、「取引先設定」フォームで定義された目的取引先事業所コードのエントリと一致している必要があります。

� ATTRIBUTE3 のエンティティが取引先設定表で見つかる場合、その取引先用のメッセージ・マップに従って、別の XML Gateway メッセージが作成されます。この新しく作成された XML メッセージは、ATTRIBUTE3 に設定されている取引先にルーティングされます。

属性属性属性属性 サンプル値サンプル値サンプル値サンプル値 取引先参照での使用取引先参照での使用取引先参照での使用取引先参照での使用

1 MESSAGE_STANDARD OAG YES

2 TRANSACTION_TYPE INVOICE YES

3 TRANSACTION_SUBTYPE PROCESS YES

4 PARTY_SITE_ID ACME_CHICAGO YES

5 ATTRIBUTE3 NULL NO

6 PAYLOAD (XML メッセージ) N/A

注意注意注意注意 : XML メッセージを作成したシステムによって、XML Gateway エンベロープに USERNAME と PASSWORD が設定されることがあります。Transport Agent では、送信のために USERNAME と PASSWORD が使用されます。これらのフィールドは、Transport Agent ソフトウェアからXML Gateway に渡されることはありません。

実行エンジン 4-9

Page 200: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのための取引先の検証

次の表は、これらのメッセージを特定するために XML Gateway エンベロープで必要なデータ、およびパス・スルー XML メッセージのキー・データを示します。

「取引先設定」フォームのデータに照らした検証「取引先設定」フォームのデータに照らした検証「取引先設定」フォームのデータに照らした検証「取引先設定」フォームのデータに照らした検証インバウンド・メッセージのデータ検証は、「取引先設定」フォームに入力したデータに対してのみ行われます。

ソース取引先事業所コードソース取引先事業所コードソース取引先事業所コードソース取引先事業所コード

ソース取引先事業所コードは、XML エンベロープの PARTY_SITE_ID に設定されたコードで、メッセージのソースを特定するために使用されます。このフィールドには、取引先設定表のソース取引先事業所コードに格納された値が設定されている必要があります。

「取引先設定」フォームに取引先を入力すると、Oracle Receivables、Oracle Payables、または Oracle HR 事業所から取得した値の一覧から、取引先名と取引先のサイトが選択されます。基本 Oracle Application の表 ID は、各取引先のサイトに関連しています。メッセージ・マップでこの表 ID を使用する場合は、「事業所コードからの所在地 ID の導出」(2-82 ページ)および「事前定義済変数値の取得」(2-99 ページ)を参照してください。

次の表に列記したパラメータは、取引先表に対する検索キーです。このキーを使用すると、取引先によりそのトランザクションを実行できるかどうかが判断され、そのトランザクションを処理するためのメッセージ・マップ名を取り出すことができます。

属性属性属性属性(オリジナルの(オリジナルの(オリジナルの(オリジナルの XMLメッセージ)メッセージ)メッセージ)メッセージ)

インバウンド・インバウンド・インバウンド・インバウンド・メッセージのサンプル値メッセージのサンプル値メッセージのサンプル値メッセージのサンプル値

作成されるパス・スルー・メッセージ作成されるパス・スルー・メッセージ作成されるパス・スルー・メッセージ作成されるパス・スルー・メッセージ(オリジナル・メッセージの(オリジナル・メッセージの(オリジナル・メッセージの(オリジナル・メッセージのATTRIBUTE3 に取引先が設定されたに取引先が設定されたに取引先が設定されたに取引先が設定されたアウトバウンド・メッセージに対応アウトバウンド・メッセージに対応アウトバウンド・メッセージに対応アウトバウンド・メッセージに対応する取引先設定を検索)する取引先設定を検索)する取引先設定を検索)する取引先設定を検索)

1 MESSAGE_STANDARD OAG OAG

2 TRANSACTION_TYPE INVOICE INVOICE

3 TRANSACTION_SUBTYPE PROCESS PROCESS

4 PARTY_SITE_ID ACME_CHICAGO BETA-LONDON(オリジナルの

ATTRIBUTE3 から)

5 ATTRIBUTE3(取引先設定表の目的取引先事業所コード。これはアウトバウンド・メッセージのPARTY_SITE_ID になる。)

BETA-LONDON

6 PAYLOAD (XML メッセージ) (XML メッセージ)

検索パラメータ検索パラメータ検索パラメータ検索パラメータ 説明説明説明説明 サンプルサンプルサンプルサンプル

1 PARTY_SITE_ID ソース取引先事業所コード ACME_CHICAGO

2 TRANSACTION_TYPE そのビジネス文書の外部トランザクション・タイプ

INVOICE

4-10 Oracle XML Gateway ユーザーズ・ガイド

Page 201: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アウトバウンド・メッセージのための取引先の検証

次の表は、「取引先設定」フォームに入力したデータを検索するときに返されるデータを示します。

トランザクションの方向は、XML Gateway によって決定されます。XML Gateway で使用される方向の値は、次のとおりです。

� IN(インバウンド・メッセージの場合)

� OUT(アウトバウンド・メッセージの場合)

アウトバウンド・メッセージのための取引先の検証アウトバウンド・メッセージのための取引先の検証アウトバウンド・メッセージのための取引先の検証アウトバウンド・メッセージのための取引先の検証

Oracle Workflow 業務イベント・システムで発生するイベント業務イベント・システムで発生するイベント業務イベント・システムで発生するイベント業務イベント・システムで発生するイベント

アウトバウンド・メッセージのアプリケーション業務イベントは、トランザクションを担当する Oracle E-Business Suite モジュールによって生成されます。Oracle XML Gateway には、トランザクションにアクセスする手段として、イベントへのサブスクリプションが含まれています。このイベントは、XML Gateway で作成されるトランザクションに関連付けられています。

Oracle Workflow 業務イベント・システムでは、この業務イベント・システム内のルール機能をコールして、取引先がそのトランザクションを実行可能かどうかが検証されます。取引先がそのトランザクションを実行可能な場合にのみ、Oracle Workflow 業務イベント・システムでは、ワークフロー・プロセスを実行してメッセージが送信されます。

XML Gateway にそのイベントのサブスクリプションがある場合は、XML Gateway では、トランザクション・データを使用して次のことが実行されます。

3 TRANSACTION_SUBTYPE そのビジネス文書の外部トランザクション・サブタイプ

PROCESS

4 DIRECTION XML Gateway で決定されます IN

返されるデータ返されるデータ返されるデータ返されるデータ 説明説明説明説明 サンプルサンプルサンプルサンプル

1 メッセージのために使用可能な取引先サイト

このデータは、選択した取引先を設定した表に格納されます。このデータは、表示されません。

12345(表 ID)

2 指定した取引先用にインバウンド・トランザクションで使用するメッセージ・マップ

OAG_IN_INVOICE

検索パラメータ検索パラメータ検索パラメータ検索パラメータ 説明説明説明説明 サンプルサンプルサンプルサンプル

実行エンジン 4-11

Page 202: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

OAG 確認ビジネス・オブジェクト文書の実装方法

� Oracle E-Business Suite からのデータの収集

� XML メッセージの作成

� メッセージのアウトバウンド・キューへのステージ(Transport Agent による取引先への配信用)

「Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合」(6-1 ページ)を参照してください。

OAG 確認ビジネス・オブジェクト文書の実装方法確認ビジネス・オブジェクト文書の実装方法確認ビジネス・オブジェクト文書の実装方法確認ビジネス・オブジェクト文書の実装方法

確認メッセージの目的確認メッセージの目的確認メッセージの目的確認メッセージの目的確認メッセージの目的は、ビジネス文書のステータスをやり取りすることです。確認メッセージには、一般的な文書ステータス情報のみでなく、検出されたエラーに関する詳細を追加できます。

確認メッセージは、任意のビジネス文書を確認するために使用できる汎用文書です。発注通知文書または発注変更通知文書など特定の目的のための確認文書の代わりとしてではなく、追加の文書として使用できます。

確認ビジネス・オブジェクト文書(BoD)DTD の詳細は、www.openapplications.orgを参照してください。

確認メッセージの構成確認メッセージの構成確認メッセージの構成確認メッセージの構成確認メッセージは、次の 2 つの部分で構成されています。

� CONFIRM_BOD/CONFIRM

CONFIRM データ型は、確認対象のビジネス文書を示すために使用されます。文書ステータス、文書の説明、および元のビジネス文書の識別子が含まれます。

� CONFIRM_BOD/CONFIRMMSG

CONFIRMMSG データ型は、文書ステータスの詳細を示すために使用されます。説明およびすべての事由コードが含まれます。各 CONFIRM データ型には、複数のCONFIRMMSG データ型を関連付けることができます。

XML Gateway のシードされた確認メッセージ・マップのシードされた確認メッセージ・マップのシードされた確認メッセージ・マップのシードされた確認メッセージ・マップOracle XML Gateway には、インバウンドおよびアウトバウンドの両方の確認 BoD メッセージのためのシードされたマップが用意されています。シードされたメッセージ・マップの名前は、次のとおりです。

4-12 Oracle XML Gateway ユーザーズ・ガイド

Page 203: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

OAG 確認ビジネス・オブジェクト文書の実装方法

� ECX_CBODI_OAG72_IN_CONFIRM

� ECX_CBODO_OAG72_OUT_CONFIRM

XML Gateway のシードされたマップは、必要に応じて、Oracle E-Business Suite アプリケーション・ビジネス・プロセスに組み込まれています。

E-Business Suite のシードされたイベントおよびイベント・サブスクリプのシードされたイベントおよびイベント・サブスクリプのシードされたイベントおよびイベント・サブスクリプのシードされたイベントおよびイベント・サブスクリプションションションション

確認 BoD の使用方法は、Oracle E-Business Suite のアプリケーション・モジュールによって異なります。ビジネス・プロセスに確認 BoD が組み込まれているアプリケーション・モジュールの場合、プロセスは次のようにモデル化されています。

アウトバウンド確認アウトバウンド確認アウトバウンド確認アウトバウンド確認

Oracle XML Gateway では、インバウンド・ビジネス文書に応答してアウトバウンド確認メッセージを送信します。

インバウンド・ビジネス文書がプロセス(ステップ 1)を開始します。すべてのインバウンドメッセージと同様、XML Gateway では、インバウンド・ビジネス文書を処理したことをOracle E-Business Suite アプリケーションに通知します。

インバウンド文書用に定義されたアプリケーション・イベント・サブスクリプションが実行され(ステップ 2)、その後イベントが発生し(ステップ 3)、アウトバウンド確認を作成して送信するように XML Gateway に通知されます(ステップ 4)。

ステップ 2 および 3 は、インバウンド・ビジネス文書の消込とアウトバウンド確認メッセージの作成および配信の間にアプリケーション・ビジネス・プロセスを実行できるように、個別に定義されます。

TPから受信された�インバウンド・�ビジネス文書、�

Seteventdetailsの�コール�

インバウンド・�ビジネス文書を�処理するための�

アプリケーション・�イベント・�

サブスクリプション�

ステップ1

アウトバウンド確認を�作成するために�

アプリケーションが�イベントを発生�

ステップ2 ステップ3

アウトバウンド確認を�作成して送信するため�のアプリケーション・�

イベント・�サブスクリプション�

ステップ4

実行エンジン 4-13

Page 204: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

OAG 確認ビジネス・オブジェクト文書の実装方法

インバウンド確認インバウンド確認インバウンド確認インバウンド確認

Oracle XML Gateway では、アウトバウンド・ビジネス文書に応答して、取引先から受信したインバウンド確認メッセージを処理します。また、インバウンド確認メッセージを処理したことを Oracle E-Business Suite に通知します。

インバウンド確認メッセージ用に定義されたアプリケーション・イベント・サブスクリプションが実行されます。イベント・サブスクリプションの動作は、アプリケーション・モジュールごとに異なり、アプリケーション・モジュールが否定、肯定、またはこの両方のタイプのいずれの確認タイプに関係するかによって異なります。

シードされた確認メッセージを実装したり使用不可にする方法シードされた確認メッセージを実装したり使用不可にする方法シードされた確認メッセージを実装したり使用不可にする方法シードされた確認メッセージを実装したり使用不可にする方法アウトバウンド・メッセージの作成および送信、またはインバウンド・メッセージの消込を行うアプリケーション・イベント・サブスクリプションは、Oracle E-Business Suite アプリケーション・モジュールによって配信されます。

インバウンドまたはアウトバウンド確認 BoD メッセージのシードされたイベント名は、次のとおりです。

ORACLE.APPS.< コンポーネント >.< タスク >.CONFIRM

コンポーネントは、「トランザクションの定義」フォームに入力された内部トランザクション・タイプであり、製品の短縮名を表しています。

TASK は、「トランザクションの定義」フォームに入力された内部トランザクション・サブタイプであり、オブジェクトの説明を表しています。

アウトバウンド発注に関連づけられた確認イベントのイベント名は、ORACLE.APPS.PO.POO.CONFIRM のようになります。

対応するシードされたイベント・サブスクリプションが使用可能に定義されます。確認 BoDメッセージを実装しない場合は、「Oracle Workflow 管理者 : イベント / イベント・グループの追加」ウィンドウを使用して、シードされたイベントおよびイベント・サブスクリプションを表示したり、使用不可にします。詳細は、「シードされたイベント・サブスクリプションの構成または削除」(6-58 ページ)を参照してください。

シードされたイベント・サブスクリプションを実装するには、次のように取引先を定義して確認メッセージを使用可能にします。

TPから受信された�インバウンド確認、�

Seteventdetailsの�コール�

インバウンド確認を�処理するための�

アプリケーション・�イベント・�

サブスクリプション�

4-14 Oracle XML Gateway ユーザーズ・ガイド

Page 205: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

OAG 確認ビジネス・オブジェクト文書の実装方法

◗◗ XML Gateway の「取引先の定義」ウィンドウを使用して、取引先を定義しの「取引先の定義」ウィンドウを使用して、取引先を定義しの「取引先の定義」ウィンドウを使用して、取引先を定義しの「取引先の定義」ウィンドウを使用して、取引先を定義します。ます。ます。ます。

◗◗ ビジネス文書を使用可能にして、「文書確認」フラグを次のいずれかに設定ビジネス文書を使用可能にして、「文書確認」フラグを次のいずれかに設定ビジネス文書を使用可能にして、「文書確認」フラグを次のいずれかに設定ビジネス文書を使用可能にして、「文書確認」フラグを次のいずれかに設定します。します。します。します。

1 = エラーが発生した場合にのみ確認を送信します。

2 = 常に確認を送信します。

注意注意注意注意 : アウトバウンド・ビジネス文書の場合は、インバウンド確認文書を使用可能にし(トランザクション・サブタイプ CBODI)、インバウンド・ビジネス文書の場合は、アウトバウンド確認文書を使用可能にします

(トランザクション・サブタイプ CBODO)。

実行エンジン 4-15

Page 206: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

OAG 確認ビジネス・オブジェクト文書の実装方法

「取引先設定」ウィンドウ、スクローリング・リージョンの左側

4-16 Oracle XML Gateway ユーザーズ・ガイド

Page 207: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

OAG 確認ビジネス・オブジェクト文書の実装方法

「取引先設定」ウィンドウ、スクローリング・リージョンの右側

注意注意注意注意 : ソース取引先事業所コードの値が、元のビジネス文書および対応する確認文書と同じであることを確認します。

確認メッセージを実装するように取引先を設定する手順の詳細は、「取引先の設定」(3-17 ページ)を参照してください。

実行エンジン 4-17

Page 208: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

OAG 確認ビジネス・オブジェクト文書の実装方法

4-18 Oracle XML Gateway ユーザーズ・ガイド

Page 209: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

メッセージ・キュ

5

メッセージ・キューメッセージ・キューメッセージ・キューメッセージ・キュー

この章では、XML Gateway で使用するキューについて説明します。

キューキューキューキューキューは、Oracle Advanced Queuing によって管理されるデータベースの表です。

XML Gateway では、一般的なエラー・キューの他に、プロセスの特に 2 つのポイントにおけるキューが使用されます。1 つ目のポイントは、Transport Agent モジュールと XML Gateway の間の、Transport Agent レベルです。2 つ目のポイントは、基本 Oracle E-Business Suite 製品または他のソース・プロセスと XML Gateway の間の取引レベルです。次の表は、これらのキューの詳細を示します。

キュー名キュー名キュー名キュー名 摘要摘要摘要摘要プロセスにおけるレベルプロセスにおけるレベルプロセスにおけるレベルプロセスにおけるレベルおよび位置および位置および位置および位置

ECX_INBOUND インバウンド・メッセージ・キューインバウンド・メッセージ・キューインバウンド・メッセージ・キューインバウンド・メッセージ・キュー :Transport Agent 経由でプロセスに

入ったすべてのメッセージ、またはAPI によって直接キューに配置され

たすべてのメッセージを保持します。

Transport Agent レベル

Transport Agent とインバウンド・ト

ランザクション・キューの間

ECX_OUTBOUND アウトバウンド・メッセージ・アウトバウンド・メッセージ・アウトバウンド・メッセージ・アウトバウンド・メッセージ・キューキューキューキュー :XML Gateway により、このキューで

書式化されたすべてのアウトバウンド・メッセージがエンキューされます。

Transport Agent レベル

XML Gateway と Transport Agent の間

ー 5-1

Page 210: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

キュー

詳細は、Oracle Database 文書の「Oracle Advanced Queuing」を参照してください。キューのステータスおよび内容の確認に関するトピックも含まれています。

アウトバウンド・キューアウトバウンド・キューアウトバウンド・キューアウトバウンド・キュー

アウトバウンド・メッセージ・キューアウトバウンド・メッセージ・キューアウトバウンド・メッセージ・キューアウトバウンド・メッセージ・キュー

アウトバウンド・メッセージ・キューは、XML Gateway と Transport Agent の間に配置されます。

XML Gateway により XML メッセージが作成され、このキューにエンキューされます。

次の手順 : Transport Agent によりメッセージがデキューされ、取引先に配信されます。

ECX_IN_OAG_Q インバウンド・トランザクション・インバウンド・トランザクション・インバウンド・トランザクション・インバウンド・トランザクション・キューキューキューキュー :ECX_INBOUND キューから送信さ

れ、Oracle Workflow によってこの

キューにエンキューされたインバウンド・メッセージを保持します。

これらのメッセージは、XML Gateway で処理されます。

中間レベルTransport Agent(既述の Transport Agent レベル)を通じてメッセージ

を受信した後、XML Gateway で処理

できるように、Oracle Workflow が

メッセージをこのキューにエンキューします。

WF_ERROR Workflow エラー・キューエラー・キューエラー・キューエラー・キュー :XML Gateway または WF BES で検出

されたエラー用です。取引先担当またはシステム管理者に通知が送信されます。

取引レベル

キュー名キュー名キュー名キュー名 摘要摘要摘要摘要プロセスにおけるレベルプロセスにおけるレベルプロセスにおけるレベルプロセスにおけるレベルおよび位置および位置および位置および位置

基本�アプリケーション�およびWorkflow業務イベント・�システム�

Oracle XML

Gateway

アウトバウンド・�メッセージ・�キュー�

Transport Agent

5-2 Oracle XML Gateway ユーザーズ・ガイド

Page 211: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

キュー

インバウンド・キューインバウンド・キューインバウンド・キューインバウンド・キュー

インバウンド・メッセージ・キューインバウンド・メッセージ・キューインバウンド・メッセージ・キューインバウンド・メッセージ・キュー

インバウンド・メッセージは、最初にインバウンド・メッセージ・キューに入れられます。

インバウンド・メッセージ・キューは、Transport Agent と Oracle Workflow 業務イベント・システムの間に配置されます。

インバウンド・メッセージ・キューにメッセージを配置するには、2 つの方法があります。

� Transport Agent がメッセージをエンキューします。

� API が直接キューに書き込みます。

詳細は、Oracle Database 文書の「Oracle Advanced Queuing」を参照してください。

完全なメッセージは、実行エンジンの項で説明する XML Gateway エンベロープのメッセージ・フォーマットに従って書式化されている必要があります。詳細は、「XML Gateway エンベロープ」(4-5 ページ)を参照してください。

次の手順 : Oracle Workflow 業務イベント・システムにより、インバウンド・メッセージが適切なインバウンド・トランザクション・キューにコピーされます。1 つのキューがシードされますが、業務上のニーズに合せて他のキューを定義することもできます。次の情報を参照してください。

インバウンド・トランザクション・キューインバウンド・トランザクション・キューインバウンド・トランザクション・キューインバウンド・トランザクション・キュー

このキューは、インバウンド・メッセージ用の 2 つ目のキューです。

インバウンド・メッセージ・キューを通してメッセージを受信した後、Oracle Workflow 業務イベント・システムにより、メッセージが、XML Gateway で処理できるようにこのキューにエンキューされます。

次の手順 : XML Gateway により、このキューに配置されたインバウンド・メッセージが処理されます。

エラー・キューエラー・キューエラー・キューエラー・キュー

XML Gateway または Oracle Workflow 業務イベント・システムによりエラーが検出されると、メッセージがエラー・キューにエンキューされます。Workflow リスナーはエラーをデ

OracleXML

Gateway

インバウンド・�トランザクション�

キュー�

Oracle Workflow

業務イベント・�システム�

インバウンド・�メッセージ・�キュー�

Transport Agent

メッセージ・キュー 5-3

Page 212: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

キュー

キューし、取引先担当にデータ・エラーの通知を送信したり、システム管理者にシステムまたはプロセス・エラーの通知を送信します。

Oracle Transport Agent のインバウンドの送信のインバウンドの送信のインバウンドの送信のインバウンドの送信 HTML ページページページページ設定した後に、メッセージをキューに配置できるかどうかを確認するには、Oracle Transport Agent のインバウンドの送信ページを使用します。このページを使用すると、HTML ページと同じ Web サーバー上で実行されている Oracle Transport Agent に、インバウンド HTML 文書を送信できます。

Oracle Transport Agent に含まれる ECXOTAInbound.htmlファイルを使用すると、Webサーバーから XML 文書を送信できます。文書は OTA によって受信され、ECX_INBOUNDキューに配置されます。この HTML ファイルは、テスト用に用意されています。本番稼働環境では使用しないでください。

ECXOTAInbound.htmlページを使用するには、Web ブラウザを開き、次の URL を入力します。

http://<サーバー名 >:<ポート >/OA_HTML/ECXOTAInbound.htm

ページでは、OTA メッセージング・プロトコルで使用されるパラメータを入力するように要求されます。OTA メッセージング・プロトコル・パラメータの情報は、Oracle MetaLink文書『Understanding the OTA (Transport Agent) Protocol』を参照してください。

5-4 Oracle XML Gateway ユーザーズ・ガイド

Page 213: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

キュー

メッセージ・キュー 5-5

Page 214: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

キュー

XML Gateway のメッセージ・フォーマットのメッセージ・フォーマットのメッセージ・フォーマットのメッセージ・フォーマットキュー内の XML メッセージは、XML Gateway の仕様に従って書式化される必要があります。この仕様は、メッセージのペイロードとともに XML Gateway エンベロープに含まれます。

このフォーマットは、オブジェクト・タイプ system.ecxmsgに記述されています。

詳細は、「XML Gateway エンベロープ」(4-5 ページ)を参照してください。

表表表表 5-1 Oracle Transport Agent のインバウンドの送信のインバウンドの送信のインバウンドの送信のインバウンドの送信 HTML ページ・フィールドページ・フィールドページ・フィールドページ・フィールド

列名列名列名列名 摘要摘要摘要摘要

TRANSPORT_PROTOCOL デフォルトは OXTA です。

TRANSPORT_PROTOCOL_VERSION

デフォルトは 1.0 です。

REQUEST_TYPE 「SEND」を選択します。

MESSAGE_ID トランザクションを識別する一意の参照番号を入力します。

MESSAGE_TYPE デフォルトは XML です。

MESSAGE_STANDARD デフォルトは OAG です。

TRANSACTION_TYPE (必須必須必須必須)トランザクション・タイプを入力します。たとえば、発注インバウンドの場合は PO を入力します。

TRANSACTION_SUBTYPE (必須必須必須必須)トランザクションのサブタイプを入力します。

DOCUMENT_NUMBER 文書番号を入力します。

PARTYID (オプション)送信者の取引先 ID を入力します。

PARTY_SITE_ID (必須必須必須必須)ソース取引先事業所コードを入力します(同じ名前の「取引先詳細」列と一致する必要があります)。

PROTOCOL_TYPE インバウンド・メッセージでは必要ありません。

PROTOCOL_ADDRESS REQUEST_TYPE が EME の場合にのみ必要となります。

USERNAME (必須必須必須必須)システムを受け入れるための有効なユーザー名を入力します。

PASSWORD (必須必須必須必須)入力したユーザー名に一致するパスワードを入力します。

ATTRIBUTE1 オプション

ATTRIBUTE2 オプション

ATTRIBUTE3 請求書インバウンドなどの受渡しトランザクションの場合にのみ必要です。

ATTRIBUTE4 オプション

ATTRIBUTE5 オプション

PAYLOAD メッセージのペイロードを入力します。

5-6 Oracle XML Gateway ユーザーズ・ガイド

Page 215: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle XML Gateway と Oracle Workflow 業務イベント・システム

6

Oracle XML Gateway とととと Oracle Workflow

業務イベント・システムの統合業務イベント・システムの統合業務イベント・システムの統合業務イベント・システムの統合

この章では、Workflow 業務イベント・システムの XML Gateway への統合について、また、特に次の項目について説明します。

� XML Gateway 標準項目タイプおよび XML Gateway エラー・プロセス項目タイプの使用

� Oracle の作成済メッセージ(インバウンドおよびアウトバウンド)の構成

Oracle XML Gateway とととと Oracle Workflow 業務イベント・業務イベント・業務イベント・業務イベント・システムの統合システムの統合システムの統合システムの統合

概要概要概要概要Oracle Workflow は、Oracle E-Business Suite のビジネス・プロセスをシームレスに統合するためのプロセス管理ツールです。Oracle Workflow 2.6 とともに業務イベント・システムが導入され、業務イベント・レベルでビジネス・プロセスの統合がサポートされます。

業務イベント・システムには、業務イベントを呼び出して、Oracle E-Business Suite で関連のある処理が発生していることを通知するための機能が必要です。たとえば、Oracle Purchasing の場合、関連のあるイベントは、発注の作成、変更、確認および削除です。

イベントの呼出しは、関連のあるイベントが発生したことを検知した場合にアクティビティを実行するように定義されたイベント・サブスクリプションによって補足されます。 Oracle Purchasing の場合のイベント・サブスクリプションの例として、新しいオーダーが作成されたか、または既存のオーダーが変更、確認、削除されたときに適切な仕入先にメッセージを送信することを挙げることができます。

イベント・サブスクリプションは、ルール機能によって管理されます。ルール機能の結果により、関連付けられているワークフロー・プロセスが実行されるかどうかが決定されます。イベント・サブスクリプションで実際に実行されるアクティビティは、定義されているワークフロー・プロセスに基づいて決定されます。

の統合 6-1

Page 216: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合

Oracle Workflow 業務イベント・システムと Oracle XML Gateway の統合では、業務イベントおよび対応するイベント・サブスクリプションは、Oracle E-Business Suite にシードおよび配置されます。取引先が定義された後、シード済業務イベントおよびイベント・サブスクリプションは、実装されるか、またはビジネス要件に関連付けられている特定のアクティビティを実行するように構成されます。

アウトバウンド・メッセージのアプリケーション業務イベントは、このメッセージに関係のある Oracle E-Business Suite のアプリケーション・モジュールによって呼び出され、定義されたイベント・サブスクリプションによって処理されます。B2B 統合のシード済イベント・サブスクリプションは、XML Gateway ルール機能またはワークフロー・デフォルト・ルール機能に基づきます。

XML Gateway ルール機能には、トランザクションに対して取引先が有効であるかどうかを判断するために使用されるトランザクション配送要機能が組み込まれています。XML Gateway ルール機能は、次のようになります。

図図図図 6-1 XML Gateway ルール機能

受信イベントの後に文書の送信機能が実行され、その後終了します。

ワークフロー・デフォルト・ルール機能では、トランザクション配送要機能をプロセス・アクティビティとして使用して、トランザクションに対して取引先が有効であるかどうかが判別されます。このプロセスのステップは、次のとおりです。受信イベントの後に、トランザクション配送要機能が実行されます。TRUE が返された場合、文書の送信機能が実行されます。FALSE が返された場合、プロセスは終了します。このプロセスは、次のとおりです。

受信� 文書の送信� 終了�

6-2 Oracle XML Gateway ユーザーズ・ガイド

Page 217: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合

図図図図 6-2 ワークフロー・デフォルト・ルール機能

いずれのルール機能を使用する場合でも、トランザクションに対して取引先が有効でない場合、メッセージは送信されません。

メッセージの生成を続ける前に、あらかじめトランザクションに対して取引先が有効であることがわかるため、XML Gateway ルール機能を使用することをお薦めします。ただし、ワークフロー・デフォルト・ルール機能には、ワークフロー・プロセスの視覚的な監査証跡が用意されています。

いずれのルール機能を使用する場合でも、Oracle XML Gateway では、Oracle E-Business Suite からデータが収集され、XML メッセージが作成されて、企業間(B2B)統合の取引先またはアプリケーション間(A2A)統合の他のアプリケーション・モジュールに配信されます。

企業間(B2B)統合の取引先から受信したインバウンド・メッセージは、インバウンド・キューにエンキューされます。プリケーション間(A2A)統合の他のアプリケーション・モジュールから受信したインバウンド・メッセージは、XML 文書の処理機能のイベント・メッセージ属性に格納され、XML Gateway 実行エンジンからアクセスされて処理されます。

XML Gateway のインバウンド・ルール機能は、B2B 統合で実行され、取引先の検証およびトランザクション・キューの識別が行われます。取引先が有効な場合、メッセージはトランザクション・キューにエンキューされて、XML Gateway 実行エンジンで処理されます。

XML Gateway 実行エンジンでは、取引先およびメッセージに関連付けられているメッセージ・マップの指示に従ってデータが処理されます。成功した場合、メッセージ・マップによ

終了(FALSE)�

FALSE

受信� トランザクション�配送要?

TRUE

文書の送信� 終了(TRUE)�

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-3

Page 218: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle Workflow Builder - 項目タイプ

りイベント詳細が設定されて、Oracle E-Business Suite にイベントが通知されます。メッセージにマップを適用することによって、イベント詳細を決定できるようになります。イベントは、インバウンド・メッセージに関係のあるアプリケーション・イベント・サブスクリプションによって処理されます。

Oracle Workflow 業務イベント・システムは、3 つの主要なコンポーネントで構成されています。これらのコンポーネントは、Oracle E-Business Suite を統合して、XML メッセージを作成したり、消し込むために使用されます。

� Oracle Workflow Builder。Oracle Workflow 標準項目タイプおよび Oracle XML Gateway 標準項目タイプが含まれています。標準項目タイプのコンポーネントを使用すると、ワークフロー・プロセスを定義できます。

� Oracle Workflow 管理者。新しいイベントおよびイベント・サブスクリプションを登録したり、シード済イベント・サブスクリプションを構成するために使用されます。

� Oracle Workflow 処理エンジン。ワークフロー・プロセスを実行するために使用されます。

Oracle Workflow Builder - 項目タイプ項目タイプ項目タイプ項目タイプXML Gateway では、次の 2 種類の標準項目タイプが配信されます。

� XML Gateway 標準項目タイプ

� XML Gateway エラー・プロセス項目タイプ

項目タイプとは、同じ項目属性(変数とも呼ばれる)を共有する特定のカテゴリのコンポーネントのグループです。

XML Gateway 標準項目タイプと XML Gateway エラー・プロセス項目タイプの両方とも、Oracle Workflow Builder を使用してアクセスできます。

項目タイプのコンポーネント項目タイプのコンポーネント項目タイプのコンポーネント項目タイプのコンポーネントすべての項目タイプで共通のコンポーネントは、次のとおりです。

� 属性

� プロセス・アクティビティ

� 通知アクティビティ

� 機能アクティビティ

� イベント・アクティビティ

� メッセージ

� 選択肢タイプ

6-4 Oracle XML Gateway ユーザーズ・ガイド

Page 219: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle Workflow Builder - 項目タイプ

ワークフロー・プロセスは、イベント・アクティビティ、機能アクティビティ、通知アクティビティ、プロセス・アクティビティで構成されています。メッセージとは、通知アクティビティで送信される情報です。参照タイプとは、有効な値の一覧です。属性とは、ワークフロー・プロセスのアクティビティ間でデータを共有する場合に使用される変数です。

詳細は、『Oracle Workflow ガイド』を参照してください。

XML Gateway 標準項目タイプ標準項目タイプ標準項目タイプ標準項目タイプXML Gateway 標準項目タイプは、機能アクティビティとイベント・アクティビティで構成されるツールキットです。B2B 統合要件に基づいて、作成済 XML メッセージ用の Oracle E-Business Suite で配信されるシードされたイベントおよびイベント・サブスクリプションを構成します。

また、機能アクティビティを使用して、A2A 統合要件をサポートするワークフロー・プロセスを定義することもできます。

機能アクティビティおよびイベント・アクティビティの詳細は、「XML Gateway 標準項目タイプ」(6-7 ページ)を参照してください。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-5

Page 220: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle Workflow Builder - 項目タイプ

XML Gateway エラー・プロセス項目タイプエラー・プロセス項目タイプエラー・プロセス項目タイプエラー・プロセス項目タイプXML Gateway エラー・プロセス項目タイプには、Oracle Workflow 業務イベント・システムまたは Oracle XML Gateway によって検出されたエラーを管理するためのエラー処理プロセスが含まれています。

Oracle Workflow では、データ・エラーの場合は取引先担当に、システム・エラーまたはプロセス・エラーの場合は XML Gateway システム管理者に通知が送信されます。取引先担当と XML Gateway システム管理者のコラボレーションを必要とするエラーの場合は、両方のパーティが協議して迅速に問題を解決するように、両方のパーティに対して通知が送信されます。

エラー処理プロセスの詳細は、「XML Gateway エラー・プロセス項目タイプ」(6-28 ページ)を参照してください。

6-6 Oracle XML Gateway ユーザーズ・ガイド

Page 221: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

E-Business Suite アプリケーションのモジュール固有項目タイプアプリケーションのモジュール固有項目タイプアプリケーションのモジュール固有項目タイプアプリケーションのモジュール固有項目タイプOracle の作成済メッセージに対して配信されるシードされたイベント・サブスクリプションは、Oracle E-Business Suite アプリケーションのモジュール固有項目タイプで配信されます。シードされたイベント・サブスクリプションは、XML Gateway 標準項目タイプで定義されたか、またはアプリケーション固有の要件をサポートするようにカスタマイズされた機能アクティビティを使用して構成できます。

シードされたイベント・サブスクリプションの設定方法の詳細は、「Oracle の作成済インバウンド・メッセージの構成」(6-51 ページ)または「Oracle の作成済アウトバウンド・メッセージの構成」(6-52 ページ)を参照してください。

XML Gateway 標準項目タイプ標準項目タイプ標準項目タイプ標準項目タイプXML Gateway 標準項目タイプは、機能アクティビティとイベント・アクティビティで構成されるツールキットです。開発者は、この機能アクティビティとイベント・アクティビティを使用して、B2B 統合要件をサポートする作成済 XML メッセージ用に、Oracle E-Business Suite によって提供されているシードされたイベント・サブスクリプションを構成するためのワークフロー・プロセスを構築することができます。

また、機能アクティビティを使用して、A2A 統合要件をサポートするワークフロー・プロセスを定義することもできます。

XML Gateway 標準項目タイプには、属性またはプロセスは含まれていません。属性とプロセスは、Oracle E-Business Suite アプリケーションのモジュール固有項目タイプに定義されています。モジュール固有項目タイプには、トランザクションのシードされたイベント・サブスクリプションのためのワークフロー・プロセスが含まれています。

通知およびメッセージは、Oracle E-Business Suite アプリケーションのモジュール固有項目タイプに含まれており、XML Gateway エラー・プロセス項目タイプを使用して定義されます。

「XML Gateway エラー・プロセス項目タイプ」(6-28 ページ)を参照してください。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-7

Page 222: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

機能機能機能機能

XML Gateway 標準項目タイプには、次の表に示す 5 つの機能アクティビティがあります。

表表表表 6-1 XML Gateway 標準項目タイプ機能アクティビティ標準項目タイプ機能アクティビティ標準項目タイプ機能アクティビティ標準項目タイプ機能アクティビティ

機能表示名機能表示名機能表示名機能表示名

A2AまたはまたはまたはまたはB2B

インバウンドインバウンドインバウンドインバウンドまたはまたはまたはまたはアウトバウンドアウトバウンドアウトバウンドアウトバウンド 目的目的目的目的

XML 文書の処理 A2A インバウンド XML Gateway を起動して、イベント・

メッセージ属性のインバウンド・メッセージを処理します。

XML 文書の生成 A2A アウトバウンド XML メッセージを生成してイベント・メッ

セージ属性に格納します。取引先の検証は必要ありません。

6-8 Oracle XML Gateway ユーザーズ・ガイド

Page 223: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

アプリケーション間(A2A)のデータ交換は、情報システム間でのデータの共有または同期化を行うために、企業内外で行われます。A2A 統合には取引先は含まれません。A2A 交換の例として、GL 連結用にデータを Oracle Payables モジュールから Oracle General Ledgerに移動することを挙げることができます。

企業間(B2B)のデータ交換は、取引先の検証が必要になるため、企業の外部で行われます。無効な取引先とのデータの送受信は行われません。B2B 交換の例として、発注を仕入先に送信することを挙げることができます。

インバウンド B2B 交換を管理するワークフロー・プロセスはありません。XML Gateway 実行エンジンでは、受信キューに直接サブスクリプションします。

機能は、その機能表示名で呼ばれます。次の表は、参考用の内部機能名を示します。

XML Gateway 標準項目タイプによってサポートされている各機能の説明は、次のとおりです。

取引先 XML 文書の生成 B2B アウトバウンド 取引先に対してトランザクションが使用可能になっているかを検証して XML メッ

セージを生成し、イベント・メッセージ属性に格納します。

文書の送信 B2B アウトバウンド XML メッセージを生成し、アウトバウン

ド・キューにエンキューします。

トランザクション配送要 B2B アウトバウンド 取引先に対してトランザクションが使用可能になっているかを検証します。

XML の変換 A2AまたはB2B

インバウンドまたはアウトバウンド

XML 対 XML 変換を可能にします。

表表表表 6-2 XML Gateway 標準項目タイプ機能の表示名標準項目タイプ機能の表示名標準項目タイプ機能の表示名標準項目タイプ機能の表示名

機能表示名機能表示名機能表示名機能表示名 内部名内部名内部名内部名

XML 文書の処理 PROCESSXML

XML 文書の生成 GETXML

取引先 XML 文書の生成 GETTPXML

文書の送信 DOCUMENT_SEND

トランザクション配送要 DELIVREQUIRED

XML の変換 XMLTOXML

表表表表 6-1 XML Gateway 標準項目タイプ機能アクティビティ標準項目タイプ機能アクティビティ標準項目タイプ機能アクティビティ標準項目タイプ機能アクティビティ (続き)(続き)(続き)(続き)

機能表示名機能表示名機能表示名機能表示名

A2AまたはまたはまたはまたはB2B

インバウンドインバウンドインバウンドインバウンドまたはまたはまたはまたはアウトバウンドアウトバウンドアウトバウンドアウトバウンド 目的目的目的目的

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-9

Page 224: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

XML 文書の処理(インバウンド・メッセージの文書の処理(インバウンド・メッセージの文書の処理(インバウンド・メッセージの文書の処理(インバウンド・メッセージの A2A に適用)に適用)に適用)に適用)

XML 文書の処理機能により XML Gateway 実行エンジンが起動され、イベント・メッセージ属性のインバウンド・メッセージが処理されます。XML Gateway 実行エンジンでは、メッセージに関連付けられているメッセージ・マップに従ってメッセージを処理し、インバウンド・メッセージの処理に成功したことを示す業務イベントを呼び出して終了します。

業務イベントを呼び出すプロシージャ・コール処理の詳細は、「プロシージャ・コール : プロシージャの実行」(2-102 ページ)を参照してください。

XML 文書の処理機能は、A2A シナリオのインバウンド・メッセージにのみ使用されます。インバウンド・メッセージが受信キューに達すると、B2B シナリオでは、XML Gateway 実行エンジンが自動的に起動されます。

次の表は、XML 文書の処理機能の属性を示します。属性値は、業務イベントや他の機能アクティビティによって提供されるか、または定数として設定される場合があります。

6-10 Oracle XML Gateway ユーザーズ・ガイド

Page 225: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

XML 文書の生成(アウトバウンド・メッセージの文書の生成(アウトバウンド・メッセージの文書の生成(アウトバウンド・メッセージの文書の生成(アウトバウンド・メッセージの A2A に適用)に適用)に適用)に適用)

XML 文書の生成機能は、Oracle E-Business Suite からのデータの取出しに使用されます。Oracle E-Business Suite から取り出された XML メッセージのデータは、イベント・メッセージ属性に保存されます。イベント・メッセージは、別の Oracle E-Business Suite アプリケーション・モジュールまたは WF_OUT エージェントに送信するなどの、それ以後のワークフローの指示に従って処理されます。

XML 文書の生成機能と取引先 XML 文書の生成機能の違いは、XML 文書の生成機能の場合、A2A 統合に取引先が含まれないため、取引先の検証が必要とされない点です。

XML 文書の生成機能アクティビティは、ワークフロー・プロセスで使用されます。ワークフロー・プロセスが存在しない環境の場合、ECX_STANDARD 生成機能が、「ワークフロー定義イベント」ウィンドウの「関数の生成」フィールドから呼び出されます。この機能の詳細は、次のとおりです。

ECX_STANDARD

PL/SQL 構文構文構文構文

機能の生成

(p_event_name in varchar2, p_event_key in varchar2, p_parameter_list in wf_parameter_list_t)return CLOB;

表表表表 6-3 XML 文書の処理機能の属性文書の処理機能の属性文書の処理機能の属性文書の処理機能の属性

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

1 マップ・コード Message Designer で定義されたマップ・コードであ

り、取引先に対して使用可能になっているビジネス文書に関連付けられたメッセージ・マップを一意に識別する取引先に関連付けられています。

2 イベント・メッセージ イベント・メッセージには、ヘッダー・プロパティと同様、イベント名、イベント・キーおよびエラー・データのイベント・データが含まれています。イベント・メッセージ属性は、XML Gateway 実行

エンジンで処理するためにインバウンド・メッセージを保存する必要があります。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-11

Page 226: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

引数(入力)引数(入力)引数(入力)引数(入力)

p_event_name トランザクションに関連付けられている業務イベントの一意の識別子

p_event_key 業務イベントに関連付けられている Oracle E-Business Suite のビジネス文書の一意の識別子

p_parameter_list 文書選択基準を含むパラメータ・リスト

6-12 Oracle XML Gateway ユーザーズ・ガイド

Page 227: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

次の表は、XML 文書の生成機能の属性を示します。属性値は、業務イベントや他の機能アクティビティによって提供されるか、または定数として設定される場合があります。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-13

Page 228: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

取引先取引先取引先取引先 XML 文書の生成(アウトバウンド・メッセージの文書の生成(アウトバウンド・メッセージの文書の生成(アウトバウンド・メッセージの文書の生成(アウトバウンド・メッセージの B2B に適用)に適用)に適用)に適用)

取引先 XML 文書の生成機能は、Oracle E-Business Suite からのデータの取出しに使用されます。Oracle E-Business Suite から取り出された XML メッセージのデータは、イベント・メッセージ属性に保存されます。イベント・メッセージは、別の Oracle E-Business Suite アプリケーション・モジュールまたは WF_OUT エージェントに送信するなどの、それ以後のワークフローの指示に従って処理されます。

表表表表 6-4 XML 文書の生成機能の属性文書の生成機能の属性文書の生成機能の属性文書の生成機能の属性

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

1 文書 ID ビジネス文書の一意の識別子です。文書番号または関連データベース・キーである場合もありますが、いずれもトランザクションに対して一意です。文書 ID は、メッセージ・マップで選択基準として使用されない限

り、XML 文書機能ではオプションとなっています。

2 マップ・コード Message Designer で定義されたマップ・コードであり、取引先に

対して使用可能になっているビジネス文書に関連付けられたメッセージ・マップを一意に識別する取引先に関連付けられています。マップ・コードは、XML 文書の生成機能には必須です。

3 イベント名 業務イベントの一意の識別子です。命名規則は、oracle.apps.<製品コード >.<コンポーネント >.<オブジェク

ト >.<イベント >です。

イベント名は、戻り値を保存するため XML 文書の生成機能には必

須です。

4 イベント・キー イベントのインスタンスを表す一意の識別子です。イベント名、イベント・キーおよびイベント・データを組み合せることによって、そのイベントで何が発生したかを表すことができます。イベント・キーは、戻り値を保存するため XML 文書の生成機能に

は必須です。

5 パラメータ 1 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

6 パラメータ 2 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

7 パラメータ 3 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

8 パラメータ 4 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

9 パラメータ 5 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

10 イベント・メッセージ イベント・メッセージには、ヘッダー・プロパティと同様、イベント名、イベント・キーおよびエラー・データのイベント・データが含まれています。イベント・メッセージは、戻り値を保存するため XML 文書の生成

機能には必須です。

6-14 Oracle XML Gateway ユーザーズ・ガイド

Page 229: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

取引先 XML 文書の生成機能と XML 文書の生成機能の違いは、取引先 XML 文書の生成機能の場合、有効な取引先を必要とする B2B 統合で使用されている点です。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-15

Page 230: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

次の表は、取引先 XML 文書の生成機能の属性を示します。属性値は、業務イベントや他の機能アクティビティによって提供されるか、または定数として設定される場合があります。

表表表表 6-5 取引先取引先取引先取引先 XML 文書の生成機能の属性文書の生成機能の属性文書の生成機能の属性文書の生成機能の属性

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

1 トランザクション・タイプ

XML Gateway「トランザクションの定義」フォームで定義された

トランザクション・タイプです。トランザクション・タイプは、マップ・コードから導出できるため、取引先 XML 文書の生成機能ではオプションとなっています。

2 トランザクション・サブタイプ

XML Gateway の「トランザクションの定義」フォームで定義され

たトランザクション・サブタイプです。トランザクション・サブタイプは、マップ・コードから導出できるため、取引先 XML 文書の生成機能ではオプションとなっていま

す。

3 文書 ID ビジネス文書の一意の識別子です。文書番号または関連データベース・キーである場合もありますが、いずれもトランザクションに対して一意です。文書 ID は、メッセージ・マップで選択基準として使用されない限

り、XML 文書機能ではオプションとなっています。

4 パーティ・サイト ID Oracle E-Business Suite で定義された取引先の一意の識別子です。

パーティ・サイト ID は、取引先 XML 文書の生成機能には必須で

す。

5 パーティ ID Oracle E-Business Suite で定義された取引先の一意の識別子です。

このフィールドはオプションです。

6 イベント名 業務イベントの一意の識別子です。命名規則は、oracle.apps.<製品コード >.<コンポーネント >.<オブジェクト >.<イベント >です。イベント名は、戻り値を保存するため取引先 XML 文書の生成機能

には必須です。

7 イベント・キー イベントのインスタンスを表す一意の識別子です。イベント名、イベント・キーおよびイベント・データを組み合せることによって、そのイベントで何が発生したかを表すことができます。イベント・キーは、戻り値を保存するため取引先 XML 文書の生成

機能には必須です。

8 パラメータ 1 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

9 パラメータ 2 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

10 パラメータ 3 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

11 パラメータ 4 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

12 パラメータ 5 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

6-16 Oracle XML Gateway ユーザーズ・ガイド

Page 231: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

文書の送信(アウトバウンド・メッセージの文書の送信(アウトバウンド・メッセージの文書の送信(アウトバウンド・メッセージの文書の送信(アウトバウンド・メッセージの B2B に適用)に適用)に適用)に適用)

文書の送信機能は、アウトバウンド・メッセージの作成を開始するために使用されます。XML メッセージはただちに作成されるか、または送信モード属性の設定により遅延されます。この機能により XML Gateway が起動され、Oracle E-Business Suite からのデータ収集、および XML メッセージの生成とエンキューが行われます。

「遅延」送信モードでは、ワークフローのバックグランド・エンジンへの処理が遅延されます。

「即時」送信モードでは、XML Gateway 実行エンジンが起動され、データが Oracle E-Business Suite で受信されたらすぐに XML メッセージが作成されます。この場合、イベントが呼び出されてからデータが取り出される前にデータが変更される競合状態を避けるため、データのスナップショットがとられます。

文書の送信機能は、XML Gateway ルール機能またはワークフロー・デフォルト・ルール機能を使用して、トランザクションに対して使用可能になっている取引先に XML メッセージが確実に送信されるようにモデル化される場合があります。

13 イベント・メッセージ イベント・メッセージには、ヘッダー・プロパティと同様、イベント名、イベント・キーおよびエラー・データのイベント・データが含まれています。イベント・メッセージは、戻り値を保存するため取引先 XML 文書

の生成機能には必須です。

14 パーティ・タイプ XML Gateway の「取引先設定」ウィンドウで定義されたパー

ティ・タイプです。

表表表表 6-5 取引先取引先取引先取引先 XML 文書の生成機能の属性文書の生成機能の属性文書の生成機能の属性文書の生成機能の属性 (続き)(続き)(続き)(続き)

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-17

Page 232: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

次の表は、文書の送信機能の属性を示します。属性値は、業務イベントや他の機能アクティビティによって提供されるか、または定数として設定される場合があります。

表表表表 6-6 文書の送信機能の属性文書の送信機能の属性文書の送信機能の属性文書の送信機能の属性

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

1 トランザクション・タイプ

XML Gateway「トランザクションの定義」フォームで定義された

トランザクション・タイプです。

2 トランザクション・サブタイプ

XML Gateway の「トランザクションの定義」フォームで定義され

たトランザクション・サブタイプです。

6-18 Oracle XML Gateway ユーザーズ・ガイド

Page 233: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

トランザクション配送要トランザクション配送要トランザクション配送要トランザクション配送要 ?(アウトバウンド・メッセージの(アウトバウンド・メッセージの(アウトバウンド・メッセージの(アウトバウンド・メッセージの B2B に適用)に適用)に適用)に適用)

トランザクション配送要機能は、取引先がトランザクションに対して使用可能になっているかどうかを判別するために使用されます。取引先の検証が必要とされる B2B 統合で使用されます。この機能では、TRUE または FALSE が返されます。

トランザクション配送要機能は、XML Gateway ルール機能にも埋め込まれています。この機能により FALSE が返された場合は、ワークフロー・プロセスは実行されません。

Oracle E-Business Suite のアプリケーション・モジュールによって送信されるシードされたイベント・サブスクリプションでは、XML Gateway ルール機能やワークフロー・デフォルト・ルール機能も使用できます。XML Gateway ルール機能では、取引先がトランザクションに対して使用可能になっているかどうかがあらかじめ判別され、ルール機能の結果がTRUE の場合のみ、関連するワークフロー・プロセスが実行されるため、より効率的です。このため、この方法を使用することをお薦めします。

3 文書 ID ビジネス文書の一意の識別子です。文書番号または関連データベース・キーである場合もありますが、いずれもトランザクションに対して一意です。

4 パーティ・サイト ID Oracle E-Business Suite で定義された取引先の一意の識別子です。

5 パーティ ID Oracle E-Business Suite で定義された取引先の一意の識別子です。

このフィールドはオプションです。

6 パラメータ 1 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

7 パラメータ 2 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

8 パラメータ 3 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

9 パラメータ 4 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

10 パラメータ 5 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

11 送信モード 「遅延」または「即時」を選択します。

12 メッセージ ID 各アウトバウンド・メッセージに対して、XML Gateway 実行エン

ジンによって提供される一意の識別子です。

13 パーティ・タイプ XML Gateway の「取引先設定」ウィンドウで定義されたパー

ティ・タイプです。

表表表表 6-6 文書の送信機能の属性文書の送信機能の属性文書の送信機能の属性文書の送信機能の属性(続き)(続き)(続き)(続き)

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-19

Page 234: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

次の表は、トランザクション配送要機能の属性を示します。属性値は、業務イベントや他の機能アクティビティによって提供されるか、または定数として設定される場合があります。

表表表表 6-7 トランザクション配送要機能の属性トランザクション配送要機能の属性トランザクション配送要機能の属性トランザクション配送要機能の属性

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

1 トランザクション・タイプ

XML Gateway「トランザクションの定義」フォームで定義された

トランザクション・タイプです。

2 トランザクション・サブタイプ

XML Gateway の「トランザクションの定義」フォームで定義され

たトランザクション・サブタイプです。

6-20 Oracle XML Gateway ユーザーズ・ガイド

Page 235: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

XML の変換の変換の変換の変換

XML の変換機能は、XML 対 XML 変換に使用されます。

3 パーティ・サイト ID Oracle E-Business Suite で定義された取引先サイトの一意の識別子

です。

4 パーティ ID Oracle E-Business Suite で定義された取引先の一意の識別子です。

5 パーティ・タイプ XML Gateway の「取引先設定」ウィンドウで定義されたパー

ティ・タイプです。

6 確認フラグ 「取引先設定」ウィンドウの「文書確認」フラグです。確認の送受信が示されます。「確認フラグ」は、トランザクション配送要 ?(DELIVREQUIRED)機能アクティビティに追加されています。

ECX_CONFIRMATION_FLAG に 1(エラーが検出された場合、確

認を送信)または 2(常に確認を送信)が設定されている場合、イ

ンバウンド確認を待つようにアウトバウンド・ビジネス文書のワークフローを設計できます。「確認」フラグは、「取引先設定」ウィンドウを使用して定義された取引先の属性です。このワークフローのデザイン方法は、アウトバウンド・ビジネス文書とインバウンド確認をリンクする場合に使用します。この属性はオプションです。

表表表表 6-7 トランザクション配送要機能の属性トランザクション配送要機能の属性トランザクション配送要機能の属性トランザクション配送要機能の属性(続き)(続き)(続き)(続き)

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-21

Page 236: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

XML の変換機能では、指定した入力 XML 文書が別の XML 文書に変換されます。このアクティビティに対する入力パラメータは、マップ・コードおよび入力 XML 文書です。このアクティビティによる出力は、変換された XML 文書です。実行エンジンでは、マップの定義に従って変換が実行されます。

次の表は、XML の変換機能の属性を示します。イベント・メッセージ・インバウンド属性は入力 XML 情報を保存し、イベント・メッセージ・アウトバウンド属性は変換された XML情報を保存します。

表表表表 6-8 XML の変換機能の属性の変換機能の属性の変換機能の属性の変換機能の属性

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

1 マップ・コード 「取引先詳細」フォームで定義されたトランザクションに関連付けられているマップ・コードです。

2 イベント・メッセージ・インバウンド

入力 XML メッセージです。

3 イベント・メッセージ・アウトバウンド

変換された XML メッセージです。

6-22 Oracle XML Gateway ユーザーズ・ガイド

Page 237: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

イベントイベントイベントイベントXML Gateway 標準項目タイプには、既存のワークフロー・プロセスから業務イベントを呼び出すイベントが含まれています。

PL/SQL コードから業務イベントを直接呼び出す別の方法もあります。詳細は、『Oracle Workflow ガイド』を参照してください。

文書配送イベントの呼出し文書配送イベントの呼出し文書配送イベントの呼出し文書配送イベントの呼出し

文書配送イベントの呼出しは、既存のワークフロー・プロセスから業務イベントを呼び出すために使用されます。この機能を使用すると、既存のワークフロー・プロセスと Oracle XML Gateway をシームレスに統合して、アウトバウンド XML メッセージを作成できるようになります。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-23

Page 238: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

次の表は、文書配送イベントの呼出しの属性を示します。属性値は、機能アクティビティによって提供されるか、または定数として設定される場合があります。

表表表表 6-9 文書配送イベントの呼出しの属性文書配送イベントの呼出しの属性文書配送イベントの呼出しの属性文書配送イベントの呼出しの属性

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

1 トランザクション・タイプ

XML Gateway「トランザクションの定義」フォームで定義された

トランザクション・タイプです。

2 トランザクション・サブタイプ

XML Gateway の「トランザクションの定義」フォームで定義され

たトランザクション・サブタイプです。

6-24 Oracle XML Gateway ユーザーズ・ガイド

Page 239: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

選択肢タイプ選択肢タイプ選択肢タイプ選択肢タイプXML Gateway 標準項目タイプでは、文書の送信機能で使用される送信モードの参照タイプがサポートされています。これにより、イベント・サブスクリプションをただちに処理するか、または遅延モードで処理するかが指定されます。

3 文書 ID ビジネス文書の一意の識別子です。文書番号または関連データベース・キーである場合もありますが、いずれもトランザクションに対して一意です。

4 パーティ・サイト ID Oracle E-Business Suite で定義された取引先の一意の識別子です。

5 パーティ ID Oracle E-Business Suite で定義された取引先の一意の識別子です。

6 パラメータ 1 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

7 パラメータ 2 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

8 パラメータ 3 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

9 パラメータ 4 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

10 パラメータ 5 オプションの変数。この属性は、メッセージ・マップで使用される場合にのみ使用されます。

表表表表 6-9 文書配送イベントの呼出しの属性文書配送イベントの呼出しの属性文書配送イベントの呼出しの属性文書配送イベントの呼出しの属性(続き)(続き)(続き)(続き)

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-25

Page 240: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

6-26 Oracle XML Gateway ユーザーズ・ガイド

Page 241: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 標準項目タイプ

通信方法通信方法通信方法通信方法

� E メール配送

� HTTP 配送

� HTTPS(安全な HTTP)

� 電子的な配送は無し

� Oracle Integration Server

� Oracle Transport Agent (HTTP)

� Oracle Transport Agent (HTTPS)

確認値確認値確認値確認値

確認値は、トランザクション配送要機能アクティビティで使用されます。

� ビジネス・オブジェクト文書配送の確認なし

� 常に、ビジネス・オブジェクト文書の確認を送信

� エラー発生時のみビジネス・オブジェクト文書の確認を返送

パーティ・タイプパーティ・タイプパーティ・タイプパーティ・タイプ

パーティ・タイプは、取引先ロールの取得機能アクティビティおよび文書の送信機能アクティビティで使用されます。

� 銀行

� 顧客

� 運送業者

� エクスチェンジ

� 社内

� 仕入先

� XML Gateway スタンドアロン

送信モード送信モード送信モード送信モード

送信モードは、文書の送信機能アクティビティで使用されます。

� 遅延

「遅延」モードでは、XML Gateway 実行エンジンに、ワークフローのバックグランド・エンジンへのメッセージ作成が遅延することが通知されます。また、このモードは、非同期処理としても機能します。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-27

Page 242: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

� 即時

「即時」モードでは、XML Gateway 実行エンジンに、データが Oracle E-Business Suiteで受信されたらすぐに XMLメッセージを作成しエンキューするように通知されます。また、このモードは、同期処理としても機能します。

同期処理により、イベントが呼び出されてからデータが抽出される前にデータが変更される競合状態を避けることができます。

XML Gateway エラー・プロセス項目タイプエラー・プロセス項目タイプエラー・プロセス項目タイプエラー・プロセス項目タイプXML Gateway エラー・プロセス項目タイプには、Oracle Workflow 業務イベント・システムまたは Oracle XML Gateway によって検出されたエラーを管理するためのエラー処理プロセスが含まれています。

Oracle Workflow では、データ・エラーの場合は取引先担当に、システム・エラーまたはプロセス・エラーの場合は XML Gateway システム管理者に通知が送信されます。取引先担当と XML Gateway システム管理者のコラボレーションを必要とするエラーの場合は、両方のパーティが協議して迅速に問題を解決するように、両方のパーティに対して通知が送信されます。

通知を受け取ったシステム管理者は、失敗したプロセスを再試行、再処理または異常終了できます。システム管理者がエラー原因を修正できる場合、システム管理者はエラーを修正して、失敗したプロセスを再試行または再処理します。

「再試行」という用語は、アウトバウンド・メッセージで使用されます。ワークフロー再試行機能は、この要件をサポートするために使用されます。ワークフロー再試行機能は、失敗した場所から再開します。

「再処理」という用語は、インバウンド・メッセージで使用されます。ECX 再処理インバウンド機能は、この再処理機能をサポートするために使用されます。この機能は、ECX_DOCLOGS 表に格納されているインバウンド・メッセージのコピーを使用して再開します。

エラーの原因が、取引先から受け取ったメッセージ・データの正確性か、または取引先アプリケーションのデータ設定の正確性にある場合、システム管理者は、失敗したプロセスを異常終了し、取引先が修正したメッセージを送信するまで待機するか(インバウンド・メッセージの場合)、または取引先がデータ設定を修正するまで待機します(アウトバウンド・メッセージの場合)。

属性属性属性属性属性(変数とも呼ばれる)は、XML Gateway エラー・プロセス項目タイプで定義された機能アクティビティ、イベント・アクティビティ、通知アクティビティおよびプロセス・アクティビティをサポートするために使用されます。

6-28 Oracle XML Gateway ユーザーズ・ガイド

Page 243: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

プロセスプロセスプロセスプロセスXML Gateway エラー・プロセス項目タイプでは、次のエラー処理プロセスがサポートされています。

� (FYI)メッセージ配送エラー

� デフォルト・エラー・プロセス

� ECX エンジン通知プロセス

� ECX メイン・エラー・プロセス

� ECX メイン・インバウンド・エラー・プロセス

� ECX メイン・アウトバウンド・エラー・プロセス

� インバウンド・メッセージのエラー処理

� アウトバウンド・メッセージのエラー処理

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-29

Page 244: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

エラー処理プロセスの関連を次に示します。インバウンド・メッセージ・エラーの場合、ECX メイン・エラー・プロセスでは、ECX メイン・インバウンド・エラー・プロセスがコールされます。アウトバウンド・メッセージ・エラーの場合は、ECX メイン・インバウンド・エラー・プロセスがコールされます。インバウンドの場合、ECX メイン・インバウンド・エラー・プロセスでは、インバウンド・メッセージのエラー処理プロセスがコールされます。アウトバウンドの場合、ECX メイン・アウトバウンド・エラー・プロセスでは、アウ

6-30 Oracle XML Gateway ユーザーズ・ガイド

Page 245: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

トバウンド・メッセージのエラー処理プロセスがコールされます。アウトバウンド・メッセージのエラー処理プロセスでは、デフォルト・エラー・プロセスがコールされます。

XML Gateway エラー・プロセス項目タイプでサポートされている(前述の機能順に挙げられている)各プロセスの説明は、次のとおりです。

ECX メイン・エラー・プロセスメイン・エラー・プロセスメイン・エラー・プロセスメイン・エラー・プロセス

XML Gateway 実行エンジンがエラーを検出した場合、ECX メイン・エラー・プロセスは、エラーの受信イベント(図のノード 1 を参照)によって起動されます。また、XML Gateway 標準項目タイプを使用して生成されたワークフロー・プロセスに含まれているエラーの場合、ECX メイン・エラー・プロセスは、ワークフロー(ノード 2)によって起動されます。

ノード 3 では、プロセスによって、エラーがインバウンド・メッセージ関連か、またはアウトバウンド・メッセージ関連かが判断されます。インバウンド・メッセージ関連のエラーの場合、ECX メイン・エラー・プロセスでは、ECX メイン・インバウンド・エラー・プロセス(ノード 4)がコールされます。アウトバウンド・メッセージ関連のエラーの場合は、ECX メイン・アウトバウンド・エラー・プロセス(ノード 5)がコールされます。

ECXメイン・エラー・プロセス�

インバウンド� アウトバウンド�

ECXメイン・エラー・インバウンド� ECXメイン・エラー・アウトバウンド�

インバウンド・メッセージの�エラー処理�

アウトバウンド・メッセージの�エラー処理�

デフォルト・エラー・プロセス�

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-31

Page 246: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

ECX メイン・インバウンド・エラー・プロセスメイン・インバウンド・エラー・プロセスメイン・インバウンド・エラー・プロセスメイン・インバウンド・エラー・プロセス

次の図に示すように、ECX メイン・インバウンド・エラー・プロセスでは、XML Gateway実行エンジンまたは Workflow Engine からエラー情報(ノード 1)を取得して、インバウンド・メッセージのエラー処理プロセス(ノード 2)がコールされます。

インバウンド・メッセージのエラー処理インバウンド・メッセージのエラー処理インバウンド・メッセージのエラー処理インバウンド・メッセージのエラー処理

XML Gateway 実行エンジンまたは Workflow Engine によってエラーが検出されると、XML Gateway システム管理者か取引先担当、またはエラーの性質によってはその両方に通知が送信されます。

ワークフロー・メーラーが使用可能な場合は、ターゲット受取者に E メールで通知が送信されます。システム管理者の E メール・アドレスは、「ECX: システム管理者 E メール・アドレ

エラーの受信�

開始�

テキストの比較�

等しい�

(デフォルト)�

ECXメイン・インバウンド・�エラー・プロセス�

ECXメイン・アウトバウンド・�エラー・プロセス�

終了�

終了�

終了�開始� ECXインバウンド・�エラー詳細の取得�

インバウンド・メッセージの�エラー処理�

6-32 Oracle XML Gateway ユーザーズ・ガイド

Page 247: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

ス」システム・プロファイルに定義されています。取引先担当の E メール・アドレスは、「取引先」フォームに定義されています。

通知のターゲット受取者は、エラー・メッセージ用にあらかじめ定義されているため変更できません。

インバウンド・メッセージのエラー処理プロセスでは、検出されたエラーのタイプがチェックされます(ノード 1)。ターゲット受取者が取引先担当であることがエラー・タイプによって示される場合、通知は取引先(ノード 2)に送信され、失敗したプロセスが終了し、エラー・プロセスも終了します。

ノード 1 で行われたチェックの結果、ターゲット受取者が取引先担当のみであることが示されなかった場合、プロセスでは、再度エラー・タイプがチェックされます(ノード 3)。ターゲット受取者が XML Gateway システム管理者である場合は、システム管理者に通知され

(ノード 4)、システム管理者は、失敗したインバウンド・プロセスを再処理するか(ノード5)、または異常終了する(ノード 6)ことができます。再処理は、ECX_DOCLOGS 表に格納されているインバウンド・メッセージのコピーを使用して再開されます。

ターゲット受取者が取引先担当と XML Gateway システム管理者の両方である場合は、2 つの通知が各パーティに 1 つずつ送信されます(ノード 7、ノード 8)。

開始� 取引先ロールの�取得�

FALSE

終了�

TRUEテキストの比較�

等しい�

取引先�インバウンド・�エラー通知�

終了�

(デフォルト)�システム管理者�ロールの取得�

テキストの比較�

�等しい�等しい�

取引先�インバウンド・�エラー通知�

ECX外部イベント�通知�

異常終了� 再処理�

AND�

プロセス・イベントの�再試行�

(デフォルト)�ECX外部イベント�

通知�

再処理�プロセス・イベントの�

再試行�

異常終了�

終了�

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-33

Page 248: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

ECX メイン・アウトバウンド・エラー・プロセスメイン・アウトバウンド・エラー・プロセスメイン・アウトバウンド・エラー・プロセスメイン・アウトバウンド・エラー・プロセス

ECX メイン・アウトバウンド・エラー・プロセスでは、エラーが初期化され(ノード 1)、XML Gateway 実行エンジンまたは Workflow Engine からエラー情報が取得され(ノード2)、アウトバウンド・メッセージのエラー処理プロセスがコールされます(ノード 3)。

アウトバウンド・メッセージのエラー処理アウトバウンド・メッセージのエラー処理アウトバウンド・メッセージのエラー処理アウトバウンド・メッセージのエラー処理

XML Gateway 実行エンジンまたは Workflow Engine によってエラーが検出されると、XML Gateway システム管理者か取引先担当、またはエラーの性質によってはその両方に通知が送信されます。

ワークフロー・メーラーが使用可能な場合は、ターゲット受取者に E メールで通知が送信されます。システム管理者の E メール・アドレスは、「ECX: システム管理者 E メール・アドレス」システム・プロファイルに定義されています。取引先担当の E メール・アドレスは、

「取引先」フォームに定義されています。

通知のターゲット受取者は、エラー・メッセージ用にあらかじめ定義されているため変更できません。

アウトバウンド・メッセージのエラー処理プロセスでは、エラー・タイプをチェックして、ターゲット受取者が取引先担当かどうかが判断されます(ノード 1)。ターゲット受取者が取引先担当である場合、通知は取引先に送信され(ノード 2)、失敗したプロセスが異常終了されます。

ターゲット受取者が XML Gateway システム管理者である場合は、デフォルト・エラー・プロセスがコールされます(ノード 3)。

ターゲット受取者が取引先担当と XML Gateway システム管理者の両方である場合、通知は、取引先担当とコールされるデフォルト・エラー・プロセスに送信されます。

アウトバウンド・メッセージの�エラー処理�

開始� 初期化エラー� ECXアウトバウンド・�エラー詳細の取得�

終了�

6-34 Oracle XML Gateway ユーザーズ・ガイド

Page 249: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

((((FYI)配送エラー・プロセス)配送エラー・プロセス)配送エラー・プロセス)配送エラー・プロセス

(FYI)配送プロセスは、メッセージの生成を開始したワークフロー・プロセスにメッセージ配送ステータスをレポートする場合に、Oracle Transport Agent(または他のメッセージ・システム)で使用されます。

oracle.apps.ecx.processing.message.callbackイベントの対応するイベント・サブスクリプション(XML Gateway でシード済)では、XML Gateway 標準エラー・プロセス項目タイプの FYI_MESSAGE_DELIVERY_ERROR エラー処理プロセスが開始されます。エラーのイベントでは、通知はシステム管理者に送信されます。システム管理者は、エラー修正後にメッセージを「再送」するか、または処理が不要な場合は通知を「無視」します。

開始� 取引先ロールの�取得�

(デフォルト)�テキストの比較�

取引先�アウトバウンド・�エラー通知�

等しい�

未解決のエラー�

TRUE

FALSE

異常終了�

終了�

(デフォルト)�

テキストの比較�等しい�

取引先�アウトバウンド・�エラー通知�

システム管理者�ロールの取得�

デフォルト・エラー・プロセス� テキストの比較�

(デフォルト)� 等しい�

(デフォルト)�

終了�AND

AND

(デフォルト)�

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-35

Page 250: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

デフォルト・エラー・プロセスデフォルト・エラー・プロセスデフォルト・エラー・プロセスデフォルト・エラー・プロセス

デフォルト・エラー・プロセスでは、エラー・メッセージ通知がシステム管理者宛の場合、アウトバウンド・メッセージのエラー処理プロセスがコールされます。

ワークフロー通知管理者は、システム管理者に通知を配送し(ノード 1)、次のパスのうちのいずれか 1 つを続行します。

� システム管理者からの応答をチェックし、応答が受信されない場合は、タイムアウトを発行します(ノード 2)。

� システム管理者が失敗したアウトバウンド・プロセスを再試行する場合は、再試行機能を実行します(ノード 3)。再試行プロセスは、失敗したポイントから再開します。エラーが解決されるか、または失敗したプロセスが異常終了されるまで、再試行機能を続けます。

� システム管理者が失敗したアウトバウンド・プロセスを異常終了する場合は、異常終了関数を実行します(ノード 4)。

� エラーを解決し、プロセスを終了します(ノード 5)。

メッセージ配送�エラー・イベント�

システム管理者�ロールの取得�

メッセージ配送�エラー(FYI)�

再送�

ECXアウトバウンド・�メッセージの再送�

6-36 Oracle XML Gateway ユーザーズ・ガイド

Page 251: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

ECX エンジン通知プロセスエンジン通知プロセスエンジン通知プロセスエンジン通知プロセス

通知の送信イベントの受信(ノード 1)では、ECX エンジン通知プロセスが起動されます。

ECX エンジン通知プロセスでは、エラー・タイプをチェックして、ターゲット受取者が判断されます(ノード 2)。ターゲット受取者が取引先担当である場合は、通知が送信されます

(ノード 3)。取引先担当のみがターゲット受取者であることがエラー・タイプによって示されない場合、プロセスでは、エラー・タイプをチェックして、XML Gateway システム管理者に通知を送信するか(ノード 5)、または両方のパーティに送信するか(ノード 6)が判断されます(ノード 4)。

開始� 初期化エラー� 管理者へ通知�

未解決のエラー�

(タイムアウト)�

再試行�

異常終了�

解決�

未解決のエラー�

未解決のエラー�

終了�

再試行�

異常終了�

終了�

終了�

終了�

終了�

TRUE

FALSE

FALSE

FALSE

TRUE

TRUE

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-37

Page 252: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

通知の送信�イベントの受信�

取引先ロールの取得� テキストの比較�

等しい�

取引先�インバウンド・�エラー通知�

終了�

(デフォルト)�

システム管理者�ロールの取得�

取引先�インバウンド・�エラー通知�

等しい� 等しい�

テキストの比較�(デフォルト)�

終了�

終了�

AND

ECXイベント�通知(FYI)�

ECXイベント�通知(FYI)�

FALSE

TRUE

6-38 Oracle XML Gateway ユーザーズ・ガイド

Page 253: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

通知通知通知通知

XML Gateway エラー・プロセス項目タイプでサポートされている各通知の説明は、次のとおりです。

ECX イベント通知(イベント通知(イベント通知(イベント通知(FYI))))ECX イベント通知(FYI)は、システム管理者に通知を送信する場合に使用されます。

この通知は、ECX エンジン通知プロセスで使用されます。

ECX 外部イベント通知外部イベント通知外部イベント通知外部イベント通知

ECX 外部イベント通知は、システム管理者に通知を送信する場合に使用されます。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-39

Page 254: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

この通知は、インバウンド・メッセージのエラー処理プロセスで使用されます。

メッセージ配送エラー(メッセージ配送エラー(メッセージ配送エラー(メッセージ配送エラー(FYI))))コールバック機能を使用すると、メッセージ・システム(OTA を含む)では、メッセージの生成を開始したワークフロー・プロセスにメッセージ配送ステータスがレポートされます。配送が失敗した場合は、apps.ecx.processing.message.callback イベントが生成されます。FYI_MESSAGE_DELIVERY_ERROR プロセスの対応するイベント・サブスクリプションが実行され、ワークフロー通知がシステム管理者(「ECX: システム管理者 E メール・アドレス」プロファイルで定義済)に送信されます。このシステム管理者は、このプロセスを再試行か再送、または異常終了か無視することができます。

取引先インバウンド・エラー通知取引先インバウンド・エラー通知取引先インバウンド・エラー通知取引先インバウンド・エラー通知

取引先インバウンド・エラー通知は、取引先担当に通知を送信する場合に使用されます。

この通知は、インバウンド・メッセージのエラー処理プロセスおよび ECX エンジン通知プロセスで使用されます。

取引先アウトバウンド・エラー通知取引先アウトバウンド・エラー通知取引先アウトバウンド・エラー通知取引先アウトバウンド・エラー通知

取引先アウトバウンド・エラー通知は、取引先担当に通知を送信する場合に使用されます。

この通知は、アウトバウンド・メッセージのエラー処理プロセスで使用されます。

6-40 Oracle XML Gateway ユーザーズ・ガイド

Page 255: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

機能機能機能機能

XML Gateway エラー・プロセス項目タイプには、エラー処理プロセスをサポートするいくつかの機能が含まれています。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-41

Page 256: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

ECX 再処理インバウンド再処理インバウンド再処理インバウンド再処理インバウンド

ECX 再処理インバウンド機能は、XML Gateway システム管理者が、エラー通知に対して「再処理」オプションを選択するという応答をした場合に使用されます。再処理機能では、

ECX_DOCLOGS 表に格納されているインバウンド・メッセージのコピーを使用して、インバウンド・プロセスが再実行されます。

再処理機能は、取引先への外部通知ではサポートされていません。

ECX 再処理インバウンド機能の属性は、次のとおりです。

ECX アウトバウンド・メッセージの再送アウトバウンド・メッセージの再送アウトバウンド・メッセージの再送アウトバウンド・メッセージの再送

ECX アウトバウンド・メッセージの再送機能は、Oracle Exchange のみをサポートするために提供されており、XML Gateway エラー・プロセス項目タイプでは使用されません。ECXアウトバウンド・メッセージの再送機能は、ECX_DOCLOGS 表に格納されているアウトバウンド・メッセージのコピーから再開します。

Oracle Workflow 再試行機能は、失敗した場所からアウトバウンド・プロセスを再実行する場合に使用されます。この機能は、デフォルト・エラー・プロセスを使用して処理されます。

次の表は、ECX アウトバウンド再送機能の属性を示します。

ECX インバウンド・エラー詳細の取得インバウンド・エラー詳細の取得インバウンド・エラー詳細の取得インバウンド・エラー詳細の取得

ECX インバウンド・エラー詳細の取得機能アクティビティは、E メール通知を準備するためにインバウンド・エラーに関する詳細を取得する場合に使用されます。また、必要な情報は、インバウンド・メッセージのエラー処理プロセス・アクティビティに渡されます。

ECX アウトバウンド・エラー詳細の取得アウトバウンド・エラー詳細の取得アウトバウンド・エラー詳細の取得アウトバウンド・エラー詳細の取得

ECX アウトバウンド・エラー詳細の取得機能は、通知を準備するためにアウトバウンド・エラーに関する詳細を取得する場合に使用されます。また、必要な情報は、アウトバウンド・メッセージのエラー処理プロセスに渡されます。

システム管理者ロールの取得システム管理者ロールの取得システム管理者ロールの取得システム管理者ロールの取得

システム管理者ロールの取得機能は、「ECX: システム管理者 E メール・アドレス」システム・プロファイルに格納されているシステム管理者の E メール・アドレスを取り出す場合に使用されます。

システム・プロファイルから取り出した E メール・アドレスは、この機能によって返され、「ECX システム管理者ロール(ECX_SA_ROLE)」項目属性に格納されます。

ECX メッセージメッセージメッセージメッセージ ID 各アウトバウンド・メッセージに対して、XML Gateway 実行エンジンによって提供される一意の識別子です。

ECX メッセージメッセージメッセージメッセージ ID 各アウトバウンド・メッセージに対して、XML Gateway 実行エンジンによって提供される一意の識別子です。

6-42 Oracle XML Gateway ユーザーズ・ガイド

Page 257: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

Oracle XML Gateway または Oracle Workflow 業務イベント・システムで検出されたシステム・エラーまたはプロセス・エラーの通知が、XML Gateway システム管理者に送信されます。

取引先ロールの取得取引先ロールの取得取引先ロールの取得取引先ロールの取得

取引先ロールの取得機能は、取引先が定義されたときに設定された取引先担当の E メール・アドレスを判断する場合に使用されます。

この機能では、取引先を独自に識別するために渡された属性値が使用されます。選択された取引先の E メール・アドレスは、この機能によって返され、「ECX 取引先ロール(ECX_TP_ROLE)」項目属性に格納されます。

Oracle XML Gateway によって検出されたデータ・エラーの通知が、取引先担当に送信されます。

次の表は、取引先ロールの取得機能の属性を示します。

イベントイベントイベントイベントXML Gateway エラー・プロセス項目タイプでは、次のイベント・アクティビティがサポートされています。

� メッセージ配送エラー

� エラーの受信

� 通知の送信イベントの受信

メッセージ配送エラーメッセージ配送エラーメッセージ配送エラーメッセージ配送エラー

メッセージ配送エラー・イベントは、XML Gateway において、エラーが発生したことを示すために使用されます。このイベントは、OTA コールバックで使用されます。

シードされたイベント名は oracle.apps.ecx.processing.message.callback です。このイベントでは、(FYI)メッセージ配送エラー・プロセス・ワークフローが起動されます。

表表表表 6-10 取引先ロールの取得機能の属性取引先ロールの取得機能の属性取引先ロールの取得機能の属性取引先ロールの取得機能の属性

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

1 ECX パーティ ID Oracle E-Business Suite で定義された取引先の一意の識別子です。

このフィールドはオプションです。

2 ECX パーティ・サイトID

Oracle E-Business Suite で定義された取引先の一意の識別子です。

3 ECX トランザクション・

タイプ

XML Gateway「トランザクションの定義」フォームで定義された

トランザクション・タイプです。

4 ECX トランザクション・

サブタイプ

XML Gateway の「トランザクションの定義」フォームで定義され

たトランザクション・サブタイプです。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-43

Page 258: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

エラーの受信エラーの受信エラーの受信エラーの受信

エラーの受信イベントは、XML Gateway において、実行エンジンがエラーを検出したことを示すために使用されます。エラーが Oracle XML Gateway によって検出されたか、またはOracle Workflow 業務イベント・システムによって検出されたかにかかわらず、同じ ECX メイン・エラー・プロセスでエラーが管理されます。詳細は、「ECX メイン・エラー・プロセス」(6-31 ページ)を参照してください。

シードされたイベント名は oracle.apps.ecx.processing.message.error です。このイベントでは、ECX メイン・エラー・プロセス・ワークフローが起動されます。

通知の送信イベントの受信通知の送信イベントの受信通知の送信イベントの受信通知の送信イベントの受信

通知の送信イベントの受信は、XML Gateway において、実行エンジンがインバウンド・プロセスに関連するエラーの通知を送信する必要があることを示すために使用されます。このエラーは、ECX エンジン通知プロセスで管理されます。詳細は、「ECX エンジン通知プロセス」(6-37 ページ)を参照してください。

シードされたイベント名は oracle.apps.ecx.processing.notification.send です。このイベントでは、ECX エンジン通知プロセス・ワークフローが起動されます。

メッセージメッセージメッセージメッセージXML Gateway エラー・プロセス項目タイプには、エラーの性質に基づいて XML Gatewayシステム管理者または取引先担当に通知を送信する様々な通知アクティビティで使用されるメッセージ・テンプレートが含まれています。

6-44 Oracle XML Gateway ユーザーズ・ガイド

Page 259: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

各メッセージ・テンプレートの説明は、次のとおりです。メッセージ・テンプレートは、「本文」タブと「テキスト本文」サブタブで表示されます。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-45

Page 260: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

ECX イベント・メッセージ(イベント・メッセージ(イベント・メッセージ(イベント・メッセージ(FYI))))ECX イベント・メッセージ [FYI] テンプレートは、ECX イベント通知で使用されます。このテンプレートには、トランザクション、検出されたエラーのタイプおよび関連するエラー・メッセージに関する情報が含まれています。

ECX 外部イベント・メッセージ外部イベント・メッセージ外部イベント・メッセージ外部イベント・メッセージ

ECX 外部イベント・メッセージ・テンプレートは、ECX 外部イベント通知アクティビティで使用されます。このテンプレートには、トランザクション、検出されたエラーのタイプおよび関連するエラー・メッセージに関する情報が含まれています。

インバウンド取引先メッセージインバウンド取引先メッセージインバウンド取引先メッセージインバウンド取引先メッセージ

インバウンド取引先メッセージ・テンプレートは、取引先インバウンド・エラー通知アクティビティで使用されます。このテンプレートには、トランザクション、検出されたエラーのタイプおよび関連するエラー・メッセージに関する情報が含まれています。

メッセージ配送エラーメッセージ配送エラーメッセージ配送エラーメッセージ配送エラー メッセージ配送エラー・テンプレートは、XML メッセージ配信コールバック・エラー・プロセスで使用されます。このテンプレートには、エラー時に実行される処理に関する情報が含まれています。

アウトバウンド取引先メッセージアウトバウンド取引先メッセージアウトバウンド取引先メッセージアウトバウンド取引先メッセージ

アウトバウンド取引先メッセージ・テンプレートは、取引先アウトバウンド・エラー通知アクティビティで使用されます。このテンプレートには、トランザクション、検出されたエラーのタイプおよび関連するエラー・メッセージに関する情報が含まれています。

メッセージ・テンプレートの属性メッセージ・テンプレートの属性メッセージ・テンプレートの属性メッセージ・テンプレートの属性次の表は、各メッセージ・テンプレートに含まれている属性を示します。属性値は、ECX アウトバウンド・エラー詳細の取得機能および ECX インバウンド・エラー詳細の取得機能で提供されます。属性値は、メッセージ・テンプレート内にあるメッセージ・トークンを置き換えるために使用されます。

次の表は、すべての有効な属性を示します。

� イベント・キーは、イベントのインスタンスを表す一意の識別子です。イベント名、イベント・キーおよびイベント・データを組み合せることによって、そのイベントで何が発生したかを表すことができます。

6-46 Oracle XML Gateway ユーザーズ・ガイド

Page 261: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

表表表表 6-11 メッセージ・テンプレートの属性メッセージ・テンプレートの属性メッセージ・テンプレートの属性メッセージ・テンプレートの属性

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

1 イベント・キー イベント・キーは、イベントのインスタンスを表す一意の識別子です。イベント名、イベント・キーおよびイベント・データを組み合せることによって、そのイベントで何が発生したかを表すことができます。

2 ECX トランザクション・

タイプ

XML Gateway「トランザクションの定義」フォームで定義された

トランザクション・タイプです。

3 ECX 文書 ID ビジネス文書の一意の識別子です。文書番号または関連データベース・キーである場合もありますが、いずれもトランザクションに対して一意です。

4 ECX エラー・メッセージ 検出されたエラーを表すエラー・メッセージ・テキストです。

5 ECX エラー・タイプ エラー・タイプ・コードです。有効な値は、次のとおりです。10 = 成功

20 = 取引先担当への通知の送信エラー

25 = 取引先担当と XML Gateway システム管理者の両方への通知の

送信エラー30 =XML Gateway システム管理者への通知の送信エラー

6 ECX リターン・コード リターン・ステータス・コードです。有効な値は、次のとおりです。0 = 成功

1 = 警告

2 = エラー

7 ECX メッセージ標準 「トランザクションの定義」フォームで定義された(たとえばOAG のような)メッセージ形式の標準です。

8 ECX TP ヘッダー ID

9 ECX メッセージ・タイプ メッセージ・タイプ。これは XML です。

10 ECX ログ・ファイル

11 ECX ステータス

12 ECX タイム・スタンプ

13 ECX トランザクション・

サブタイプ

XML Gateway の「トランザクションの定義」フォームで定義され

たトランザクション・サブタイプです。

14 ECX パーティ ID Oracle E-Business Suite で定義された取引先の一意の識別子です。

15 ECX パーティ・サイトID

XML Gateway の「トランザクションの定義」フォームで定義され

た取引先サイトの一意の識別子です。

16 ECX 内部制御番号 内部制御番号は、システムで生成される番号です。これにより、処理中のメッセージが一意に識別されます。

17 イベント名 業務イベントの一意の識別子です。命名規則は、 oracle.apps.<製品コード >.<コンポーネント >.<オブジェクト >.<イベント >です。イベント名は、戻り値を格納するため XML 文書の生成機能

に必須です。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-47

Page 262: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

選択肢タイプ選択肢タイプ選択肢タイプ選択肢タイプXML Gateway エラー・プロセス項目タイプでは、エラー処理プロセスの参照タイプがサポートされています。

18 ECX パーティ管理者の Eメール

「取引先設定」ウィンドウで定義されたシステム管理者です。

19 ECX プロトコル・アドレ

使用されるプロトコル・アドレスです(たとえば、SMTP、HTTP、HTTPS)。

20 ECX 属性 1 メッセージ・マップで定義されたオプション変数です。

21 ECX 属性 2 メッセージ・マップで定義されたオプション変数です。

22 ECX 属性 3 メッセージ・マップで定義されたオプション変数です。

23 ECX 属性 4 メッセージ・マップで定義されたオプション変数です。

24 ECX 属性 5 メッセージ・マップで定義されたオプション変数です。

25 ECX トリガー ID 呼び出された各イベントに与えられる一意の番号です。

26 ECX 取引先ロール 取引先ロールの取得機能によって返される「取引先設定」ウィンドウの E メール・アドレスです。

27 ECX プロトコル・タイプ 「取引先設定」ウィンドウで定義された伝送プロトコルです。

表表表表 6-11 メッセージ・テンプレートの属性(続き)メッセージ・テンプレートの属性(続き)メッセージ・テンプレートの属性(続き)メッセージ・テンプレートの属性(続き)

属性名属性名属性名属性名 属性の説明属性の説明属性の説明属性の説明

6-48 Oracle XML Gateway ユーザーズ・ガイド

Page 263: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-49

Page 264: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway エラー・プロセス項目タイプ

ECX インバウンド・エラー処理インバウンド・エラー処理インバウンド・エラー処理インバウンド・エラー処理

ECX インバウンド・エラー処理参照は、ECX 外部イベント通知で結果タイプ属性として使用されます。有効な値は、次のとおりです。

� 異常終了

失敗したインバウンド・プロセスを異常終了します。

� 再処理

失敗したインバウンド・プロセスを再処理します。

ECX アウトバウンド・エラー処理アウトバウンド・エラー処理アウトバウンド・エラー処理アウトバウンド・エラー処理

ECX アウトバウンド・エラー処理参照は、デフォルト・エラー・プロセスで使用されます。有効な値は、次のとおりです。

� 異常終了

失敗したアウトバウンド・プロセスを異常終了します。

再試行機能は、デフォルト・エラー・プロセスでサポートされています。

ECX アウトバウンド・エラー・タイプアウトバウンド・エラー・タイプアウトバウンド・エラー・タイプアウトバウンド・エラー・タイプ

ECX アウトバウンド・エラー・タイプ参照は、ECX エラー・タイプの取得機能で結果タイプ属性として使用されます。有効な値は、次のとおりです。

� 生成エラー

このエラーは、メッセージ配送プロセスではなく、メッセージ生成プロセスで検出されます。

� 送信エラー

このエラーは、メッセージ生成プロセスではなく、メッセージ配送プロセスで検出されます。

� 取引先設定エラー

誤った取引先設定が原因でこのエラーが発生します。先に進む前に、誤った設定を修正します。

ECX 再送処理再送処理再送処理再送処理

ECX 再送処理は、XML Gateway エラー・プロセスで使用される参照です。有効な値は、次のとおりです。

� 無視

� 再送

6-50 Oracle XML Gateway ユーザーズ・ガイド

Page 265: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle の作成済インバウンド・メッセージの構成

Oracle の作成済インバウンド・メッセージの構成の作成済インバウンド・メッセージの構成の作成済インバウンド・メッセージの構成の作成済インバウンド・メッセージの構成

シードされた業務イベントおよび対応するイベント・サブスクリプションシードされた業務イベントおよび対応するイベント・サブスクリプションシードされた業務イベントおよび対応するイベント・サブスクリプションシードされた業務イベントおよび対応するイベント・サブスクリプションOracle E-Business Suite のアプリケーション・モジュールで作成されて配信されるインバウンド・メッセージは、次の項目とともに配信されます。

� 最後のアクティビティとして XML Gateway プロシージャ・コール処理が含まれているメッセージ・マップ。このアクティビティにより、XML Gateway でインバウンド・メッセージが正常に処理されたことを示すイベント詳細が設定されます。

� メッセージ・マップで生成された業務イベントを処理するシードされたイベント・サブスクリプション。

イベント・サブスクリプションは、使用可能なサブスクリプションとしてシードされています。必要に応じて、イベント・サブスクリプションを使用不可にすることができます。

アプリケーションとインバウンド・メッセージの関係にかかわらず、取引先(B2B)からのインバウンド・メッセージを処理するには、イベント・サブスクリプションが必要になります。シードされたイベント・サブスクリプションでは、ワークフロー・デフォルト・ルール機能が使用されます。ただし、このイベント・サブスクリプションは、ビジネス要件に関連するルール機能およびワークフロー・プロセスを使用するように構成できます。

新規メッセージ・マップの作成方法および Oracle の作成済メッセージ・マップの修正方法の詳細は、「Message Designer」(2-1 ページ)のセクションを参照してください。

シードされたイベント・サブスクリプションの構成オプションシードされたイベント・サブスクリプションの構成オプションシードされたイベント・サブスクリプションの構成オプションシードされたイベント・サブスクリプションの構成オプション「Workflow 管理者」を使用して、作成済のインバウンド・メッセージに対するシードされたイベント・サブスクリプションを必要に応じて構成します。

1. 新規のイベント・サブスクリプションの登録新規のイベント・サブスクリプションの登録新規のイベント・サブスクリプションの登録新規のイベント・サブスクリプションの登録

シードされたサブスクリプションを構成せずに新規のサブスクリプションを定義する場合は、「Workflow 管理者イベント・サブスクリプションの追加」ウィンドウを使用して、新規のイベント・サブスクリプションを登録します。

新規のイベント・サブスクリプションの登録方法の詳細は、「ワークフロー・プロセスの管理」(6-57 ページ)を参照してください。

2. シードされたサブスクリプションの構成シードされたサブスクリプションの構成シードされたサブスクリプションの構成シードされたサブスクリプションの構成

アプリケーションが対応している場合は、「Oracle Workflow 管理者イベント・サブスクリプションの追加」ウィンドウを使用して、インバウンド・メッセージが処理されるシードされたイベント・サブスクリプションを構成します。このサブスクリプションにより、Oracle E-Business Suite がトリガーされ、アクティビティが実行されます。このイベント・サブスクリプションで実行される実際のアクティビティは、このアクティビティ用に定義されたワークフロー・プロセスに基づいています。次に例を示します。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-51

Page 266: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle の作成済アウトバウンド・メッセージの構成

� Oracle E-Business Suite で定義された既存のワークフロー・プロセスに統合します。

� アプリケーション API をコールして、特定の機能を実行します。

新規のイベント・サブスクリプションの登録方法およびシードされたイベント・サブスクリプションの設定方法の詳細は、「ワークフロー・プロセスの管理」(6-57 ページ)を参照してください。

Oracle の作成済アウトバウンド・メッセージの構成の作成済アウトバウンド・メッセージの構成の作成済アウトバウンド・メッセージの構成の作成済アウトバウンド・メッセージの構成

シードされた業務イベントおよび対応するイベント・サブスクリプションシードされた業務イベントおよび対応するイベント・サブスクリプションシードされた業務イベントおよび対応するイベント・サブスクリプションシードされた業務イベントおよび対応するイベント・サブスクリプションOracle E-Business Suite のアプリケーション・モジュールで作成されて配信されるアウトバウンド・メッセージは、次の項目とともに配信されます。

� ビジネス・アクティビティが発生した時点を示す業務イベントを生成するためのアプリケーション・モジュール内のコール。このイベントには、文書が作成、変更、確認または削除された時点を示すイベント・ポイントが含まれています。

� アプリケーション・モジュールで生成されるすべての業務イベントを処理する XML Gateway、またはワークフロー・デフォルト・ルール機能を使用するシードされたイベント・サブスクリプション。

イベント・サブスクリプションは、使用可能なサブスクリプションとしてシードされています。必要に応じて、イベント・サブスクリプションを使用不可にすることができます。

シードされたイベント・サブスクリプションでは、シードされたすべてのイベントが処理されます。ただし、このイベント・サブスクリプションは、関係するアウトバウンド・イベントに対する特定のワークフロー・プロセスを実行するように構成できます。

新規メッセージ・マップの作成方法および Oracle の作成済メッセージ・マップの修正方法の詳細は、「Message Designer」(2-1 ページ)の章を参照してください。

シードされたイベント・サブスクリプションの構成オプションシードされたイベント・サブスクリプションの構成オプションシードされたイベント・サブスクリプションの構成オプションシードされたイベント・サブスクリプションの構成オプション「Workflow 管理者」を使用して、作成済のアウトバウンド・メッセージに対するシードされたイベント・サブスクリプションを必要に応じて構成します。

1. 新規のイベント・サブスクリプションの登録新規のイベント・サブスクリプションの登録新規のイベント・サブスクリプションの登録新規のイベント・サブスクリプションの登録

シードされたサブスクリプションを構成せずに新規のサブスクリプションを定義する場合は、「Workflow 管理者イベント・サブスクリプションの追加」ウィンドウを使用して、新規のイベント・サブスクリプションを登録します。

新規のイベント・サブスクリプションの登録方法の詳細は、「ワークフロー・プロセスの管理」(6-57 ページ)を参照してください。

6-52 Oracle XML Gateway ユーザーズ・ガイド

Page 267: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle の作成済アウトバウンド・メッセージの構成

2. シードされたイベント・サブスクリプションの構成シードされたイベント・サブスクリプションの構成シードされたイベント・サブスクリプションの構成シードされたイベント・サブスクリプションの構成

「Oracle Workflow 管理者イベント・サブスクリプションの追加」ウィンドウを使用して、目的のアプリケーション業務イベントを処理するシードされたイベント・サブスクリプションを設定します。このサブスクリプションにより、Oracle E-Business Suite がトリガーされ、アクティビティが実行されます。このイベント・サブスクリプションで実行される実際のアクティビティは、このアクティビティ用に定義されたワークフロー・プロセスに基づいています。

企業間(B2B)統合シナリオに対応する 3 つのサブスクリプション・オプションについて説明します。XML Gateway 標準項目タイプでは、ここで説明されている関数アクティビティがサポートされています。

3. XML Gateway ルール機能を使用した文書の送信機能ルール機能を使用した文書の送信機能ルール機能を使用した文書の送信機能ルール機能を使用した文書の送信機能

このオプションでは、トランザクション配送要機能が組み込まれている XML Gatewayルール機能を使用して、メッセージが生成される前に取引先がトランザクションを実行できるかどうかが判別されます。

送信モード属性を「即時」または「遅延」にそれぞれ設定すると、メッセージが同期モードまたは非同期モードで生成されるよう文書の送信機能を構成できます。

XML Gateway ルール機能によって起動されたワークフロー・プロセスの例を次に示します。受信アクティビティの後に文書の送信機能アクティビティが実行され、その後終了します。トランザクション配送要機能はルール機能にすでに組み込まれているため、ワークフロー・プロセスではモデル化されません。

4. ワークフロー・デフォルト・ルール機能を使用する文書の送信機能ワークフロー・デフォルト・ルール機能を使用する文書の送信機能ワークフロー・デフォルト・ルール機能を使用する文書の送信機能ワークフロー・デフォルト・ルール機能を使用する文書の送信機能

このオプションを使用すると、取引先がトランザクションを実行可能かどうかを判別できます。トランザクション配送要機能アクティビティの結果によって「TRUE」が返される場合は、文書の送信機能が実行されます。

注意注意注意注意 : 最初のワークフロー・アクティビティは、受信アクティビティまたは開始アクティビティになります。受信アクティビティを使用して、既存のワークフロー・プロセスを続行します。開始アクティビティを使用して、新規のワークフロー・プロセスを開始します。

受信��文書の送信� 終了�

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-53

Page 268: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle の作成済アウトバウンド・メッセージの構成

送信モード属性を「即時」または「遅延」にそれぞれ設定すると、メッセージが同期モードまたは非同期モードで送信されるよう文書の送信機能アクティビティを構成できます。

ワークフロー・デフォルト・ルール機能によって起動されたワークフロー・プロセスの例を次に示します。トランザクション配送要機能はワークフロー・デフォルト・ルール機能に組み込まれていないため、ワークフロー・プロセスではモデル化されません。

5. 取引先取引先取引先取引先 XML 文書の生成文書の生成文書の生成文書の生成

このオプションを使用すると、取引先に配信せずにイベントメッセージ属性のメッセージデータを収集したり返すことができます。イベント・メッセージは、それ以後のワークフローの指示に従って処理されます。

取引先 XML 文書の生成機能を使用するワークフロー・プロセスの例を次に示します。受信アクティビティの後にトランザクション配送要機能アクティビティが実行されます。これにより、「False」が返される場合、プロセスは終了します。「True」が返される場合は、取引先 XML 文書の生成機能アクティビティが実行されてから終了します。生成ワークフロー・プロセスでは、取引先 XML 文書の生成機能アクティビティの後にアプリケーション特有のアクティビティが実行されます。

注意注意注意注意 : 最初のワークフロー・ステップは、受信アクティビティまたは開始アクティビティになります。受信アクティビティを使用して、既存のワークフロー・プロセスを続行します。開始アクティビティを使用して、新規のワークフロー・プロセスを開始します。

受信� トランザクション�配送要?

文書の送信� 終了�(TRUE)�

終了�(FALSE)�

TRUE

FALSE

6-54 Oracle XML Gateway ユーザーズ・ガイド

Page 269: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アプリケーション統合のためのアプリケーション

アプリケーション統合のためのアプリケーションアプリケーション統合のためのアプリケーションアプリケーション統合のためのアプリケーションアプリケーション統合のためのアプリケーションXML Gateway 標準項目タイプには、A2A 統合要件をサポートするための機能があります。インバウンド・トランザクションおよびアウトバウンド・トランザクションのオプションは、次のとおりです。

インバウンド・オプションインバウンド・オプションインバウンド・オプションインバウンド・オプションXML 文書の処理文書の処理文書の処理文書の処理

このオプションは、Oracle XML Gateway とやり取りして、基本アプリケーション表にデータを挿入する場合に使用します。メッセージ・マップの定義に応じて、アプリケーション・オープン・インタフェース API またはアプリケーション API のいずれかを使用してデータを挿入できます。「API へのマッピング方法」(2-112 ページ)を参照してください。

XML 文書の処理機能は、A2A 統合を実行する場合に使用します。この機能は、イベント・メッセージ属性を使用してメッセージ・データを渡す既存のワークフロー・プロセスで使用できます。この機能を使用すると、B2B の統合シナリオで推奨されているように業務イベントを呼び出したり、イベント・サブスクリプションを定義する必要がなくなります。

注意注意注意注意 : 最初のワークフロー・ステップは、受信アクティビティまたは開始アクティビティになります。受信アクティビティを使用して、既存のワークフロー・プロセスを続行します。開始アクティビティを使用して、新規のワークフロー・プロセスを開始します。

受信� トランザクション�配送要?

取引先XML文書の�作成�

終了�(TRUE)�

終了�(FALSE)�

FALSE

TRUE

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-55

Page 270: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アプリケーション統合のためのアプリケーション

XML 文書の処理機能を使用したワークフロー・プロセスの例は、次のとおりです。

このワークフロー・プロセスでは、XML 文書の処理機能(2)が完了した後に終了関数(3)が実行されています。生成ワークフロー・プロセスでは、XML 文書の処理機能の後にアプリケーション固有のアクティビティが実行されます。

アウトバウンド・オプションアウトバウンド・オプションアウトバウンド・オプションアウトバウンド・オプションXML メッセージの生成メッセージの生成メッセージの生成メッセージの生成

このオプションは、XML メッセージを生成して、後のワークフロー・プロセスにそのメッセージを転送する場合に使用します。XML 文書の生成機能を使用して、文書データを収集し、そのデータをイベント・メッセージ属性に戻します。次に、イベント・メッセージは、ワークフローの指示に従って、別の Oracle E-Business Suite のアプリケーション・モジュールに転送されます。

XML 文書の生成機能を使用したワークフロー・プロセスの例は、次のとおりです。

このワークフロー・プロセスでは、XML 文書の生成機能が完了した後に終了関数が実行されています。生成ワークフロー・プロセスでは、XML 文書の生成機能の後にアプリケーション固有のアクティビティが実行されます。

注意注意注意注意 : 最初のワークフロー・ステップ(1)は、受信アクティビティまたは開始アクティビティになります。受信アクティビティを使用して、既存のワークフロー・プロセスを続行します。開始アクティビティを使用して、新規のワークフロー・プロセスを開始します。

開始� XML文書の�処理�

終了�

開始� XML文書の�生成�

終了�

6-56 Oracle XML Gateway ユーザーズ・ガイド

Page 271: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ワークフロー・プロセスの管理

ワークフロー・プロセスの管理ワークフロー・プロセスの管理ワークフロー・プロセスの管理ワークフロー・プロセスの管理次に示す「Oracle Workflow 管理者」ウィンドウを使用すると、ワークフロー・プロセスを簡単に管理できます。

これらのウィンドウの詳細は、『Oracle Workflow ガイド』を参照してください。

新規の業務イベントおよびイベント・サブスクリプションの登録新規の業務イベントおよびイベント・サブスクリプションの登録新規の業務イベントおよびイベント・サブスクリプションの登録新規の業務イベントおよびイベント・サブスクリプションの登録このプロセスは、新規の XML メッセージを作成すると追加される新規のイベントおよびサブスクリプションに対して必要となります。Oracle E-Business Suite によって配信されたシードされた業務イベントおよびイベント・サブスクリプションは、すでに登録されています。実装中に構成されたシードされたイベント・サブスクリプションを登録する必要はありません。

「イベント / イベント・グループの追加」ウィンドウを使用して、新規の業務イベントを追加します。

「イベント・サブスクリプションの追加」ウィンドウを使用して、新規のイベントを処理するための新規のサブスクリプションを追加します。

シードされた項目タイプの指定シードされた項目タイプの指定シードされた項目タイプの指定シードされた項目タイプの指定「項目タイプの定義」ウィンドウを使用して、Oracle Workflow 業務イベント・システム、

Oracle XML Gateway および Oracle E-Business Suite のモジュールで配信されたシードされた項目タイプを表示します。

シードされた業務イベントおよび関連するイベント・サブスクリプションシードされた業務イベントおよび関連するイベント・サブスクリプションシードされた業務イベントおよび関連するイベント・サブスクリプションシードされた業務イベントおよび関連するイベント・サブスクリプションの指定の指定の指定の指定

「イベント / イベント・グループの追加」ウィンドウを使用して、Oracle Workflow 業務イベント・システム、Oracle XML Gateway および Oracle E-Business Suite のモジュールで配信されたシードされた業務イベントを表示します。

この業務イベントを選択して、「サブスクリプションの編集」をクリックし、「イベント・サブスクリプション」ウィンドウに進み、関連するサブスクリプションを表示します。

注意注意注意注意 : 最初のワークフロー・ステップは、受信アクティビティまたは開始アクティビティになります。受信アクティビティを使用して、既存のワークフロー・プロセスを続行します。開始アクティビティを使用して、新規のワークフロー・プロセスを開始します。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-57

Page 272: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ワークフロー・プロセスのモニター

シードされたイベント・サブスクリプションの構成または削除シードされたイベント・サブスクリプションの構成または削除シードされたイベント・サブスクリプションの構成または削除シードされたイベント・サブスクリプションの構成または削除「イベント・サブスクリプション」ウィンドウでサブスクリプションを選択し、「編集」をクリックしてサブスクリプションを構成します。サブスクリプションを削除するには、「削除」をクリックします。サブスクリプションに対して定義したルール機能またはワークフロー・プロセスを修正できます。

エラー通知に対する応答または特定の通知の検索エラー通知に対する応答または特定の通知の検索エラー通知に対する応答または特定の通知の検索エラー通知に対する応答または特定の通知の検索「ワークリスト」ウィンドウを使用して、待機中の通知に対して応答します。「通知の検索」ウィンドウを使用し、通知 ID を使用して特定の通知を検索します。

ワークフロー・プロセスのモニターワークフロー・プロセスのモニターワークフロー・プロセスのモニターワークフロー・プロセスのモニター次に示す「Oracle Workflow 管理者」ウィンドウは、ワークフロー・プロセスをモニターするときに役立ちます。

トレース機能を使用したサブスクリプションのモニタートレース機能を使用したサブスクリプションのモニタートレース機能を使用したサブスクリプションのモニタートレース機能を使用したサブスクリプションのモニターイベント・サブスクリプションを変更して、次の表に示すトレース・レベルに「処理 : パラメータ」フィールドを設定します。

ECX_DEBUG_LEVEL = 0(オフ)がデフォルトの設定です。

トランザクション・ステータスのモニタートランザクション・ステータスのモニタートランザクション・ステータスのモニタートランザクション・ステータスのモニタートランザクションのステータスをモニターするには、「イベント・キュー要約」ウィンドウを使用します。「エージェント・リスナー」を選択して、「詳細の表示」アイコンをクリックします。トランザクションを識別するための選択基準を入力すると、ステータス、イベント・データを XML またはテキスト・フォーマットで表示するためのオプションなどの詳細情報が表示されます。

関数の生成により返される関数の生成により返される関数の生成により返される関数の生成により返される XML メッセージのレビューメッセージのレビューメッセージのレビューメッセージのレビューXML 文書の生成機能または取引先 XML 文書の生成機能のサブスクリプションを変更し、

「処理 : 外部エージェント」フィールドを WF_OUT に設定します。この機能で生成されるXML データは、WF_OUT エージェントに送られます。

パラメータの設定パラメータの設定パラメータの設定パラメータの設定 説明説明説明説明

ECX_DEBUG_LEVEL = 1 プロセス・レベルのトレース

ECX_DEBUG_LEVEL = 2 プロセス・レベルおよびサブプロセス・レベルのトレース

ECX_DEBUG_LEVEL = 3 プロセス・レベル、サブプロセス・レベルおよびシステム・レベルのトレース

6-58 Oracle XML Gateway ユーザーズ・ガイド

Page 273: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

B2B 統合用カスタム・メッセージの開発ガイドライン

WF_OUT に送られる XML メッセージの表示方法の詳細は、「トランザクション・ステータスのモニター」を参照してください。

エージェント・リスナーのオンエージェント・リスナーのオンエージェント・リスナーのオンエージェント・リスナーのオン / オフオフオフオフ エージェントごとに 1 つのエージェント・リスナーが存在します。次の表は、Oracle Workflow 業務イベント・システムと Oracle XML Gateway の統合をサポートするために必要なエージェントを示します。

必要なエージェントをオンにするには、「Workflow 管理者 : エージェントの追加」ウィンドウを使用します。このウィンドウは、必要に応じてエージェントをオフにする場合にも使用します。

別のオプションでは、「システム管理者 : ワークフロー・エージェント・リスナー」コンカレント要求が実行され、リスナーが継続的に実行されるようにスケジューリングされます。

B2B 統合用カスタム・メッセージの開発ガイドライン統合用カスタム・メッセージの開発ガイドライン統合用カスタム・メッセージの開発ガイドライン統合用カスタム・メッセージの開発ガイドラインOracle XML Gateway を使用して新規のインバウンド・メッセージおよびアウトバウンド・メッセージを作成する場合は、次のガイドラインに従って業務イベントを呼び出し、イベント・サブスクリプションを定義します。

このプロセスでは、XML Gateway Message Designer で作成したメッセージ・マップを使用する必要があります。

新規メッセージ・マップの作成方法および Oracle の作成済メッセージ・マップの修正方法の詳細は、「Message Designer」(2-1 ページ)のセクションを参照してください。

エージェント名エージェント名エージェント名エージェント名 説明説明説明説明

ECX_INBOUND B2B 統合において企業の外側から発生するインバウンド・メッ

セージ用のエージェント。

ECX_TRANSACTION A2A 統合において企業内で発生するインバウンド・メッセージ

用のエージェント。

WF_OUT アウトバウンド・メッセージを処理するためのエージェント。ECX_OUTBOUND は、取引先へのアウトバウンド XML メッ

セージを処理および送信するために使用するエージェントです。

WF_IN Oracle E-Business Suite に送信されるインバウンド・メッセー

ジを受信するためのエージェント。

WF_DEFERRED 遅延モードのアウトバウンド・メッセージ用のエージェント。

WF_ERROR Oracle Workflow 業務イベント・システムまたは Oracle XML Gateway によって検出されるエラー用のエージェント。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-59

Page 274: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

B2B 統合用カスタム・メッセージの開発ガイドライン

アウトバウンド・メッセージの開発ガイドラインアウトバウンド・メッセージの開発ガイドラインアウトバウンド・メッセージの開発ガイドラインアウトバウンド・メッセージの開発ガイドライン1. 業務イベントおよび対応するイベント・サブスクリプションの登録業務イベントおよび対応するイベント・サブスクリプションの登録業務イベントおよび対応するイベント・サブスクリプションの登録業務イベントおよび対応するイベント・サブスクリプションの登録

Oracle E-Business Suite で定義されている業務イベントおよび対応するイベント・サブスクリプションを登録します。

業務イベントおよびイベント・サブスクリプションの登録方法の詳細は、「ワークフロー・プロセスの管理」(6-57 ページ)を参照してください。

2. アプリケーションでの業務イベントの呼出しアプリケーションでの業務イベントの呼出しアプリケーションでの業務イベントの呼出しアプリケーションでの業務イベントの呼出し

文書が作成、変更、確認または削除された時期を示す場合は、Workflow 機能を使用して、アプリケーションで業務イベントを呼び出します。業務イベントは、文書配送イベントの呼出しアクティビティを使用する既存のワークフロー・プロセスによって、または新規のワークフロー・プロセスの最初のアクティビティとして、PL/SQL コードで呼び出すことができます。

特定のイベント・サブスクリプションを定義しない場合でも、可能性のあるすべてのイベント・ポイントでイベントを呼び出す必要があります。これにより、イベントを呼び出すアプリケーション・コードを変更せずに、任意のすべてのイベントに対してイベント・サブスクリプションを定義することができます。

3. イベント・サブスクリプションの定義イベント・サブスクリプションの定義イベント・サブスクリプションの定義イベント・サブスクリプションの定義

任意の業務イベントごとにイベント・サブスクリプションを追加します。XML Gateway 標準項目タイプで提供される機能およびイベント・アクティビティを使用して、イベント・サブスクリプションに関連付けられているワークフロー・プロセスを定義します。

ワークフロー・プロセスの構成オプションは、「Oracle の作成済アウトバウンド・メッセージの構成」(6-52 ページ)を参照してください。

イベント・サブスクリプションの追加方法の詳細は、「ワークフロー・プロセスの管理」(6-57 ページ)を参照してください。

使用しない業務イベントに対してイベント・サブスクリプションを追加する必要はありません。このような業務イベントには、後で実装のためにこのイベントが必要になったときに、イベント・サブスクリプションを追加します。

インバウンド・メッセージの開発ガイドラインインバウンド・メッセージの開発ガイドラインインバウンド・メッセージの開発ガイドラインインバウンド・メッセージの開発ガイドライン1. 業務イベントおよび対応するイベント・サブスクリプションの登録業務イベントおよび対応するイベント・サブスクリプションの登録業務イベントおよび対応するイベント・サブスクリプションの登録業務イベントおよび対応するイベント・サブスクリプションの登録

Oracle E-Business Suite で定義されている業務イベントおよび対応するイベント・サブスクリプションを登録します。

業務イベントおよびイベント・サブスクリプションの登録方法の詳細は、「ワークフロー・プロセスの管理」(6-57 ページ)を参照してください。

2. メッセージ・マップでのイベント詳細の設定メッセージ・マップでのイベント詳細の設定メッセージ・マップでのイベント詳細の設定メッセージ・マップでのイベント詳細の設定

6-60 Oracle XML Gateway ユーザーズ・ガイド

Page 275: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

よくある質問

Workflow 機能を呼び出すための後処理プロシージャ・コール処理がメッセージ・マップに含まれていることを確認して、XML Gateway によりインバウンド・メッセージが正常に処理されるようにイベント詳細を設定します。

プロシージャ・コール処理の詳細は、「プロシージャ・コール : プロシージャの実行」(2-102 ページ)を参照してください。

3. イベント・サブスクリプションの定義イベント・サブスクリプションの定義イベント・サブスクリプションの定義イベント・サブスクリプションの定義

アプリケーションでインバウンド・メッセージが必要かどうかにかかわらず、取引先(B2B)からのインバウンド・メッセージにはイベント・サブスクリプションが必要です。

ご使用のアプリケーションでインバウンド・メッセージが必要な場合、ビジネス要件に関連付けられているルール機能およびワークフロー・プロセスを使用して、イベント・サブスクリプションを定義します。

ご使用のアプリケーションでインバウンド・メッセージが必要ない場合は、ワークフロー・デフォルト・ルール機能を使用して、ワークフロー・プロセスを使用せずにイベント・サブスクリプションを定義します。イベント・サブスクリプションは、ご使用のアプリケーションでインバウンド・メッセージが必要になった場合には変更できます。

イベント・サブスクリプションの追加方法の詳細は、「ワークフロー・プロセスの管理」(6-57 ページ)を参照してください。

よくある質問よくある質問よくある質問よくある質問実装についてよくある質問は、次のとおりです。

1. 取引先取引先取引先取引先 XML 文書の生成機能と文書の送信機能は、組み合せることができますか。文書の生成機能と文書の送信機能は、組み合せることができますか。文書の生成機能と文書の送信機能は、組み合せることができますか。文書の生成機能と文書の送信機能は、組み合せることができますか。

いいえ。これらの機能を組み合せることはできません。

取引先 XML 文書の生成機能では、イベント・メッセージ属性で XML メッセージが返されます。文書の送信機能では、データが収集され、XML メッセージが作成されて、アウトバウンド・キューにエンキューされます。

この 2 つの機能を組み合せると、文書の送信機能は正常に実行されますが、取引先XML 文書の生成機能は、メッセージをエンキューする外部エージェント属性(イベント詳細に関連付けられている)で何かを定義しない限り送信されないイベント・メッセージ属性でデータを受け取ります。

2. XML 文書の生成機能と文書の送信機能は、組み合せることができますか。文書の生成機能と文書の送信機能は、組み合せることができますか。文書の生成機能と文書の送信機能は、組み合せることができますか。文書の生成機能と文書の送信機能は、組み合せることができますか。

答えは 1 と同じです。

Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合 6-61

Page 276: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

よくある質問

3. 取引先取引先取引先取引先 XML 文書の生成機能を使用する場合、取引先が文書を受け取るように定義され文書の生成機能を使用する場合、取引先が文書を受け取るように定義され文書の生成機能を使用する場合、取引先が文書を受け取るように定義され文書の生成機能を使用する場合、取引先が文書を受け取るように定義されているかどうかを判別するために、トランザクション配送要機能を使用する必要がありているかどうかを判別するために、トランザクション配送要機能を使用する必要がありているかどうかを判別するために、トランザクション配送要機能を使用する必要がありているかどうかを判別するために、トランザクション配送要機能を使用する必要がありますか。ますか。ますか。ますか。

はい。取引先 XML 文書の生成機能を使用する前にトランザクション配送要機能を使用する必要があります。

6-62 Oracle XML Gateway ユーザーズ・ガイド

Page 277: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

Oracle Transport

7

Oracle Transport Agent

この章では、Oracle Transport Agent について説明します。次のトピックが含まれます。

� Oracle Transport Agent の概要

� 認証方法

� メッセージ配信ステータス

Oracle Transport Agent の概要の概要の概要の概要Oracle Transport Agent(OTA)は、Oracle Applications 11i で XML 文書を送受信するために使用される転送メカニズムです。Oracle Transport Agent(OTA)は、HTTP アプリケーション・プロトコル上の OTA プロトコルに実装される Java ベースのサーブレットで、次の要求がサポートされています。

� 1 度で完了することが保証された HTTP(S)上でのメッセージの配信

� 送受信されたメッセージの完全な監査および履歴のトラッキング

� アウトバウンド E メール配信のサポート(SMTP)

� メッセージの作成を開始したワークフロー・プロセスへのメッセージの配信ステータスの提供

� Oracle E-Business Suite および Oracle Exchange に対する組込みアプリケーション・ユーザー認証の提供

SSL では、デジタル証明書を使用して、クライアントとサーバーの両方の証明書認証が提供されますが、OTA の初期のリリースでは、サーバー認証のみがサポートされていました。つまり、クライアントによって、サーバーの証明書が要求され、サーバーが認証されていました。クライアントからサーバーに認証用の証明書情報が送信されないため、サーバーでは、受信したメッセージが正当な送信者から送信されたものであるかどうかが判断できませんでした。

Agent 7-1

Page 278: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

認証方法

この文書では、クライアント認証が OTA の最新のリリースにどのように実装されたかについて説明します。Oracle E-Business Suite ユーザーは、クライアント認証の実装を選択できますが、必須ではありません。

この文書では、送信者とは、文書を送信する " クライアント " か、または接続を要求する "クライアント " のことです。また、受信者とは、文書または接続要求を受信する " サーバー" のことです。

認証方法認証方法認証方法認証方法SSL でサポートされている認証方法には、サーバー認証とクライアント認証の 2 つがあります。SSL は、TCP/IP プロトコルとアプリケーション層の間に存在する層です。SSL によって、次の処理が実行されます。

� デジタル証明書を使用したサーバーの認証

� デジタル証明書を使用したクライアントの認証

� データの暗号化

� メッセージ認証の使用によるデータの整合性

サーバー認証サーバー認証サーバー認証サーバー認証

クライアントが HTTPS を経由して Web サーバーに問題なく接続されると、サーバーでは認証が行われたことを示すサーバー証明書がクライアントに返信されます。一度認証されると、クライアントでは暗号化されたデータをサーバーに送信できます。サーバー認証が行われると、クライアントではサーバーを識別できるようになります。

クライアント認証クライアント認証クライアント認証クライアント認証

サーバーでは、クライアント証明書を要求することによってクライアントが識別されます。クライアント証明書は、クライアントの独自性を証明するデジタル証明書です。クライアント証明書は、システム名と固有の秘密キーを組み合せたものです。クライアント証明書およびサーバー証明書は、認証局(CA)によって発行されます。Oracle E-Business Suite のユーザーは、任意の CA サポートを選択できます。CA には、Identris、Verisign、Baltimore などがあります。

クライアント認証の利点クライアント認証の利点クライアント認証の利点クライアント認証の利点

クライアント認証では、従来のユーザー名とパスワードが、暗号化および不正防止加工されたデジタル証明書に置換されます。

クライアント認証書では、匿名性は容認されません。クライアントからサーバーへのすべての接続には、クライアントの証明書、およびその証明書の妥当性を検証する公開キーが必要となります。

7-2 Oracle XML Gateway ユーザーズ・ガイド

Page 279: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

認証方法

インプリメンテーションインプリメンテーションインプリメンテーションインプリメンテーションOTA によって、一連の Java プログラムを使用してクライアント証明書の認証がインプリメントされます。OTA では、その環境におけるサーバー証明書、CA 証明書、秘密キー・ファイルおよびパスワードが認識されています。

SSL クライアントが SSL サーバーに接続されると、SSL ハンドシェイクが開始されます。SSL サーバーからクライアントおよびクライアントからサーバーへの認証には、SSL ハンドシェイク・プロトコルが使用されます。このプロトコルには、暗号化アルゴリズムおよびキーに関する合意事項も含まれています。

イベントの順序イベントの順序イベントの順序イベントの順序1. クライアントによって接続が開かれ、ClientHello が送信されます。このメッセージに

は、クライアントでサポートされている最新の SSL バージョン、セッション ID およびサポートされている圧縮方法のリストが含まれています。

2. サーバーでは、ServerHello が送信されます。SSL サーバーでは、ClientHello が受信されると、ハンドシェイク・エラー・アラートか ServerHello メッセージ(クライアントで使用される SSL バージョン、セッション ID、およびこのセッションに対してサーバーで選択された圧縮方法)のいずれかが発行されて、応答が行われます。

3. サーバーでは、CA(証明書に署名する機関)の証明書チェーンとともに証明書が送信されます。

4. クライアントでは、SSL 証明書チェーン・ファイル(クライアントが信頼する CA のリスト)にある CA 証明書を使用してサーバー証明書の妥当性が検証されます。

5. サーバーでは、クライアント証明書が要求されます。この要求は、クライアント認証モードでのみ行われます。このモードでは、証明書要求がクライアントに送信されます。

6. クライアントでは、CA(証明書に署名する機関)の証明書チェーンとともに証明書が送信されます。使用可能な証明書が存在しない場合、クライアントでは証明書が存在しないことを示すアラートが送信されます。このアラートを受け取った場合にどのような処理をするかは、SSL サーバーによって決定されます。SSL サーバーでは、匿名クライアントを使用して SSL トランザクションを続行したり、データ・ハンドシェイク・エラー・アラートを送信して通信を切断することができます。

7. クライアントでは、ClientKeyExchange が送信されます。クライアントでは、特定の公開キー・アルゴリズムに従って、キー交換メッセージを送信できます。

8. サーバーでは、CA を使用してクライアント証明書の妥当性が検証されます。

9. アプリケーション・データは、圧縮方法に応じて圧縮され、暗号化されます。

Oracle Transport Agent 7-3

Page 280: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

認証方法

サーバー認証サーバー認証サーバー認証サーバー認証

上の図は、次の詳細ステップを示します。

1. OTA クライアントでは、アウトバウンド・キューからメッセージがデキューされます。

2. OTA クライアントでは、最大再試行回数の妥当性が検証されます。

3. OTA クライアントでは、HTTP メッセージが作成されます。

4. クライアントでは、HTTP ハンドシェイクが開始され、宛先サーバーの証明書が要求されます。

5. 宛先 Web サーバーでは、そのサーバーの証明書が送信されます。

6. クライアントでは、サーバー証明書が受信されて妥当性が検証されます。

7. 認証されると、クライアントでは HTTP メッセージのヘッドおよび本文のデータ・ストリームを開始します。

8. サーバーでは、任意でユーザーおよびパスワードの妥当性が検証されます。

9. サーバーでは、転送プロトコルおよびバージョンの妥当性が検証されます。

サーバー認証�

クライアントとしての�OTAサーバー(送信者)�

サーバーとしての�OTAサーバー(受信者)�2)最大再試行回数を検証�

3)HTTPメッセージを作成�

15)クライアントが応答を読み取り�a. ステータス表を更新��b. エラーの場合、再試行回数を� 更新し、再試行を行う� メッセージをエンキュー�

4)HTTPハンドシェイクを開始/証明書を要求�

5)Webサーバーがそのサーバーの� 証明書を送信�

7)HTTPヘッド/本文のデータ・� ストリームを開始�

14)HTTP応答を返信�

証明書�認証局�

サーバー証明書�

8)ユーザー/パスワードの妥当性� を検証(任意)�9)転送プロトコル/バージョンを検証�10)アプリケーション・ユーザー� /パスワードの妥当性を検証�11)複製用のメッセージIDの妥当性� を検証�13)HTTP応答を作成�

6)サーバー証明書の�

妥当性を検証�

1)メッセージ�

をデキュー�

12)メッセージ�

をエンキュー�

7-4 Oracle XML Gateway ユーザーズ・ガイド

Page 281: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

認証方法

10. サーバーでは、アプリケーション・ユーザーおよびパスワードの妥当性が検証されます。

11. サーバーでは、複製用のメッセージ ID の妥当性が検証されます。

12. サーバーでは、使用するメッセージがエンキューされます。

13. サーバーでは、HTTP 応答メッセージが作成されます。

14. サーバーでは、HTTP 応答がクライアントに返信されます。

15. クライアントでは、この応答が読み取られ、ステータス表が更新されます。この応答がメッセージのエラーを示すものである場合、再試行回数が更新され、再試行を行うメッセージがエンキューされます。

クライアント認証�

クライアントとしての� OTAサーバー�(送信者)�

サーバーとしての� OTAサーバー�(受信者)�

2)最大再試行回数を検証�3)HTTPメッセージを作成�

17)クライアントが応答を読み取り�a. ステータス表を更新�b. エラーの場合、再試行回数を� 更新し、再試行を行う� メッセージをエンキュー�

4)HTTPハンドシェイクを開始/証明書を要求�

5)Webサーバーがそのサーバーの�証明書を送信、クライアント証明書を要求�

7)クライアントがクライアントの証明書を送信�

9)HTTPヘッド/本文のデータ・ストリームを開始�

16)HTTP応答を返信�

10)ユーザー/パスワードの�妥当性を検証(任意)�11)転送プロトコル/バージョンを検証�12)アプリケーション・ユーザー/�パスワードの妥当性を検証�13)複製用のメッセージIDの妥当性を�検証�

15)HTTP応答を作成�

サーバー�証明書� サーバー�

証明書�

6)サーバー証明書の�

妥当性を検証�

1)メッセージを�

デキュー�

14)メッセージを�

エンキュー�

8)クライアント証明書の�

妥当性を検証�

証明書�認証局�

証明書�認証局�

Oracle Transport Agent 7-5

Page 282: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

認証方法

クライアント認証クライアント認証クライアント認証クライアント認証

上の図は、次の詳細ステップを示します。

1. OTA クライアントでは、アウトバウンド・キューからメッセージがデキューされます。

2. OTA クライアントでは、最大再試行回数の妥当性が検証されます。

3. クライアントでは、HTTP メッセージが作成されます。

4. クライアントでは、HTTP ハンドシェイクが開始され、宛先サーバーの証明書が要求されます。

5. 宛先 Web サーバーでは、そのサーバーの証明書がクライアント・サーバーに返信され、クライアント証明書が要求されます。

6. クライアント証明書認証局によって、サーバー証明書の妥当性が検証されます。

7. 認証されると、クライアントではそのクライアントの証明書が送信されます。

8. サーバーの証明書認証局によって、クライアント証明書の妥当性が検証されます。

9. クライアントでは、HTTP メッセージのヘッドおよび本文のデータ・ストリームが開始されます。

10. サーバーでは、任意で Web サーバーのユーザーおよびパスワードの妥当性が検証されます。

11. サーバーでは、転送プロトコルおよびバージョンの妥当性が検証されます。

12. サーバーでは、アプリケーション・ユーザーおよびパスワードの妥当性が検証されます。

13. サーバーでは、複製用のメッセージ ID の妥当性が検証されます。

14. サーバーでは、使用するメッセージがエンキューされます。

15. サーバーでは、HTTP 応答メッセージが作成されます。

16. サーバーでは、HTTP 応答がクライアントに返信されます。

17. クライアントでは、この応答が読み取られ、ステータス表が更新されます。この応答がメッセージのエラーを示すものである場合、再試行回数が更新され、再試行を行うメッセージがエンキューされます。

追加情報追加情報追加情報追加情報 : Oracle MetaLink note「Understanding the Oracle Transport Agent Protocol」

7-6 Oracle XML Gateway ユーザーズ・ガイド

Page 283: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

メッセージ配信ステータス

メッセージ配信ステータスメッセージ配信ステータスメッセージ配信ステータスメッセージ配信ステータスXML メッセージ配信コールバックを使用すると、メッセージ・システム(Oracle Transport Agent など)では、メッセージの作成を開始したワークフロー・プロセスにメッセージの配信ステータスをレポートできるようになります。配信が失敗すると、システム管理者にワークフロー通知が送信されます。システム管理者は、このプロセスを再試行または再送信するか、あるいは強制終了または無視することができます。

XML メッセージ配信コールバックの使用メッセージ配信コールバックの使用メッセージ配信コールバックの使用メッセージ配信コールバックの使用

この機能が導入される前は、取引先にアウトバウンド文書を送信する通常のワークフロー・プロセスは、次のような文書の送信機能を使用して行われました。

文書の送信機能では、メッセージが作成され、このメッセージが ECX_OUTBOUND キューにエンキューされます。XML のメッセージ配信が失敗すると、ワークフロー全体が再実行されるため、不要なメッセージ作成ステップまでが再実行されていました。

メッセージ配信コールバックを使用すると、メッセージの作成とメッセージのエンキューが切り離されるため、メッセージの配信に失敗した場合はメッセージのエンキューのみが再実行されます。この新しいモデルは、取引先 XML 文書の生成機能およびワークフロー送信機能で構成されています。次の図を参照してください。

取引先 XML 文書の作成機能では、メッセージ・データが収集されます。ワークフロー送信イベントでは、メッセージが ECX_OUTBOUND キューにエンキューされます。

Oracle E-Business Suite アプリケーション・モジュールによって、このモデルに従うアウトバウンド文書に基づき、イベント・サブスクリプションとともにワークフローが配信されます。どちらのモデルも有効です。シードされたいずれのイベント・サブスクリプションも、使用不可にすることができます。シードされたイベント・サブスクリプションを使用不可にする方法の詳細は、「ワークフロー・プロセスの管理」(6-57 ページ)を参照してください。

受信� 文書の送信� 終了�

受信� 取引先�XML文書の作成�

ワークフロー送信� 終了�

Oracle Transport Agent 7-7

Page 284: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

メッセージ配信ステータス

XML メッセージ配信コールバックには、4 つの使用方法があります。次に、これらの方法の要約を示します。

ブロック・モードブロック・モードブロック・モードブロック・モード = Yブロック・モードは、ワークフロー送信イベント・アクティビティの属性です。ブロック・モード値 Y は、ワークフロー・プロセスがメッセージの配信ステータスを待機してから、ワークフロー・プロセス内の次のアクティビティに移行することを意味します。配信が失敗すると、ワークフロー・デフォルト・エラー・プロセスが実行されて、システム管理者に通知が送信されます。システム管理者は、エラーが修正されたと判断してプロセスを再試行するか、またはエラーが修正できない場合はプロセスを無視することができます。

� ユーザー・イベントを定義済

XML Gateway で生成される XML メッセージは、ECX_OUTBOUND キューにエンキューされます。メッセージ・システム(OTA や webMethods など)では、ECX_OUTBOUND キューからメッセージがデキューされ、取引先へのメッセージ配信が試行されます。任意のユーザー定義イベント(ワークフロー送信イベントで定義)が起動され、対応するイベント・サブスクリプションが実行されます。

成功か失敗かにかかわらず、メッセージの配信ステータスが戻されます。配信が失敗すると、ワークフロー・デフォルト・エラー・プロセスが実行されます。この機能により、システム管理者は処理を再試行または強制終了することができます。

� ユーザー・イベントを未定義

XML Gateway で生成される XML メッセージは、ECX_OUTBOUND キューにエンキューされます。メッセージ・システム(OTA や webMethods など)では、ECX_OUTBOUND キューからメッセージがデキューされ、取引先へのメッセージ配信が試行されます。成功か失敗かにかかわらず、配信ステータスが戻されます。配信が失敗すると、ワークフロー・デフォルト・エラー・プロセスが実行されます。この機能により、システム管理者は処理を再試行または強制終了することができます。

ブロック・モードブロック・モードブロック・モードブロック・モード = N ブロック・モード値 N は、ワークフロー・プロセスが、メッセージの配信ステータスを待機せずに、ワークフロー・プロセス内の次のアクティビティに移行することを意味します。配信が失敗すると、FYI_MESSAGE_DELIVERY_ERROR プロセスが実行されて、システム管理者に通知が送信されます。

システム管理者は、エラーが修正されたと判断して再送信するか、または処理が必要ない場合は通知を無視することができます。

(FYI)メッセージ配送エラーはシードされたプロセスで、XML Gateway エラー・プロセス項目タイプの一部です。

7-8 Oracle XML Gateway ユーザーズ・ガイド

Page 285: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

トラブルシューティング

� ユーザー・イベントを定義済

XML Gateway で生成される XML メッセージは、ECX_OUTBOUND キューにエンキューされます。メッセージ・システム(OTA や webMethods など)では、ECX_OUTBOUND キューからメッセージがデキューされ、取引先へのメッセージ配信が試行されます。任意のユーザー定義イベント(ワークフロー送信イベントで定義)が起動され、対応するイベント・サブスクリプションが実行されます。

配信が失敗すると、apps.ecx.processing.message.callbackイベントが起動します。FYI_MESSAGE_DELIVERY_ERROR プロセスに対応するイベント・サブスクリプションが実行されて、システム管理者はメッセージ通知を再送信するか、無視することができます。

� ユーザー・イベントを未定義

XML Gateway で生成される XML メッセージは、ECX_OUTBOUND キューにエンキューされます。メッセージ・システム(OTA や webMethods など)では、ECX_OUTBOUND キューからメッセージがデキューされ、取引先へのメッセージ配信が試行されます。

配信が失敗すると、apps.ecx.processing.message.callbackイベントが起動します。FYI_MESSAGE_DELIVERY_ERROR プロセスに対応するイベント・サブスクリプションが実行されて、システム管理者はメッセージ通知を再送信するか、無視することができます。

詳細は、「XML Gateway エラー・プロセス項目タイプ」(6-28 ページ)を参照してください。

他のメッセージ・システムで他のメッセージ・システムで他のメッセージ・システムで他のメッセージ・システムで XML メッセージ配信コールバックを使用すメッセージ配信コールバックを使用すメッセージ配信コールバックを使用すメッセージ配信コールバックを使用する方法る方法る方法る方法

webMethods や iAS などの他のメッセージ・システムでは、ECX_ERRORLOG.external_system API を呼び出すことによって、XML メッセージ配信コールバック機能を使用できます。この API は、メッセージの配信ステータスをレポートするために、すべてのメッセージ・システム(Oracle および非 Oracle)で使用されます。ステータス情報は、メッセージの配信データを追跡およびレポートする XML Gateway ログ表に書き込まれます。

API の詳細は、「ECX_ERRORLOG.external_system」(F-22 ページ)を参照してください。

トラブルシューティングトラブルシューティングトラブルシューティングトラブルシューティング「クライアント認証のインプリメントに関する一般的な問題」(G-8 ページ)を参照してください。

Oracle Transport Agent 7-9

Page 286: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

トラブルシューティング

7-10 Oracle XML Gateway ユーザーズ・ガイド

Page 287: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

マップ分析のガイドライ

A

マップ分析のガイドラインマップ分析のガイドラインマップ分析のガイドラインマップ分析のガイドライン

Message Designer を使用して新規メッセージ・マップを作成する前に、マップ分析を行う必要があります。この章では、次のトピックを通じて、マップ分析の実行方法について説明します。

� アウトバウンド・メッセージのマップ分析のプロシージャ

� インバウンド・メッセージのマップ分析のプロシージャ

� ソースおよびターゲット文書レベルの指定

ン A-1

Page 288: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

マップ分析の概要

マップ分析の概要マップ分析の概要マップ分析の概要マップ分析の概要Oracle E-Business Suite データ・モデルと要求されたメッセージの間でのデータのマップ方法を決定するために、マップ分析が必要になります。アウトバウンド・メッセージの場合は、マップ分析で Oracle E-Business Suite データベース・ビューと文書タイプ定義(DTD)または本番の XML メッセージを比較する必要があります。

マップ分析の結果は、XML Gateway Message Designer への入力として使用されます。メッセージ・マップを作成するには、その前に完全なマップ分析を完了することが不可欠です。マップ分析では、データの相違をすべて解決し、導出ルールを識別する必要があります。また、デフォルト値を識別し、データの変換および処理についての制御を「処理」で指定して、必要なすべてのターゲット・フィールドがマップされていることを確認する必要があります。

アウトバウンド・メッセージのマップ分析のガイドラインアウトバウンド・メッセージのマップ分析のガイドラインアウトバウンド・メッセージのマップ分析のガイドラインアウトバウンド・メッセージのマップ分析のガイドラインアウトバウンド・メッセージのマップ分析を実行するステップは、次のとおりです。

� データベース・ビュー(ソース)と DTD(ターゲット)の比較

� アプリケーション業務イベント・トリガーの指定

� 選択基準を定義する XML Gateway の必要な処理の追加

� ソース文書レベルおよびターゲット文書レベルの指定

アウトバウンド・メッセージのマップ分析のガイドラインのチェックリストアウトバウンド・メッセージのマップ分析のガイドラインのチェックリストアウトバウンド・メッセージのマップ分析のガイドラインのチェックリストアウトバウンド・メッセージのマップ分析のガイドラインのチェックリストアウトバウンド・メッセージを分析する場合は、次の進捗管理のチェックリストを使用します。各ステップの詳細は以降の項で説明します。ステップが完了したら「完了」列にチェック・マークを記入します。

ステップステップステップステップ 完了済完了済完了済完了済 摘要摘要摘要摘要

1 ワークシートの作成ワークシートの作成ワークシートの作成ワークシートの作成 : ワークシートを作成してすべてのデータを識別し

ます。

2 ソースの設定ソースの設定ソースの設定ソースの設定 : データベース・ビューを作成するか、またはデータベー

ス・スキーマから必要なメッセージのデータベース・ビューかデータベース表の定義(ソース)を取得します。

3 ターゲットの設定ターゲットの設定ターゲットの設定ターゲットの設定 : ワークシートのターゲット列に拡張フォーマットの

DTD または本番の XML メッセージを挿入します。

3A 必要な DTD(ターゲット)要素を指定します。

3B 発生識別子として "|" が使用されている DTD 要素に対して、リストか

ら 1 つの要素を選択します。パーサーの違反を避けるために、選択しな

かった要素をメッセージ・マップから削除する必要があるため、選択しなかった要素を記録します。

A-2 Oracle XML Gateway ユーザーズ・ガイド

Page 289: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アウトバウンド・メッセージのマップ分析のガイドライン

4 ソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付け : 各 DTD(ターゲット)要素

に対して、マップ元のデータベース・ビュー(ソース)列を指定します。

4A コード変換が必要な場合を指定します。

4B 導出ルールを指定します。

4C デフォルト設定ルールを指定します。

4D DTD 属性の設定を指定します。

5 Oracle フォーマットからフォーマットからフォーマットからフォーマットから OAG フォーマットへの変換フォーマットへの変換フォーマットへの変換フォーマットへの変換 : OAG DTD(ターゲット)の各 DATETIME、AMOUNT、OPERAMT または

QUANTITY 要素に対して、マップ元のデータベース・ビューまたは

データベース表(ソース)の列を指定します。その他の XML 標準に同

様の要素がある場合もあります。

5A 各 DATETIME 要素を識別してマップします。

5B 各 AMOUNT 要素を識別してマップします。

5C 各 OPERAMT 要素を識別してマップします。

5D 各 QUANTITY 要素を識別してマップします。

6 複数のノード複数のノード複数のノード複数のノード / 要素の兄弟を追加要素の兄弟を追加要素の兄弟を追加要素の兄弟を追加 : 必要に応じて兄弟ノードおよび兄弟

要素を追加します。

7 フレックスフィールドのフレックスフィールドのフレックスフィールドのフレックスフィールドの DTD 定義を拡張する子の追加定義を拡張する子の追加定義を拡張する子の追加定義を拡張する子の追加 : マップ元とな

るデータベース・ビュー列またはデータベース表列に対して、それをサポートする DTD 要素が定義されていない場合は、OAG の USERAREAを使用できます。データを USERAREA または対応する領域(他の

XML 標準を使用する場合)にマップします。

8 データの相違の解決データの相違の解決データの相違の解決データの相違の解決 : マップされていない DTD(ターゲット)要素は、

データの相違となります。

9 アプリケーション業務イベント・トリガーの指定アプリケーション業務イベント・トリガーの指定アプリケーション業務イベント・トリガーの指定アプリケーション業務イベント・トリガーの指定 : メッセージ作成をト

リガーするアプリケーション業務イベントを指定します。

ステップステップステップステップ 完了済完了済完了済完了済 摘要摘要摘要摘要

マップ分析のガイドライン A-3

Page 290: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アウトバウンド・メッセージのマップ分析のガイドライン

データベース・ビュー(ソース)とデータベース・ビュー(ソース)とデータベース・ビュー(ソース)とデータベース・ビュー(ソース)と DTD(ターゲット)の比較(ターゲット)の比較(ターゲット)の比較(ターゲット)の比較

ステップステップステップステップ 1 ワークシートの作成ワークシートの作成ワークシートの作成ワークシートの作成次の表に示すように、ターゲット、必須(Y/N)、ソース、コード・カテゴリ、導出ルール、デフォルト値および処理の列があるワークシートを作成します。

ステップステップステップステップ 2 ソースの設定ソースの設定ソースの設定ソースの設定データベース・ビューを作成するか、またはデータベース・スキーマから必要なメッセージのデータベース・ビュー定義およびデータベース表定義(ソース)を取得します。DTD のCNTROLAREA セグメントにマップするように、ECX_OAG_CONTROLAREA_V またはECX_OAG_CONTROLAREA_TP_V(「注意」(2-32 ページ)を参照)ビューを含めます。

10 必要な処理の指定必要な処理の指定必要な処理の指定必要な処理の指定 : すべてのアウトバウンド・メッセージには、選択基

準を定義する次の処理が必要になります。ワークシートに、これらの処理が含まれるように記述します。

WHERE 句の追加処理を使用して、トランザクション・タイプ、トラン

ザクション・サブタイプ、パーティ ID およびパーティ・サイト ID を

ECX_OAG_CONTROLAREA_TP_V(以前の ECX_OAG_CONTROLAREA_V にバインドします。「注意」(2-32 ページ)を参照

してください。

ECX_OAG_CONTROLAREA_V を使用する場合は、トランザクショ

ン・タイプおよびトランザクション・サブタイプを、WHERE 句の追加

処理を使用してバインドします。

WHERE 句の追加処理を使用して、文書 ID をヘッダー・ビューにバイ

ンドし、文書を選択します。

11 ソース文書レベルおよびターゲット文書レベルの指定ソース文書レベルおよびターゲット文書レベルの指定ソース文書レベルおよびターゲット文書レベルの指定ソース文書レベルおよびターゲット文書レベルの指定

ターゲットターゲットターゲットターゲット 必須(必須(必須(必須(Y/N)))) ソースソースソースソース コード・コード・コード・コード・カテゴリカテゴリカテゴリカテゴリ

導出ルール導出ルール導出ルール導出ルール デフォルトデフォルトデフォルトデフォルト値値値値

処理処理処理処理

ステップステップステップステップ 完了済完了済完了済完了済 摘要摘要摘要摘要

A-4 Oracle XML Gateway ユーザーズ・ガイド

Page 291: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アウトバウンド・メッセージのマップ分析のガイドライン

ステップステップステップステップ 3 ターゲットの設定ターゲットの設定ターゲットの設定ターゲットの設定ワークシートのターゲット列に拡張フォーマットの DTD または本番の XML メッセージを挿入します。

ステップステップステップステップ 3A 必要なターゲット要素の指定必要なターゲット要素の指定必要なターゲット要素の指定必要なターゲット要素の指定

必要な DTD(ターゲット)要素を指定します。要素名の隣に特別な記号がない場合、要素は必須になります。

XML 発生識別子は、次のとおりです。

"+" は、1 つ以上を意味します。

"*" は、0 以上を意味します。

"?" は、0 または 1 を意味します。

"|" は、いずれか一方を意味します。

"," は、リストされたすべての子要素を、示されている順序で使用する必要があることを意味します。

ステップステップステップステップ 3B 発生識別子として発生識別子として発生識別子として発生識別子として "|" が使用されている要素の場合が使用されている要素の場合が使用されている要素の場合が使用されている要素の場合

発生識別子として "|" が使用されている DTD 要素に対して、リストから 1 つの要素を選択します。選択しなかった要素をメッセージ・マップから削除するために、それらの要素を記録します。パーサーの違反を避けるために、選択しなかった要素をメッセージ・マップから削除する必要があります。

ステップステップステップステップ 4 ソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付け各 DTD(ターゲット)要素に対して、マップ元のデータベース・ビュー(ソース)列を指定します。

注意注意注意注意 : サード・パーティ製のソフトウェアを使用して DTD を拡張するか、または本番の XML メッセージを使用できます。

注意注意注意注意 : DTD で指定される各要素の詳細説明は、『Open Application Group's Integration Specification』

(http://www.openapplications.org)の付録 C「Field Identifier Descriptions」および付録 D「Segment Descriptions」を参照してください。

マップ分析のガイドライン A-5

Page 292: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アウトバウンド・メッセージのマップ分析のガイドライン

ステップステップステップステップ 4ADTD(ターゲット)要素のソースにデータベース・ビュー(ソース)列を使用できる場合、データベース・ビュー列値のコード変換が必要かどうかを指定します。

� コード換算が必要な場合は、付録 B にあるリストからコード・カテゴリを指定します。

� 必要な値がデータベースで使用可能かどうかを判別するための下限の値または上限の値を指定します。値が使用可能でない場合は、値を追加する必要があります。

ステップステップステップステップ 4B 導出ルールの指定導出ルールの指定導出ルールの指定導出ルールの指定

DTD(ターゲット)要素のソースにデータベース・ビュー(ソース)列を使用できない場合は、値を導出できるかどうかを指定します。導出できる場合は、導出ルールを指定します。導出ルールは、たとえば、複数のビュー列の組合せ、プロシージャ・コール、ファンクション・コールなどです。XML Gateway 処理が要求される場合があることを記述します(たとえば、別の列から値を取得する、複数の列の値を組み合せるなど)。

XML Gateway でサポートされている処理のリストは、付録 C を参照してください。

導出値にコード変換が必要かどうかを指定します。コード変換が必要な場合は、付録 B にあるリストからコード・カテゴリを指定します。

ステップステップステップステップ 4C デフォルト設定ルールの指定デフォルト設定ルールの指定デフォルト設定ルールの指定デフォルト設定ルールの指定

DTD(ターゲット)要素のソースにデータベース・ビュー(ソース)列を使用できず、値の導出もできない場合は、値をデフォルト設定できるかどうかを指定します。デフォルト設定が可能な場合は、デフォルト値を指定します。デフォルト値は、リテラルにするか、または別のデータベース・ビュー列の値に基づいた値にすることができます。XML Gateway 処理が必要な場合があることを記述します。

デフォルト値は、Message Designer を使用してマップに直接設定できます。または、デフォルト値が条件に基づいている場合は、XML Gateway 処理として設定できます。

XML Gateway でサポートされている処理のリストは、「トランザクション・マップ - 処理」(2-67 ページ)を参照してください。

デフォルト値にコード変換が必要かどうかを指定します。コード変換が必要な場合は、付録B にあるリストからコード・カテゴリを指定します。

注意注意注意注意 : 必要な値がデータベースで使用可能かどうかを判別するための下限の値または上限の値を指定します。値が使用可能でない場合は、値を追加する必要があります。

注意注意注意注意 : 必要な値がデータベースで使用可能かどうかを判別するための下限の値または上限の値を指定します。値が使用可能でない場合は、値を追加する必要があります。

A-6 Oracle XML Gateway ユーザーズ・ガイド

Page 293: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アウトバウンド・メッセージのマップ分析のガイドライン

ステップステップステップステップ 4D DTD 属性の設定を指定属性の設定を指定属性の設定を指定属性の設定を指定

属性(小文字のタグ)を含む各 DTD(ターゲット)要素に対して、データベース・ビュー列またはデータベース表列の用途をチェックして、適切な設定を決定します。次に、DTD要素のセグメントの摘要をリストしている OAG の付録 D を調べ、属性の有効な設定を指定します。適切な属性設定は、Message Designer を使用して、デフォルト値としてターゲット定義に直接設定します。

たとえば、ビュー列を作成日として使用する場合、Message Designer を使用してDATETIME クオリファイア属性値の CREATION をデフォルト値として設定します。

ステップステップステップステップ 5 Oracle フォーマットからフォーマットからフォーマットからフォーマットから OAG フォーマットへの変換フォーマットへの変換フォーマットへの変換フォーマットへの変換DTD(ターゲット)の各 DATETIME、AMOUNT、OPERAMT または QUANTITY 要素に対して、マップ元のデータベース・ビューまたはデータベース表(ソース)の列を指定します。

Oracle E-Business Suite では、日付、金額、営業金額および数量が 1 つのデータベース列で表されます。OAG では、これらのデータは集合として表されます。Oracle XML Gatewayでは、Oracle の表現を OAG の表現に変換する処理が用意されています。Message Designerを使用して定義される OAG への変換処理がこの列に必要であることを記述します。

ステップステップステップステップ 5A� DATETIME 要素に対して、日付に使用するデータベース・ビューまたはデータベース

表(ソース)の列を指定します。

� ステップ 4D に従って、クオリファイア、タイプおよび索引の各属性を設定します。

� その他すべての OAG フィールドは、OAG への変換処理により日付値に基づいて設定されます。

� TIMEZONE のデフォルト設定はグリニッジ標準時(GMT)です。

ステップステップステップステップ 5B� AMOUNT 要素に対して、通貨コードおよびクレジット / デビット・フラグに使用する

データベース・ビューまたはデータベース表(ソース)の列が使用可能な場合は、列を指定します。XML Gateway の OAG への変換処理は、ビュー列値または表列値を使用するように定義したり、ビュー列または表列が使用可能でない場合は OAG 推奨値をデフォルトとして定義することもできます。

� ステップ 4D に従って、クオリファイア、タイプおよび索引の各属性を設定します。

注意注意注意注意 : OAG DATETIME は、クオリファイア、タイプ、索引、YEAR、MONTH、DAY、HOUR、MINUTE、SECOND、SUBSECOND、TIMEZONE の属性および要素で構成されています。

マップ分析のガイドライン A-7

Page 294: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アウトバウンド・メッセージのマップ分析のガイドライン

� NUMOFDEC および SIGN に使用する OAG フィールドは、OAG への変換処理により金額値に基づいて設定されます。

ステップステップステップステップ 5C� OPERAMT フィールドに対して、通貨および単位コードに使用するデータベース・

ビューまたはデータベース表(ソース)の列が使用可能な場合は、列を指定します。XML Gateway の OAG への変換処理は、ビュー列値または表列値を使用するように定義したり、ビュー列または表列が使用可能でない場合は OAG 推奨値をデフォルトとして定義することもできます。

� ステップ 4D に従って、クオリファイアおよびタイプの各属性を設定します。

� NUMOFDEC、SIGN、UOMVALUE および UOMNUMDEC に使用する OAG フィールドは、OAG への変換処理により営業金額値に基づいて設定されます。

ステップステップステップステップ 5DQUANTITY 要素に対して、単位コードに使用するデータベース・ビューまたはデータベース表(ソース)の列が使用可能な場合は、列を指定します。XML Gateway の OAG への変換処理は、ビュー列値または表列値を使用するように定義したり、ビュー列または表列が使用可能でない場合は OAG 推奨値をデフォルト設定するように定義することもできます。

ステップ 4D に従って、クオリファイア属性を設定します。

NUMOFDEC および SIGN に使用する OAG フィールドは、OAG への変換処理により数量値に基づいて設定されます。

注意注意注意注意 : OAG AMOUNT は、クオリファイア、タイプ、索引、VALUE、NUMOFDEC、SIGN、CURRENCY、DRCR の属性および要素で構成されています。

注意注意注意注意 : OAG OPERAMT は、クオリファイア、タイプ、VALUE、NUMOFDEC、SIGN、CURRENCY、UOMVALUE、UOMNUMDEC、UOM の属性および要素で構成されています。

注意注意注意注意 : OAG QUANTITY は、クオリファイア、VALUE、NUMOFDEC、SIGN、UOM の属性および要素で構成されています。

A-8 Oracle XML Gateway ユーザーズ・ガイド

Page 295: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アウトバウンド・メッセージのマップ分析のガイドライン

ステップステップステップステップ 6 複数のノード複数のノード複数のノード複数のノード / 要素の兄弟を追加要素の兄弟を追加要素の兄弟を追加要素の兄弟を追加DTD ではノードまたは要素の 1 回のオカレンスを定義します。マップ元のデータベース・ビューまたはデータベース表(ソース)に複数のオカレンスがある場合は、複数のするノードまたは要素を示す記述をワークシートに追加し、要素および複数のノードまたは要素の属性をマップします。Message Designer を使用して兄弟を追加することを記述します。

例として、Oracle E-Business Suite から SHIP-TO、BILL-TO および REMIT-TO をマップするために使用する PARTNER を表す DTD 要素があります。BILL-TO および REMIT-TO をマップするために、2 つの兄弟 PARTNER ノード(同じ階層レベル)を追加する必要があります。

ステップステップステップステップ 7 フレックスフィールドのフレックスフィールドのフレックスフィールドのフレックスフィールドの DTD 定義を拡張する子の追加定義を拡張する子の追加定義を拡張する子の追加定義を拡張する子の追加マップ元のデータベース・ビュー列またはデータベース表列をサポートする DTD 要素が定義されていない場合は、USERAREA を使用できます。USERAREA を別の USERAREA の兄弟(同じ階層レベル)として追加できます。または、子(階層の次のレベル)要素を追加し、その要素をマップして、既存の USERAREA を拡張できます。Message Designer を使用して子を追加することを記述します。

この方法は、データベース・ビューおよびデータベース表に含まれるすべてのフレックスフィールドをサポートするために必要になります。ユーザーのサイトで実装されるフレックスフィールドは特定できないため、すべてのフレックスフィールドをマップする必要があります。

詳細は、「DTD の拡張方法」(2-110 ページ)を参照してください。

ステップステップステップステップ 8 データの相違の解決データの相違の解決データの相違の解決データの相違の解決この時点で、可能な限り多くの DTD(ターゲット)要素に対してデータベース・ビューおよびデータベース表(ソース)の列の指定が完了しました。マップされていない必要なDTD(ターゲット)要素は、データの相違を表します。

データベース・ビューまたはデータベース表に含まれるアプリケーション・フレックスフィールドを使用してデータの相違を解決することを検討します。これが有効なオプションである場合は、指定フレックスフィールドを定義し、Oracle E-Business Suite に挿入することによって実装する必要があります。ユーザーが実装したフレックスフィールドが上書きされないように、実装するフレックスフィールドを慎重に検討してください。

データベース・ビューに含まれないアプリケーション列を使用してデータの相違を解決することを検討します。これが有効なオプションである場合は、表および列を直接参照するのではなく、アプリケーション列を組み込むようにデータベース・ビューを変更する必要があります。変更したデータベース・ビューをデータベース・スキーマにロードします。必ずこのフィールドをマップしてください。

注意注意注意注意 : DTD には、USERAREA に対する更新のみ可能です。その他の変更を行うと DTD は無効になります。

マップ分析のガイドライン A-9

Page 296: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アウトバウンド・メッセージのマップ分析のガイドライン

前述の考慮事項のいずれによってもデータの相違が解決されない場合は、アプリケーション・モジュールに機能を追加し、新規データベース・ビューを作成する必要があります。次に、作成した新しいビューをデータベース・スキーマにロードし、メッセージ・マップを作成する必要があります。

ステップステップステップステップ 9 アプリケーション・イベント・トリガーの指定アプリケーション・イベント・トリガーの指定アプリケーション・イベント・トリガーの指定アプリケーション・イベント・トリガーの指定メッセージ作成をトリガーするアプリケーション業務イベントを指定します。一般的なトリガー・ポイントは、文書が作成、確認、更新または削除された時点です。

Oracle Workflow 業務イベント・システムを使用して業務イベントを登録し、メッセージを作成および送信するための対応するイベント・サブスクリプションを定義します。

アプリケーション業務イベントの登録およびサブスクリプションの詳細は、「Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合」(6-1 ページ)を参照してください。

ステップステップステップステップ 10 必要な処理の指定必要な処理の指定必要な処理の指定必要な処理の指定すべてのアウトバウンド・メッセージには、選択基準を指定する次の処理が必要になります。ワークシートに、これらの処理が含まれるように記述します。

� ECX_OAG_CONTROLAREA_TP_V を使用する場合は、トランザクション・タイプ、トランザクション・サブタイプ、パーティ ID およびパーティ・サイト ID を、WHERE 句の追加処理を使用してバインドします。

ECX_OAG_CONTROLAREA_V を使用する場合は、トランザクション・タイプおよびトランザクション・サブタイプを、WHERE 句の追加処理を使用してバインドします。

� WHERE 句の追加処理を使用して、文書 ID をヘッダー・ビューにバインドし、文書を選択します。

ステップステップステップステップ 11 ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定「ソースおよびターゲット文書レベルの指定」(A-19 ページ)を参照してください。

注意注意注意注意 : ECX_OAG_CONTROLAREA_TP_V ビューは、ECX_OAG_CONTROLAREA_V ビューのアップグレード・バージョンです。Oracle XML Gateway では、両方のバージョンのデータベース・ビューがサポートされています。詳細は、「注意」(2-32 ページ)を参照してください。

A-10 Oracle XML Gateway ユーザーズ・ガイド

Page 297: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのマップ分析のガイドライン

インバウンド・メッセージのマップ分析のガイドラインインバウンド・メッセージのマップ分析のガイドラインインバウンド・メッセージのマップ分析のガイドラインインバウンド・メッセージのマップ分析のガイドラインインバウンド・メッセージのマップ分析プロセスは、次のステップで構成されています。

� DTD(ソース)とアプリケーション・オープン・インタフェース表(ターゲット)の比較

� XML Gateway の必要な処理の追加

� XML Gateway のオプションの処理の追加

� ソース文書レベルおよびターゲット文書レベルの指定

インバウンド・メッセージのマップ分析のガイドラインのチェックリストインバウンド・メッセージのマップ分析のガイドラインのチェックリストインバウンド・メッセージのマップ分析のガイドラインのチェックリストインバウンド・メッセージのマップ分析のガイドラインのチェックリストインバウンド・メッセージを分析する場合は、次の進捗管理のチェックリストを使用します。各ステップの詳細は以降の項で説明します。「完了」列には、完了データを入力するか、またはステップが完了したときにチェック・マークを記入します。

ステップステップステップステップ 完了済完了済完了済完了済 摘要摘要摘要摘要

1 ワークシートの作成ワークシートの作成ワークシートの作成ワークシートの作成 : ワークシートを作成してすべてのデータを識別し

ます。

2 ソースの設定ソースの設定ソースの設定ソースの設定 : 必要なメッセージの DTD(ソース)を取得するか、ま

たは本番の XML メッセージを使用します。

3 ターゲットの設定ターゲットの設定ターゲットの設定ターゲットの設定 : ワークシートのターゲット列にアプリケーション・

オープン・インタフェース表の定義またはアプリケーション API パラ

メータ・リストを挿入します。

3A 必要なアプリケーション・オープン・インタフェース(ターゲット)表列またはアプリケーション API パラメータを指定します。

4 ソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付け : 各アプリケーション・オープ

ン・インタフェース(ターゲット)表列に対して、マップ元の DTD(ソース)要素を指定します。

4A コード変換が必要な場合を指定します。

4B 導出ルールを指定します。

4C デフォルト設定ルールを指定します。

5 OAG フォーマットからフォーマットからフォーマットからフォーマットから Oracle フォーマットへの変換フォーマットへの変換フォーマットへの変換フォーマットへの変換 : 各 OAG DTD(ソース)の DATETIME、AMOUNT、OPERAMT または QUANTITY要素に対して、マップ先のアプリケーション・オープン・インタフェース(ターゲット)列またはアプリケーション API パラメータを指定し

ます。その他の XML 標準に同様の要素がある場合もあります。

5A 各 DATETIME 要素を識別してマップします。

5B 各 AMOUNT 要素を識別してマップします。

5C 各 OPERAMT 要素を識別してマップします。

マップ分析のガイドライン A-11

Page 298: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのマップ分析のガイドライン

5D 各 QUANTITY 要素を識別してマップします。

6 複数のノード複数のノード複数のノード複数のノード / 要素の兄弟を追加要素の兄弟を追加要素の兄弟を追加要素の兄弟を追加 : 必要に応じて兄弟ノードおよび兄弟

要素を追加します。

7 DTD USERAREA のレビューのレビューのレビューのレビュー : OAG のすべての USERAREA 定義をレ

ビューし、アプリケーション・オープン・インタフェース表列またはアプリケーション API パラメータにマップする必要があるかどうかを判

断します。その他の XML 標準に同様の要素がある場合もあります。

8 データの相違の解決データの相違の解決データの相違の解決データの相違の解決 : アプリケーション・オープン・インタフェース

(ターゲット)表列またはアプリケーション API パラメータと同じ数の

DTD(ソース)要素(ソース)を指定し、データの相違を識別します。

9 オプションの処理オプションの処理オプションの処理オプションの処理 : アプリケーション・オープン・インタフェース表を

使用して着信データをステージングし、ステージングしたデータをアプリケーション・オープン・インタフェース API を使用して検証するア

プリケーション製品の場合

データベース表への挿入処理を使用して、アプリケーション・オープン・インタフェース表にデータを挿入します。

プロシージャ・コール処理を使用して、アプリケーション・オープン・インタフェース API を実行します。

ステージ表と検証 API を組み合せたアプリケーション API を使用する

アプリケーション製品の場合

プロシージャ・コール処理を使用して、ソース(DTD)データをアプ

リケーション API パラメータ・リストにマップします。

10 必要な処理必要な処理必要な処理必要な処理 : インバウンド処理の完了を示すビジネス・イベントを発生

させるルートレベルの後処理を追加します。

ECX_STANDARD.setEventDetails のプロシージャ・コール処理を追加

します。API の付録の「setEventDetails」(F-3 ページ)を参照してくだ

さい。

11 ソース文書レベルおよびターゲット文書レベルの指定ソース文書レベルおよびターゲット文書レベルの指定ソース文書レベルおよびターゲット文書レベルの指定ソース文書レベルおよびターゲット文書レベルの指定

ステップステップステップステップ 完了済完了済完了済完了済 摘要摘要摘要摘要

A-12 Oracle XML Gateway ユーザーズ・ガイド

Page 299: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのマップ分析のガイドライン

データベース・ビュー(ソース)とデータベース・ビュー(ソース)とデータベース・ビュー(ソース)とデータベース・ビュー(ソース)と DTD(ターゲット)の比較(ターゲット)の比較(ターゲット)の比較(ターゲット)の比較

ステップステップステップステップ 1 ワークシートの作成ワークシートの作成ワークシートの作成ワークシートの作成次の表に示すように、ターゲット、必須(Y/N)、ソース、コード・カテゴリ、導出ルール、デフォルト値および処理の列があるワークシートを作成します。

ステップステップステップステップ 2 ソースの設定ソースの設定ソースの設定ソースの設定必要なメッセージの DTD(ソース)を取得するか、または本番の XML メッセージを使用します。

『Open Applications Group Integration Specification』の付録 C のフィールド識別子、付録 Dのセグメントの摘要を追加します。

ステップステップステップステップ 3 ターゲットの設定ターゲットの設定ターゲットの設定ターゲットの設定ワークシートのターゲット列にアプリケーション・オープン・インタフェース表の定義またはアプリケーション API パラメータ・リストを挿入します。

ステップステップステップステップ 3A 必要なターゲット要素の指定必要なターゲット要素の指定必要なターゲット要素の指定必要なターゲット要素の指定

次のように、必要なアプリケーション・オープン・インタフェース(ターゲット)表列またはアプリケーション API パラメータ・リストを指定します。

� データ・モデルに定義された NOT NULL 列

� NOT NULL として定義されていない必要な列を強制使用するアプリケーション・オープン・インタフェース API またはアプリケーション API のコード

� 必要な列および関連する導出ルールおよびデフォルト設定ルールを指定した、オープン・インタフェース API またはアプリケーション API の(製品の)文書

ターゲットターゲットターゲットターゲット 必須(必須(必須(必須(Y/N)))) ソースソースソースソース コード・コード・コード・コード・カテゴリカテゴリカテゴリカテゴリ

導出ルール導出ルール導出ルール導出ルール デフォルトデフォルトデフォルトデフォルト値値値値

処理処理処理処理

注意注意注意注意 : サード・パーティ製のソフトウェアを使用して DTD を拡張するか、または本番の XML メッセージを使用できます。

注意注意注意注意 : サード・パーティ製のソフトウェアを使用して DTD を拡張するか、または本番の XML メッセージを使用できます。

マップ分析のガイドライン A-13

Page 300: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのマップ分析のガイドライン

ステップステップステップステップ 4 ソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付けソース要素とターゲット要素の関連付け各アプリケーション・オープン・インタフェース(ターゲット)表列に対して、マップ元のDTD(ソース)要素を指定します。

ターゲット列を内部 ID に使用する場合は、後述のステップ 4B および 4C に示すように、導出ルールまたはデフォルト設定ルールを使用してこれを解決する必要があります。送信者には有効な ID が不明なため、送信者からは ID を送信できません。XML Gateway には、アドレスおよび組織 ID を導出する導出処理が用意されています。

DTD 属性(小文字のタグ)は Oracle E-Business Suite に保存されないため、マップされません。ただし、属性の値を使用して、マップ先のアプリケーション・オープン・インタフェース表列またはアプリケーション API パラメータを正確に判別できます。

ステップステップステップステップ 4Aアプリケーション・オープン・インタフェース(ターゲット)表列のソースに DTD(ソース)要素を使用できる場合は、結果が Oracle E-Business Suite に対して有効な値となるために DTD(ソース)要素値のコード変換が必要かどうかを判別します。

コード換算が必要な場合は、付録 B にあるリストからコード・カテゴリを指定します。

必要な値が、使用するデータベースで使用可能かどうかを判別するための下限の値または上限の値を指定します。値が使用可能でない場合は、値を追加する必要があります。

ステップステップステップステップ 4B 導出ルールの指定導出ルールの指定導出ルールの指定導出ルールの指定

アプリケーション・オープン・インタフェース(ターゲット)表列のソースに DTD(ソース)要素を使用できない場合は、導出できるかどうかを判別します。ご使用の製品のアプリケーション・オープン・インタフェースの文書を参照し、定義済導出ルールがあるかどうかを調べます。導出ルールが定義されている場合は、導出ルールをサポートするデータが着信メッセージによって提供されることを確認します。アプリケーション・オープン・インタフェース API では、そのデータを使用してターゲット列の値を導出します。単体テストで導出ルールを検証できるように、ワークシートに導出ルールを記述します。

導出ルールが定義されていない場合は、導出ルールを定義できます。導出ルールは、複数のDTD 要素または複数のデフォルト値に基づいて定義できます。ワークシートに導出ルールを記述します。処理が要求される場合があることを記述します。

XML Gateway でサポートされている処理のリストは、「トランザクション・マップ - 処理」(2-67 ページ)を参照してください。

注意注意注意注意 : DTD で指定される各要素の詳細説明は、『Open Applications Group Integration Specification』の付録 C(「Field Identifier Descriptions」)および付録 D(「Segment Descriptions」)を参照してください。

A-14 Oracle XML Gateway ユーザーズ・ガイド

Page 301: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのマップ分析のガイドライン

導出ルール(要素またはリテラル)で取引先コード換算が必要かどうかを判別します。コード換算が必要な場合は、付録 B にあるリストからコード・カテゴリを指定します。

必要な値がデータベースで使用可能かどうかを判別するための下限の値または上限の値を指定します。値が使用可能でない場合は、値を追加する必要があります。

ステップステップステップステップ 4C デフォルト設定ルールの指定デフォルト設定ルールの指定デフォルト設定ルールの指定デフォルト設定ルールの指定

アプリケーション・オープン・インタフェース(ターゲット)表列のソースに DTD(ソース)要素を使用できず、導出もできない場合は、デフォルト設定できるかどうかを判別します。ご使用の製品のアプリケーション・オープン・インタフェースの文書を参照し、定義済デフォルト設定ルールがあるかどうかを調べます。デフォルト設定ルールが定義されている場合は、デフォルト設定ルールをサポートするデータが着信メッセージによって提供されることを確認します。アプリケーション・オープン・インタフェース API では、そのデータをターゲット列のデフォルト値として使用します。単体テストでデフォルト設定ルールを検証できるように、ワークシートにデフォルト設定ルールを記述します。

デフォルト設定ルールが定義されていない場合、デフォルト設定ルールを定義できます。デフォルト値は、Message Designer を使用してターゲット定義に直接設定するか、またはデフォルト値が条件に基づいている場合は XML Gateway 処理として設定できます。付録 C

「XML Gateway でサポートされている処理」を参照してください。

デフォルト設定ルール(要素またはリテラル)で取引先コード換算が必要かどうかを判別します。コード換算が必要な場合は、付録 B にあるリストからコード・カテゴリを指定します。

必要な値がデータベースで使用可能かどうかを判別するための下限の値または上限の値を指定します。値が使用可能でない場合は、値を追加する必要があります。

ステップステップステップステップ 5 OAG フォーマットからフォーマットからフォーマットからフォーマットから Oracle フォーマットへの変換フォーマットへの変換フォーマットへの変換フォーマットへの変換DTD(ソース)の各 DATETIME、AMOUNT、OPERAMT または QUANTITY 要素に対して、マップ先にアプリケーション・オープン・インタフェース(ターゲット)列またはアプリケーション API パラメータを指定します。

Oracle E-Business Suite では、日付、金額、営業金額および数量が 1 つのデータベース列で表されます。OAG では、これらがデータの集合として表されます。Oracle XML Gatewayでは、OAG の表現を Oracle の表現に変換する処理が用意されています。Message Designerを使用して定義される OAG からの変換処理がこの列に必要であることを記述します。

ステップステップステップステップ 5ADATETIME 要素に対して、日付に使用するアプリケーション・オープン・インタフェース

(ターゲット)表列を指定します。

クオリファイア、タイプおよび索引の各属性の値は、日付に使用するアプリケーション・オープン・インタフェース表列に意味が暗黙的に指定されるため、マップされません。

マップ分析のガイドライン A-15

Page 302: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのマップ分析のガイドライン

ステップステップステップステップ 5BAMOUNT 要素に対して、通貨コードおよびクレジット / デビット・フラグに使用するアプリケーション・オープン・インタフェース(ターゲット)表列が使用可能な場合は、列を指定します。XML Gateway の OAG からの変換処理は、指定した列に OAG の通貨コードおよびクレジット / デビット・フラグを保存するように定義するか、または列が使用可能でない場合は無視することができます。

クオリファイア、タイプおよび索引の各属性の値は、アプリケーション・オープン・インタフェース表列に意味が暗黙的に指定されるため、マップされません。

NUMOFDEC および SIGN の値は、Oracle での金額値の表現に暗黙的に指定されます。アプリケーションでサポートされていない限り、これらの値はマップされません。この場合、Message Designer を使用して値をマップする必要があります。

ステップステップステップステップ 5COPERAMT 要素に対して、通貨コードおよび単位コードに使用するアプリケーション・オープン・インタフェース(ターゲット)表列が使用可能な場合は、列を指定します。XML Gateway の OAG からの変換処理は、指定した列に OAG の通貨コードおよび単位コードを保存するように定義するか、または列が使用可能でない場合は無視することができます。

クオリファイアおよびタイプの各属性の値は、アプリケーション・オープン・インタフェース表列に意味が暗黙的に指定されるため、マップされません。

NUMOFDEC、SIGN、UOMVALUE および UOMNUMDEC の値は、Oracle での営業金額値の表現に暗黙的に指定されます。アプリケーションでサポートされていない限り、これらの値はマップされません。この場合、Message Designer を使用して値をマップする必要があります。

注意注意注意注意 : OAG DATETIME は、クオリファイア、タイプ、索引、YEAR、MONTH、DAY、HOUR、MINUTE、SECOND、SUBSECOND、TIMEZONE の属性および要素で構成されています。

注意注意注意注意 : OAG AMOUNT は、クオリファイア、タイプ、索引、VALUE、NUMOFDEC、SIGN、CURRENCY、DRCR の要素および属性で構成されています。

注意注意注意注意 : OAG OPERAMT は、クオリファイア、タイプ、VALUE、NUMOFDEC、SIGN、CURRENCY、UOMVALUE、UOMNUMDEC、UOM の属性および要素で構成されています。

A-16 Oracle XML Gateway ユーザーズ・ガイド

Page 303: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのマップ分析のガイドライン

ステップステップステップステップ 5DQUANTITY 要素に対して、単位コードに使用するアプリケーション・オープン・インタフェース(ターゲット)表列が使用可能な場合は、列を指定します。XML Gateway の OAGからの変換処理は、指定した列に OAG の単位コードを保存するように定義するか、または列が使用可能でない場合は無視することができます。

クオリファイア属性は、アプリケーション・オープン・インタフェース表列に意味が暗黙的に指定されるため、マップされません。

NUMOFDEC および SIGN の値は、Oracle での数量値の表現に暗黙的に指定されます。アプリケーションでサポートされていない限り、これらの値はマップされません。この場合、Message Designer を使用して値をマップする必要があります。

ステップステップステップステップ 6 複数のノード複数のノード複数のノード複数のノード / 要素の兄弟を追加要素の兄弟を追加要素の兄弟を追加要素の兄弟を追加DTD では要素の 1 回のオカレンスを定義しますが、メッセージの実装時に、ビジネス・データに適合するようにそれ以上のオカレンスを追加できます。複数のノードを適切なアプリケーション・オープン・インタフェース表列にマップします。

例として、取引パーティの識別に使用する PARTNER の DTD 要素があります。アプリケーション・オープン・インタフェースで SHIP-TO、BILL-TO および REMIT-TO が必要な場合は、BILL-TO および REMIT-TO に適合するように元の DTD に 2 つの兄弟 PARTNER ノード

(同じ階層レベル)が追加されます。これらのエンティティを適切なアプリケーション・オープン・インタフェース表列にマップします。

ステップステップステップステップ 7 DTD USERAREA のレビューのレビューのレビューのレビューメッセージに必要な追加データをサポートするために元の DTD が拡張されている可能性があることを検討します。すべての USERAREA 定義をレビューし、これらをアプリケーション・オープン・インタフェース表列またはアプリケーション API パラメータにマップする必要があるかどうかを判別します。

アウトバウンド・メッセージの場合、すべてのアプリケーション・フレックスフィールドはUSERAREA フィールドにマップされました。アウトバウンド・メッセージが別の Oracle アプリケーション・モジュールへのインバウンド・メッセージとして処理される場合、値に意味がある可能性があります。この場合、アプリケーション・オープン・インタフェース表列またはアプリケーション API パラメータにマップする必要があります。

注意注意注意注意 : OAG QUANTITY は、クオリファイア、VALUE、NUMOFDEC、SIGN、UOM の属性および要素で構成されています。

マップ分析のガイドライン A-17

Page 304: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのマップ分析のガイドライン

ステップステップステップステップ 8 データの相違の解決データの相違の解決データの相違の解決データの相違の解決この時点で、可能な限りの多くのアプリケーション・オープン・インタフェース(ターゲット)表列またはアプリケーション API パラメータに対して DTD(ソース)要素の指定が完了しました。マップされていない必要なアプリケーション・オープン・インタフェース

(ターゲット)表列またはアプリケーション API パラメータはデータの相違を表します。

� 必要な列が内部 ID の場合、ステップ 4B および 4C に示すように、導出ルールまたはデフォルト設定ルールを使用してこれを解決するか、または所在地 ID の導出処理または親 ID の導出処理を使用します。

� DTD を拡張して必要なデータを組み込むことにより、データの相違を解決することを検討します。DTD を拡張するには、兄弟(同じ階層レベル)または子(階層の次のレベル)の USERAREA 要素を追加するか、または既存の USERAREA に新規要素を追加します。これらの要素の定義方法は、「DTD の拡張方法」(2-110 ページ)を参照してください。

� 新規アプリケーション・オープン・インタフェース表列および関連付けられた API の作成を検討します。これが有効なオプションである場合は、新規の表定義を作成してデータベース・スキーマにロードし、メッセージ・マップを作成します。

ステップステップステップステップ 9 オプションの処理オプションの処理オプションの処理オプションの処理アプリケーション・オープン・インタフェース表を使用して着信データをステージングし、ステージングしたデータをアプリケーション・オープン・インタフェース API を使用して検証するアプリケーション製品の場合

� データベース表への挿入処理を使用して、アプリケーション・オープン・インタフェース表にデータを挿入します。

� プロシージャ・コール処理を使用して、アプリケーション・オープン・インタフェースAPI を実行します。

ステージ表と検証 API を組み合せたアプリケーション API を使用するアプリケーション製品の場合

� プロシージャ・コール処理を使用して、ソース(DTD)データをアプリケーション APIパラメータ・リストにマップします。追加説明は、「API へのマッピング方法」(2-112ページ)を参照してください。

注意注意注意注意 : DTD には、USERAREA に対する更新のみ可能です。その他の変更を行うと DTD は無効になります。

A-18 Oracle XML Gateway ユーザーズ・ガイド

Page 305: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ソースおよびターゲット文書レベルの指定

ステップステップステップステップ 10 必要な処理必要な処理必要な処理必要な処理インバウンド処理の完了を示すビジネス・イベントを発生させるルートレベルの後処理を追加します。

ECX_STANDARD.setEventDetails のプロシージャ・コール処理を追加します。API の付録の「setEventDetails」(F-3 ページ)を参照してください。

ステップステップステップステップ 11 ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定「ソースおよびターゲット文書レベルの指定」(A-19 ページ)を参照してください。

ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定ソースおよびターゲット文書レベルの指定マップ分析が完了した後、ソース・データおよびターゲット・データの両方の文書レベルを指定します。

文書レベルは、繰り返されるデータの集合を表します。アプリケーション・オープン・インタフェース表またはデータベース・ビューでは、各表が文書レベルを表します。レベルは親子関係の親です。

文書レベルは用途に基づいて暗黙的に指定されるため、DTD では文書レベルが使用されません。データがどのようにグループ化されるかについて理解するには、OAG 定義にあるツリー形式の図を参照してください。このツリー形式の図には、データ型の追加オカレンスが必要な場所も示されています。

ソースおよびターゲットの文書レベルを指定した後、ソース・データ構造をターゲット・データ構造に関連付けます。このタスクは、ソースとターゲットのデータ・レベル数が同じ場合は簡単ですが、数が異なる場合は困難になる可能性があります。ソースのレベル数がターゲットのレベル数よりも多い場合は、レベルを縮小する必要があります。ソースのレベル数がターゲットのレベル数よりも少ない場合は、レベルを拡張する必要があります。

マップ分析のガイドライン A-19

Page 306: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ソースおよびターゲット文書レベルの指定

レベルの縮小レベルの縮小レベルの縮小レベルの縮小レベルの縮小とは、複数のソース・レベルを同じ 1 つのターゲット・レベルにマッピングすることです。たとえば、ソースが 3 レベルでターゲットが 2 レベルの場合は、次の図のようにレベルを縮小できます。

正しいレベルの縮小方法正しいレベルの縮小方法正しいレベルの縮小方法正しいレベルの縮小方法 誤ったレベルの縮小方法誤ったレベルの縮小方法誤ったレベルの縮小方法誤ったレベルの縮小方法

前述の正しい例では、レベル縮小の結果、ソース・レベル 2 および 3 のデータが連結されて、ターゲット・レベル 2 にマッピングされています。ソース・レベル 2 に 2 つの行があり、ソース・レベル 3 に 3 つの行がある場合は、ターゲット・レベル 2 に合計 6 行が作成されます。

誤った例では、ソース・レベル 1 および 3 がターゲット・レベル 1 に縮小されていますが、ソース・レベル 3 がターゲット・レベル 2 で交差しています。

別のオプションとして、次に示す正しい例のように、ソース・レベル 1 と 2 をターゲット・レベル 1 に、ソース・レベル 3 をターゲット・レベル 2 に関連付ける方法があります(ソース・レベル 3 をターゲット・レベル 2 で交差させてターゲット・レベル 1 にマッピングしなしなしなしないでいでいでいでください)。

正しいレベルの縮小方法正しいレベルの縮小方法正しいレベルの縮小方法正しいレベルの縮小方法 誤ったレベルの縮小方法誤ったレベルの縮小方法誤ったレベルの縮小方法誤ったレベルの縮小方法

ソース�レベル1

ターゲット�レベル1

ソース�レベル2

ターゲット�レベル2

ソース�レベル3

ソース�レベル1

ターゲット�レベル1

ソース�レベル2

ターゲット�レベル2

ソース�レベル3

ソース�レベル1

ターゲット�レベル1

ソース�レベル2

ターゲット�レベル2

ソース�レベル3

ソース�レベル1

ターゲット�レベル1

ソース�レベル2

ターゲット�レベル2

ソース�レベル3

A-20 Oracle XML Gateway ユーザーズ・ガイド

Page 307: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ソースおよびターゲット文書レベルの指定

いずれのオプションを選択した場合でも、下位レベルの詳細データを上位レベルに昇格させることの意味を十分考慮してください。ソース・データが上位レベルで利用価値があるようにするには、ソース・データを集約する必要がある場合があります。

レベルの拡張レベルの拡張レベルの拡張レベルの拡張レベルの拡張とは、1 つのソース・レベルを複数のターゲット・レベルにマッピングすることです。たとえば、ソースが 2 レベルでターゲットが 3 レベルの場合は、次の図のようにレベルを拡張できます。

正しいレベルの拡張方法正しいレベルの拡張方法正しいレベルの拡張方法正しいレベルの拡張方法 誤ったレベルの拡張方法誤ったレベルの拡張方法誤ったレベルの拡張方法誤ったレベルの拡張方法

レベル拡張の結果、前述の正しい例のように、ソース・レベル 2 のデータがターゲット・レベル 2 および 3 に分散してマッピングされます。ソース・レベル 2 に 2 つの行がある場合は、ターゲット・レベル 2 およびターゲット・レベル 3 に 2 つの行が作成されます。

前述の誤った例のように、ソース・レベルをターゲット・レベルに対して交差させて拡張しないでください。ソース・レベル 1 はターゲット・レベル 1 および 3 に誤って拡張され、ターゲット・レベル 2 で交差しています。

別のオプションとして、次に示す正しい例のように、ソース・レベル 1 をターゲット・レベル 1 と 2 に分散して、ソース・レベル 2 をターゲット・レベル 3 にマッピングする方法があります(ソース・レベル 1 をターゲット・レベル 2 で交差させてターゲット・レベル 1 と 3にマッピングしないでしないでしないでしないでください)。

ソース�レベル1

ターゲット�レベル1

ソース�レベル2

ターゲット�レベル2

ターゲット�レベル3

ソース�レベル1

ターゲット�レベル1

ソース�レベル2

ターゲット�レベル2

ターゲット�レベル3

マップ分析のガイドライン A-21

Page 308: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ソースおよびターゲット文書レベルの指定

正しいレベルの拡張方法正しいレベルの拡張方法正しいレベルの拡張方法正しいレベルの拡張方法 誤ったレベルの拡張方法誤ったレベルの拡張方法誤ったレベルの拡張方法誤ったレベルの拡張方法

いずれのオプションを選択する場合でも、上位レベルから下位レベルに詳細データを降格させることの意味を十分考慮してください。ソース・データが下位レベルで利用価値があるようにするには、ソース・データを集約解除する必要がある場合があります。

不連続ノードのレベルの拡張不連続ノードのレベルの拡張不連続ノードのレベルの拡張不連続ノードのレベルの拡張

ターゲットの拡張されたレベルがすべて兄弟の関係にあるか、またはこれらのレベルがすべて前のノードの子である場合は、レベルの拡張がサポートされます。

有効なレベルの拡張の例

前述の例において、ターゲット・レベル 2 とターゲット・レベル 3 は、相互に兄弟の関係にあり、いずれもターゲット・レベル 1 の子です。

ソース�レベル1

ターゲット�レベル1

ソース�レベル2

ターゲット�レベル2

ターゲット�レベル3

ソース�レベル1

ターゲット�レベル1

ソース�レベル2

ターゲット�レベル2

ターゲット�レベル3

ソース・レベル1 ターゲット・レベル1

ソース・レベル2ターゲット・レベル2

ターゲット・レベル3

A-22 Oracle XML Gateway ユーザーズ・ガイド

Page 309: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

DTD に関する追加または変更の OAG への提案

無効なレベルの拡張の例

前述の無効なレベル拡張の例において、ターゲット・レベル 2 とターゲット・レベル 3 は、相互に兄弟の関係にあり、いずれもターゲット・レベル 1 の子です。ターゲット・レベル 4は、ターゲット・レベル 1 と兄弟の関係にあり、ターゲット・レベル 2 とターゲット・レベル 3 とは関係していません。

不連続ノードの詳細は、「不連続ノード」(2-56 ページ)を参照してください。

データ構造の不一致に対処する別の方法として、データベース・ビューまたはアプリケーション・オープン・インタフェース表を縮小または拡張し、変更したデータベース・ビューまたはアプリケーション・オープン・インタフェース表の定義を使用してメッセージ・マップを作成します。

結果の階層マッピングは、Message Designer の「Level Mapping」タブを使用して定義します。

DTD に関する追加または変更のに関する追加または変更のに関する追加または変更のに関する追加または変更の OAG への提案への提案への提案への提案オラクル社は、業界から独立した XML 標準を作成する役割を持つオープン・アプリケーション・グループの標準規格委員会のメンバーです。このグループは、定期的に会合を開いて推奨事項をレビューし、標準に関する変更事項および追加事項を発行しています。

マップ分析プロセスにおいて、必要なフィールドが DTD で記述されていないか、または必要な DTD が OAG でサポートされていない場合があります。

新規のビジネス・オブジェクト文書(BOD)および文書タイプ定義(DTD)の作成を推奨するか、または既存の DTD への追加または変更を推奨するかにかかわらず、推奨事項は OAGフォーマットで提出してください。また、ビジネス・ケースおよび理由を特定できるようにしてください。既存の DTD への追加または変更を推奨する場合は、使用している DTD とそのバージョンを特定してください。提案する DTD または DTD への変更によって、アプリ

ターゲット・レベル1ソース・レベル1

ソース・レベル2

ターゲット・レベル2

ターゲット・レベル3

ターゲット・レベル4

マップ分析のガイドライン A-23

Page 310: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

カスタム・メッセージに関する特別な考慮事項

ケーション間(A2A)および企業間(B2B)の両方のシナリオがサポートされていることを確認してください。

オラクル社から OAG への要求の提出を希望される場合は、拡張要求を入力してください。Oracle から OAG 委員会に提案を行い、結果を報告します。事例を直接 OAG に提案することを希望される場合は、Oracle にご連絡ください。会合に参加していただきます。

カスタム・メッセージに関する特別な考慮事項カスタム・メッセージに関する特別な考慮事項カスタム・メッセージに関する特別な考慮事項カスタム・メッセージに関する特別な考慮事項Oracle E-Business Suite から文書を抽出した後、文書抽出済であることを示すためにアプリケーション表を更新することを検討します。これを行うには、適切な表に列を追加する必要がある場合があります。このことは、Oracle E-Business Suite での文書のステータス報告や供給と需要のデータを管理する場合に重要です。

EDI の世界では、文書が 2 回以上抽出されることを防止するために、Oracle E-Business Suite アプリケーション表を更新することが必要でした。XML Gateway モデルでは、文書は

(文書が作成されるときに)Oracle E-Business Suite のイベント・トリガーに基づいて抽出されます。これに対して、EDI モデルではバッチ処理が使用されます。

インバウンド・メッセージの場合は、アプリケーション・オープン・インタフェース API プロセスを下位プロセスにリンクするアプリケーション・プロシージャのコールを(処理として)追加することを検討します。

A-24 Oracle XML Gateway ユーザーズ・ガイド

Page 311: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway シード済コード・カテ

B

XML Gateway シード済コード・カテゴリシード済コード・カテゴリシード済コード・カテゴリシード済コード・カテゴリ

この付録では、シード済コード・カテゴリについて説明します。

ゴリ B-1

Page 312: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway シード済コード・カテゴリ

XML Gateway シード済コード・カテゴリシード済コード・カテゴリシード済コード・カテゴリシード済コード・カテゴリ次の表は、XML Gateway シード済コード・カテゴリおよびその説明を示します。

カテゴリ・コードカテゴリ・コードカテゴリ・コードカテゴリ・コード 摘要摘要摘要摘要

ACTION_CODE 処理コード(Add/Change/Delete など)

AC_HANDL 手当および金利取扱コード

AC_SPEC_CHARGES 手当および金利・特別チャージ

AC_SPEC_SERVICES 手当および金利・特別サービス

AETC_REASON AETC 理由コード

AETC_RESPONSIBILITY AETC 職責コード

AGREEMENT 基本契約コード

ALLOW_CHARGES_INDICATOR 手当または金利インディケータ・コード

ALLOW_METHOD_HANDLING 手当または金利取扱方法コード

BARCODE バー・コード

BUYER_ITEM 購買担当品目

CARRIER_CODE 運送業者コード

CHARGE_ALLOW_QUALIFIER 手当または金利クオリファイア・コード

CHARGE_TYPE 手数料タイプ・コード

COMMODITY_COD_QUALIFIER 商品コード・クオリファイア・コード

COMPANY_CODE 会社コード

CONTAINER_CODE コンテナ・コード

CONTAINER_TYPE コンテナ・タイプ・コード

COUNTRY 国コード

CURRENCY 通貨

CURRENCY_CODE 通貨コード

CURRENCY_CONV_TYPE 通貨換算タイプコード

CUSTOMER_BANK_ACCOUNT 顧客銀行口座コード

CUSTOMER_BANK_ACCOUNT_TYPE

顧客銀行口座タイプ・コード

CUSTOMER_BANK_BRANCH 顧客銀行支店コード

CUSTOMER_BANK_BRANCH_ID 顧客銀行支店 ID

CUSTOMER_BANK_BRANCH_TYPE 顧客銀行支店タイプ・コード

CUSTOMER_BANK_LOCATION 顧客銀行所在地コード

CUSTOMER_BANK_ORG 顧客銀行組織コード

B-2 Oracle XML Gateway ユーザーズ・ガイド

Page 313: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway シード済コード・カテゴリ

CUSTOMER_BANK_SITE 顧客銀行サイト・コード

CUSTOMER_CODE 顧客コード

CUSTOMER_ITEM 顧客品目

CUSTOMER_LOCATION_CODE 顧客所在地コード

CUSTOMER_NAME 顧客名

CUSTOMER_NUMBER 顧客番号

CUSTOMER_ORG 顧客組織コード

CUSTOMER_SITE 顧客サイト・コード

CUSTOMER_SITE_ORG 顧客サイト組織コード

DATE_TIME_QUALIFIER 日付 / 時刻クオリファイア・コード

DATE_TYPE 日付タイプ・コード

DESTINATION_CLASS 目的区分コード

DETAIL_SUBTYPE 詳細サブタイプ・コード

DETAIL_TYPE 詳細タイプ・コード

DOC_HANDLING_CODE 文書取扱コード

DOC_PURPOSE_CODE 文書目的コード

DOC_STATUS 文書ステータス・コード

DOC_SUBTYPE 文書サブ・タイプ

DOC_TYPE 文書タイプ

EAN 欧州商品番号(EAN)

EQUIPMENT_CODE 設備コード

EQUIPMENT_DESC 設備摘要コード

EXCESS_TRANS_REASON_CODE 過剰輸送時由コード

EXCESS_TRANS_RESPONSIBILITY 過剰輸送職責コード

EXPORT_DETAIL 輸出詳細コード

EXPORT_HEADER 輸出ヘッダー・コード

FOB 運送費コード

FOB_PAYMENT FOB 支払コード

FOB_POINT FOB ポイント・コード

FREIGHT_TERMS 運送条件コード

HAZ_CERTIFICATION 危険物認証コード

HAZ_CLASS 危険度区分コード

カテゴリ・コードカテゴリ・コードカテゴリ・コードカテゴリ・コード 摘要摘要摘要摘要

XML Gateway シード済コード・カテゴリ B-3

Page 314: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway シード済コード・カテゴリ

HAZ_MATERIAL 危険物コード

HAZ_MATL_CODE_QUAL 危険物コード・クオリファイア

HAZ_MATL_SHIPMENT_INFO_QUAL

危険物出荷情報クオリファイア

INTL_DOMESTIC_CODE 国際 / 国内コード

INT_LOC_LOCATION_CODE 内部所在地コード

INT_LOC_ORG 内部所在地組織コード

INT_LOC_SITE 内部所在地サイト・コード

INVENTORY_ITEM 在庫品目

INVOICE_TYPE 請求タイプ・コード

ISBN_CODE 国際標準図書番号コード

ITEM_CATEGORY 品目カテゴリ・コード

ITEM_QUALIFIER 品目クオリファイア・コード

ITEM_TYPE 項目タイプ・コード

LABEL_NAME ラベル名コード

LADING_DESC_QUALIFIER 荷受摘要クオリファイア

METHOD_OF_PAYMENT 支払方法コード

NETWORKS ネットワーク・コード

PACKAGING_CODE 梱包コード

PACKAGING_FROM 梱包コード : 自

PACK_CODE 梱包コード

PAYMENT_FORMAT 支払フォーマット・コード

PAYMENT_METHOD 支払方法コード

PAYMENT_TERMS 支払条件コード

PAYMENT_TYPE 支払タイプ・コード

PRICE_BASIS 価格基準コード

PRICE_IDENTIFIER 価格識別子コード

PROVINCE 都道府県コード

PURCHASE_ORDER_TYPE 発注タイプ・コード

QUALIFIER クオリファイア・コード

QUANTITY_TYPE 数量タイプ・コード

RATING CATEGORY レート・カテゴリ・コード

カテゴリ・コードカテゴリ・コードカテゴリ・コードカテゴリ・コード 摘要摘要摘要摘要

B-4 Oracle XML Gateway ユーザーズ・ガイド

Page 315: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway シード済コード・カテゴリ

RECORD_TYPE レコード・タイプ・コード

REFERENCE_CODE リファレンス・コード

REFERENCE_ID 参照識別子

REGION1 リージョン 1 コード

REGION2 リージョン 2 コード

REGION3 リージョン 3 コード

SALES_ORDER_TYPE 受注タイプ・コード

SCHEDULE_PURPOSE スケジュール目的コード

SCHEDULE_TYPE スケジュール・タイプ・コード

SEGMENT_DESC セグメント摘要コード

SERVICE_LEVEL サービス・レベル・コード

SHIPMENT_METHOD_PAYMENT 出荷支払方法コード

SHIPMENT_PRIORITY 出荷優先度コード

SHIPMENT_QUALIFIER 出荷クオリファイア・コード

SHIPMENT_STATUS 出荷ステータス・コード

SHIP_DELIV_PATTERN 出荷配送パターン・コード

SITE_QUALIFIER サイト・クオリファイア・コード

SPECIAL_CHARGE_ALLOWANCE 特別チャージまたは手当コード

SPECIAL_HANDLING 特別取扱コード

SPECIAL_SERVICES 特別サービス・コード

STATE 州コード

SUPPLIER_BANK_ACCOUNT 仕入先銀行口座コード

SUPPLIER_BANK_ACCOUNT_TYPE 仕入先銀行口座タイプ・コード

SUPPLIER_BANK_BRANCH 仕入先銀行支店コード

SUPPLIER_BANK_BRANCH_ID 仕入先銀行支店 ID コード

SUPPLIER_BANK_BRANCH_TYPE 仕入先銀行支店タイプ・コード

SUPPLIER_BANK_LOCATION 仕入先銀行所在地コード

SUPPLIER_BANK_ORG 仕入先銀行組織コード

SUPPLIER_BANK_SITE 仕入先銀行サイト・コード

SUPPLIER_CODE 仕入先コード

SUPPLIER_ITEM 仕入先品目コード

SUPPLIER_LOCATION_CODE 仕入先所在地コード(EDI 事業所コードなど)

カテゴリ・コードカテゴリ・コードカテゴリ・コードカテゴリ・コード 摘要摘要摘要摘要

XML Gateway シード済コード・カテゴリ B-5

Page 316: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway シード済コード・カテゴリ

SUPPLIER_NAME 仕入先名コード

SUPPLIER_NUMBER 仕入先番号コード

SUPPLIER_ORG 仕入先組織コード

SUPPLIER_SCHEDULING_DESCRIPTOR

仕入先計画記述子コード

SUPPLIER_SITE 仕入先サイト・コード

SUPPLIER_SITE_ORG 仕入先サイト組織コード

TAX_CODE 税コード

TAX_EXEMPT 免税コード

TAX_EXEMPT_REASON 免税事由コード

TAX_JURISDICTION 税金管轄区域コード

TAX_NAME 税金名コード

TERMS 条件コード

TERMS_BASIS_DATE_CODE 条件基準日コード

TERMS DUE DATE QUALIFIER 条件納期クオリファイア

TERMS_TYPE 条件タイプ・コード

TERRITORY テリトリ・コード

TRADING_PARTNER 取引先コード

TRANSPORTATION_TERMS 輸送条件コード

TRANSPORTATION_TERMS_QUALIFIER

輸送条件クオリファイア・コード

UNIT_PRICE_BASIS 単価基準コード

UOM 単位コード

UPC 統一商品コード(UPC)

VESSEL_REQUIREMENT 船舶要件コード

WAREHOUSE_CODE 倉庫コード

WAREHOUSE_LOCATION_CODE 倉庫所在地コード

WAREHOUSE_NAME 倉庫名コード

WAREHOUSE_NUMBER 倉庫番号コード

WAREHOUSE_ORG 倉庫組織コード

WAREHOUSE_SITE 倉庫サイト・コード

WAREHOUSE_SITE_ORG 倉庫サイト組織

WAYBILL REQUEST 運送状要求コード

カテゴリ・コードカテゴリ・コードカテゴリ・コードカテゴリ・コード 摘要摘要摘要摘要

B-6 Oracle XML Gateway ユーザーズ・ガイド

Page 317: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway でサポートされている

C

XML Gateway でサポートされている処理でサポートされている処理でサポートされている処理でサポートされている処理

この付録では、サポートされている処理の概要について説明します。

処理 C-1

Page 318: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway でサポートされている処理

XML Gateway でサポートされている処理でサポートされている処理でサポートされている処理でサポートされている処理次の表は、XML Gateway でサポートされている処理を示します。マップ分析処理については、必須の処理を定義します。各処理の詳細および処理の定義方法は、「トランザクション・マップ - 処理」(2-67 ページ)を参照してください。

処理カテゴリ処理カテゴリ処理カテゴリ処理カテゴリ 処理摘要処理摘要処理摘要処理摘要

割当て 変数値の割当てグローバル値の作成

データベース機能 次の連番値の割当てWHERE 句の追加

データベース表への挿入

導出 事業所コードからの所在地 ID の導出事業所コードからの上位

ID の導出

関数呼出し ファンクションの実行およびファンクション戻り値の割当て

算術関数 加算除算乗算減算

OAG の標準変換 Oracle 日付を OAG 日付フォーマットに変換

Oracle 営業金額を OAG 営業金額フォーマットに変換

Oracle 数量を OAG 数量フォーマットに変換

Oracle 金額を OAG 金額フォーマットに変換

OAG 日付を Oracle 日付フォーマットに変換

OAG 営業金額を Oracle 営業金額に変換

OAG 数量を Oracle 数量フォーマットに変換

OAG 金額を Oracle 金額フォーマットに変換

その他 プログラムの終了

事前定義済変数 事前定義済変数値の取得コード変換のリターン・ステータス(特定の要素)

内部制御番号

リターン・コード

リターン・メッセージ

受信側取引先 ID送信元取引先 ID組織 ID

プロシージャ・コール 送信およびリターン・パラメータによるプロシージャの実行

リターン・エラー・メッセージ

取引先または XML Gateway システム管理者へのエラー・メッ

セージ送信

文字列関数 連結の実行サブ文字列の実行

XSLT 変換 XSLT を実行するプロシージャの実行

C-2 Oracle XML Gateway ユーザーズ・ガイド

Page 319: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway でサポートされている処理

各処理は条件付けることができます。条件は、リテラル値または変数として宣言した 2 つのオペランドで構成されます。条件を定義した場合、条件の結果が TRUE であれば処理が実行されます。XML Gateway でサポートされている条件演算子は次のとおりです。

演算子演算子演算子演算子 摘要摘要摘要摘要

NULL NULL

not null NULL 値でない

= 等しい

!= 等しくない

< 未満

> 超過

<= 以下

>= 以上

注意注意注意注意 : 日付がユリウス日として宣言されている場合以外は、日付の比較を実行しないでください。そのかわりに、データベース・ファンクションを使用して日付を比較します。

XML Gateway でサポートされている処理 C-3

Page 320: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway でサポートされている処理

C-4 Oracle XML Gateway ユーザーズ・ガイド

Page 321: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 命名

D

XML Gateway 命名規則命名規則命名規則命名規則

この付録では、XML Gateway 命名規則の要約を示します。

規則 D-1

Page 322: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway 命名規則の要約

D-2 Oracle XML Gateway ユーザーズ・ガイド

XML Gateway 命名規則の要約命名規則の要約命名規則の要約命名規則の要約データを容易に認識できるように、命名規則が定義されている複数の領域があります。それらの領域は次のとおりです。

Message Designer

� メッセージ・マップ名

「マップ名の指定」(2-23 ページ)を参照してください。

� データ定義名

「ソース / ターゲット・データ定義の選択 / 作成」(2-25 ページ)を参照してください。

� XGM ファイル名

「トランザクション・マップ - 要素のマッピング」(2-63 ページ)を参照してください。

設定フォーム設定フォーム設定フォーム設定フォーム

� トランザクション・タイプおよびトランザクション・サブタイプ

「「トランザクションの定義」フォーム」(3-7 ページ)を参照してください。

� 外部トランザクション・タイプおよび外部トランザクション・サブタイプ

「「トランザクションの定義」フォーム」(3-7 ページ)を参照してください。

処理処理処理処理

� 業務イベント

「Oracle XML Gateway と Oracle Workflow 業務イベント・システムの統合」(6-1 ページ)を参照してください。

Page 323: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾー

E

XML Gateway の有効なタイム・ゾーン値の有効なタイム・ゾーン値の有効なタイム・ゾーン値の有効なタイム・ゾーン値

この付録では、プロファイル・オプションの「ECX: サーバー・タイム・ゾーン」の有効なタイム・ゾーン値のリストが示されています。

XML Gateway の有効なタイム・ゾーン値の有効なタイム・ゾーン値の有効なタイム・ゾーン値の有効なタイム・ゾーン値次の表は、「アプリケーション」プロファイル・オプションの「ECX: サーバー・タイム・サーバー・タイム・サーバー・タイム・サーバー・タイム・ゾーンゾーンゾーンゾーン」の有効な値を示します。次の値のいずれかを正確に入力する必要があります。入力が正しくない場合は、デフォルトのグリニッジ標準時(GMT)が使用されます。

値は地域ごとに分類されています。データベース・サーバーが動作しているタイム・ゾーンに対応する地域または都市区を選択します。

アウトバウンド・トランザクションでは、データベースから取得された日付と時刻のデータ、およびプロファイル・オプションで指定されたタイム・ゾーンを使用して、GMT からの偏差が判定されます。この偏差は、XML Gateway によって生成される XML メッセージで使用されます。変換は行われません。

インバウンド・トランザクションでは、着信メッセージのタイム・ゾーンがプロファイル・オプションで指定されたタイム・ゾーンと異なる場合は、着信日および時刻が変換されます。

タイム・ゾーン値は、次のように分類されています。

� Africa(E-2 ページ)

� America(E-4 ページ)

� Antarctica(E-6 ページ)

� Asia(E-6 ページ)

� Atlantic(E-8 ページ)

� Australia(E-9 ページ)

� Europe(E-9 ページ)

ン値 E-1

Page 324: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾーン値

� Indian(E-10 ページ)

� Pacific(E-11 ページ)

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Africa

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Africa

Africa/Abidjan

Africa/Accra

Africa/Addis_Ababa

Africa/Algiers

Africa/Asmera

Africa/Bangui

Africa/Banjul

Africa/Bissau

Africa/Blantyre

Africa/Bujumbura

Africa/Cairo

Africa/Casablanca

Africa/Conakry

Africa/Dakar

Africa/Dar_es_Salaam

Africa/Djibouti

Africa/Douala

Africa/Freetown

Africa/Gaborone

Africa/Harare

Africa/Johannesburg

Africa/Kampala

Africa/Khartoum

Africa/Kigali

Africa/Kinshasa

Africa/Lagos

Africa/Libreville

E-2 Oracle XML Gateway ユーザーズ・ガイド

Page 325: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾーン値

Africa/Lome

Africa/Luanda

Africa/Lubumbashi

Africa/Lusaka

Africa/Malabo

Africa/Maputo

Africa/Maseru

Africa/Mbabane

Africa/Mogadishu

Africa/Monrovia

Africa/Nairobi

Africa/Ndjamena

Africa/Niamey

Africa/Nouakchott

Africa/Ouagadougou

Africa/Porto-Novo

Africa/Sao_Tome

Africa/Timbuktu

Africa/Tripoli

Africa/Tunis

Africa/Windhoek

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Africa

XML Gateway の有効なタイム・ゾーン値 E-3

Page 326: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾーン値

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : America

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : America

America/Adak

America/Anchorage

America/Anguilla

America/Antigua

America/Aruba

America/Asuncion

America/Barbados

America/Belize

America/Bogota

America/Buenos_Aires

America/Caracas

America/Cayenne

America/Cayman

America/Chicago

America/Costa_Rica

America/Cuiaba

America/Curacao

America/Dawson_Creek

America/Denver

America/Dominica

America/Edmonton

America/El_Salvador

America/Fortaleza

America/Godthab

America/Grand_Turk

America/Grenada

America/Guadeloupe

America/Guatemala

America/Guayaquil

America/Guyana

America/Halifax

America/Havana

E-4 Oracle XML Gateway ユーザーズ・ガイド

Page 327: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾーン値

America/Indianapolis

America/Jamaica

America/La_Paz

America/Lima

America/Los_Angeles

America/Managua

America/Manaus

America/Martinique

America/Mazatlan

America/Mexico_City

America/Miquelon

America/Montevideo

America/Montreal

America/Montserrat

America/Nassau

America/New_York

America/Noronha

America/Panama

America/Paramaribo

America/Phoenix

America/Port_of_Spain

America/Port-au-Prince

America/Porto_Acre

America/Puerto_Rico

America/Regina

America/Santiago

America/Santo_Domingo

America/Sao_Paulo

America/Scoresbysund

America/St_Johns

America/St_Kitts

America/St_Lucia

America/St_Thomas

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : America

XML Gateway の有効なタイム・ゾーン値 E-5

Page 328: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾーン値

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Antarctica

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Asia

America/St_Vincent

America/Tegucigalpa

America/Thule

America/Tijuana

America/Tortola

America/Vancouver

America/Winnipeg

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Antarctica

Antarctica/Casey

Antarctica/DumontDUrville

Antarctica/Mawson

Antarctica/McMurdo

Antarctica/Palmer

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Asia

Asia/Aden

Asia/Alma-Ata

Asia/Amman

Asia/Anadyr

Asia/Aqtau

Asia/Aqtobe

Asia/Ashkhabad

Asia/Baghdad

Asia/Bahrain

Asia/Baku

Asia/Bangkok

Asia/Beirut

Asia/Bishkek

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : America

E-6 Oracle XML Gateway ユーザーズ・ガイド

Page 329: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾーン値

Asia/Brunei

Asia/Calcutta

Asia/Colombo

Asia/Dacca

Asia/Damascus

Asia/Dubai

Asia/Dushanbe

Asia/Hong_Kong

Asia/Irkutsk

Asia/Ishigaki

Asia/Jakarta

Asia/Jayapura

Asia/Jerusalem

Asia/Kabul

Asia/Kamchatka

Asia/Karachi

Asia/Katmandu

Asia/Krasnoyarsk

Asia/Kuala_Lumpur

Asia/Kuwait

Asia/Macao

Asia/Magadan

Asia/Manila

Asia/Muscat

Asia/Nicosia

Asia/Novosibirsk

Asia/Phnom_Penh

Asia/Pyongyang

Asia/Qatar

Asia/Rangoon

Asia/Riyadh

Asia/Saigon

Asia/Seoul

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Asia

XML Gateway の有効なタイム・ゾーン値 E-7

Page 330: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾーン値

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Atlantic

Asia/Shanghai

Asia/Singapore

Asia/Taipei

Asia/Tashkent

Asia/Tbilisi

Asia/Tehran

Asia/Thimbu

Asia/Tokyo

Asia/Ujung_Pandang

Asia/Ulan_Bator

Asia/Vientiane

Asia/Vladivostok

Asia/Yakutsk

Asia/Yekaterinburg

Asia/Yerevan

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Atlantic

Atlantic/Azores

Atlantic/Bermuda

Atlantic/Canary

Atlantic/Cape_Verde

Atlantic/Faeroe

Atlantic/Jan_Mayen

Atlantic/Reykjavik

Atlantic/South_Georgia

Atlantic/St_Helena

Atlantic/Stanley

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Asia

E-8 Oracle XML Gateway ユーザーズ・ガイド

Page 331: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾーン値

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Australia

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Europe

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Australia

Australia/Adelaide

Australia/Brisbane

Australia/Darwin

Australia/Lord_Howe

Australia/Perth

Australia/Sydney

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Europe

Europe/Amsterdam

Europe/Andorra

Europe/Athens

Europe/Belgrade

Europe/Berlin

Europe/Brussels

Europe/Bucharest

Europe/Budapest

Europe/Chisinau

Europe/Copenhagen

Europe/Dublin

Europe/Gibraltar

Europe/Helsinki

Europe/Istanbul

Europe/Kaliningrad

Europe/Kiev

Europe/Lisbon

Europe/London

Europe/Luxembourg

Europe/Madrid

Europe/Malta

Europe/Minsk

XML Gateway の有効なタイム・ゾーン値 E-9

Page 332: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾーン値

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Indian

Europe/Monaco

Europe/Moscow

Europe/Oslo

Europe/Paris

Europe/Prague

Europe/Riga

Europe/Rome

Europe/Samara

Europe/Simferopol

Europe/Sofia

Europe/Stockholm

Europe/Tallinn

Europe/Tirane

Europe/Vaduz

Europe/Vienna

Europe/Vilnius

Europe/Warsaw

Europe/Zurich

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Indian

Indian/Antananarivo

Indian/Chagos

Indian/Christmas

Indian/Cocos

Indian/Comoro

Indian/Kerguelen

Indian/Mahe

Indian/Maldives

Indian/Mauritius

Indian/Mayotte

Indian/Reunion

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Europe

E-10 Oracle XML Gateway ユーザーズ・ガイド

Page 333: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾーン値

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Pacific

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Pacific

Pacific/Apia

Pacific/Auckland

Pacific/Chatham

Pacific/Easter

Pacific/Efate

Pacific/Enderbury

Pacific/Fakaofo

Pacific/Fiji

Pacific/Funafuti

Pacific/Galapagos

Pacific/Gambier

Pacific/Guadalcanal

Pacific/Guam

Pacific/Honolulu

Pacific/Kiritimati

Pacific/Kosrae

Pacific/Majuro

Pacific/Marquesas

Pacific/Nauru

Pacific/Niue

Pacific/Norfolk

Pacific/Noumea

Pacific/Pago_Pago

Pacific/Palau

Pacific/Pitcairn

Pacific/Ponape

Pacific/Port_Moresby

Pacific/Rarotonga

Pacific/Saipan

Pacific/Tahiti

Pacific/Tarawa

XML Gateway の有効なタイム・ゾーン値 E-11

Page 334: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway の有効なタイム・ゾーン値

Pacific/Tongatapu

Pacific/Truk

Pacific/Wake

Pacific/Wallis

タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値タイム・ゾーン値 : Pacific

E-12 Oracle XML Gateway ユーザーズ・ガイド

Page 335: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gatewa

F

XML Gateway API

この付録では、Message Designer で使用する特別な使途の API のリストが示されています。

y API F-1

Page 336: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway API

XML Gateway APIXML Gateway には、Message Designer で使用される特殊な用途のプロシージャおよび関数が用意されています。これらのプロシージャおよび関数を使用して、次のタスクを実行できます。

1. インバウンド・トランザクションの業務イベントを起動するようにイベント詳細を設定します。

2. XML Gateway 実行エンジンで管理されているイベント名を使用して、イベント詳細を取得します。

3. 文字列操作を実行します。

4. XML Gateway 実行エンジンで管理されている送信者または受信者の取引先 ID を使用して、取引先情報を取得します。

5. インバウンド・メッセージのメッセージ・エンベロープ・データを取得します。

6. アウトバウンド・メッセージの配送データを取得します。

7. ビジネス文書の文書ロギング情報を取得します。

8. メッセージの配信ステータスを設定します。

9. 「ECX: システム管理者 E メール・アドレス」プロファイルからシステム管理者の E メール・アドレスを取得します。

10. ECX_OAG_LOGICALID システム・プロファイルから送信者の論理 ID を取得します。

11. エラー終了の設定

Message Designer、プロシージャ・コールまたは関数呼出しの処理を使用して、API を初期化します。

ほとんどのプロシージャには、入力と出力の引数があります。入力引数には、ソース変数またはターゲット変数をマップできます。出力引数は、警告の場合はエラー・メッセージの送信処理、重大なエラーの場合は ECX_ACTIONS.set_error_exit_programAPI と組み合せて、通知を送信できます。通知は、取引先担当かシステム管理者(「ECX: システム管理者E メール・アドレス」システム・プロファイルで指定)またはその両方に送信されます。

トランザクションが成功するために API が正常に完了することが重要となる場合は、プログラムの終了処理を使用して、API が処理に失敗したときにトランザクションを終了することもできます。

注意注意注意注意 : ECX_ERRORLOG.external_system を除いて、プロシージャおよび関数は、Message Designer でのみ使用するように設計されているため、他の用途では使用しないようにしてください。

F-2 Oracle XML Gateway ユーザーズ・ガイド

Page 337: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_STANDARD で定義されている API

ECX_STANDARD で定義されているで定義されているで定義されているで定義されている API

setEventDetails

PL/SQL 構文構文構文構文

procedure setEventDetails

(eventname in varchar2, eventkey in varchar2, parameter1 in varchar2, parameter2 in varchar2, parameter3 in varchar2, parameter4 in varchar2, parameter5 in varchar2, parameter6 in varchar2, parameter7 in varchar2, parameter8 in varchar2, parameter9 in varchar2, parameter10 in varchar2, retcode out pls_integer, retmsg out varchar2);

摘要摘要摘要摘要

インバウンド・トランザクションの業務イベントを起動するようにイベント詳細を設定します。

setEventDetails は、インバウンド・メッセージが処理されたことを示す後処理として、ルート・レベルで定義されます。このインバウンド・メッセージに関連付けられている Oracle E-Business Suite で定義されているすべてのイベント・サブスクリプションでは、この APIが処理されます。

このプロシージャは、すべてのインバウンド・トランザクションに対して使用する必要があります。引数値はトランザクションによって変化します。ただし、引数値が固有の確認メッセージの場合は例外です。イベント詳細を定義する方法の詳細は、「OAG 確認ビジネス・オブジェクト文書の実装方法」(4-12 ページ)を参照してください。

XML Gateway API F-3

Page 338: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_STANDARD で定義されている API

引数(入力)引数(入力)引数(入力)引数(入力)

引数(出力)引数(出力)引数(出力)引数(出力)

eventname インバウンド・メッセージに関連付けられている業務イベントの一意の識別子。イベント名は、次のコンポーネントで構成されています。

ORACLE.APPS.<コンポーネント >.<タスク >.<イベント >

各コンポーネントの説明は、次のとおりです。

コンポーネントは、「トランザクションの定義」ウィンドウで入力した内部トランザクション・タイプに基づいています。コンポーネントは、製品の短縮コードを表しています。

タスクは、「トランザクションの定義」ウィンドウで入力した内部トランザクションのサブタイプに基づいています。タスクは、オブジェクトの詳細を表しています。

イベントは、メッセージの業務機能を表すリテラルです。

アウトバウンド発注に関連付けられている確認イベントを特定するイベント名の例は、次のとおりです。

ORACLE.APPS.PO.POO.CONFIRM

eventkey 業務イベントに関連付けられている Oracle E-Business Suite のビジネス文書の一意の識別子

parameter1からparameter10

ユーザー定義パラメータ。これらのパラメータを使用すると、関連するデータが、インバウンド・ビジネス文書用の Oracle E-Business Suite で定義されたイベント・サブスクリプションに渡されます。

retcode プロシージャのリターン・コード

retmsg プロシージャのリターン・メッセージ

F-4 Oracle XML Gateway ユーザーズ・ガイド

Page 339: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_STANDARD で定義されている API

getEventDetails

PL/SQL 構文構文構文構文

procedure getEventDetails

(eventname out varchar2, eventkey out varchar2, itemtype out varchar2, itemkey out varchar2, parentitemtype out varchar2, parentitemkey out varchar2, retcode out pls_integer, retmsg out varchar2);

摘要摘要摘要摘要

XML Gateway 実行エンジンで管理されているイベント名を使用して、イベント詳細を取得します。

引数(入力)引数(入力)引数(入力)引数(入力)

なし。

引数(出力)引数(出力)引数(出力)引数(出力)eventname プロシージャに内部的に渡されるイベント名。eventname は、トラ

ンザクションに関連付けられている業務イベントの一意の識別子です。

eventkey 渡されたイベント名に関連付けられているイベント・キー。

itemtype 同じ品目属性のセット(変数とも呼ばれる)を共有するオブジェクト・グループの一意の識別子。

項目タイプは、Workflow Builder を使用して作成され、関連する機能をグループ化するために Oracle E-Business Suite のアプリケーション・モジュールで使用されます。

itemkey 項目タイプにある項目の一意の識別子。

parentitemtype 項目タイプの親項目タイプ

parentitemkey 項目キーの親項目キー

retcode プロシージャのリターン・コード

retmsg プロシージャのリターン・メッセージ

XML Gateway API F-5

Page 340: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_STANDARD で定義されている API

getEventSystem

PL/SQL 構文構文構文構文

procedure getEventSystem

(from_agent out varchar2, to_agent out varchar2, from_system out varchar2, to_system out varchar2, retcode out pls_integer, retmsg out varchar2);

摘要摘要摘要摘要

XML Gateway 実行エンジンで管理されているイベント名を使用して、システムやエージェントに関連付けられているイベント詳細を取得します。

このプロシージャはコンテキストに依存しているため、コンテキストに関連する戻り値が受け取られます。「from」パラメータはインバウンド・トランザクションで使用します。「to」パラメータはアウトバウンド・トランザクションで使用します。

引数(入力)引数(入力)引数(入力)引数(入力)

なし

引数(出力)引数(出力)引数(出力)引数(出力)

from_agent インバウンド・メッセージがデキューされたワークフロー・エージェント(キュー)

to_agent アウトバウンド・メッセージがエンキューされたワークフロー・エージェント(キュー)

from_system インバウンド・メッセージを処理するシステム

to_system アウトバウンド・メッセージを処理するシステム

retcode プロシージャのリターン・コード

retmsg メッセージのリターン・コード

F-6 Oracle XML Gateway ユーザーズ・ガイド

Page 341: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_STANDARD で定義されている API

getReferenceID

PL/SQL 構文構文構文構文

function getReferenceID

return out varchar2;

摘要摘要摘要摘要

OAG CONTROLAREA の REFERENCEID 要素に関連付けられている値を戻します。このフィールドには、システム名、イベント名およびイベント・キーを ":" で区切って連結した値が含まれています。このプロシージャは、OAG 標準を使用しないメッセージ・マップで使用されます。

OAG 標準を使用して作成したメッセージ・マップの場合、ECX_OAG_CONTROLAREA_TP_V ビューは、業務イベントごとに指定した reference_id を検索する場合に使用されます。この値は、OAG CNTROLAREA、REFERENCEID 要素にマッピングする場合に使用されます。

引数引数引数引数

なし。

XML Gateway API F-7

Page 342: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_DOCUMENT で定義されている API

ECX_DOCUMENT で定義されているで定義されているで定義されているで定義されている API

get_delivery_attribs

PL/SQL 構文構文構文構文

procedure get_delivery_attribs

(transaction_type in varchar2, transaction_subtype in varchar2, party_id in varchar2, party_site_id in varchar2, party_type in/out varchar2, standard_type out varchar2, standard_code out varchar2, ext_type out varchar2, ext_subtype out varchar2, source_code out varchar2, destination_code out varchar2, destination_type out varchar2, destination_address out varchar2, username out varchar2, password out varchar2, map_code out varchar2, queue_name out varchar2, tp_header_id out pls_integer, retcode out pls_integer, retmsg out vachar2);

摘要摘要摘要摘要

内部トランザクション・タイプ、サブタイプ、パーティ ID、party_type およびパーティ・サイト ID を使用して設定データを取得します。このデータは、アウトバウンド・トランザクションを処理する場合に必要となります。

引数(入力)引数(入力)引数(入力)引数(入力)

transaction_type プロシージャに渡される内部トランザクション・タイプ。この内部トランザクション・タイプは、「トランザクションの定義」ウィンドウで入力します。

transaction_subtype プロシージャに渡される内部トランザクションのサブタイプ。この内部トランザクション・サブタイプは、「トランザクションの定義」ウィンドウで入力します。

F-8 Oracle XML Gateway ユーザーズ・ガイド

Page 343: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_DOCUMENT で定義されている API

引数(出力)引数(出力)引数(出力)引数(出力)

party_id プロシージャに渡される取引先 ID。パーティ・サイト ID は、パーティ ID が NULL の場合に使用されます。この取引先 ID は、「トランザクションの定義」ウィンドウで入力します。

party_site_id プロシージャに渡される取引先サイト ID。この取引先サイト ID は、「トランザクションの定義」ウィンドウで入力します。

party_type プロシージャに渡される取引先および取引先サイトに関連付けられているパーティ・タイプ。このパーティ・タイプは、「取引先の定義」ウィンドウで入力します。

party_type プロシージャに渡される取引先および取引先サイトに関連付けられているパーティ・タイプ。このパーティ・タイプは、「取引先の定義」ウィンドウで入力します。

standard_type プロシージャに渡されるトランザクションに関連付けられているXML 標準タイプ。この標準タイプは、「XML 標準の定義」ウィンドウで入力します。

standard_code プロシージャに渡されるトランザクションに関連付けられている標準コード(たとえば OAG)。この標準コードは、「XML 標準の定義」ウィンドウで入力します。

ext_type プロシージャに渡される内部トランザクション・タイプに関連付けられている外部トランザクション・タイプ。この外部トランザクション・タイプは、「トランザクションの定義」ウィンドウで入力します。

ext_subtype プロシージャに渡される内部トランザクション・サブタイプに関連付けられている外部トランザクション・サブタイプ。この外部トランザクション・サブタイプは、「トランザクションの定義」ウィンドウで入力します。

source_code プロシージャに渡される取引先および取引先サイトに関連付けられているソース事業所コード。このソース事業所コードは、「取引先の定義」ウィンドウで入力します。

destination_code プロシージャに渡される取引先および取引先サイトに関連付けられている宛先事業所コード。この宛先事業所コードは、「取引先の定義」ウィンドウで入力します。

destination_type プロシージャに渡される取引先および取引先サイトに関連付けられている宛先事業所タイプ。この宛先事業所タイプは、「取引先の定義」ウィンドウで入力します。

XML Gateway API F-9

Page 344: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_DOCUMENT で定義されている API

destination_address プロシージャに渡される取引先および取引先サイトに関連付けられている宛先アドレス。この宛先アドレスは、「取引先の定義」ウィンドウで入力します。

username プロシージャに渡される取引先および取引先サイトに関連付けられているユーザー名。このユーザー名は、「取引先の定義」ウィンドウで入力します。

password プロシージャに渡される取引先および取引先サイトのユーザー名に関連付けられているパスワード。パスワードは暗号化されて戻されます。パスワードは、「取引先の定義」ウィンドウで入力します。

map_code プロシージャに渡される取引先およびトランザクションに関連付けられているメッセージ・マップ。このマップ・コードは、「取引先の定義」ウィンドウで入力します。

queue_name プロシージャに渡されるトランザクションに関連付けられているキュー名。このキュー名は、「トランザクションの定義」ウィンドウで入力します。

tp_header_id プロシージャに渡される取引先に応じてシステムで生成される識別子。この識別子は、「取引先の定義」ウィンドウで入力します。

retcode プロシージャのリターン・コード

retmsg プロシージャのリターン・メッセージ

F-10 Oracle XML Gateway ユーザーズ・ガイド

Page 345: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_CONDITIONS で定義されている API

ECX_CONDITIONS で定義されているで定義されているで定義されているで定義されている API

getLengthForString

PL/SQL 構文構文構文構文

procedure getLengthForString

(i_string in varchar2); i_length out pls_integer);

摘要摘要摘要摘要

このプロシージャに渡される文字列の長さを指定します。このプロシージャは、getPositionInString プロシージャまたはサブ文字列の実行処理とともに使用できます。

引数(入力)引数(入力)引数(入力)引数(入力)

引数(出力)引数(出力)引数(出力)引数(出力)

getPositionInString

PL/SQL 構文構文構文構文

procedure getPositionInString

(i_string in varchar2, i_search_string in varchar2, i_start_position in pls_integer, default null, i_occurrence in pls_integer, default null, i_position out pls_integer);

摘要摘要摘要摘要

デリミタとともに連結された文字列を個々のコンポーネントごとに解析します。i_search_stringパラメータは、デリミタを指定します。i_occurrenceパラメータは、検査対象のデリミタのオカレンスを指定します。プロシージャの戻り値は、指定した文字列の最初の文字の位置です。

このプロシージャは、getLengthForString プロシージャまたはサブ文字列の実行処理とともに使用できます。

i_string 入力文字列

i_length 入力文字列の長さ

XML Gateway API F-11

Page 346: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_CONDITIONS で定義されている API

引数(入力)引数(入力)引数(入力)引数(入力)

引数(出力)引数(出力)引数(出力)引数(出力)

getSubString

PL/SQL 構文構文構文構文

procedure getSubString

(i_string in varchar2, i_start_position in pls_integer, default 0, i_length in pls_integer, default 0, i_substr out varchar2);

摘要摘要摘要摘要

このプロシージャに渡される文字列の開始位置とサブ文字列の長さを解析します。

このプロシージャは、サブ文字列の長さが変数で管理されている場合に使用します。文字列の長さがリテラル値の場合は、サブ文字列の実行処理を使用します。

引数(入力)引数(入力)引数(入力)引数(入力)

引数(出力)引数(出力)引数(出力)引数(出力)

i_string 入力文字列

i_search_string 連結文字列で使用されるデリミタ

i_start_position 解析を開始する文字の位置

i_occurrence 検索するデリミタのオカレンス

i_position 指定した入力文字列の最初の文字の位置

i_string 入力文字列

i_start_position 解析を開始する文字の位置

i_length 結果のサブ文字列に含まれている入力文字列の開始位置からの長さ

i_substr サブ文字列

F-12 Oracle XML Gateway ユーザーズ・ガイド

Page 347: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_TRADING_PARTNER_PVT で定義されている API

ECX_TRADING_PARTNER_PVT で定義されているで定義されているで定義されているで定義されている API

get_receivers_tp_info

PL/SQL 構文構文構文構文

procedure get_receivers_tp_info

(p_party_id out number, p_party_site_id out number, p_org_id out pls_integer, p_admin_email out varchar2, retcode out pls_integer, retmsg out varchar2);

摘要摘要摘要摘要

XML Gateway 実行エンジンで管理されている受信者の取引先 ID を使用し

て、取引先のデータを取得します。取引先データは、「取引先の定義」ウィンドウを使用して入力します。

引数(入力)引数(入力)引数(入力)引数(入力)

なし

引数(出力)引数(出力)引数(出力)引数(出力)

p_party_id 取引先 ID

p_party_site_id 取引先に関連付けられているサイト

p_org_id 取引先サイトに関連付けられている組織

p_admin_email 取引先担当に関連付けられている E メール・アドレス

retcode プロシージャのリターン・コード

retmsg プロシージャのリターン・メッセージ

XML Gateway API F-13

Page 348: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_TRADING_PARTNER_PVT で定義されている API

get_senders_tp_info

PL/SQL 構文構文構文構文

procedure get_senders_tp_info

(p_party_id out number, p_party_site_id out number, p_org_id out pls_integer, p_admin_email out varchar2, retcode out pls_integer, retmsg out varchar2);

摘要摘要摘要摘要

XML Gateway 実行エンジンで管理されている送信者の取引先 ID を使用して、取引先のデータを取得します。取引先データは、「取引先の定義」ウィンドウを使用して入力します。

引数(入力)引数(入力)引数(入力)引数(入力)

なし

引数(出力)引数(出力)引数(出力)引数(出力)

p_party_id 取引先 ID

p_party_site_id 取引先に関連付けられているサイト

p_org_id 取引先サイトに関連付けられている組織

p_admin_email 取引先担当に関連付けられている E メール・アドレス

retcode プロシージャのリターン・コード

retmsg プロシージャのリターン・メッセージ

F-14 Oracle XML Gateway ユーザーズ・ガイド

Page 349: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_TRADING_PARTNER_PVT で定義されている API

get_sysadmin_email

PL/SQL 構文構文構文構文

procedure get_sysadmin_email

(email_address out varchar2, retcode out pls_integer, errmsg out varchar2);

摘要摘要摘要摘要

「ECX: システム管理者 E メール・アドレス」プロファイル・オプション用に定義されたシステム管理者の E メール・アドレスを取得します。

エラー・メッセージの送信処理を使用してシステム管理者に通知を送信する場合、このプロシージャは必要ありません。システム管理者のアドレスが導出されます。

引数(入力)引数(入力)引数(入力)引数(入力)

なし

引数(出力)引数(出力)引数(出力)引数(出力)

email_address 「ECX: システム管理者 E メール・アドレス」システム・プロファイルで指定された E メール・アドレス

retcode プロシージャのリターン・コード

errmsg プロシージャのリターン・メッセージ

XML Gateway API F-15

Page 350: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_TRADING_PARTNER_PVT で定義されている API

getEnvelopeInformation

PL/SQL 構文構文構文構文

procedure getEnvelopeInformation

(i_internal_control_number in pls_integer, i_message_type out varchar2, i_message_standard out varchar2, i_transaction_type out varchar2, i_transaction_subtype out varchar2, i_document_number out varchar2, i_party_id out varchar2, i_party_site_id out varchar2, i_protocol_type out varchar2, i_protocol_address out varchar2, i_username out varchar2, i_password out varchar2, i_attribute1 out varchar2, i_attribute2 out varchar2, i_attribute3 out varchar2, i_attribute4 out varchar2, i_attribute5 out varchar2, retcode out pls_integer, retmsg out varchar2);

摘要摘要摘要摘要

XML Gateway 実行エンジンで管理されている内部制御番号を使用して、メッセージ・エンベロープ・データを抽出します。

メッセージ・エンベロープの詳細は、「XML Gateway エンベロープ」(4-5 ページ)を参照してください。

引数(入力)引数(入力)引数(入力)引数(入力)

引数(出力)引数(出力)引数(出力)引数(出力)

i_internal_control_number

XML Gateway 実行エンジンで管理されている、インバウンド・メッセージに関連付けられている内部制御番号

i_message_type メッセージ・タイプのデフォルトは XML です。

i_message_standard 取引先から受け取るビジネス文書に使用する XML 標準。

XML 標準は、「XML 標準の定義」ウィンドウで入力し、「トランザクションの定義」ウィンドウで使用されます。

F-16 Oracle XML Gateway ユーザーズ・ガイド

Page 351: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_TRADING_PARTNER_PVT で定義されている API

i_transaction_type 取引先から受け取るビジネス文書に関連付けられている外部トランザクション・タイプ。

外部トランザクション・タイプは、「トランザクションの定義」ウィンドウで入力し、「取引先の定義」ウィンドウで使用されます。

i_transaction_ subtype

取引先から受け取るビジネス文書に関連付けられている外部トランザクション・サブタイプ。

外部トランザクション・サブタイプは、「トランザクションの定義」ウィンドウで入力し、「取引先の定義」ウィンドウで使用されます。

i_document_ number

取引先から受け取るビジネス文書の一意の識別子。このフィールドは XML Gateway では使用されませんが、Oracle e-Business Suite が受け取るアプリケーション・モジュールでは使用可能です。

i_party_id 未使用

i_party_site_id 「目的取引先事業所コード」でデータが見つからない場合に、「取引先の定義」ウィンドウを使用して入力したソース取引先事業所コード。

i_protocol_type 「取引先の定義」ウィンドウで入力した伝送方式。

i_protocol_address 伝送方式に関連付けられているアドレス /URL。「取引先の定義」ウィンドウで入力します。

i_username 「取引先の定義」ウィンドウで入力したユーザー名。

i_password ユーザー名に関連付けられているパスワード。「取引先の定義」ウィンドウで入力します。

i_attribute1 データを渡すためのユーザー定義フィールド。

i_attribute2 データを渡すためのユーザー定義フィールド。

i_attribute3 「目的取引先事業所コード」フィールド(「取引先の定義」ウィンドウで入力済)で指定した取引先に対して送信される別の XML メッセージのデータが、このフィールドのデータによってトリガーされます。

i_attribute4 データを渡すためのユーザー定義フィールド。

i_attribute5 データを渡すためのユーザー定義フィールド。

retcode プロシージャのリターン・コード

retmsg プロシージャのリターン・メッセージ

XML Gateway API F-17

Page 352: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_TRADING_PARTNER_PVT で定義されている API

getOAGLOGICALID

PL/SQL 構文構文構文構文

function getOAGLOGICALID

return varchar2;

摘要摘要摘要摘要

ECX_OAG_LOGICALID システム・プロファイルに定義した送信者の論理 ID を取得します。

ECX_OAG_LOGICALID システム・プロファイルで定義した値は、ECX_OAG_CONTROLAREA_TP_V ビューで抽出されます。この値は、OAG CNTROLAREA、LOGICALID 要素をマッピングする場合に使用されます。

この機能は、ECX_OAG_CONTROLAREA_TP_V ビューを使用する場合は必要ありません。

引数(入力)引数(入力)引数(入力)引数(入力)

なし

引数(出力)引数(出力)引数(出力)引数(出力)

なし

F-18 Oracle XML Gateway ユーザーズ・ガイド

Page 353: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_ERRORLOG で定義されている API

ECX_ERRORLOG で定義されているで定義されているで定義されているで定義されている API

getDoclogDetails

PL/SQL 構文構文構文構文

procedure getDoclogDetails

(i_msgid in raw, i_message_type out varchar2, i_message_standard out varchar2, i_transaction_type out varchar2, i_transaction_subtype out varchar2, i_document_number out varchar2, i_party_id out varchar2, i_party_site_id out varchar2, i_protocol_type out varchar2, i_protocol_address out varchar2, i_username out varchar2, i_password out varchar2, i_attribute1 out varchar2, i_attribute2 out varchar2, i_attribute3 out varchar2, i_attribute4 out varchar2, i_attribute5 out varchar2, i_logifle out varchar2, i_internal_control_number out number, i_status out varchar2, i_time_stamp out date, i_direction out varchar2, retcode out pls_integer, retmsg out varchar2);

摘要摘要摘要摘要

XML Gateway によって処理されるトランザクションについての情報を取得します。XML Gateway によって作成される各アウトバウンド・メッセージおよび XML Gateway によって処理されるインバウンド・メッセージごとに、ECX_DOCLOGS 表に対して書込みが行われます。

格納されているメッセージのコピーを使用してエラーが修復されます。エラーの修復の詳細は、「XML Gateway エラー・プロセス項目タイプ」(6-6 ページ)を参照してください。

XML Gateway API F-19

Page 354: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_ERRORLOG で定義されている API

引数(入力)引数(入力)引数(入力)引数(入力)

引数(出力)引数(出力)引数(出力)引数(出力)

i_msgid 処理されるメッセージごとに XML Gateway 実行エンジンによって挿入されるメッセージ識別子。

i_message_type メッセージ・タイプのデフォルトは XML です。

i_message_standard ビジネス文書に関連付けられた XML 標準。「XML 標準の定義」ウィンドウで入力し、「取引先の定義」ウィンドウで使用します。

i_transaction_type ビジネス文書に関連付けられた外部トランザクション・タイプ。「トランザクションの定義」ウィンドウで入力し、「取引先の定義」ウィンドウで使用します。

i_transaction_ subtype

ビジネス文書に関連付けられた外部トランザクション・サブタイプ。「トランザクションの定義」ウィンドウで入力し、「取引先の定義」ウィンドウで使用します。

i_document_ number

アウトバウンド・ビジネス文書用の Oracle E-Business Suite 固有の識別子。

取引先から受け取るインバウンド・ビジネス文書固有の識別子。

i_party_id ビジネス文書に関連付けられた取引先の識別子。「取引先の定義」ウィンドウで入力します。

i_party_site_id ビジネス文書に関連付けられた取引先サイトの識別子。「取引先の定義」ウィンドウで入力します。

i_protocol_type ビジネス文書に関連付けられた通信方法。「取引先の定義」ウィンドウで入力します。

i_protocol_address 通信方法に関連付けられたアドレスまたは URL。「取引先の定義」ウィンドウで入力します。

i_username 取引先に関連付けられたユーザー名。「取引先の定義」ウィンドウで入力します。

i_password ユーザー名に関連付けられたパスワード。「取引先の定義」ウィンドウで入力します。

i_attribute1 データを渡すためのユーザー定義フィールド。

i_attribute2 データを渡すためのユーザー定義フィールド。

i_attribute3 「取引先の定義」ウィンドウで入力した目的取引先事業所コード。

i_attribute4 データを渡すためのユーザー定義フィールド。

i_attribute5 データを渡すためのユーザー定義フィールド。

F-20 Oracle XML Gateway ユーザーズ・ガイド

Page 355: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_ERRORLOG で定義されている API

i_logfile 処理されたビジネス文書に対して、XML Gateway 実行エンジンによって作成されるログ・ファイルの名称を識別します。このログ・ファイルは、「ECX: ログ・ファイル・パス」システム・プロファイルで指定されているディレクトリに書き込まれます。

i_internal_control_number

処理された各ビジネス文書に対して、XML Gateway 実行エンジンによって定義される固有の識別子。

i_status 処理されるビジネス文書のステータス。

i_time_stamp アウトバウンド・ビジネス文書が作成された時間、またはインバウンド・ビジネス文書が処理された時間を示す XML Gateway 実行エンジンのタイム・スタンプ。

i_direction ビジネス文書が、Oracle E-Business Suite に対してアウトバウンドであるかインバウンドであるかを識別します。

retcode 関数のリターン・コード。

retmsg 関数のリターン・メッセージ。

XML Gateway API F-21

Page 356: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_ERRORLOG で定義されている API

external_system

PL/SQL 構文構文構文構文

procedure external_system

(i_outmsgid in raw, i_status in pls_integer, i_errmsg in varchar2, i_timestamp in date, o_ret_code out pls_integer, o_ret_msg out varchar2);

摘要摘要摘要摘要

配信ステータスをレポートするために、Oracle および非 Oracle メッセージ・システムで使用されます。ステータス情報は、トランザクション配信データの追跡およびレポートを行うために、XML Gateway ログ表に書き込まれます。

引数(入力)引数(入力)引数(入力)引数(入力)

引数(出力)引数(出力)引数(出力)引数(出力)

i_outmsgid XML Gateway 実行エンジンで管理されている、メッセージ・システムで配信されるアウトバウンド・メッセージに対するメッセージID。

i_status メッセージ・システムでレポートされるメッセージの配信ステータス。

i_errmsg メッセージ・システムでレポートされるエラー・メッセージ。

i_timestamp メッセージ・システムのタイム・スタンプ。XML Gateway によって作成されたアウトバウンド・メッセージが、いつ処理されたのかを示します。

o_ret_code プロシージャのリターン・コード。

o_ret_msg プロシージャのリターン・メッセージ。

F-22 Oracle XML Gateway ユーザーズ・ガイド

Page 357: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_ACTIONS で定義されている API

ECX_ACTIONS で定義されているで定義されているで定義されているで定義されている API

set_error_exit_program

PL/SQL 構文構文構文構文

procedure set_error_exit_program

(i_err_type in pls_integer, i_err_code in pls_integer, i_err_msg in varchar2);

摘要摘要摘要摘要

取引先担当とシステム管理者(「ECX: システム管理者 E メール・アドレス」で指定)のいずれかまたは両方に送信できるように、エラー・コードおよびメッセージを設定します。

エラー・メッセージの送信処理は、処理を終了する必要がない警告で使用されます。この手順は、処理を終了する必要がある重大なエラーが発生した場合に使用されます。

エラー・メッセージの送信処理の詳細は、「Map Action Editor - リターン・エラー・メッセージ : エラー・メッセージの送信」(2-106 ページ)を参照してください。

引数(入力)引数(入力)引数(入力)引数(入力)

i_err_type エラー通知の受信者を識別するコード。有効な値は、次のとおりです。

10 = レポート・エラー、通知を送信しません。

20 = エラー・コードおよびメッセージを含む通知を取引先担当に送信します。

25 = エラー・コードおよびメッセージを含む通知を取引先担当およびシステム管理者に送信します。

30 = エラー・コードおよびメッセージを含む通知をシステム管理者に送信します。

i_err_code 検出されたエラーのコード。

i_err_msg 検出されたエラー・メッセージの文字列。複数のメッセージをこの変数に連結し、通知として送信できます。

XML Gateway API F-23

Page 358: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ECX_ACTIONS で定義されている API

F-24 Oracle XML Gateway ユーザーズ・ガイド

Page 359: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

トラブルシューティン

G

トラブルシューティングトラブルシューティングトラブルシューティングトラブルシューティング

この章では、トラブルシューティングに関する次の内容について説明します。

� ecxver.sql スクリプトの実行(G-2 ページ)

� XML Gateway バージョンの検証(G-6 ページ)

� クライアント認証のインプリメントに関する一般的な問題(G-8 ページ)

グ G-1

Page 360: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway インストレーションのトラブルシューティング

XML Gateway インストレーションのトラブルシューティングインストレーションのトラブルシューティングインストレーションのトラブルシューティングインストレーションのトラブルシューティングその他のトラブルシューティング情報は、Oracle MetaLink の「Oracle XML Gateway Troubleshooting Guide」を参照してください。

ecxver.sql スクリプトの実行スクリプトの実行スクリプトの実行スクリプトの実行ecxver.sqlスクリプトは、Oracle XML Gateway のインストール状況を検証するために使用します。このスクリプトは、いつでも実行できます。次に、スクリプトの実行および出力の解釈の概要を示します。

自動化されたテスト・スクリプトの実行方法自動化されたテスト・スクリプトの実行方法自動化されたテスト・スクリプトの実行方法自動化されたテスト・スクリプトの実行方法

データベースの apps アカウントにログインして、次のコマンドを実行します。

SQL> @$ECX_TOP/patch/115/sql/ecxver.sql

スクリプトの出力が画面に表示されます。

自動化されたテスト・スクリプトのサンプル出力自動化されたテスト・スクリプトのサンプル出力自動化されたテスト・スクリプトのサンプル出力自動化されたテスト・スクリプトのサンプル出力

Component OBJECT_NAME LOCKED_MODE

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

OTA ECX_OUTQUEUE 正常

WEBMETHODS ECX_OUTQUEUE 正常

WEBMETHODS ECX_OUTQUEUE 正常

WEBMETHODS ECX_OUTQUEUE 正常

G-2 Oracle XML Gateway ユーザーズ・ガイド

Page 361: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway インストレーションのトラブルシューティング

ECX_UTL_XSLT_DIR Profile : /sqlcom/log/dev115ECX_OAG_LOGICALID Profile : www.oracle.comECX_SERVER_TIMEZONE Profile:ECX_SYS_ADMIN_EMAIL Profile: [email protected]_UTL_LOG_DIR Profile : /sqlcom/log/dev115ERROR: Parser Version wrong: Oracle XML Parser 2.0.2.8.0 ProductionERROR: Some Invalid ECX Objects!----------------------------------------------------------

XML Gateway Status Summary

----------------------------------

-------------------------------------------------------------

End of Summary

----------------------------------

WEBMETHODS ECX_OUTQUEUE 正常

WEBMETHODS ECX_OUTQUEUE 正常

Log Profile/utl_file_dir OK

XML Parser Version FAIL

All ECX Objects Valid? No

All XML Parser Objects Valid? OK

webMethods Running? OK

OTA Running? OK

Total Messages on Outbound Queue 6

OTA Msgs on Outbound Queue 4

webMethods Msgs on Outbound Queue 1

Messages on Inbound Queue 8

トラブルシューティング G-3

Page 362: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway インストレーションのトラブルシューティング

自動化されたテスト・スクリプトによって生成された出力の解釈方法自動化されたテスト・スクリプトによって生成された出力の解釈方法自動化されたテスト・スクリプトによって生成された出力の解釈方法自動化されたテスト・スクリプトによって生成された出力の解釈方法次の表では、上述の出力例の各行について説明します。一部の出力は、通知を行うためにのみ使用され、さらに処理が必要となることはありません。

出力出力出力出力 説明説明説明説明 / トラブルシューティングのヒントトラブルシューティングのヒントトラブルシューティングのヒントトラブルシューティングのヒント

Transport Software 「LOCKED_MODE」値は「Normal」になりますが、「DEADLOCK」

と表示される場合もあります。デッドロックは、短時間表示される場合は正常です。デッドロックが 10 分を超えて表示される場合は、重

大な問題が発生している可能性があります。

注意注意注意注意 : webMethods は Oracle Exchange 環境でのみ使用され、ERP 環

境では使用されません。

システム・プロファイル : ECX_UTL_XSLT_DIRECX_OAG_LOGICALIDECX_SERVER_TIMEZONEECX_SYS_ADMIN_EMAILECX_UTL_LOG_DIR

各 XML Gateway システム・プロファイルに関連付けられている値

が、確認のために表示されます。

注意注意注意注意 : 「ECX_SERVER_TIMEZONE」プロファイル・オプションは、

パッチ #2128930 で導入されました。

ERROR: Parser Version Wrong この環境に関連する XML パーサーのバージョンが表示されます。

XML パーサーのバージョン 2.0.2.9 以降が必要です。

ERROR: Some Invalid ECX Objects

一部の ECX データベース・オブジェクトが無効であることを示す情

報メッセージです。

Log Profile/utl_file_dir 表示される値が「OK」以外の場合は、次の点を確認します。

「ECX_UTL_XSLT_DIR」および「ECX_UTL_LOG_DIR」システム・

プロファイルに関連付けられる物理ディレクトリは、INIT.ORA ファ

イルの utl_file_dir パラメータに割り当てられる必要があります。ま

た、物理ディレクトリが書込み可能になっているかどうかを確認します。必要に応じて、データベースを変更して再起動します。

XML Parser Version 表示される値が「FAIL」の場合は、XML パーサーをバージョン

2.0.2.9 以降にアップグレードします。

All ECX Objects Valid? 表示される値が「NO」の場合は、無効なオブジェクトを再コンパイ

ルする必要があります。無効なオブジェクトを再コンパイルするか、または XML Gatewayパッチを再適用して無効な ECX データベース・オブジェクトを解決

します。

All XML Parser Objects Valid? 表示される値が「NO」の場合は、XML パーサーを再インストールす

る必要があります。XML パーサーを再インストールして、無効な XML パーサー・オブ

ジェクトを解決します。

G-4 Oracle XML Gateway ユーザーズ・ガイド

Page 363: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway インストレーションのトラブルシューティング

webMethods Running? 表示される値が「OK」以外の場合は、webMethods を再起動します。

Oracle がホストである環境の場合は、オペレーションに通知します。

セルフホスト環境の場合は、webMethods に通知します。

注意注意注意注意 : webMethods は Oracle Exchange 環境でのみ使用され、ERP 環

境では使用されません。

OTA Running? 表示される値が「OK」以外の場合は、Oracle Transport Agent(OTA)を再起動します。

OTA パッチの指示に従って、Apache Web サーバーを起動します。必

要な JSERV プロパティを確実に設定します。

Total Messages on Outbound Queue

レポートされる番号は、OTA または webMethods による処理をアウ

トバウンド・キューで待機しているメッセージの数を示します。この数が異常に多い場合は、OTA および webMethods キューにある

個々の合計を確認します。

OTA Messages on Outbound Queue

レポートされる番号は、OTA による処理をアウトバウンド・キュー

で待機しているメッセージの数を示します。これは、合計のサブセットです。この数が異常に多い場合は、OTA が実行されているかどうかを確認

します。

webMethods Messages on Outbound Queue

レポートされる番号は、webMethods による処理をアウトバウンド・

キューで待機しているメッセージの数を示します。これは、合計のサブセットです。この数が異常に多い場合は、webMethods が実行されているかどうか

を確認します。

Messages on Inbound Queue インバウンド・キューにあるメッセージの数を示します(通知用)。インバウンド・キューのエージェント・リスナーが使用可能で、OTA/webMethods が動作している場合、これらのメッセージは処理

されます。必要に応じて、「Workflow 管理者 : エージェントの追加」ウィンドウ

で、インバウンド・キューをモニターする Workflow エージェント・

リスナーを使用可能にします。または、「システム管理者 : Workflowエージェント・リスナー」コンカレント要求を使用して、エージェント・リスナーが継続的に実行されるようにスケジュールします。

出力出力出力出力 説明説明説明説明 / トラブルシューティングのヒントトラブルシューティングのヒントトラブルシューティングのヒントトラブルシューティングのヒント

トラブルシューティング G-5

Page 364: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway バージョンの検証

XML Gateway バージョンの検証バージョンの検証バージョンの検証バージョンの検証各データ定義またはマップ・ファイルには、メジャー・バージョンの番号およびマイナー・バージョンの番号が関連付けられます。これらの番号は、マップを作成するために使用するMessage Designer のバージョンを表します。これらの番号は、<ECX_MAJOR_VERSION>タグおよび <ECX_MINOR_VERSION> タグで入手可能です。Message Designer によって、マップのバージョン番号が Message Designer のバージョン番号(「Help」>「About」メニューで入手可能)と比較され、メジャー・バージョンが同じで、かつマイナー・バージョンが同じか小さい場合にのみマップが開かれます。

また、マップを XML Gateway のリポジトリにロードしようとすると、そのマップのバージョン番号は、XML Gateway のインストール済バージョン番号(WF_RESOURCES.ECX_VERSION で入手可能)と比較されます。マップは、メジャー・バージョンが同じで、かつマイナー・バージョンが同じか小さい場合にのみロードされます。

問題問題問題問題 : LoadMap の実行時エラーの実行時エラーの実行時エラーの実行時エラーバージョン非互換 : XML Gateway 2.10 マップは、現在インストールされている XML Gateway 2.6 ではサポートされていません。

サンプル・エラー・メッセージサンプル・エラー・メッセージサンプル・エラー・メッセージサンプル・エラー・メッセージJava oracle.apps.ecx.loader.LoadMap apps apps $JDBC mymap.xgm Database Connect String(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=ap935sun) (PORT=1543))(CONNECT_DATA=(SID=ecxcert)))UserName appsConnecting...connected.Installed XML Gateway Version: 2.6.0.0Started Processing of the DocumentProcessing Instructions for xmlGateway=> MAPMap Code: ECX_POO Using Old Map id: 19Version Incompatible: XML Gateway 2.10 map is not supported by currently installed XML Gateway 2.6.0.0

解決法解決法解決法解決法 : インストールされているインストールされているインストールされているインストールされている XML Gateway のアップグレードのアップグレードのアップグレードのアップグレード次の表は、他のサンプル・マップと XML Gateway バージョンの互換性を示します。バージョン番号は、<ECX_MAJOR_VERSION> タグおよび <ECX_MINOR_VERSION> タグで入手可能です。

サンプルのバージョン 2.6 では、2 がメジャー・バージョン番号、6 がマイナー・バージョン番号です。

G-6 Oracle XML Gateway ユーザーズ・ガイド

Page 365: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

XML Gateway バージョンの検証

問題問題問題問題 : トランザクション処理時のエラー(デバッグ・レベルトランザクション処理時のエラー(デバッグ・レベルトランザクション処理時のエラー(デバッグ・レベルトランザクション処理時のエラー(デバッグ・レベル 3 を使用)を使用)を使用)を使用)

サンプル・エラー・メッセージサンプル・エラー・メッセージサンプル・エラー・メッセージサンプル・エラー・メッセージEnter ECX_UTILS.INITIALIZE i_map_id==>19 Enter ECX_UTILS.CHECK_VERSION i_major_version==>2 i_minor_version==>10 i_eng_version==>2.6.0.0 i_eng_major_version==>2 i_eng_minor_version==>6 Exit ECX_UTILS.CHECK_VERSION [ECE_PROGRAM_ERROR] PROGRESS_LEVEL=ecx_utils.INITIALIZE [ECE_ERROR_MESSAGE] ERROR_MESSAGE=Version Incompatible: XML Gateway version 2.10 is not supported by currently installed XML Gateway 2.6.0.0 Exit ecx_utils.INITIALIZE Clean-up i_stack, l_node_stack and i_tmpxml Exit ECX_OUTBOUND.PROCESS_OUTBOUND_DOCUMENTS ECX_UTILS.INITIALIZE: Version Incompatible: XML Gateway version 2.10 is not supported by currently installed XML Gateway 2.6.0.0Exit ECX_OUTBOUND.GETXML

解決法解決法解決法解決法 : インストールされているインストールされているインストールされているインストールされている XML Gateway のアップグレードのアップグレードのアップグレードのアップグレード実行時に、エンジンによって .xgm ファイルからのバージョンがインストール済 XML Gateway バージョンと比較されます。ローダーおよびエンジンでは、同じメジャー・バージョンおよび同じ(または小さい)マイナー・バージョンのマップのみがサポートされています。XML Gateway によって、バージョンに互換性がない場合にエラー・メッセージが戻されます。

次の表は、トランザクション処理時に発生するその他のエラー条件の例を示します。

Installed XML Gateway Version

XGM/LOADERバージョンバージョンバージョンバージョン 互換互換互換互換 / 非互換非互換非互換非互換 処理処理処理処理

2.6.0.0 2.10.0.0 非互換 XML Gateway のアップグレード

2.6.0.0 2.6.0.0 OK なし

2.10.0.0 2.6.0.0 OK なし

2.6.0.0 2.4.0.0 OK なし

2.6.0.0 1.1.0.0 非互換 マップのアップグレード

2.6.0.0 3.1.0.0 非互換 XML Gateway のアップグレード

トラブルシューティング G-7

Page 366: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

クライアント認証のインプリメントに関する一般的な問題

クライアント認証のインプリメントに関する一般的な問題クライアント認証のインプリメントに関する一般的な問題クライアント認証のインプリメントに関する一般的な問題クライアント認証のインプリメントに関する一般的な問題次に、クライアント認証時に発生する一般的なエラーを示します。

これらのエラーや他のエラーの詳細は、Oracle MetaLink にある「Installing Oracle XML Gateway with Oracle Applications 11i」を参照してください。

java.lang.NoSuchMethodErrorこのエラーが発生する場合は、jserv.propertiesファイルで wrapper.classpathパラメータが正しく設定されているかどうかを確認してください。

SSLException X509CertExpiredErr 説明説明説明説明 : ハンドシェイク中に、SSL 例外およびメッセージ X509CertExpiredErr によってプログラムが失敗しました。プログラムは前日には正常に動作しており、プログラムに対しては何の変更も行われていません。

解決法解決法解決法解決法 : ご使用のユーザー証明書が期限切れです。CA に新しいユーザー証明書を要求してください。

SSL Exception :SSL handshake failed: X509CertChainInvalidErr説明説明説明説明 : クライアント側でハンドシェイクが失敗して、SSL 例外およびメッセージX509CertChainInvalidErr が発行されます。Web ブラウザは、サーバーに正常に接続できます。

解決法解決法解決法解決法 : サーバーまたはクライアントのいずれかに適切な証明書がありません。jserv.propertiesで OASSLCACertFile が有効な CA バンドルをポイントしていることを確認してください。

クライアント・プログラムで有効な証明書が設定されている場合は、サーバーの証明書チェーン内の証明書がリストに 1 つ以上あるかどうかを確認してください。また、サーバーがクライアントに完全な証明書チェーンを送信するかどうかを確認してください。これは、Java SSL 自体では証明書チェーンを作成できないためです。

Installed XML Gateway Version

XGM/LOADERバージョンバージョンバージョンバージョン 互換互換互換互換 / 非互換非互換非互換非互換 処理処理処理処理

2.6.0.0 2.10.0.0 非互換 XML Gateway のアップグレード

2.6.0.0 2.6.0.0 OK なし

2.10.0.0 2.6.0.0 OK なし

2.6.0.0 2.4.0.0 OK なし

2.6.0.0 1.1.0.0 非互換 マップのアップグレード

2.6.0.0 3.1.0.0 非互換 XML Gateway のアップグレード

G-8 Oracle XML Gateway ユーザーズ・ガイド

Page 367: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

クライアント認証のインプリメントに関する一般的な問題

Apache サーバーを使用する場合は、変数 SSLCertificateChainFile および SSLCertificateFileを正しく設定する必要があります。このことは、クライアント・プログラムで有効な証明書が設定されていない場合に特に重要です。詳細は、Web サーバーの文書を参照してください。

Client Connection with No Credentials説明説明説明説明 : サーバーでは、クライアント・プログラムで OracleSSLCredentials が設定されていない場合でもクライアント接続が許可されます。

解決法解決法解決法解決法 : Java SSL では、セキュリティ機能を備えたアプリケーションで独自の検証を行うことができるように、サーバーから送信される証明書チェーンが完全である場合は、クライアントで証明書が設定されていなくても通信が許可されます。この動作を回避するには、アプリケーションで 1 つ以上の有効な証明書を設定する必要があります。

トラブルシューティング G-9

Page 368: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

クライアント認証のインプリメントに関する一般的な問題

G-10 Oracle XML Gateway ユーザーズ・ガイド

Page 369: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

用語集用語集用語集用語集

SSL((((Secure Socket Layer))))

インターネット上で情報を暗号化するための汎用プロトコル。

SSL 証明書チェーン・ファイル(証明書チェーン・ファイル(証明書チェーン・ファイル(証明書チェーン・ファイル(SSL Certificate Chain File))))

PEM エンコードされた CA 証明書が連結されたファイル。サーバー証明書の証明書チェーンを構成します。認証局 CA1 がクライアントを証明し、認証局 CA2 がサーバーを証明する場合、このファイルには CA1 および CA2 の証明書が含まれます。同じ認証局がクライアントとサーバーの両方を証明する場合、このファイルはその CA の証明書ファイルになります。

XML((((Extensible Markup Language))))

文書書式を定義、検証および共有するためのシステム。

XML スキーマ(スキーマ(スキーマ(スキーマ(XML Schema))))

(オブジェクトの)要素、その属性(たとえばデータ型)および異なる要素間の関係を定義するデータ・モデルの説明。

XML パーサー(パーサー(パーサー(パーサー(XML Parser))))

XML メッセージの形式が正しいかどうかを検証するプロセス。パーサーでは、DTD ルールに対して XML メッセージを検証することもできます。XML パーサーは、Oracle8i のコンポーネントです。

XSL((((Extensible Stylesheet Language))))

XML 文書の表示および外観に関する仕様を定義。

XSLT((((XSL Transformation))))

1 つのタグ・セットで表現された文書を他のタグ・セットで表現された文書に変換するためのルール・セットを提供する XSL 変換ツール。

用語集用語集用語集用語集 -1

Page 370: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

アプリケーション間(アプリケーション間(アプリケーション間(アプリケーション間(Application-to-Application: A2A))))

Oracle Inventory と Oracle General Ledger 間など、企業内の ERP アプリケーション・モジュール間におけるデータ交換のタイプ。

企業アプリケーション統合(企業アプリケーション統合(企業アプリケーション統合(企業アプリケーション統合(Enterprise Application Integration: EAI))))

企業の内部および外部の ERP アプリケーション間におけるデータ交換のタイプ。企業間の例には、Oracle General Ledger と通信する Oracle Inventory があります。企業内の例には、レガシー・システムやその他の異種システムと通信する Oracle E-Business Suite があります。

企業間(企業間(企業間(企業間(Business-to-Business: B2B))))

Oracle E-Business Suite と取引先の間のデータ交換のタイプ(たとえば、発注の送信や仕入先からの請求書の受信)。

クライアント証明書(クライアント証明書(クライアント証明書(クライアント証明書(Client Certificate))))

クライアントの ID を証明するデジタル証明書。

公開キー(公開キー(公開キー(公開キー(Public Key))))

作成された署名を検証するために使用。

認証局(認証局(認証局(認証局(Certification Authority: CA))))

公開キー証明書を発行する組織。証明書は、個人(組織)の名前、個人の公開キー、シリアル番号およびその他の情報(発行日、失効日)を含む、CA の独自の秘密キーによって署名されます。証明書によって、特定の公開キーが特定の個人または組織に属していることが証明されます。

秘密キー(秘密キー(秘密キー(秘密キー(Private Key))))

XML 文書などのデータ・ブロックに署名するために使用。

文書タイプ定義(文書タイプ定義(文書タイプ定義(文書タイプ定義(Document Type Definition: DTD))))

文書で許可される要素(マークアップ・タグ)および属性(タグに関連付けられた値)を指定する XML 文書のルール。

用語集用語集用語集用語集 -2

Page 371: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

索引索引索引索引

A

「Add Child」ボタン,2-5「Add Sibling」ボタン,2-5API

ECX_ACTIONS.set_error_exit_program,F-23ECX_CONDITIONS.getLengthForString,F-11ECX_CONDITIONS.getPositionInString,F-11ECX_CONDITIONS.getSubString,F-12ECX_DOCUMENT.get_delivery_attribs,F-8ECX_ERRORLOG.external_system,F-22ECX_ERRORLOG.getDoclogDetails,F-19ECX_STANDARD.getEventDetails,F-5ECX_STANDARD.getEventSystem,F-6ECX_STANDARD.getReferenceID,F-7ECX_STANDARD.setEventDetails,F-3ECX_STANDARD 生成,6-11ECX_TRADING_PARTNER_PVT.get_receivers_tp_

info,F-13ECX_TRADING_PARTNER_PVT.get_senders_tp_

info,F-14ECX_TRADING_PARTNER_PVT.get_sysadmin_

email,F-15ECX_TRADING_PARTNER_

PVT.getEnvelopeInformation,F-16ECX_TRADING_PARTNER_

PVT.getOAGLOGICALID,F-18マッピング方法,2-112

ATTRIBUTE3動的ルーティング内,3-29

ATTRIBUTE3 フィールド,3-26,4-7

CConditional Node Mapping,2-49

D「Delete」ボタン,2-5DTD

拡張方法,2-110ロード,2-115

EE-Business Suite アプリケーションのモジュール固有項

目タイプ,6-7ECX_DOCLOGS 表,6-28,6-33,6-42ECX_IN_OAG_Q,5-2ECX_INBOUND キュー,5-1ECX_OUTBOUND キュー,5-1ECXOTAInbound.html ファイル,5-4ecxver.sql スクリプト,G-2ECX アウトバウンド・エラー詳細の取得機能,6-42ECX アウトバウンド・メッセージの再送機能,6-42ECX イベント通知(FYI),6-39ECX イベント・メッセージ(FYI),6-46ECX インバウンド・エラー詳細の取得機能,6-42ECX エンジン通知プロセス,6-37ECX 外部イベント通知,6-39ECX 外部イベント・メッセージ(FYI),6-46ECX 再処理インバウンド機能,6-42ECX メイン・アウトバウンド・エラー・プロセス,

6-34ECX メイン・インバウンド・エラー・プロセス,6-32ECX メイン・エラー・プロセス,6-31EDI トランザクション

XML メッセージと比較,1-10

索引索引索引索引 -1

Page 372: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

FFYI 配送エラー・プロセス,6-35

L「Level Mapping」タブ,2-58

MMap Action Editor

起動,2-70処理レベルと処理ステージの組合せ,2-72

NNOUN

OAG 標準での設定,3-13

OOAG

変更の提案,A-23Oracle Transport Agent (OTA),7-1

P「Properties」メニュー・オプション,2-5

S「Source Definition」タブ,2-43

T「Target Definition」タブ,2-52

UUTL_FILE_DIR パラメータの定義,3-3

VVERB

OAG 標準での設定,3-13

WWF_ERROR キュー,5-2Workflow Builder

E-Business Suite アプリケーションのモジュール固有項目タイプ,6-7

XML Gateway エラー・プロセス項目タイプ,6-6XML Gateway 標準項目タイプ,6-5,6-7項目タイプ,6-4項目タイプのコンポーネント,6-4

Workflow エラー・キュー,5-2,5-3

XXML Gateway エラー・プロセス項目タイプ,6-6,

6-28イベント,6-43

エラーの受信,6-44受信、通知の送信,6-44メッセージ配送エラー,6-43

機能,6-41ECX アウトバウンド・エラー詳細の取得,6-42ECX アウトバウンド・メッセージの再送,6-42ECX インバウンド・エラー詳細の取得,6-42ECX 再処理インバウンド,6-42システム管理者ロールの取得,6-42取引先ロールの取得,6-43

選択肢タイプ,6-48ECX アウトバウンド・エラー処理,6-50ECX アウトバウンド・エラー・タイプ,6-50ECX インバウンド・エラー処理,6-50

通知,6-39ECX イベント通知(FYI),6-39ECX 外部イベント通知,6-39取引先アウトバウンド・エラー通知,6-40取引先インバウンド・エラー通知,6-40メッセージ配送エラー(FYI),6-40

プロセス

ECX エンジン通知プロセス,6-37ECX メイン・アウトバウンド・エラー・プロ

セス,6-34ECX メイン・インバウンド・エラー・プロセス,

6-32ECX メイン・エラー・プロセス,6-31FYI 配送エラー・プロセス,6-35アウトバウンド・メッセージのエラー処理,6-34

索引索引索引索引 -2

Page 373: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

インバウンド・メッセージのエラー処理,6-32デフォルト・エラー・プロセス,6-36

メッセージ,6-44ECX イベント・メッセージ(FYI),6-46ECX 外部イベント・メッセージ(FYI),6-46アウトバウンド取引先メッセージ,6-46インバウンド取引先メッセージ,6-46

メッセージ・テンプレートの属性,6-46XML Gateway 職責の定義,3-3XML Gateway 標準項目タイプ,6-5,6-7

イベント,6-23文書配送イベントの呼出し,6-23

機能,6-8選択肢タイプ,6-25

送信モード,6-27「XML 標準の定義」フォーム,3-6

XML 文書の処理機能,6-10XML 文書の生成機能,6-11

ああああアーキテクチャ、XML Gateway

ダイアグラム,1-3アウトバウンド取引先メッセージ,6-46アウトバウンド・メッセージ・キュー,5-1,5-2アプリケーション間

例,6-9

いいいいイベント

XML Gateway エラー・プロセス項目タイプ,6-43エラーの受信,6-44受信、通知の送信,6-44メッセージ配送エラー,6-43

XML Gateway 標準項目タイプ,6-23文書配送イベントの呼出し,6-23

インバウンド・トランザクション・キュー,5-2,5-3インバウンド取引先メッセージ,6-46インバウンド・メッセージ・キュー,5-1,5-3インプリメンテーション・チェックリスト,3-1

ええええエラー処理

アウトバウンド・メッセージの場合,6-34インバウンド・メッセージの場合,6-32

エラー処理プロセス,6-29関連,6-31

エラーの受信イベント,6-44エラー・キュー,5-3エンベロープ,4-5

コンポーネント,4-5

かかかか確認ビジネス・オブジェクト文書,4-12

構成,4-12シードされたイベントおよびサブスクリプション,

4-13シードされたメッセージ・マップ,4-12実装,4-14使用不可,4-14

カスタム・メッセージ考慮事項,A-24

きききき企業間

例,6-9機能(ワークフロー)

XML Gateway エラー・プロセス項目タイプ,6-41ECX アウトバウンド・エラー詳細の取得,6-42ECX アウトバウンド・メッセージの再送,6-42ECX インバウンド・エラー詳細の取得,6-42ECX 再処理インバウンド,6-42システム管理者ロールの取得,6-42取引先ロールの取得,6-43

XML Gateway 標準項目タイプ,6-8XML 文書の処理,6-10XML 文書の生成,6-11トランザクション配送要,6-19取引先 XML 文書の生成,6-14文書の送信,6-17

キュー

XML Gateway で使用,5-1アウトバウンド・メッセージ,5-2インバウンド・トランザクション,5-3インバウンド・メッセージ,5-3エラー,5-3定義,5-1

索引索引索引索引 -3

Page 374: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

くくくくクライアント認証,7-2,7-6

トラブルシューティング,G-8

けけけけ検証

アウトバウンド・メッセージのための取引先,4-11インバウンド・メッセージのための取引先,4-8

ここここ項目タイプ

E-Business Suite アプリケーションのモジュール固有項目タイプ,6-7

XML Gateway エラー・プロセス項目タイプ,6-6XML Gateway 標準項目タイプ,6-5,6-7コンポーネント,6-4

コード変換,3-311 から複数の外部コードへ,3-38アウトバウンド・トランザクション・コード表への

アクセス,3-36インバウンド・トランザクション・コード表へのア

クセス,3-37「取引先コード変換」フォーム,3-42「標準コード変換」フォーム,3-39

コード変換値キー・アクセス,3-35表検索の順序,3-35

コールバック,7-7

ささささサーバー認証,7-2,7-4再試行,6-28,6-42再処理,6-28参照タイプ

XML Gateway エラー・プロセス項目タイプECX アウトバウンド・エラー処理,6-50ECX アウトバウンド・エラー・タイプ,6-50ECX インバウンド・エラー処理,6-50

XML Gateway 標準項目タイプ送信モード,6-27

参照値定義付け,3-14

参照値の定義,3-14

ししししシステム管理者ロールの取得機能,6-42システム・プロファイル値の定義,3-2実行エンジン

アウトバウンド・メッセージのための取引先の

検証,4-11インバウンド・メッセージのための取引先の検証,

4-8機能,1-8必要な設定,4-2プロセス・フロー,4-1

実行エンジンの処理順序,2-68処理,2-67

OAG AMOUNT からの変換,2-97OAG AMOUNT への変換,2-91OAG DATETIME からの変換,2-93OAG DATETIME への変換,2-87OAG OPERAMT からの変換,2-94OAG OPERAMT への変換,2-88OAG QUANTITY からの変換,2-96OAG QUANTITY への変換,2-90WHERE 句の追加,2-79XSLT 変換,2-110エラー・メッセージの送信,2-106関数コールの実行,2-85グローバル変数の作成,2-77サブ文字列の実行,2-109算術関数,2-86事業所コードからの親 ID の導出,2-84事業所コードからの所在地 ID の導出,2-82事前定義済変数値の取得,2-99次の連番値の割当て,2-78データベース表への挿入,2-82プログラムの終了,2-99プロシージャの実行,2-102変数値の割当て,2-76連結の実行,2-108

せせせせ静的および動的ルーティング,3-26静的ルーティング,3-28

索引索引索引索引 -4

Page 375: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

そそそそ相互参照トランザクション識別子,3-8ソースの定義の概要,2-41

たたたたターゲットの定義,2-50タイム・ゾーン

設定,3-2プロファイル・オプションの値,E-1

つつつつ通知

XML Gateway エラー・プロセス項目タイプ,6-39ECX イベント通知(FYI),6-39ECX 外部イベント通知,6-39取引先アウトバウンド・エラー通知,6-40取引先インバウンド・エラー通知,6-40メッセージ配送エラー(FYI),6-40

通知の送信イベントの受信,6-44ツールバー、Message Designer,2-4

ててててデフォルト・エラー・プロセス,6-36

とととと動的ルーティング,3-29トラブルシューティング

ecxver.sql スクリプトの実行,G-2クライアント認証問題,G-8バージョンの検証,G-6

「トランザクションの定義」フォーム,3-7トランザクション配送要機能,6-19取引先 XML 文書の生成,6-14取引先アウトバウンド・エラー通知,6-40取引先インバウンド・エラー通知,6-40「取引先コード変換」フォーム,3-42「取引先設定」フォーム,3-17

データ検証,4-10取引先の検証

アウトバウンド・メッセージ,4-11インバウンド・メッセージ,4-8

取引先ロールの取得機能,6-43

にににに認証,7-2

イベントの順序,7-3クライアント認証,7-2サーバー認証,7-2

ははははバージョンの検証,G-6パス・スルー・メッセージ

実行エンジンの処理,4-9ハブ・エンティティ・コード,3-6「ハブ定義」フォーム,3-4

ひひひひ引渡しメッセージ

マッピング方法,2-112「標準コード変換」フォーム,3-39

ふふふふフォーム

XML 標準の定義,3-6参照値の定義,3-14トランザクションの定義,3-7取引先コード変換,3-42取引先設定,3-17ハブ定義,3-4標準コード変換,3-39

複数組織を考慮,3-18不連続ノード

ソースの定義,2-47ターゲットの定義,2-56

プロセス

XML Gateway エラー・プロセス項目タイプ,6-29文書確認,3-24文書の送信機能,6-17文書配送イベントの呼出し,6-23文書レベル

ソースおよびターゲットの指定,A-19レベルの拡張,A-21レベルの縮小,A-20

索引索引索引索引 -5

Page 376: Oracle XML GatewayOracle XML Gateway ユーザーズ・ガイド, リリース11i 部品番号:J07398-01 原本名:Oracle XML Gateway User’s Guide, Release 11i 原本部品番号:A90250-03

ほほほほボタン、Message Designer,2-5ボタン、Message Designer のウィザード,2-19

ままままマップ分析のガイドライン

アウトバウンド・メッセージ,A-2インバウンド・メッセージ,A-11

めめめめ命名規則

トランザクション・タイプおよびトランザクション・サブタイプ,3-11

メッセージ

XML Gateway エラー・プロセス項目タイプ,6-44ECX イベント・メッセージ(FYI),6-46ECX 外部イベント・メッセージ(FYI),6-46アウトバウンド取引先メッセージ,6-46インバウンド取引先メッセージ,6-46メッセージ・テンプレートの属性,6-46

メッセージ・エンベロープ,4-5メッセージ配信コールバック,7-7

ブロック・モード,7-8メッセージ配送エラー(FYI),6-40メッセージ配送エラー・イベント,6-43メッセージ・マップ

ロード,2-113メニュー、Message Designer,2-2「File」メニュー,2-2

「Properties」オプション,2-5「Help」メニュー,2-4「View」メニュー,2-3

よよよよ要素のマッピング,2-63

アイコン,2-65ガイドライン,2-64処理の適用,2-66

るるるるルーティング,3-25

静的,3-28

静的および動的,3-26動的,3-29

ルール機能、XML Gateway,6-2ルール機能、ワークフロー・デフォルト,6-2

れれれれレベルのマッピングのガイドライン

OAG DTD,2-59不連続ノード,2-62,A-22レベルの拡張,2-60レベルの縮小,2-59

索引索引索引索引 -6