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

# X12 端口

> X12 端口的配置与使用指南。

export const SampleFilesTab = () => <>
    <p><em>上传示例文件可以方便地在任何连接的 CSV Map 或 XML Map 端口中进行映射。</em></p>

    <p>使用 <strong>示例文件</strong> 选项卡生成用于 <a href="/26.2/self-hosted/zh/connectors/map">CSV Map</a> 或 <a href="/26.2/self-hosted/zh/connectors/xml-map/xml-map">XML Map</a> 端口的源或目标 XML 模板。单击 <strong>添加示例文件</strong>。</p>

    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>1. 如果您已有反映数据预期格式和结构的示例文件，请选择 <strong>文件上传</strong> 并浏览到您的文件。或者，选择 <strong>手动创建</strong> 直接在应用程序中创建文件。如果您选择 <strong>手动创建</strong>，请为示例文件命名。单击 <strong>下一步</strong>。</p>
    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>2. 如果您浏览到现有文件，<strong>查看文件</strong> 选项卡将填充其内容。如果您选择手动创建文件，请在此选项卡上输入示例数据。单击 <strong>下一步</strong>。</p>
    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>3. <strong>翻译和预览</strong> 选项卡显示将示例数据转换为 XML 的预览。当您对示例满意时，单击 <strong>添加</strong>。</p>
  </>;

export const EdiPrintView = ({fileFormat = "EDI", customImage = "x12_print_preview.png"}) => <>
    <p>在端口的 <strong>交易</strong> 选项卡上查看 {fileFormat} 文档时，可以以打印预览格式或原始数据格式进行查看。默认情况下，文档以预览格式显示，如下图所示：</p>
    <img src={`/public/images/${customImage}`} alt={`${fileFormat} print preview`} width="800" />
    <p>预览格式以易于阅读的布局显示数据。使用右上角的 <strong>原始视图</strong>（Raw View）开关可以查看未格式化的文档。</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>交易</strong> 选项卡中，单击 <strong>更多</strong> 下拉菜单，然后单击 <strong>上传测试文件</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>源文件</strong> 或 <strong>目标文件</strong> 下拉菜单中。</p>
      <Note>XML Map 端口需要源模板和目标模板，因此必须根据数据来源结构或应转换为的结构来设置剩余模板。例如，如果需要将 {docLabel} 文档中的数据插入数据库，则 XML Map 端口中的另一个模板将是数据库插入的 XML 模型。有关在两个模板文件之间创建映射的更多信息，请参阅 XML Map 端口的 <a href="/26.2/self-hosted/zh/connectors/xml-map/xml-map-designer">使用映射编辑器</a>。</Note>
    </>;
};

export const EdiXmlMapIntro = ({fileFormat = "EDI"}) => <p>{fileFormat} 端口执行两项操作之一：接收 XML 输入或生成 XML 输出。为确保输入和输出文件具有正确的 XML 结构，我们强烈建议在生成出站 {fileFormat} 文档时将 <a href="/26.2/self-hosted/zh/connectors/xml-map/xml-map">XML Map 端口</a> 用作流程中的上一步，或在接收入站 {fileFormat} 文档时将其用作流程中的下一步。下面描述的 <strong>上传测试文件</strong> 功能使 XML Map 端口和 {fileFormat} 端口之间的交互变得简单。</p>;

export const DynamicallyProcessPartnersDetail = ({customImage1 = "edi_partners_tab.png", customImage2 = "edi_dynamically_process_partners_disabled.png"}) => <>
    <p>默认情况下，端口 <strong>设置</strong> 页面上的 <strong>动态处理交易伙伴</strong> 复选框是启用的。这意味着端口会自动从 EDI 事务中识别并跟踪交易伙伴关系。在这种情况下，不需要手动配置交易伙伴，因为端口会在许可限制范围内动态管理所有交易伙伴，并在达到限制时发出通知。端口根据其处理的文件跟踪标识符，这意味着可能可以使用单个端口来处理所有交易伙伴。</p>

    <img src="/public/images/edi_dynamically_process_partners.png" alt="Dynamically process partners setting" width="200" />

    <p>仅当知行之桥正在动态处理交易伙伴时，<strong>EDI 交易伙伴</strong> 选项卡才会被启用。该选项卡会填充端口识别出的每个关系的交易伙伴标识符和个人标识符，以及该交易伙伴最后一次处理文件的日期。在 <strong>EDI 交易伙伴</strong> 选项卡中，可以通过将鼠标悬停在交易伙伴上并点击垃圾桶图标，删除最后处理日期超过 30 天的交易伙伴。</p>

    <img src={`/public/images/${customImage1}`} alt="EDI Partners tab" width="600" />

    <p>启用此设置后，端口识别出的所有交易伙伴关系都会自动跟踪以用于许可计量。它们会出现在 <strong>设置 &gt; 许可</strong> 页面的 <a href="/26.2/self-hosted/zh/getting-started/administration/settings/license-settings#connector-usage">端口使用情况</a> 部分。在此处，您可以查看交易伙伴标识符和个人标识符、关联的端口以及日期信息。</p>

    <img src="/public/images/edi_partner_licenses.png" alt="EDI partner licenses" width="800" />

    <p>如果禁用此设置，则必须在 <strong>设置</strong> 页面的 <strong>交易伙伴标识符</strong> 和 <strong>个人标识符</strong> 字段中显式配置交易伙伴关系，如下图所示。</p>

    <img src={`/public/images/${customImage2}`} alt="Dynamically process partners disabled" width="700" />

    <p>手动定义的交易伙伴关系也会出现在 <strong>设置 &gt; 许可</strong> 页面的 <a href="/26.2/self-hosted/zh/getting-started/administration/settings/license-settings#connector-usage">端口使用情况</a> 部分。</p>
  </>;

