> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arc.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HL7 MLLP Connector

> Configuration and usage guide for the CData Arc HL7 MLLP connector.

export const NameDescription = ({extraRows}) => <table>
    <thead>
      <tr>
        <th>設定</th>
        <th>説明</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><strong>Connector Id</strong></td>
        <td>コネクタの静的で一意の識別子です。</td>
      </tr>
      <tr>
        <td><strong>Connector Type</strong></td>
        <td>コネクタ名とその機能の説明を表示します。</td>
      </tr>
      <tr>
        <td><strong>Connector Description</strong></td>
        <td>コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。</td>
      </tr>
      {extraRows}
    </tbody>
  </table>;

export const ServerStatus = () => <>
    <p><em>コネクタの基盤サービスの現在の状態。以下のステータスが使用可能です：</em></p>
    <table>
      <thead>
        <tr>
          <th>ステータス</th>
          <th>説明</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>アクティブ</strong></td>
          <td>サービスが実行中です。</td>
        </tr>
        <tr>
          <td><strong>非アクティブ</strong></td>
          <td>サービスは設定済みですが、現在は実行されていません。</td>
        </tr>
        <tr>
          <td><strong>未設定</strong></td>
          <td>基盤となるプロファイルまたはサービスが設定されていません。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const SampleFilesTab = () => <>
    <p><em>サンプルファイルをアップロードすると、接続されているCSV Map またはXML Map コネクタでのマッピングが容易になります。</em></p>

    <p><strong>Sample Files</strong> タブを使用して、<a href="/26.3/cloud/ja/connectors/map">CSV Map</a> または<a href="/26.3/cloud/ja/connectors/xml-map/xml-map">XML Map</a> コネクタで使用するソースまたは宛先のXML テンプレートを生成します。<strong>Add Sample File</strong> をクリックします。</p>

    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>1. データの想定される形式と構造を反映したサンプルファイルが既にある場合は、<strong>File Upload</strong> を選択してファイルを参照します。あるいは、<strong>Manually Create</strong> を選択して、アプリケーション内で直接ファイルを作成します。<strong>Manually Create</strong> を選択した場合は、サンプルファイルに名前を付けます。<strong>Next</strong> をクリックします。</p>
    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>2. 既存のファイルを参照した場合、<strong>View File</strong> タブにその内容が表示されます。手動でファイルを作成することを選択した場合は、このタブにサンプルデータを入力します。<strong>Next</strong> をクリックします。</p>
    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>3. <strong>Translate and Preview</strong> タブには、XML に変換されたサンプルデータのプレビューが表示されます。サンプルに問題がなければ、<strong>Add</strong> をクリックします。</p>
  </>;

export const EdiUploadTestFile = ({fileFormat = "EDI", documentType}) => {
  const docLabel = documentType || fileFormat;
  return <>
      <p>入力ファイルのXML 表現を生成するには、次の手順を実行します。</p>
      <p style={{
    paddingLeft: '1.5rem',
    marginTop: '0.25rem',
    marginBottom: '0.25rem'
  }}>1. コネクタの<strong>Transactions</strong> タブで、<strong>More</strong> ドロップダウンをクリックし、<strong>Upload Test File</strong> をクリックします。</p>
      <p style={{
    paddingLeft: '1.5rem',
    marginTop: '0.25rem',
    marginBottom: '0.25rem'
  }}>2. XML としてモデル化したいディスク上のファイルに移動し、それを選択して<strong>OK</strong> をクリックします。</p>
      <p style={{
    paddingLeft: '1.5rem',
    marginTop: '0.25rem',
    marginBottom: '0.25rem'
  }}>3. フロー内で{fileFormat} コネクタをXML Map コネクタに接続します。この接続はいずれの方向でも可能です。XML Map コネクタへのインバウンド、またはXML Map コネクタからのアウトバウンドのいずれかです。</p>
      <p>XML Map コネクタは、テストファイルの構造を自動的に検出します。{fileFormat} コネクタを配置した場所に応じて、ファイルはXML Map コネクタの<strong>Source File</strong> または<strong>Destination File</strong> ドロップダウンメニューに表示されます。</p>
      <Note>XML Map コネクタにはソーステンプレートとデスティネーションテンプレートの両方が必要なため、残りのテンプレートは、データの元となる構造、または変換先となる構造に基づいて設定する必要があります。例えば、{docLabel} ドキュメントのデータをデータベースに挿入する必要がある場合、XML Map コネクタのもう一方のテンプレートはデータベース挿入のXML モデルになります。2 つのテンプレートファイル間のマッピングの作成について詳しくは、XML Map コネクタの<a href="/26.3/cloud/ja/connectors/xml-map/xml-map-designer">マッピングエディタの使用</a>を参照してください。</Note>
    </>;
};

