次の方法で共有


Azure Logic Apps の契約での X12 メッセージの設定に関するリファレンス

適用対象: Azure Logic Apps (従量課金プラン + Standard)

このリファレンスでは、取引先間のメッセージを処理する方法を指定するために X12 契約で設定できるプロパティについて説明します。 メッセージを交換するパートナーとの契約に基づいて、これらのプロパティを設定します。

X12 の受信設定

Azure portal と受信メッセージ用の X12 契約の設定を示すスクリーンショット。

識別子

プロパティ 説明
ISA1 (Authorization Qualifier) (ISA1 (認証修飾子)) 使用する認証修飾子の値。 既定値は、 [00 - No Authorization Information Present](00 - 認証情報が存在しません) です。

:他の値を選択する場合は、ISA2 プロパティの値を指定します。
ISA2 ISA1 プロパティが [00 - No Authorization Information Present](00 - 認証情報が存在しません) でない場合に使用する認証情報の値。 このプロパティ値には、1 文字以上で 10 文字以下の英数字を入力する必要があります。
ISA3 (Security Qualifier) (ISA3 (セキュリティ修飾子)) 使用するセキュリティ修飾子の値。 既定値は、 [00 - No Security Information Present](00 - セキュリティ情報が存在しません) です。

:他の値を選択する場合は、ISA4 プロパティの値を指定します。
ISA4 ISA3 プロパティが [00 - No Security Information Present](00 - セキュリティ情報が存在しません) でない場合に使用するセキュリティ情報の値。 このプロパティ値には、1 文字以上で 10 文字以下の英数字を入力する必要があります。

Acknowledgement (受信確認)

プロパティ 説明
TA1 Expected (TA1 が必要) インターチェンジの送信者に技術確認 (TA1) を返します。
FA Expected (FA が必要) インターチェンジの送信者に機能確認 (FA) を返します。

FA Version (FA バージョン) プロパティについては、スキーマのバージョンに基づいて、997 または 999 の受信確認を選択します。

受理されたトランザクション セットの機能確認で AK2 ループの生成を有効にするには、 [Include AK2 / IK2 Loop](AK2 / IK2 ループを含める) を選択します。

スキーマ

このセクションについては、各トランザクションの種類 (ST01) と送信側アプリケーション (GS02) に対して統合アカウントからスキーマを選択します。 EDI 受信パイプラインは、このセクションで設定された値とスキーマを、受信メッセージの ST01 と GS02 の値および受信メッセージのスキーマと照合することにより、受信メッセージを逆アセンブルします。 行を 1 つ完了するたびに、新しい空の行が自動的に表示されます。

プロパティ 説明
Version スキーマの X12 バージョン
Transaction Type (ST01) (トランザクションの種類 (ST01)) トランザクションの種類
Sender Application (GS02) (送信側アプリケーション (GS02)) 送信側アプリケーション
[スキーマ] 使用するスキーマ ファイル

エンベロープ

プロパティ 説明
ISA11 Usage (ISA11 の使用) トランザクション セットで使用する区切り記号:

- 標準識別子: EDI 受信パイプラインの受信ドキュメントの 10 進数表記ではなく、ピリオド (.) を 10 進数表記に使用します。

- 繰り返し区切り記号: 繰り返し出現する単純なデータ要素または繰り返されるデータ構造体の区切り記号を指定します。 たとえば、繰り返し区切り記号としては通常、キャレット (^) が使用されます。 HIPAA スキーマに対しては、キャレットのみ使用できます。

制御番号

プロパティ 説明
Disallow Interchange control number duplicates (インターチェンジ制御番号の重複を許可しない) 重複したインターチェンジを防止します。 受信したインターチェンジ制御番号に対して、インターチェンジ制御番号 (ISA13) をチェックします。 一致が検出されると、EDI 受信パイプラインはインターチェンジを処理しません。



チェックを実行する日数を指定するには、Check for duplicate ISA13 every (days)(ISA13 の重複の確認間隔 (日単位)) プロパティに値を指定します。
Disallow Group control number duplicates (グループ制御番号の重複を許可しない) 重複するグループ制御番号を持つインターチェンジをブロックします。
Disallow Transaction set control number duplicates (トランザクション セット制御番号の重複を許可しない) 重複するトランザクション セット制御番号を持つインターチェンジをブロックします。

確認

[Default](既定) 行には、EDI メッセージ型に使用される検証ルールが表示されます。 別のルールを定義する場合は、ルールを true に設定する各ボックスを選択します。 行を 1 つ完了するたびに、新しい空の行が自動的に表示されます。