export const CommonPendingAck = () => <p>当需要确认的 EDI 消息未收到确认时，会在消息中添加一个 Pending-Timeout 标头。在等待 ACK 期间，消息处于 <em>Pending</em> 状态。如果在规定时间内未收到 ACK，则会将消息状态更改为 <em>Error</em> 的日期和时间填充到 Pending-Timeout 标头中。当收到 ACK 并将消息更新为 <em>Success</em> 时，会添加一个包含空字符串值的新标头。</p>;

export const SlasTab = ({siteName = "知行之桥"}) => <>
    <p><em>与配置服务级别协议 (SLA) 相关的设置。</em></p>
    <p>
      SLA 允许配置预期流程中端口发送或接收的数据量，并设置预期达到该数据量的时间范围。当 SLA 未达到时，{siteName} 会发送电子邮件警告用户，并将 SLA 标记为 <em>存在风险</em>，这意味着如果 SLA 未能尽快达到，则会被标记为 <em>已违反</em>。这让用户有机会介入并确定 SLA 未达到的原因，并采取适当的措施。如果在风险时间段结束时仍未达到 SLA，则会将 SLA 标记为已违反，并再次通知用户。
    </p>
    <p>
      要定义 SLA，请启用 <strong>预期数据量</strong>，然后点击 <strong>设置</strong> 选项卡。
    </p>
    <img src="/public/images/sla_empty.png" alt="SLA Empty" />
    <ul>
      <li>如果端口具有单独的发送和接收操作，请使用单选按钮指定 SLA 适用的方向。</li>
      <li>在窗口的 <strong>预计至少</strong> 部分中：
        <ul>
          <li>设置预计处理的最小事务数量（交易量）</li>
          <li>使用 <strong>每个</strong> 字段指定时间范围</li>
          <li>指示 SLA 生效的时间。如果选择 <strong>开始于</strong>，请填写日期和时间字段。</li>
          <li>勾选希望 SLA 生效的星期几对应的复选框。如有必要，请使用下拉菜单选择 <strong>每天</strong>。</li>
        </ul>
      </li>
      <li>在窗口的 <strong>将状态设置为“有风险”</strong> 部分中，指定应将 SLA 标记为有风险的时间。
        <ul>
          <li>默认情况下，只有在违反 SLA 的情况下才会发送通知。要更改此设置，请勾选 <strong>发送“有风险”通知</strong>。</li>
        </ul>
      </li>
    </ul>
    <p>
      以下示例显示了为端口配置的 SLA，该端口预计在周一至周五每天接收 1000 个文件。如果尚未收到 1000 个文件，则会在时间段结束前 1 小时发送风险通知。
    </p>
    <img src="/public/images/sla_defined.png" alt="SLA Configuration Example" />
    <Note>
      如果有必要，可以关闭 SLA 通知。这在维护窗口期间非常有用。点击导航栏上的 <strong>设置</strong>，然后跳转到 <strong>通知 &gt; 通用通知</strong>。点击平板和铅笔图标进行编辑，并取消勾选 <strong>SLA 通知</strong> 设置。
    </Note>
  </>;

export const AlertsTab = ({siteNameShort = "知行之桥"}) => <>
    <p><em>与配置通知相关的设置。</em></p>
    <p>
      在执行服务级别协议 (SLA) 之前，需要设置电子邮件通知以接收通知。默认情况下，{siteNameShort} 使用 <a href="/26.2/self-hosted/zh/getting-started/administration/settings/alerts">通知</a> 选项卡上的全局设置。要为此端口使用其他设置，请启用 <strong>覆盖全局设置</strong>。
    </p>
    <p>
      默认情况下，错误通知处于启用状态，这意味着每当出现错误时都会发送电子邮件。要关闭错误通知，请取消选中 <strong>启用</strong> 复选框。
    </p>
    <p>
      输入 <strong>主题</strong>（必填），然后（可选）输入以逗号分隔的 <strong>收件人</strong> 电子邮件列表。
    </p>
  </>;