export const EdiXmlMapIntro = ({fileFormat = "EDI"}) => <p>Arc の規約に従い、{fileFormat} コネクタは2 つのうちいずれかの動作を行います。XML 入力を受け取るか、XML 出力を生成するかのいずれかです。入力ファイルと出力ファイルが正しいXML 構造を持つようにするため、CData は、送信{fileFormat} ドキュメントを生成する際にはフロー内の前のステップとして、また受信{fileFormat} ドキュメントを受け取る際にはフロー内の次のステップとして、<a href="/26.3/cloud/ja/connectors/xml-map/xml-map">XML Map コネクタ</a>を使用することを強く推奨します。XML Map コネクタと{fileFormat} コネクタ間のやり取りは、以下で説明する<strong>Upload Test File</strong> 機能によって簡単になります。</p>;

export const CommonProxySettings = () => <>
    <p>これらは、接続のルーティング先となるプロキシを識別し認証するための一連の設定です。デフォルトでは、このセクションは<a href="/26.3/cloud/ja/getting-started/administration/settings/security">Security Settings</a> ページの<a href="/26.3/cloud/ja/getting-started/administration/settings/proxy-settings">Proxy Settings</a> 部分にあるグローバル設定を使用します。チェックボックスをオフにすると、コネクタ固有の設定を指定できます。</p>
    <table>
      <thead>
        <tr><th>設定</th><th>説明</th></tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>Proxy Type</strong></td>
          <td>プロキシベースのファイアウォールで使用されるプロトコル。</td>
        </tr>
        <tr>
          <td><strong>Proxy Host</strong></td>
          <td>プロキシベースのファイアウォールの名前またはIP アドレス。</td>
        </tr>
        <tr>
          <td><strong>Proxy Port</strong></td>
          <td>プロキシベースのファイアウォールのTCP ポート。</td>
        </tr>
        <tr>
          <td><strong>Proxy User</strong></td>
          <td>プロキシベースのファイアウォールで認証するために使用するユーザー名。</td>
        </tr>
        <tr>
          <td><strong>Proxy Password</strong></td>
          <td>プロキシベースのファイアウォールで認証するために使用するパスワード。</td>
        </tr>
        <tr>
          <td><strong>Authentication Scheme</strong></td>
          <td>デフォルトの<strong>None</strong> のままにするか、次の認証スキームのいずれかを選択します：<strong>Basic</strong>、<strong>Digest</strong>、<strong>Proprietary</strong>、または<strong>NTLM</strong>。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const SlasTab = ({siteName = "CData Arc"}) => <>
    <p><em>サービスレベルアグリーメント（SLA）の設定に関する設定です。</em></p>
    <p>
      SLA を使用すると、フロー内のコネクタが送受信すると見込まれるボリュームを設定し、そのボリュームを達成すると見込まれる期間を設定できます。{siteName} は、SLA が達成されない場合にユーザーへ警告するメールを送信し、SLA を<em>At Risk</em> としてマークします。これは、SLA が間もなく達成されない場合に<em>Violated</em> としてマークされることを意味します。これにより、ユーザーは介入してSLA が達成されない理由を特定し、適切な対応を取る機会を得られます。At Risk 期間の終了時点でもSLA が達成されない場合、SLA はviolated としてマークされ、ユーザーに再度通知されます。
    </p>
    <p>
      SLA を定義するには、<strong>Expected Volume</strong> をオンに切り替え、<strong>Settings</strong> タブをクリックします。
    </p>
    <img src="/public/images/sla_empty.png" alt="SLA Empty" />
    <ul>
      <li>コネクタに送信と受信の個別のアクションがある場合は、ラジオボタンを使用してSLA がどちらの方向に適用されるかを指定します。</li>
      <li>ウィンドウの<strong>Expect at least</strong> 部分で、次を設定します。
        <ul>
          <li>処理を見込む最小トランザクション数（ボリューム）を設定します。</li>
          <li><strong>Every</strong> フィールドを使用して期間を指定します。</li>
          <li>SLA を有効にするタイミングを指定します。<strong>Starting on</strong> を選択した場合は、日付および時刻フィールドを入力します。</li>
          <li>SLA を有効にしたい曜日のチェックボックスをオンにします。必要に応じて、ドロップダウンで<strong>Everyday</strong> を選択します。</li>
        </ul>
      </li>
      <li>ウィンドウの<strong>Set status to 'At Risk'</strong> 部分で、SLA をAt Risk としてマークするタイミングを指定します。
        <ul>
          <li>デフォルトでは、SLA が違反状態になるまで通知は送信されません。これを変更するには、<strong>Send an 'At Risk' notification</strong> をオンにします。</li>
        </ul>
      </li>
    </ul>
    <p>
      次の例は、月曜日から金曜日まで毎日1000 件のファイルを受信すると見込むコネクタ向けに設定されたSLA を示しています。1000 件のファイルが受信されていない場合、期間の終了の1時間前にAt Risk 通知が送信されます。
    </p>
    <img src="/public/images/sla_defined.png" alt="SLA Configuration Example" />
    <Note>
      必要に応じてSLA アラートをオフにすることができます。これはメンテナンスウィンドウ中に役立ちます。navbar で<strong>Settings</strong> をクリックし、<strong>Alerts &gt; General Alerts</strong> に移動します。タブレットと鉛筆のアイコンをクリックして編集し、<strong>SLA Alerts</strong> 設定のチェックを外します。
    </Note>
  </>;

