1. Homepage
  2. EDIFACT EDI Connector (2.2)

  3. Anypoint Studio を使用した EDIFACT EDI Connector の設定

All Connectors

Anypoint Studio を使用した EDIFACT EDI Connector 2.2 の設定 - Mule 4

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

  1. ​Mule プロジェクトを作成​します。

  2. ​コネクタを Mule プロジェクトに追加​します。

  3. ​コネクタのフローのソースを設定​します。

  4. ​コネクタ操作をフローに追加​します。

  5. ​コネクタのグローバル要素を設定​します。

  6. ​他のコネクタ項目を設定します​。

このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​「EDIFACT EDI リファレンス」​を参照してください。

Mule プロジェクトを作成する

Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。

  1. Studio で、​[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)]​ を選択します。

  2. Mule プロジェクトの名前を入力して、​[Finish (完了)]​ をクリックします。

コネクタを Mule プロジェクトに追加する

EDIFACT EDI Connector を Mule プロジェクトに追加して、XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの ​pom.xml​ ファイルに必須の連動関係を追加します。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[(X) Search in Exchange ((X) Exchange 内を検索)]​ をクリックします。

  2. [Add Dependencies to Project (連動関係をプロジェクトに追加)]​ ウィンドウで、検索項目に「​EDIFACT EDI​」と入力します。

  3. [Available modules (使用可能なモジュール)]​ で、​[EDIFACT EDI]​ をクリックします。

  4. [Add (追加)]​ をクリックします。

  5. [Finish (完了)]​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

ソースの設定

ソースは、指定された条件が満たされたときにフローを開始します。 EDIFACT EDI Connector でこのソースを使用するように設定できます。

  • HTTP Listener (HTTP リスナー)
    設定されたホストとポートで要求を受信するたびにフローを開始します。

たとえば、HTTP Listener ソースを設定する手順は、次のとおりです。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[HTTP] > [Listener]​ を選択します。

  2. [Listener]​ を Studio キャンバスにドラッグします。

  3. [Listener (リスナー)]​ 設定画面で、必要に応じて ​[Display Name (表示名)]​ 項目の値を変更します。

  4. [Path (パス)]​ 項目の値を指定します。

  5. [Connector configuration (コネクタ設定)]​ 項目の横にあるプラス記号 (​+​) をクリックして、アプリケーション内の HTTP Listener ソースのすべてのインスタンスで使用できるグローバル要素を設定します。

  6. [General (一般)]​ タブで、コネクタの接続情報を指定します。

  7. [TLS]​ タブで、必要に応じてコネクタの TLS 情報を指定します。

  8. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  9. [Test Connection (接続をテスト)]​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。

  10. [OK]​ をクリックします。

フローにコネクタの操作を追加する

フローにコネクタの操作を追加するときは、そのコネクタで実行するアクションを指定しています。 EDIFACT EDI Connector の操作を追加する手順は、次のとおりです。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[EDIFACT EDI]​ を選択し、目的の操作を選択します。

  2. その操作を Studio キャンバスの入力元の右にドラッグします。

コネクタのグローバル要素を設定する

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定します。グローバル要素を設定するには、コネクタが対象の EDIFACT EDI システムにアクセスするために必要な認証ログイン情報を指定する必要があります。

EDIFACT EDI Connector のグローバル要素を設定する手順は、次のとおりです。

  1. Studio キャンバスで操作を選択します。

  2. 操作の設定画面で、​[Connector configuration (コネクタ設定)]​ 項目の横にあるプラス記号 (​+​) をクリックし、グローバル要素設定項目にアクセスします。

  3. [General (一般)]​ タブの ​[Connection (接続)]​ で、設定する認証方式を選択します。

    ANT スタイルのプロパティプレースホルダーを含む設定ファイルを参照するか (推奨)、グローバル設定プロパティに認証ログイン情報を入力できます。

  4. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  5. [Test Connection (接続をテスト)]​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。

  6. [OK]​ をクリックします。

その他のコネクタ項目の設定

EDIFACT EDI のグローバル要素を設定したら、コネクタの他の省略可能な項目または必須項目を設定します。必須項目は、使用するコネクタ操作によって異なります。

[General (一般)] タブ

[General (一般)]​ タブを使用して、EDIFACT メッセージの読み取りと書き込みに関する設定を定義します。

項目 説明

Schema definitions (スキーマ定義)

メッセージ構造で使用するスキーマ定義のリストを手動で作成するか、編集します。

Substitution character (置換文字)

文字列データ内の無効な文字を置き換えるために使用します。

Separators usage (区切り文字の使用方法)