プロパティ 説明
Message Type (メッセージ型) EDI メッセージ型
EDI Validation (EDI 検証) スキーマの EDI プロパティ、長さ制限、空のデータ要素、および末尾の区切り記号で定義されたデータ型で EDI 検証を実行します。
Extended Validation (拡張検証) データ型が EDI でない場合は、検証はデータ要素の要件と許可される繰り返し、列挙、およびデータ要素の長さの検証 (最小または最大) に対して実行されます。
Allow Leading/Trailing Zeroes (先頭および末尾のゼロを許可) 追加の先頭または末尾のゼロと空白文字をすべて保持します。 これらの文字を削除しません。
Trim Leading/Trailing Zeroes (先頭および末尾のゼロをトリミングする) 先頭または末尾のゼロと空白文字をすべて削除します。
末尾の区切り記号のポリシー 末尾の区切り記号を生成します。

- Not Allowed (禁止) : 受信インターチェンジの末尾の区切り記号や区切り文字を禁止します。 インターチェンジに末尾の区切り記号や区切り文字が含まれている場合、インターチェンジは無効と宣言されます。

- Optional (省略可能) : 末尾の区切り記号や区切り文字の有無に関係なくインターチェンジを受け入れます。

- Mandatory (必須) : 受信インターチェンジは、末尾の区切り記号や区切り文字を持っている必要があります。

Internal Settings (内部設定)

プロパティ 説明
Convert implied decimal format Nn to a base 10 numeric value (暗黙的に指定された 10 進形式 Nn を 底 10 の数値に変換する) 形式 "Nn" で指定されている EDI 番号を底 10 の数値に変換します。
Create empty XML tags if trailing separators are allowed (末尾の区切り記号が許可されている場合は空の XML タグを作成する) インターチェンジの送信者に、末尾の区切り記号用の空の XML タグを含めさせます。
Split Interchange as transaction sets - suspend transaction sets on error (インターチェンジをトランザクション セットとして分割 - エラー発生時にトランザクション セットを中断) トランザクション セットに適切なエンベロープを適用することで、インターチェンジ内の各トランザクション セットを個別の XML ドキュメントで解析します。 検証に失敗したトランザクションのみを中断します。
Split Interchange as transaction sets - suspend interchange on error (インターチェンジをトランザクション セットとして分割 - エラー発生時にインターチェンジを中断) 適切なエンベロープを適用することで、インターチェンジ内の各トランザクション セットを個別の XML ドキュメントで解析します。 インターチェンジの 1 つ以上のトランザクション セットが検証に失敗した場合、インターチェンジ全体を中断します。
Preserve Interchange - suspend transaction sets on error (インターチェンジの保存 - エラー発生時にトランザクション セットを中断) インターチェンジはそのままにして、バッチ インターチェンジ全体に対する XML ドキュメントを作成します。 検証に失敗したトランザクション セットだけを中断し、他のすべてのトランザクション セットの処理を継続します。
Preserve Interchange - suspend interchange on error (インターチェンジの保存 - エラー発生時にインターチェンジを中断) インターチェンジはそのままにして、バッチ インターチェンジ全体に対する XML ドキュメントを作成します。 インターチェンジの 1 つ以上のトランザクション セットが検証に失敗した場合、インターチェンジ全体を中断します。

X12 送信設定

Azure portal と送信メッセージ用の X12 契約の設定を示すスクリーンショット。

識別子

プロパティ 説明
ISA1 (Authorization Qualifier) (ISA1 (認証修飾子)) 使用する認証修飾子の値。 既定値は、 [00 - No Authorization Information Present](00 - 認証情報が存在しません) です。

:他の値を選択する場合は、ISA2 プロパティの値を指定します。
ISA2 ISA1 プロパティが [00 - No Authorization Information Present](00 - 認証情報が存在しません) でない場合に使用する認証情報の値。 このプロパティ値には、1 文字以上で 10 文字以下の英数字を入力する必要があります。
ISA3 (Security Qualifier) (ISA3 (セキュリティ修飾子)) 使用するセキュリティ修飾子の値。 既定値は、 [00 - No Security Information Present](00 - セキュリティ情報が存在しません) です。

:他の値を選択する場合は、ISA4 プロパティの値を指定します。
ISA4 ISA3 プロパティが [00 - No Security Information Present](00 - セキュリティ情報が存在しません) でない場合に使用するセキュリティ情報の値。 このプロパティ値には、1 文字以上で 10 文字以下の英数字を入力する必要があります。

Acknowledgement (受信確認)

プロパティ 説明
TA1 Expected (TA1 が必要) インターチェンジの送信者に技術確認 (TA1) を返します。

この設定は、メッセージを送信しているホスト パートナーが、契約でゲスト パートナーからの受信確認を要求することを指定します。 ホスト パートナーは、契約の [受信設定] に基づいてこれらの受信確認を想定しています。
FA Expected (FA が必要) インターチェンジの送信者に機能確認 (FA) を返します。 FA Version (FA バージョン) プロパティについては、スキーマのバージョンに基づいて、997 または 999 の受信確認を選択します。