export const AlertsTab = ({siteNameShort = "Arc"}) => <>
    <p><em>アラートの設定に関する設定です。</em></p>
    <p>
      サービスレベルアグリーメント（SLA）を実行する前に、通知用のメールアラートをセットアップする必要があります。デフォルトでは、{siteNameShort} は<a href="/26.3/cloud/ja/getting-started/administration/settings/alerts">Alerts</a> タブのグローバル設定を使用します。このコネクタに別の設定を使用するには、<strong>Override global setting</strong> をオンに切り替えます。
    </p>
    <p>
      デフォルトではエラーアラートが有効になっており、エラーが発生するたびにメールが送信されます。これをオフにするには、<strong>Enable</strong> チェックボックスのチェックを外します。
    </p>
    <p>
      <strong>Subject</strong>（必須）を入力します。<strong>Allow {siteNameShort}Script in Subject</strong> をチェックすると、<strong>Subject</strong> フィールドで{siteNameShort}Script を使用できます。これを選択すると、<strong>{siteNameShort}Script エディタ</strong>ボタンが表示されます（<img src="/public/images/rest_arcscript_editor.png" alt="arcscript editor button" style={{
  display: 'inline',
  verticalAlign: 'middle',
  margin: 0
}} />）。
    </p>
    <p>
      必要に応じて<strong>Recipient</strong> のメールアドレスをカンマ区切りのリストで入力します。
    </p>
  </>;