export const Message = () => <>
    <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>端口根据选定的时间间隔对 <strong>已发送</strong> 文件夹中的文件进行分组。例如，<strong>Weekly</strong> 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 <strong>已发送</strong> 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const MiscConnector = () => <>
    <p><em>特殊设置适用于特定用例。</em></p>
    <table>
      <thead>
        <tr>
          <th>设置</th>
          <th>描述</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>其他设置</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>日志级别</strong></td>
          <td>指定要记录在端口日志目录中的信息类型：
            <ul>
              <li><b>None</b> - 不创建任何日志。</li>
              <li><b>Error</b> - 仅当端口遇到错误时才创建日志。</li>
              <li><b>Warning</b> - 仅当端口发出警告时才创建日志。</li>
              <li><b>Info</b> - 记录工作流的一般信息，包括任何错误和警告（如果适用）。</li>
              <li><b>Debug</b> - 记录成功和失败工作流的详细调试信息。</li>
              <li><b>Trace</b> - 记录成功和失败工作流的详细跟踪信息。</li>
            </ul>
            <strong>请注意：</strong><strong>Debug</strong> 和 <strong>Trace</strong> 级别的日志可能会记录敏感信息，包括消息内容和 SSL 证书。尽管连接属性（例如密码）被屏蔽了，但在与您的组织外部共享它们之前，请查看此级别的日志以避免泄漏敏感信息。</td>
        </tr>
        <tr>
          <td><strong>日志文件夹结构</strong></td>
          <td>指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如，<strong>Weekly</strong> 选项指示端口每周创建一个新的子文件夹，并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口，使用子文件夹有助于保持日志的有序性并提高性能。</td>
        </tr>
        <tr>
          <td><strong>保留消息副本</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.2/self-hosted/zh/getting-started/administration/settings/global-settings-vault">vault</a> 中项目的名称。例如，<code>%Vault:companyname%</code> 解析为存储在保管库中的 <code>companyname</code> 项的值。</li>
      <li>%DateFormat:format%：其中 <code>format</code> 是可接受的日期格式（有关详细信息，请参阅 <a href="/26.2/self-hosted/zh/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>将多个宏组合在一个文件名中：<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 = "知行之桥", 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>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>以常规格式计算系统的当前日期时间（例如，2024 年 1 月 24 日星期三）。</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.2/self-hosted/zh/scripting/value-formatters/date-formatters#date-formats-with-literal-characters">示例日期格式</a>。</td></tr>
        <tr><td>Vault:<em>vaultitem</em></td><td>计算指定保管库项目的值。</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>最大工作线程数</strong></td>
          <td>此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置，则会覆盖 <a href="/26.2/self-hosted/zh/getting-started/administration/settings/advanced-settings">高级设置</a> 页面的 <a href="/26.2/self-hosted/zh/getting-started/administration/settings/performance-settings">性能设置</a> 部分的默认设置。</td>
        </tr>
        <tr>
          <td><strong>最大文件数</strong></td>
          <td>分配给端口的每个线程发送的最大文件数。如果设置，则会覆盖 <a href="/26.2/self-hosted/zh/getting-started/administration/settings/advanced-settings">高级设置</a> 页面的 <a href="/26.2/self-hosted/zh/getting-started/administration/settings/performance-settings">性能设置</a> 部分的默认设置。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const companyName = "知行软件";

export const siteNameShort = "知行之桥";

export const siteName = "知行之桥";

export const fileFormat = "X12";
export const documentType = "X12";

X12 端口支持从 XML 生成 X12 文件以及将 X12 文件转换为 XML。

## 核心功能

* 完整的双向 EDI X12 与 XML 文档处理，支持所有事务集
* 交换头和功能组头的验证与生成
* 支持 997/999 功能确认（ACK）及自动路由
* 提供 HIPAA 合规性所需的 SNIP 验证等高级功能

## 概览

接收 X12 报文时，X12 端口会验证 X12 交互头部并将 X12 报文转换为 XML。这是一个非常有用的准备步骤，因为 XML 是 {siteNameShort} 用于处理工作流中数据的主要格式。X12 端口自动读取输入文件以确定与报文相匹配的 X12 Schema，然后根据该 Schema 解析报文。

生成 X12 报文时，X12 端口将 XML 文件转化为符合 X12 语法规则的 X12 报文，并应用此端口配置的 X12 交换头信息。这对于创建 X12 报文非常重要，此步骤发生在 XML 数据已在工作流其他位置完成获取和转换之后。

<Note>可以通过在端口的**测试指示符**设置中选择 *Test Data* 来跳过交换头验证。</Note>