この設定は、メッセージを送信しているホスト パートナーが、契約でゲスト パートナーからの受信確認を要求することを指定します。 ホスト パートナーは、契約の [受信設定] に基づいてこれらの受信確認を想定しています。

スキーマ

このセクションについては、各トランザクションの種類 (ST01) に対して統合アカウントからスキーマを選択します。 行を 1 つ完了するたびに、新しい空の行が自動的に表示されます。

プロパティ 説明
Version スキーマの X12 バージョン
Transaction Type (ST01) (トランザクションの種類 (ST01)) スキーマのトランザクションの種類
[スキーマ] 使用するスキーマ ファイル。 最初にスキーマを選択すると、バージョンとトランザクションの種類が自動的に設定されます。

エンベロープ

プロパティ 説明
ISA11 Usage (ISA11 の使用) トランザクション セットで使用する区切り記号:

- Standard Identifier (標準識別子) : EDI 送信パイプラインの送信ドキュメントの 10 進数表記ではなく、ピリオド (.) を 10 進数表記に使用します。

- Repetition Separator (繰り返し区切り記号) : 繰り返し出現する単純なデータ要素または繰り返されるデータ構造体の区切り記号を指定します。 たとえば、繰り返し区切り記号としては通常、キャレット (^) が使用されます。 HIPAA スキーマに対しては、キャレットのみ使用できます。

制御バージョン番号

このセクションについては、各インターチェンジに対して統合アカウントからスキーマを選択します。 行を 1 つ完了するたびに、新しい空の行が自動的に表示されます。

プロパティ 説明
Control Version Number (ISA12) (制御バージョン番号 (ISA12)) X12 標準のバージョン
Usage Indicator (ISA15) (使用状況インジケーター (ISA15)) インターチェンジのコンテキスト。 [Test](テスト) データ、 [Information](情報) データ、または [Production](運用) データのいずれか
[スキーマ] EDI 送信パイプラインに送信される X12 エンコード インターチェンジの GS および ST セグメントの生成に使用するスキーマ。
GS1 省略可能。機能コードを選択します。
GS2 省略可能。アプリケーション送信者を指定します。
GS3 省略可能。アプリケーション受信者を指定します。
GS4 省略可能。 [CCYYMMDD] または [YYMMDD] を選択します。
GS5 省略可能。 [HHMM][HHMMSS] 、または [HHMMSSdd] を選択します。
GS7 省略可能。担当機関の値を選択します。
GS8 省略可能。スキーマ ドキュメントのバージョンを指定します。

制御番号

プロパティ 説明
Interchange Control Number (ISA13) (インターチェンジ制御番号 (ISA13)) インターチェンジ制御番号の値の範囲。最小値は 1、最大値は 999999999 です
Group Control Number (GS06) (グループ制御番号 (GS06)) グループ制御番号の値の範囲。最小値は 1、最大値は 999999999 です
Transaction Set Control Number (ST02) (トランザクション セット制御番号 (ST02)) トランザクション セット制御番号の値の範囲。最小値は 1、最大値は 999999999

- プレフィックス: 省略可能、英数字の値
- Suffix (サフィックス) : 省略可能。英数字の値

文字セットと区切り記号

[Default](既定) 行には、メッセージ スキーマの区切り記号として使用される文字セットが表示されます。 既定の文字セットを使用しない場合は、メッセージ型ごとに異なる区切り記号セットを入力できます。 行を 1 つ完了するたびに、新しい空の行が自動的に表示されます。

ヒント

特殊文字の値を指定するには、契約を JSON として編集し、特殊文字の ASCII 値を指定します。

プロパティ 説明
Character Set to be used (使用する文字セット) X12 文字セット。 [Basic](基本)\[Extended](拡張) 、または [UTF8] のいずれか。
[スキーマ] 使用するスキーマ。 スキーマを選択した後、次の区切り記号の説明に基づいて、使用する文字セットを選択します。
[Input Type](入力の種類) 文字セットの入力の種類
Component Separator (コンポーネントの区切り記号) 複合データ要素を区切る 1 文字
Data Element Separator (データ要素区切り記号) 複合データ内の単純データ要素を区切る 1 文字
replacement Character Separator (置換文字の区切り記号) X12 送信メッセージを生成するときにペイロード データ内のすべての区切り文字を置換する置換文字
Segment Terminator (セグメント終端記号) EDI セグメントの終端を示す 1 文字
サフィックス セグメント識別子と共に使用する文字。 サフィックスを指定する場合、セグメント終端記号のデータ要素は空にできます。 セグメント終端記号を空のままにする場合は、サフィックスを指定する必要があります。

検証

[Default](既定) 行には、EDI メッセージ型に使用される検証ルールが表示されます。 別のルールを定義する場合は、ルールを true に設定する各ボックスを選択します。 行を 1 つ完了するたびに、新しい空の行が自動的に表示されます。