export const MiscConnector = () => <>
    <p><em>Miscellaneous 設定は、特定のユースケース向けの設定です。</em></p>
    <table>
      <thead>
        <tr>
          <th>設定</th>
          <th>説明</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>Other Settings</strong></td>
          <td>非表示のコネクタ設定をセミコロン区切りのリストで設定できます（例：<code>setting1=value1;setting2=value2</code>）。通常のコネクタのユースケースや機能では、これらの設定の使用は必要ありません。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const Logging = () => <>
    <p><em>ログの作成と保存を制御する設定です。</em></p>
    <table>
      <thead>
        <tr>
          <th>設定</th>
          <th>説明</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>Log Level</strong></td>
          <td>コネクタが生成するログの詳細度です。サポートを依頼する際は、これを<strong>Debug</strong> に設定してください。</td>
        </tr>
        <tr>
          <td><strong>Log Subfolder Scheme</strong></td>
          <td>選択した間隔に従って、コネクタがLogs フォルダ内のファイルをグループ化するよう指示します。<strong>Weekly</strong> オプション（デフォルト）は、コネクタが毎週新しいサブフォルダを作成し、その週のすべてのログをそのフォルダに保存するよう指示します。この設定を空白のままにすると、コネクタはすべてのログをLogs フォルダに直接保存します。多数のトランザクションを処理するコネクタでは、サブフォルダを使用することでログを整理しやすくなり、パフォーマンスが向上します。</td>
        </tr>
        <tr>
          <td><strong>Log Messages</strong></td>
          <td>処理したファイルのログエントリにファイル自体のコピーを含めるには、これをオンにします。これを無効にすると、<strong>Transactions</strong> タブからファイルのコピーをダウンロードできなくなる場合があります。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const ProfileLogging = () => <>
    <p><em>ログの作成と保存を制御する設定です。</em></p>
    <table>
      <thead>
        <tr>
          <th>設定</th>
          <th>説明</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>Log Level</strong></td>
          <td>コネクタが生成するログの詳細度です。サポートを依頼する際は、これを<strong>Debug</strong> に設定してください。</td>
        </tr>
        <tr>
          <td><strong>Log Rotate Interval</strong></td>
          <td>新しいログファイルを作成するまでに待機する日数です。</td>
        </tr>
        <tr>
          <td><strong>Log Delete Interval</strong></td>
          <td>古いログファイルを削除するまでに待機する日数です。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const MacrosExamples = ({extraMacros = []}) => <>
    <p>
      %Ext% や %ShortDate% などの一部のマクロは引数を必要としませんが、引数を必要とするものもあります。
      引数を取るすべてのマクロは次の構文を使用します。<code>%Macro:argument%</code>
    </p>

    <p>引数を取るマクロの例を次に示します。</p>

    <ul>
      <li>%Header:headername%：<code>headername</code> はメッセージ上のヘッダーの名前です。</li>
      <li>%Header:mycustomheader% は、入力メッセージに設定された<code>mycustomheader</code> ヘッダーの値に解決されます。</li>
      <li>%Header:ponum% は、入力メッセージに設定された<code>ponum</code> ヘッダーの値に解決されます。</li>
      <li>%RegexFilename:pattern%：<code>pattern</code> は正規表現パターンです。例えば、<code>%RegexFilename:^([\w][A-Za-z]+)%</code> は、ファイル名の最初の単語にマッチしてそれに解決され、大文字・小文字を区別しません（<code>test_file.xml</code> は<code>test</code> に解決されます）。</li>
      <li>%Vault:vaultitem%：<code>vaultitem</code> は<a href="/26.3/cloud/ja/getting-started/administration/settings/global-settings-vault">Vault</a> 内のアイテムの名前です。例えば、<code>%Vault:companyname%</code> は、Vault に保存された<code>companyname</code> アイテムの値に解決されます。</li>
      <li>%DateFormat:format%：<code>format</code> は許容される日付形式です（詳細は<a href="/26.3/cloud/ja/scripting/value-formatters/date-formatters#sample-date-formats">日付形式のサンプル</a>を参照してください）。例えば、<code>%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%</code> は、ファイルの日付とタイムスタンプに解決されます。</li>
      {extraMacros.filter(item => item.example).map(item => <li key={`ex-${item.name}`}>{item.example}</li>)}
    </ul>

    <p>次の例に示すように、より高度なマクロを作成することもできます。</p>

    <ul>
      <li>1 つのファイル名で複数のマクロを組み合わせる：<code>%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%</code></li>
      <li>マクロの外側にテキストを含める：<code>MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%</code></li>
      <li>マクロの内側にテキストを含める：<code>%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%</code></li>
    </ul>
  </>;