指定した値を書き込みまたは読み取りのデフォルトとして使用するかどうか

Data element separator (データ要素区切り文字)

データ要素のデフォルトの区切り文字

Component element separator (コンポーネント要素の区切り文字)

コンポーネント要素のデフォルトの区切り文字

Repetition separator (反復の区切り文字)

反復のデフォルトの区切り文字

Segment terminator (セグメント終端文字)

セグメントのデフォルトの終端文字

Release character (リリース文字)

デフォルトのリリース文字

[Identity (ID)] タブ

[Identity (ID)]​ タブを使用して、EDIFACT EDI Connector 設定内にある自分側と取引パートナー側のインターチェンジヘッダー (UNB) 識別子の値を設定します。設定されている場合、その値は、入力メッセージの読み取り時に検証され、出力メッセージの書き込み時にデフォルトとして使用されます。これは、値出力データが指定されていない場合のみです。

これらの値は、Mule アプリケーションとパートナーに対して設定できます。

  • Interchange ID qualifier (インターチェンジ ID 修飾子)

  • Interchange ID (インターチェンジ ID)

Mule の値は、受信メッセージの受信者項目 (UNB3.1/UNB3.2) を指定し、送信メッセージの送信者項目 (UNB2.1/UNB2.2) に入力されます。

[Parser (パーサー)] タブ

必要に応じて、受信メッセージのパーサー検証を制御する以下の項目を設定します。

項目 説明

Enforce length limits (長さ制限を適用)

受信値の最小長と最大長を適用します。

Enforce value repeats (値の反復を適用)

受信値の反復数制限を適用します。

Enforce valid characters (有効な文字を適用)

UNOA/UNOB 構文レベルの有効な文字を適用します。

Allow unknown segments (不明なセグメントを許可)

メッセージ内の不明なセグメントを許可します。

Enforce segment order (セグメント順序を適用)

メッセージ内のセグメント順序を適用します。

Allow unused segments (未使用のセグメントを許可)

メッセージ内で ​Unused​ としてマークされたセグメントを許可します。

Enforce segment repeats (セグメントの反復を適用)

メッセージ内のセグメントの反復数制限を適用します。

Character encoding override (文字エンコードの上書き)

受信メッセージの文字エンコードを上書きします。

Require unique interchanges (一意のインターチェンジを要求)

一意のインターチェンジ制御参照を要求します (UNB.5)。

Require unique messages (一意のメッセージを要求)

グローバルで一意のメッセージ参照番号を要求します (UNH.1)。

Store time-to-live (保存の存続期間)

一意性を確認するためにインターチェンジおよびメッセージ番号を保存する最小日数を設定します。

[Writer (ライター)] タブ

[Writer (ライター)]​ タブを使用して、メッセージの書き込み設定を指定します。

項目 説明

Write character encoding (書き込み文字エンコード)

メッセージの書き込みで使用する文字エンコードを設定します。文字エンコードは EDIFACT 構文バージョンで定義する必要があります。

Syntax version (構文バージョン)

構文バージョンを設定します (UNB1.2)。

Segment line ending (セグメント行末)

出力を読みやすくするように、セグメント間に書き込まれる行末を有効にします。

Always send UNA (UNA を常に送信)

UNA サービスセグメントを常に送信します。これは、非標準の区切り文字を使用する場合にのみ送信されます。

Enforce valid characters (有効な文字を適用)

UNOA および UNOB 構文レベルの有効な文字を適用します。

Request acknowledgments (肯定応答を要求)

肯定応答要求項目を使用して、送信インターチェンジの肯定応答を要求します (UNB.9)。

Test indicator (テストインジケーター)

送信インターチェンジで使用するテストインジケーター桁を設定します (UNB.11)。

Unique message numbers (一意のメッセージ番号)

制御セグメント情報 (制御番号など) について指定された値を使用するかどうか

Initial message reference (初期メッセージ参照)

出力の MIME タイプのデフォルト ​application/plain​ を使用するか、EDIFACT 固有の代替方法 ​application/edifact​ を使用するか

インターチェンジ制御番号キー

インターチェンジ制御キーとインターチェンジ制御番号のキー-値ペア

メッセージ制御番号キー

メッセージ制御キーとトランザクション制御番号のキー-値ペア

Enforce length limits (長さ制限を適用)

入力データに長さ制限を適用するかどうか

インターチェンジ制御番号キー

インターチェンジ制御キーとインターチェンジ制御番号のキー-値ペア。

メッセージ制御番号キー

メッセージ制御キーとメッセージ制御番号のキー-値ペア。

次のステップ

詳細な設定手順については、​「スキーマの設定」​を参照してください。

関連情報