プロパティ 説明
Message Type (メッセージ型) EDI メッセージ型
EDI Validation (EDI 検証) スキーマの EDI プロパティ、長さ制限、空のデータ要素、および末尾の区切り記号で定義されたデータ型で EDI 検証を実行します。
Extended Validation (拡張検証) データ型が EDI でない場合は、検証はデータ要素の要件と許可される繰り返し、列挙、およびデータ要素の長さの検証 (最小または最大) に対して実行されます。
Allow Leading/Trailing Zeroes (先頭および末尾のゼロを許可) 追加の先頭または末尾のゼロと空白文字をすべて保持します。 これらの文字を削除しません。
Trim Leading/Trailing Zeroes (先頭および末尾のゼロをトリミングする) 先頭または末尾のゼロと空白文字をすべて削除します。
末尾の区切り記号のポリシー 末尾の区切り記号を生成します。

- Not Allowed (禁止) : 送信インターチェンジの末尾の区切り記号や区切り文字を禁止します。 インターチェンジに末尾の区切り記号や区切り文字が含まれている場合、インターチェンジは無効と宣言されます。

- Optional (省略可能) : 末尾の区切り記号や区切り文字の有無に関係なくインターチェンジを送信します。

- Mandatory (必須) : 送信インターチェンジは、末尾の区切り記号や区切り文字を持っている必要があります。

HIPAA スキーマとメッセージ型

HIPAA スキーマと 277 または 837 のメッセージ型を操作する場合は、いくつかの追加手順を実行する必要があります。 これらのメッセージ型のドキュメント バージョン番号 (GS8) には、9 文字を超える文字 (たとえば、"005010X222A1") が含まれます。 また、一部のドキュメント バージョン番号は、バリアント メッセージ型にマップされます。 スキーマおよび契約で正しいメッセージ型を参照していない場合は、次のエラー メッセージが表示されます。

"The message has an unknown document type and did not resolve to any of the existing schemas configured in the agreement."

次の表に、影響を受けるメッセージ型、バリアント、およびそれらのメッセージ型にマップされるドキュメント バージョン番号を示します。

メッセージ型またはバリアント 説明 ドキュメント バージョン番号 (GS8)
277 医療保険情報の状態通知 005010X212
837_I 健康保険請求: 機関 004010X096A1
005010X223A1
005010X223A2
837_D 医療保険請求: 歯科 004010X097A1
005010X224A1
005010X224A2
837_P 健康保険請求: 専門家 004010X098A1
005010X222
005010X222A1

また、これらのドキュメント バージョン番号を使用するときは、文字の長さが無効であるというエラーが発生するため、EDI の検証を無効にする必要があります。

これらのドキュメント バージョン番号とメッセージ型を指定するには、次の手順を実行します。

Note

837_P、837_I、または837_Dの各メッセージには、個別の契約が必要です。

  1. HIPAA スキーマで、使用するドキュメント バージョン番号に対して、現在のメッセージ型をバリアント メッセージ型に置き換えます。

    たとえば、ドキュメント バージョン番号 005010X222A1837 メッセージ型で使用するとします。 スキーマでは、それぞれの "X12_00501_837" 値を、代わりに "X12_00501_837_P" 値に置き換えます。

    スキーマを更新するには、次の手順を実行します。

    1. Azure portal で統合アカウントに移動します。 スキーマを検索してダウンロードします。 メッセージ型を置き換えて、スキーマ ファイルの名前を変更し、変更したスキーマを統合アカウントにアップロードします。 詳細については、「スキーマを編集する」を参照してください。

    2. 契約のメッセージ設定で、変更後のスキーマを選択します。

  2. 契約の schemaReferences オブジェクトで、ドキュメント バージョン番号と一致するバリアント メッセージ型を指定する別のエントリを追加します。

    たとえば、ドキュメント バージョン番号 005010X222A1837 メッセージ型で使用するとします。 契約には、次のプロパティと値を含む schemaReferences セクションがあります。

    "schemaReferences": [
       {
          "messageId": "837",
          "schemaVersion": "00501",
          "schemaName": "X12_00501_837"
       }
    ]
    

    schemaReferences セクションを次の例のように編集します。

    "schemaReferences": [
       {
          "messageId": "837",
          "schemaVersion": "00501",
          "schemaName": "X12_00501_837_P"
       }
    ]
    
  3. 契約のメッセージ設定で、それぞれのメッセージ型、または既定の値を使用している場合はすべてのメッセージ型に対して [EDI 検証] チェックボックスをオフにして、EDI 検証を無効にします。

    スクリーンショットは、すべてのメッセージ型または各メッセージ型の検証を無効にする X12 契約の設定を示しています。

次のステップ

X12 メッセージの交換