export const MacrosTable = ({siteName = "CData Arc", extraMacros = []}) => <>
    <p>
      ファイル命名戦略でマクロを使用すると、データの整理効率と文脈の理解を高めることができます。
      ファイル名にマクロを組み込むことで、識別子、タイムスタンプ、ヘッダー情報などの関連情報を
      動的に含めることができ、各ファイルに有用な文脈を提供します。
    </p>

    <p>{siteName} は次のマクロをサポートしています。これらはすべて次の構文を使用します。<code>%Macro%</code></p>

    <table>
      <thead>
        <tr><th>マクロ</th><th>説明</th></tr>
      </thead>
      <tbody>
        <tr><td>ConnectorID</td><td>コネクタのConnectorID に評価されます。</td></tr>
        <tr><td>ConnectorName</td><td>コネクタの名前に評価されます。ファイル名やパスに接続名を含めることができます。例えば、どのデータベース接続が生成したかによってバックアップファイルにタグを付けるために使用できます。</td></tr>
        <tr><td>Ext</td><td>コネクタが現在処理しているファイルの拡張子に評価されます。</td></tr>
        <tr><td>Filename</td><td>コネクタが現在処理しているファイルのファイル名（拡張子を含む）に評価されます。</td></tr>
        <tr><td>FilenameNoExt</td><td>コネクタが現在処理しているファイルのファイル名（拡張子を除く）に評価されます。</td></tr>
        <tr><td>MessageId</td><td>コネクタが出力しているメッセージのMessageId に評価されます。</td></tr>
        <tr><td>RegexFilename:<em>pattern</em></td><td>コネクタが現在処理しているファイルのファイル名に正規表現パターンを適用します。</td></tr>
        <tr><td>Header:<em>headername</em></td><td>コネクタが現在処理しているメッセージ上の対象ヘッダー（<code>headername</code>）の値に評価されます。</td></tr>
        <tr><td>LongDate</td><td>システムの現在の日時を長い形式（例：Wednesday, January 24, 2024）で評価します。</td></tr>
        <tr><td>ShortDate</td><td>システムの現在の日時をyyyy-MM-dd 形式（例：2024-01-24）で評価します。</td></tr>
        <tr><td>DateFormat:<em>format</em></td><td>システムの現在の日時を指定された形式（<code>format</code>）で評価します。利用可能な日時形式については、<a href="/26.3/cloud/ja/scripting/value-formatters/date-formatters#date-formats-with-literal-characters">日付形式のサンプル</a>を参照してください。</td></tr>
        <tr><td>Vault:<em>vaultitem</em></td><td>指定されたVault アイテムの値に評価されます。</td></tr>
        {extraMacros.map(item => <tr key={item.name}>
            <td>{item.name}</td>
            <td>{item.description}</td>
          </tr>)}
      </tbody>
    </table>
  </>;

export const Performance = () => <>
    <p><em>コネクタへのリソースの割り当てに関する設定です。</em></p>
    <table>
      <thead>
        <tr>
          <th>設定</th>
          <th>説明</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>Max Workers</strong></td>
          <td>このコネクタでファイルを処理するためにスレッドプールから消費されるワーカースレッドの最大数です。設定すると、<a href="/26.3/cloud/ja/getting-started/administration/settings/advanced-settings">Advanced Settings</a> ページの<a href="/26.3/cloud/ja/getting-started/administration/settings/performance-settings">Performance Settings</a> 部分にあるデフォルト設定が上書きされます。</td>
        </tr>
        <tr>
          <td><strong>Max Files</strong></td>
          <td>コネクタに割り当てられた各スレッドが送信するファイルの最大数です。設定すると、<a href="/26.3/cloud/ja/getting-started/administration/settings/advanced-settings">Advanced Settings</a> ページの<a href="/26.3/cloud/ja/getting-started/administration/settings/performance-settings">Performance Settings</a> 部分にあるデフォルト設定が上書きされます。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const companyName = "CData";

export const siteNameShort = "Arc";

export const siteName = "CData Arc";

export const fileFormat = "HL7 MLLP";
export const documentType = "HL7";