X12 端口还可以自动为传入的 X12 报文生成 ACK。有关更多信息，请参阅 [X12 ACK](#x12-ack) 部分。

## 先决条件

开始之前，请确保已为需要处理的文档类型安装了正确的 Schema。X12 端口本身支持以下 Schema 定义：00401、00403 和 00501。可以在 {siteNameShort} 安装目录的 `app_data/x12_schemas` 目录中找到它们。如果需要不同的 Schema，可以从 [{companyName} 官网](https://arc.cdata.com/schemas/) 免费下载其他 Schema 文件。

下载并解压 zip 存档后，将整个文件夹放入 `app_data/x12_schemas` 目录下适当命名的子目录中。

## 端口配置

本节包含所有可配置的端口属性。

### 设置选项卡

#### 转换配置

*与端口核心操作相关的设置。*

| 设置           | 描述                                                                                |
| ------------ | --------------------------------------------------------------------------------- |
| **端口 ID**    | 端口的静态唯一标识符。                                                                       |
| **端口类型**     | 显示端口名称及其功能描述。                                                                     |
| **端口描述**     | 可选字段，用于对端口及其在流中的角色进行自由描述。                                                         |
| **转换类型**     | 端口是将 X12 报文转换为 XML 文件，还是将 XML 文件转换为 X12 报文。                                       |
| **动态处理交易伙伴** | 启用后，端口自动从 EDI 事务中识别并跟踪交易伙伴关系。禁用后，您必须手动定义伙伴关系。更多信息请参阅 [EDI 交易伙伴选项卡](#edi-交易伙伴选项卡)。 |

#### EDI 交易伙伴

| 设置                  | 描述                                                             |
| ------------------- | -------------------------------------------------------------- |
| **交易伙伴标识符 (ISA06)** | 标识 X12 通信中的发送方（生成 X12 文档时，此处应为您自己的标识符）。仅在未勾选**动态处理交易伙伴**时适用。   |
| **个人标识符 (ISA08)**   | 标识 X12 通信中的接收方（生成 X12 文档时，此处应为您交易伙伴的标识符）。仅在未勾选**动态处理交易伙伴**时适用。 |

#### 交换头配置

*与 X12 文档的交换头相关的设置。生成文档时，这些设置将作为交换头应用到生成的文档中。解析文档时，交换头设置用于验证传入文档。*

| 设置                      | 描述                                                       |
| ----------------------- | -------------------------------------------------------- |
| **交易伙伴 ID 限定符 (ISA05)** | 通过为该值提供上下文来限定**交易伙伴标识符**。                                |
| **个人 ID 限定符 (ISA07)**   | 通过为该值提供上下文来限定**个人标识符**。                                  |
| **控制版本号 (ISA12)**       | 标识交换的控制版本。                                               |
| **使用指示符 (ISA15)**       | 交换的数据是否代表测试数据、生产数据或常规信息。当此项设置为 *Test Data* 时，交换头*不会*被验证。 |
| **功能组**                 | 选中此选项可自动将发送者和接收者标识符添加到**高级**选项卡上的[功能组配置](#功能组配置)。        |

#### ACK

*与生成和请求确认相关的设置。*

| 设置            | 描述                                                   |
| ------------- | ---------------------------------------------------- |
| **TA1 ACK**   | 是否发送 TA1 交换确认。                                       |
| **功能 ACK**    | 是否应返回（接收时）和请求（发送时）功能性 ACK。功能性 ACK 标识接收或拒绝已收到的交换和交换集。 |
| **功能 ACK 类型** | 选中此项以指定是否使用 997 或 999 功能确认。                          |

### 示例文件选项卡

<SampleFilesTab />

### 高级设置选项卡

#### EDI 分隔符

*指定哪些字符作为元素、段等的分隔符。*

| 设置          | 描述                 |
| ----------- | ------------------ |
| **数据元素分隔符** | 分隔文档中各个数据元素的字符。    |
| **组件元素分隔符** | 分隔文档中组件数据结构内元素的字符。 |
| **段终止符**    | 指示文档中段结尾的字符。       |
| **后缀**      | 附加到**段终止符**中以区分段。  |

#### 交换头配置

*与 X12 交换头相关的其他设置。*

| 设置                  | 描述                        |
| ------------------- | ------------------------- |
| **授权限定符 (ISA01)**   | 通过提供值的上下文来限定**授权 ID** 设置。 |
| **授权 ID (ISA02)**   | 标识与交换关联的授权级别。             |
| **安全限定符 (ISA03)**   | 通过提供值的上下文来限定**安全密码**设置。   |
| **安全密码 (ISA04)**    | 表示有关交换的安全信息。              |
| **控制标准标识符 (ISA11)** | 标识 X12 标准。唯一有效的值是 *U*。    |

#### 功能组配置

*与 X12 文档的功能组头相关的设置。这些可选标识符可以帮助对类似的交换进行分组或促进组织中的子寻址。*

| 设置                 | 描述                   |
| ------------------ | -------------------- |
| **交易伙伴标识符 (GS02)** | 标识 X12 通信中的发送方。      |
| **个人标识符 (GS03)**   | 标识 X12 通信中的接收方。      |
| **日期格式 (GS04)**    | 日期戳的格式。              |
| **时间格式 (GS05)**    | 时间戳的格式。              |
| **负责机构代码 (GS07)**  | 标识 X12 标准的发行者。       |
| **标识符代码 (GS08)**   | 标识 X12 标准的版本、发行版和行业。 |

#### 高级设置

*先前类别中未包含的设置。*

| 设置               | 描述                                                                                                                                                                                                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **批处理事务**        | 一个交换（Interchange）可以包含多个事务。如果未选中，端口将为交换中的每个事务创建单独的输出文件。如果选中，端口将同一个交换中的所有事务组织输出在一个文件中。仅当**转换类型**为 X12 转换为 XML 时适用。                                                                                                                                              |
| **使用引用 Id**      | 选中后，将 X12 转换为 XML 时，引用 Id 将用于命名 XML 元素。仅当**转换类型**为 X12 转换为 XML 时适用。例如：`<_143>value</_143>`。如果未选中，则引用指示符将用于命名 XML 元素：`<BEG03>value</BEG03>`                                                                                                                    |
| **编码**           | 指定字符编码（例如 ASCII 或 UTF-8）。                                                                                                                                                                                                                                     |
| **扩展限定符值**       | 选中时，包含 EDI 限定符的 XML 元素包括包含限定符代码和值的子元素。例如：<br /><code>\<N101></code><br />  <code>\<Code>ST\</Code></code><br />  <code>\<Value>Ship To\</Value></code><br /><code>\</N101></code>                                                                             |
| **功能 ACK**       | 默认情况下，所有功能确认（997、999）都会路由到流程图中选择的端口，并且**交易**选项卡中不会接收 XML 转换。选中此项可使转换后的 ACK 也包含在**交易**选项卡中。除了新的 EDI 文档之外，这还允许将功能确认集成到目标源中。                                                                                                                                     |
| **生成描述为**        | 将 X12 转换为 XML 时，可以提供 X12 段和元素的描述作为 X12 数据的上下文。使用此下拉列表可以选择是否将此上下文添加为 XML 注释或 XML 属性。                                                                                                                                                                           |
| **HIPAA Schema** | 选中后，端口将使用一组单独的 EDI Schema，并在转换和验证文档时应用 HIPAA 约束。对于除受 HIPAA 约束的医疗保健文档之外的 EDI 文档，此设置将被忽略。                                                                                                                                                                       |
| **HIPAA 278**    | 两个单独的 Schema 可用于 278 文档，具体取决于这些文档是否应解释为请求或响应。选中后，将使用请求 Schema；否则使用响应 Schema。                                                                                                                                                                                  |
| **本地文件名方案**      | 用于为端口输出消息分配文件名的方案。可在文件名中使用宏动态包含标识符和时间戳等信息。更多信息请参阅[宏](#宏)。                                                                                                                                                                                                     |
| **嵌套循环**         | 选中后，端口会检测 EDI 数据中嵌入了层次关系的 EDI 结构，并生成 XML，其中这些层次关系表示为父子关系。有关详细信息，请参阅[主从层次结构：转换 HLLoop](#主从层次结构转换-hlloop)。                                                                                                                                                      |
| **处理延迟**         | 放置在**交易**选项卡中的文件的处理延迟时间（以秒为单位）。这是一项遗留设置。最佳做法是[使用 File 端口](../flows/designing-a-flow#interacting-with-the-local-file-system)来管理本地文件系统，而不是使用此设置。                                                                                                                |
| **SNIP 验证**      | 启用后，端口将执行前三个级别的 SNIP 验证以确保 HIPAA 合规性：(1) 文档的语法完整性，(2) 是否存在所需的段以及重复段的适当重复，以及 (3) 索赔行项目和索赔总额之间正确的数学关系。更高级别的 SNIP 验证 (4+) 可能需要 [Validate](./validate) 端口或自定义脚本。详情请阅读 <a href="https://arc.cdata.com/kb/articles/snip-validation.rst" target="_blank">此知识库文章</a>。 |
| **严格 Schema 验证** | 当检测到以下情况时，端口是否应忽略、警告或失败：重复计数超过允许的数量、缺少必需的元素或段、无效的限定符和代码值、不允许的元素长度以及无效的元素值。选择"禁用"会关闭 Schema 验证检查。                                                                                                                                                              |
| **跟踪 ISA06**     | 是否将 ISA06 值作为跟踪头添加到已处理的消息中。                                                                                                                                                                                                                                   |
| **跟踪 ISA08**     | 是否将 ISA08 值作为跟踪头添加到已处理的消息中。                                                                                                                                                                                                                                   |
| **跟踪事务类型**       | 是否将事务类型作为跟踪头添加到已处理的消息中。                                                                                                                                                                                                                                       |
| **验证标识符**        | 选中此项以确保已翻译文档中的标识符与端口配置中的标识符匹配。                                                                                                                                                                                                                                |
| **重复文件操作**       | 端口在收到控制号曾经出现过的消息（重复消息）时应如何处理。设置为 `Ignore` 时，端口静默跳过重复消息并继续处理。设置为 `Warn` 时，端口处理文件但返回警告。设置为 `Fail` 时，端口不接受文件并返回错误。                                                                                                                                               |
| **上传 Schema**    | 用于上传 Schema 并将其安装到端口的 Schema 文件夹中。如果 Schema 已存在，系统将询问是否要覆盖。                                                                                                                                                                                                   |
| **重置状态**         | EDI 端口会跟踪已使用的控制号并递增该数字，以确保未来的运行不会重复数据。使用此按钮可在不更改任何已配置设置的情况下将计数器重置为初始状态。                                                                                                                                                                                       |

#### 消息

<Message />

#### 日志

<Logging />

#### 其他

<MiscConnector />

### EDI 交易伙伴选项卡

<DynamicallyProcessPartnersDetail customImage1="edi_x12_partners_tab.png" customImage2="edi_x12_partner_config_disabled.png" />

### 自动化选项卡

#### 自动化设置

*与端口自动处理文件有关的设置。*

| 设置                 | 描述                                                                                                                  |
| ------------------ | ------------------------------------------------------------------------------------------------------------------- |
| **发送**             | 指示端口在文件就绪时自动发送文件的开关。                                                                                                |
| **重发间隔**           | 端口在重新发送收到负面 ACK 的文件之前等待的时间间隔。例如，如果交易伙伴收到文件但文件存在问题并发回负面 ACK，此设置指定在再次发送文件前等待多长时间。                                     |
| **最大尝试次数 (async)** | 当请求功能性 ACK 时，端口处理输入文件的最大次数。是否成功基于在**重发间隔**内收到功能性 ACK。如果未返回成功的功能性 ACK，端口将重新发送文件直到达到**最大尝试次数**。如果设置为 0，则端口将无限次重新发送文件。 |

#### 性能

<Performance />

### 告警选项卡

<AlertsTab />

### SLA 选项卡

<SlasTab />

## 转换格式

以下各节详细介绍了将 X12 转换为 XML 的过程，以及将 XML 转换为 X12 的过程。

### X12 转换为 XML

将**转换类型**设置为 *X12 转换为 XML* 指示端口将传入的 X12 文档解析为 XML。端口首先读取文档"交换"和"功能组"部分的所有头部信息，并根据配置的端口设置验证它们（除非**测试指示符**设置为 *Test Data*）。然后，端口解析文档中使用的特定 X12 Schema，并从磁盘上的 `x12_schemas` 文件夹加载 Schema（其他 Schema 文件可从<a href="https://arc.cdata.com/schemas/" target="_blank">官网</a>免费下载）。使用该 Schema，端口生成表示文档 X12 结构的 XML，使用文档中的值填充 XML，并以 XML 注释或 XML 元素属性（基于**生成描述为**的值）的形式为每个值提供上下文。

要使用一组测试 X12 文档查看此过程，请导航到 X12 端口的**交易**选项卡（将**转换类型**设置为 *X12 转换为 XML*）并选择**更多 > 创建测试文件**。发票、采购订单、采购订单确认和发货通知的 X12 文档会自动生成并放置在**交易**目录中。端口处理这些测试文件后，导航到**交易**选项卡以查看生成的 XML。

一旦 X12 报文被转换成 XML，数据就可以通过多种方式进行转换和操作。通常，X12 数据需要存储在数据库或其他后端应用系统中。因为 {siteNameShort} 使用 XML 来表示这些后端系统中的插入，所以存储 X12 数据就变成了简单地将一个 XML 结构映射到另一个 XML 的问题。通常是用可视化设计器驱动 [XML Map 端口](./xml-map/xml-map)。

### XML 转换为 X12

将**转换类型**设置为 *XML 转换为 X12* 指示端口根据文档的 XML 表示形式生成 X12 文档。端口根据从 XML 解析的数据构建 X12 消息后，会根据配置的端口设置添加功能组和交换头部。

要使用一组测试 XML 文件查看此过程，请导航到 X12 端口的**交易**选项卡（将**转换类型**设置为 *XML 转换为 X12*）并选择**更多 > 创建测试文件**。发票、采购订单、采购订单确认和发货通知的 XML 文件将自动生成并放置在**交易**目录中。端口处理这些测试文件后，导航到**交易**选项卡以查看生成的 X12 文档。

### 打印视图

<EdiPrintView fileFormat={fileFormat} customImage="x12_print_preview.png" />

## 与 XML Map 端口配合使用

<EdiXmlMapIntro fileFormat={fileFormat} />

### 上传测试文件

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

## X12 ACK

以下章节详细介绍了三种 X12 ACK，以及 {siteNameShort} 期待、处理和生成 ACK 的方式。

### 交换 ACK、997 和 999

TA1 是一种普遍接受的交换确认形式。这表明双方之间已经发生了数据交换，尽管不一定交换了具体报文。这作为接收方发给发件人的收据，表明接收方已成功收到 EDI 消息，但未指定在处理消息内容时是否存在任何问题。

997（版本 4010）、997（版本 5010）或 999 确认被视为功能性 ACK，即单个消息（例如发票或采购订单）已被接受的确认。这些是根据双方的双向协议生成的。

### 期待 ACK、处理 ACK 和生成 ACK

#### 期待 ACK

X12 端口在 XML 转换为 X12 模式下运行时，可以进行配置，以便可以要求交换和功能确认。在"设置"选项卡的 [ACK](#ack) 部分中选中 **TA1 ACK** 或 **功能 ACK** 时，端口将保持传输的"Pending ACK"状态，直到返回并处理相应的 ACK。这意味着端口状态可用于确定收件人是否已确认他们收到了交换。

<CommonPendingAck />

下图显示了从发票文档期待 ACK 时涉及的逻辑流程：

<img src="https://mintcdn.com/qiao/ilnLy7gsSdFqbKmI/public/images/x12-ack-receive.png?fit=max&auto=format&n=ilnLy7gsSdFqbKmI&q=85&s=ed95bc9aa45c3334d492fc91f2367344" alt="接收 X12 ACK" width="640" height="408" data-path="public/images/x12-ack-receive.png" />

上图中，以 XML 转换为 X12 模式运行的 X12 端口生成要交换的文档 **（1）**，在文档传输到交易伙伴时保持为 Pending ACK 状态。交易伙伴根据其业务逻辑处理传输，并根据配置的交换参数创建确认 **（2）**。当确认返回后，将根据下一部分 **（3）** 中的信息进行处理。

#### 处理 ACK

在典型的工作流中，X12 ACK 将到达以 X12 转换为 XML 模式运行的 X12 端口。可以将该 X12 端口配置为自动将所有收到的 ACK 路由到最初生成被确认文档的 X12 端口。在[流](../flows/flows)画布上，可以通过将 X12 转换为 XML 模式下 X12 端口底部的灰色点拖动到 XML 转换为 X12 模式下的 X12 端口上，来可视化配置 X12 端口之间的 ACK 路由。

一旦 XML 转换为 X12 模式下的 X12 端口接收到路由的 ACK，会将 ACK 与原始消息进行匹配，并将其状态从 "Pending ACK" 更新为 "Sent"。

#### 生成 ACK

当处于 X12 转换为 XML 模式的 X12 端口收到一条消息并生成相应的 XML 时，它可以自动为收到的消息生成确认。为此，请在"设置"选项卡的 [ACK](#ack) 部分中启用 **TA1 ACK** 和/或**Functional ACK expected**。必须将这些确认路由到另一个 X12 端口（处于 XML 转换为 X12 模式）以最终确定 ACK。ACK 路由到的端口将应用交换头部，并将 ACK 传递到工作流中的下一个端口，就像其他 X12 消息一样。要适当路由 ACK，请将 X12 转换为 XML 模式下 X12 端口底部边缘的灰色点拖动到 XML 转换为 X12 模式下的 X12 端口上。

下图显示了为收到的发票文档创建 ACK 时涉及的逻辑流程：

<img src="https://mintcdn.com/qiao/ilnLy7gsSdFqbKmI/public/images/x12-ack-create.png?fit=max&auto=format&n=ilnLy7gsSdFqbKmI&q=85&s=bc7bc6233185cefdf4a9ff06ee8b4764" alt="创建 X12 ACK" width="640" height="408" data-path="public/images/x12-ack-create.png" />

如上图所示，在交易伙伴发送了一条要求确认的消息后 **（1）**，X12 转换为 XML 模式下的 X12 端口解析文档会自动生成一个 ACK **（2）**。该 ACK 是一个 XML 文件，其中包含与交易相关的事务信息。然后，此 XML ACK 将以 XML 转换为 X12 模式 **（3）** 路由至 X12 端口，以便在将 ACK 发送至交易伙伴之前使用交换头部（和其他 EDI 方协议设置）。

## 主从层次结构：转换 HLLoop

在 EDI 文档中，大多数层次结构关系由 EDI 段的顺序表示。但一些 EDI 结构，例如 HLLoop（见于\_预先装运通知\_或 X12 856s 中）不遵循此约定，而是将层次结构关系嵌入到 EDI 元素数据本身中，这使得将 EDI 数据转换为 XML 时保留这些层次关系变得困难。

X12 端口通过**高级**选项卡[高级设置](#高级设置)中的**嵌套主从细节循环**设置支持在 HLLoop 中保留层次结构关系。启用后，端口将解析 HLLoop 段中的元素，以确定哪些段"属于"层次关系中的其他段。这些层次结构关系在输出的 XML 中反映为"父子关系"。换句话说，此设置将 EDI 内容隐含的层次结构转换为 XML 结构表示的层次结构。

本节将简要说明如何在 HLLoop 数据中编码层次结构，以及在启用**嵌套主从细节循环**时如何将此层次结构转换为 XML。

### HLLoop 层次结构

所有 HL 段均具有两个有助于建立层次结构的值：

* ID 值，它标识当前的 HL 段（此值存储在 HL01 或 HL 段中的第一个元素中）
* 父 ID 值，标识当前 HL 段的层次结构父级（此值存储在 HL02 或 HL 段中的第二个元素中）

例如，假设 HL 段的 ID 值为 '2'。如果下一个 HL 段以分层关系"属于"该段，则下一个 HL 段的父 ID 应为 "2"。

如果 HL 段的父 ID 为 "0"，则表示该段没有父级（即位于层次结构的顶层）。

#### HLLoop 示例

为了进一步阐明 HLLoop 数据中的层次结构关系，请使用以下 EDI 代码段作为样本输入（仅以 *HL* 开头的行与确定数据层次结构相关；其余段被包括在内以更紧密地代表实际的 EDI 数据）：

```csharp theme={null}
HL*1*0*S      // First HL loop, the shipment loop
TD3*RR*SEAU*1234567
HL*2*1*O      // Second HL loop, the order loop
PRF*PO111111
HL*3*2*P      // Third HL loop, the first package loop
MAN*UC*PACKAGE1
HL*4*3*I      // Fourth HL loop, the first item loop
MAN*UC*ITEM_1
HL*5*3*I      // Fifth HL loop, the second item loop
MAN*UC*ITEM_2
HL*6*2*P      // Sixth HL loop, the second package loop
MAN*UC*PACKAGE_2
HL*7*6*I      // Seventh HL loop, the third item loop
MAN*UC*ITEM_1
HL*8*6*I      // Eighth HL loop, the fourth item loop
MAN*UC*ITEM_3
```

在此数据中，第二个 HL 段以分层关系"属于"第一个 HL 段。可以通过查看以下段的 HL01 和 HL02 的值来确定：

* 第一个 HL 段的 HL01（ID）的值为 "1"
* 第二个 HL 段的 HL02（父 ID）的值也为 "1"

将父 ID 值与 ID 值进行匹配相同的过程可用于确定数据中的所有层次关系。

### 将 HLLoop 层次结构转换为 XML

启用**嵌套主从细节循环**时，X12 端口会自动处理 HL 层次结构到 XML 层次结构的转换。端口从 EDI 输入中解析 HL01 和 HL02 元素值，并确保 XML 元素正确嵌套（缩进）在代表其父元素的元素内。

查看 HL 层次结构如何转换为 XML 层次结构，启用**嵌套主从细节循环**时，将从上面的示例 HL 数据生成以下 XML 输出：

```xml theme={null}
<HLLoop1_S>
  <HL><HL01>1</HL01><HL02>0</HL02><HL03>S</HL03></HL>
  <TD3><TD301>RR</TD301><TD302>SEAU</TD302><TD303>1234567</TD303></TD3>
  <HLLoop1_O>
    <HL><HL01>2</HL01><HL02>1</HL02><HL03>O</HL03></HL>
    <PRF><PRF01>PO111111</PRF01></PRF>
    <HLLoop1_P>
      <HL><HL01>3</HL01><HL02>2</HL02><HL03>P</HL03></HL>
      <MAN><MAN01>UC</MAN01><MAN02>PACKAGE1</MAN02></MAN>
      <HLLoop1_I>
        <HL><HL01>4</HL01><HL02>3</HL02><HL03>I</HL03></HL>
        <MAN><MAN01>UC</MAN01><MAN02>ITEM_1</MAN02></MAN>
      </HLLoop1_I>
      <HLLoop1_I>
        <HL><HL01>5</HL01><HL02>3</HL02><HL03>I</HL03></HL>
        <MAN><MAN01>UC</MAN01><MAN02>ITEM_2</MAN02></MAN>
      </HLLoop1_I>
    </HLLoop1_P>
    <HLLoop1_P>
      <HL><HL01>6</HL01><HL02>2</HL02><HL03>P</HL03></HL>
      <MAN><MAN01>UC</MAN01><MAN02>PACKAGE2</MAN02></MAN>
      <HLLoop1_I>
        <HL><HL01>7</HL01><HL02>6</HL02><HL03>I</HL03></HL>
        <MAN><MAN01>UC</MAN01><MAN02>ITEM_1</MAN02></MAN>
      </HLLoop1_I>
      <HLLoop1_I>
        <HL><HL01>8</HL01><HL02>6</HL02><HL03>I</HL03></HL>
        <MAN><MAN01>UC</MAN01><MAN02>ITEM_3</MAN02></MAN>
      </HLLoop1_I>
    </HLLoop1_P>
  </HLLoop1_O>
</HLLoop1_S>
```

快速辨别差异有一定难度，但需要注意的关键是，HLLoop 段包含在其他段中（即，在 XML 中具有父子关系），这与原始 HL01 和 HL02 的值一致。

## 宏

<MacrosTable />

### 示例

<MacrosExamples />

## X12 操作

除了 {siteNameShort} 提供的[操作](../scripting/operations/operations)之外，端口还可以提供将功能扩展到 {siteNameShort}Script 中的操作。这些端口操作可以像任何其他 {siteNameShort}Script 操作一样调用，但必须通过 `connector.rsc` 端点调用，并且必须包含身份验证令牌。

下面列出了 X12 端口特定功能的操作。

### x12Scan

从 X12 文档的标题中扫描标题值。

#### 必须的参数

* **file**：X12 文件的路径。

#### 可选的参数

* **format**：文件格式。默认值为 'X12'。

#### 输出属性

* **InterchangeSenderIdQualifier**：发送方 ID（ISA05）限定符。
* **InterchangeSenderId**：发送方 ID（ISA06）。
* **InterchangeReceiverIdQualifier**：接收方 ID（ISA07）限定符。
* **InterchangeReceiverId**：接收方 ID（ISA08）。
* **InterchangeControlNumber**：唯一标识 EDI 交换的值（ISA13）。
* **FunctionalGroupSenderId**：功能组配置中发送方 ID（GS02）。
* **FunctionalGroupReceiverId**：功能组配置中接收方 ID（GS03）。
* **DocumentType**：文件类型或交易集标识符代码（ST01）。
* **StandardVersion**：此交换中使用的 X12 标准的主要版本（例如 00401、00501）。

## 常见错误

以下列出了常见错误，以及原因和建议的解决方案。

### 错误：找不到 Schema 文件（\[schema 主要版本] \[schema 文档类型]）

**原因**

{siteNameShort} 解析 X12 文件时，首先在文件中扫描 EDI 版本和文档类型，以确定在解析过程中使用哪种 Schema。该应用程序包含一组广泛的 JSON 格式的 X12 Schema，存储在应用程序目录的 `schemas` 文件夹中（紧邻 `data` 文件夹）。

此错误表明应用程序找不到与文件报告的主要版本和文档类型相匹配的 Schema 文件。

如果错误消息中缺少 \[schema major version] 值或 \[schema document type] 值，则表明 EDI 文档不包含主要版本或文档类型。

否则，这表明 {siteNameShort} 随附的 Schema 定义集中未包含相应的 Schema。

**解决**

如果 EDI 文件不包含 Schema 主版本或文档类型，请与交易伙伴（或 EDI 文档的其他来源）联系，告知他们这些值必须包含在消息头部中。

否则，请从免费下载页面获取合适的 Schema 版本。下载 Schema 文件夹并将其放置在以下位置之一：

1. 在磁盘上的 Schema 文件夹内（例如 `<ConnectorDirectory>/Resources/Schemas/`）
2. 如果一个 Schema 被多个端口使用，建议使用如下文件夹结构：`<ApplicationDirectory>/schemas/<type>_schemas/<major version>`。在此示例中，`<type>` 应为 `x12`。

### 错误：第 \[line number] 行中标记为 \[segment name] 的段在指定 Schema（\[schema 主要版本] \[schema 文档类型]）中不处于有效位置。这可能表示输入文件包含顺序错误的段。

**原因**

{siteNameShort} 解析 X12 文件时，首先在文件中扫描 EDI 版本和文档类型，以确定在解析过程中使用哪种 Schema。该应用程序包含一组广泛的 JSON 格式的 X12 Schema，存储在根安装目录的 `www\app_data` 文件夹中。

此错误表明解析器在文件中遇到的 EDI 段与相关文档 Schema 中定义的段的顺序不匹配。这可能表明几个不同的问题：

* 交易伙伴生成的 EDI 文件有误
* EDI 文件由不同于文件中指示的 Schema 版本生成
* EDI 文件由自定义 Schema 生成

**解决**

如果 EDI 文件由自定义 Schema 生成，请将自定义 Schema 文件（JSON 格式）放在 {siteNameShort} 读取 EDI Schema 的文件夹中。端口通过按顺序检查以下位置来搜索 Schema：

1. 在磁盘上的 Schema 文件夹内（例如 `<ConnectorDirectory>/Resources/Schemas/`）
2. 如果一个 Schema 被多个端口使用，建议使用如下文件夹结构：`<ApplicationDirectory>/schemas/<type>_schemas/<major version>`。在此示例中，`<type>` 应为 `x12`。

如果 EDI 文件不是由自定义 Schema 生成的，则有两种方法可以解决交易伙伴生成的 EDI 文件与用于解析该文件的 EDI Schema 之间的差异。

1. 手动编辑适当的 EDI Schema 文件（在上面的文件路径中找到），以调整段顺序，使其与交易伙伴的 EDI 文件匹配。错误消息指示文件中段与 Schema 定义不同的行。跟踪段顺序的 JSON 定义，直到找到差异为止，然后对 JSON 中的段重新排序以匹配交易伙伴提供的文件。
2. 与交易伙伴联系了解 EDI 文件情况。确认文件是根据文件中报告的主要版本生成的，并说明未识别文件中段的顺序。

使用哪种方法取决于对特定文档类型的 EDI 段的熟悉程度（根据交易伙伴的文件正确编辑 JSON Schema）和交易伙伴的灵活性（调整 EDI 文件以响应有关错误的信息）。