Health Level-7 is a set of standards for the transfer of clinical data used by hospitals and other healthcare providers. HL7 MLLP connectors support generating and parsing HL7 documents in conjunction with MLLP as the transport protocol.

## Key Capabilities

* Healthcare data exchange using HL7 over MLLP (Minimal Lower Layer Protocol) transport
* Embedded MLLP server functionality with SSL/TLS encryption support
* Bidirectional HL7 document translation between HL7 and XML formats
* MSH header validation with configurable application and facility identifiers
* Automatic acknowledgment handling with retry and resend capabilities for reliable delivery

## Overview

HL7 MLLP connectors provide two sets of functionality:

* File transfer over the MLLP transport protocol
* EDI document parsing and generation according to the HL7 EDI standard

An HL7 MLLP connection is configured in two places. Configure the HL7 MLLP [Profiles](../getting-started/administration/profiles) page with the settings that identify {siteNameShort} as an HL7 and MLLP entity. Then configure individual HL7 MLLP connectors with the HL7 and MLLP details for each trading partner.

When an HL7 MLLP connector receives an inbound message from a trading partner, it verifies the HL7 identification details to confirm that the document was sent from and to the expected parties. Then it translates the document into XML for further processing in a {siteNameShort} flow.

When an HL7 MLLP connector sends files to a trading partner:

* XML files are translated to HL7 before being sent
* HL7 documents are sent as-is

{companyName} strongly recommends that you use the HL7 MLLP connector in conjunction with the [XML Map connector](./xml-map/xml-map) to ensure that input and output XML is formatted correctly. See [Use with the XML Map Connector](#use-with-the-xml-map-connector) for more information.

## Profile Configuration

The HL7 MLLP Profile must be configured before connections can be established with individual HL7 MLLP connectors. Click **Profiles** on the navbar, then click the **HL7 MLLP** tab.

### HL7 MLLP Profile Tab

#### Server Configuration

*Settings for hosting a local MLLP server.*

| Setting                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Port**                   | The port on which to listen for incoming MLLP connections.                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Use SSL/TLS**            | Whether to require incoming connections to use SSL/TLS encryption for transport security.                                                                                                                                                                                                                                                                                                                                                                       |
| **TLS Server Certificate** | The public key certificate used to verify the identity of a TLS/SSL server. If the target server uses TLS/SSL, set this field to the certificate that identifies the server. If the server's certificate is not available, you can leave this setting blank to allow the underlying OS/JVM to perform certificate validation, or set it to `Any Certificate` to implicitly trust the server's identity. (This field only appears if you check **Use SSL/TLS**.) |

#### HL7 Personal Ids

| Setting                                    | Description                                                                           |
| ------------------------------------------ | ------------------------------------------------------------------------------------- |
| **Application Namespace Id (MSH3.1)**      | The application Id that identifies the local namespace for the HL7 protocol exchange. |
| **Application Universal Id (MSH3.2)**      | The local application universal Id for the HL7 protocol exchange.                     |
| **Application Universal Id Type (MSH3.3)** | A type qualifier to provide context to the local application universal Id.            |
| **Facility Namespace Id (MSH4.1)**         | The facility Id that identifies the local namespace for the HL7 protocol exchange.    |
| **Facility Universal Id (MSH4.2)**         | The local facility universal Id for the HL7 protocol exchange.                        |
| **Facility Universal Id Type (MSH4.3)**    | A type qualifier to provide context to the local facility universal Id.               |

#### Other Settings

*Settings that rarely need to be modified.*

| Setting                | Description                                                                                                            |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Inactivity Timeout** | The amount of time (in seconds) that the server allows clients to remain inactive before the connection is terminated. |

#### Logging

<ProfileLogging />

#### Miscellaneous

<MiscConnector />

## Connector Configuration

Once you configure the global HL7 MLLP profile settings, create and configure individual HL7 MLLP connectors for each trading partner on the Flows page.

### Settings Tab

#### Configuration

<NameDescription />

#### Connector Settings

##### サーバーステータス

<ServerStatus />

HL7 MLLP プロファイルを作成済みかどうかに応じて、**HL7 MLLP プロファイルを設定**または**HL7 MLLP プロファイルを表示**リンクをクリックして新しいタブでプロファイルを開きます。

*Settings related to the core operation of the connector.*

| Setting                | Description                                                                                                    |
| ---------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Remote Host**        | The hostname or IP address of your remote host.                                                                |
| **Port**               | The port on which to listen for incoming MLLP connections.                                                     |
| **Version**            | The version of MLLP being used.                                                                                |
| **Connection Timeout** | The length of time (in seconds) the connector waits for a connection response before throwing a timeout error. |
| **Use SSL/TLS**        | Whether to require incoming connections to use SSL/TLS encryption for transport security.                      |

#### HL7 Configuration

*Settings related to the message headers. When converting HL7 documents into XML, the document headers are validated against these settings; when generating HL7 documents from XML, these settings are used to generate document headers.*

| Setting                                    | Description                                                                                                    |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
| **Application Namespace Id (MSH5.1)**      | In conjunction with the other 5.X elements, identifies the application on the remote side of the HL7 exchange. |
| **Application Universal Id (MSH5.2)**      | In conjunction with the other 5.X elements, identifies the application on the remote side of the HL7 exchange. |
| **Application Universal Id Type (MSH5.3)** | In conjunction with the other 5.X elements, identifies the application on the remote side of the HL7 exchange. |
| **Facility Namespace Id (MSH6.1)**         | In conjunction with the other 6.X elements, identifies the facility on the remote side of the HL7 exchange.    |
| **Facility Universal Id (MSH6.2)**         | In conjunction with the other 6.X elements, identifies the facility on the remote side of the HL7 exchange.    |
| **Facility Universal Id Type (MSH6.3)**    | In conjunction with the other 6.X elements, identifies the facility on the remote side of the HL7 exchange.    |

#### Acknowledgments

*Settings related to generating and requesting acknowledgments.*

| Setting                 | Description                                                       |
| ----------------------- | ----------------------------------------------------------------- |
| **Acknowledgment Type** | Whether or not acknowledgments should be generated and requested. |

### Sample Files Tab

<SampleFilesTab />

### Advanced Tab

#### EDI Delimiters

*Settings that specify which characters separate elements, segments, and so on.*

| Setting                         | Description                                                                                                                                                                                                     |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Data Element Separator**      | The character that separates individual data elements in the document.                                                                                                                                          |
| **Component Element Separator** | The character that separates elements within a composite data structure in the document.                                                                                                                        |
| **Segment Terminator**          | The character that indicates the end of a segment in the document.                                                                                                                                              |
| **Release Char**                | The character that *releases* (escapes) the next character, overriding its usual meaning. This allows reserved characters to appear as data within documents, as long as they are preceded by the Release Char. |
| **Repetition Char**             | The character that indicates repetition of element values.                                                                                                                                                      |
| **Suffix**                      | Appended to the **Segment Terminator** to distinguish segments.                                                                                                                                                 |

#### Proxy Settings

<CommonProxySettings />

#### Advanced Settings

*Settings not included in the previous categories.*

| Setting                      | Description                                                                                                                                                                                                                                                                                                                                                                                |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Generate Description As**  | When translating HL7 into XML, descriptions of the HL7 segments and elements can be provided as context for the HL7 data. Use this dropdown to choose whether to add this context as an XML comment or as XML attributes.                                                                                                                                                                  |
| **Processing Delay**         | The amount of time (in seconds) by which the processing of files placed in the **Transactions** tab is delayed. This is a legacy setting. Best practice is to [use a File connector](../flows/designing-a-flow#ローカルファイルシステムとのやり取り) to manage local file systems instead of this setting.                                                                                                   |
| **Strict Schema Validation** | Whether the connector should Ignore, Warn, or Fail when the following are detected: repeat counts above the allowed number, missing required elements or segments, invalid qualifier and code values, disallowed element lengths, and invalid element values.                                                                                                                              |
| **Local File Scheme**        | A scheme for assigning filenames to messages that are output by the connector. You can use macros in your filenames dynamically to include information such as identifiers and timestamps. For more information, see [Macros](#macros).                                                                                                                                                    |
| **TLS Enabled Protocols**    | The list of TLS/SSL protocols supported when establishing outgoing connections. Best practice is to only use TLS protocols. SSL v2 and SSL v3 are considered vulnerable and should only be used if your partner does not support higher versions. Keep in mind that TLS v1.3 is not universally adopted, and might be refused if the destination server does not support it.               |
| **Validate Identifiers**     | When checked, the connector ensures that the identifiers in the translated document match the identifiers specified in the connector configuration.                                                                                                                                                                                                                                        |
| **Duplicate File Action**    | How the connector should behave when it receives a message with a control number that the connector has seen before (a duplicate). When set to `Ignore`, the connector silently skips the duplicate and continues processing. When set to `Warn`, the connector processes the file but returns a warning. When set to `Fail`, the connector does not accept the file and returns an error. |
| **Upload Schema**            | Use this to upload a schema and install it in the connector's Schema folder. If a schema already exists, you are asked if you want to overwrite it.                                                                                                                                                                                                                                        |
| **Reset State**              | EDI connectors keep track of control numbers that have been used and increment that number to ensure that future runs do not duplicate data. Use this button to reset the counter to its initial state without changing any of the configured settings.                                                                                                                                    |

#### Logging

<Logging />

#### Miscellaneous

<MiscConnector />

### Automation Tab

#### Automation Settings

*Settings related to the automatic processing of files by the connector.*

| Setting                  | Description                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Send**                 | Whether files arriving at the connector are automatically sent as HL7 or XML messages.                                                                                                                                                                                                                                                                                                                          |
| **Retry Interval**       | The number of minutes before a failed send is retried. A retry is triggered when the server does not respond to a send attempt, or responds negatively to communicate that the file was not received.                                                                                                                                                                                                           |
| **Max Attempts**         | The maximum number of times the connector processes the input file. Success is based on a successful server acknowledgement and validation of the receipt (when requested synchronously). If you set this to 0, the connector retries the file indefinitely.                                                                                                                                                    |
| **Resend Interval**      | The number of minutes before unacknowledged messages are resent. A resend is triggered when the server receives the file, but an asynchronous MDN receipt is not provided within the expected timeframe.                                                                                                                                                                                                        |
| **Max Attempts (async)** | The maximum number of times the connector processes the input file when asynchronous receipts are requested. Success is based on the return of an asynchronous receipt within the **Resend Interval** after a successful server acknowledgement. If a successful server acknowledgement is not returned, **Max Attempts** is applied instead. If this is set to 0, the connector resends the file indefinitely. |

#### Performance

<Performance />

### Alerts Tab

<AlertsTab />

### SLAs Tab

<SlasTab />

## Generating HL7 Documents

When generating HL7 files from XML, the connector applies transaction headers based on the [HL7 Personal Ids](#hl7-personal-ids) on the HL7 MLLP Profile tab, and the [HL7 Configuration](#hl7-configuration) in the connector. The remaining data comes from XML input files. See [Use with the XML Map Connector](#use-with-the-xml-map-connector) for more information on generating the appropriate XML input files.

Files that arrive in the **Transactions** tab for the connector are packaged into HL7 documents and sent out over MLLP. Files can arrive in the **Transactions** tab either by dropping the file directly into the folder path on disk, or by connecting another {siteNameShort} connector to the HL7 MLLP connector in the flow.

## HL7 to XML

When converting HL7 documents into XML, the application verifies the interchange headings from the inbound document against the [HL7 Personal Ids](#hl7-personal-ids) on the HL7 MLLP Profile tab, and the [HL7 Configuration](#hl7-configuration) in the connector. The XML generated from the HL7 document is placed in the **Transactions** tab to be passed along in the flow for further processing. See [Use with the XML Map Connector](#use-with-the-xml-map-connector) for more information on processing the translated XML.

## Use With the XML Map Connector

<EdiXmlMapIntro fileFormat={fileFormat} />

### Upload Test File

<EdiUploadTestFile fileFormat={fileFormat} documentType={documentType} />

## Macros

<MacrosTable />

### Examples

<MacrosExamples />