> ## 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.

# AS4 V1 端口（廢棄）

> 已廢棄的 AS4 V1 端口配置與使用指南，支援透過 AS4 協議傳送和接收訊息。

export const CommonProxySettings = () => <>
    <p>這是一組用於識別連線所經代理並對其進行身分驗證的設定。預設情況下，本節使用 <a href="/26.3/self-hosted/zh/getting-started/administration/settings/security">安全設定</a> 頁面的 <a href="/26.3/self-hosted/zh/getting-started/administration/settings/proxy-settings">代理設定</a> 部分中的全域設定。清除此核取方塊可為您的端口提供特定的設定。</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>基於代理的防火牆的名稱或 IP 地址。</td>
        </tr>
        <tr>
          <td><strong>代理端口</strong></td>
          <td>基於代理的防火牆的 TCP 端口。</td>
        </tr>
        <tr>
          <td><strong>代理使用者</strong></td>
          <td>用於透過基於代理的防火牆進行身分驗證的使用者名稱。</td>
        </tr>
        <tr>
          <td><strong>代理密碼</strong></td>
          <td>用於對基於代理的防火牆進行身分驗證的密碼。</td>
        </tr>
        <tr>
          <td><strong>身分驗證方案</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 = "知行之桥"}) => <>
    <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.3/self-hosted/zh/getting-started/administration/settings/alerts">通知</a> 索引標籤上的全域設定。要為此端口使用其他設定，請啟用 <strong>覆蓋全域設定</strong>。
    </p>
    <p>
      預設情況下，錯誤通知處於啟用狀態，這意味著每當出現錯誤時都會傳送電子郵件。要關閉錯誤通知，請取消選中 <strong>啟用</strong> 核取方塊。
    </p>
    <p>
      輸入 <strong>主題</strong>（必填）。勾選<strong>允許在主題中使用 ArcScript</strong>，即可在<strong>主題</strong>欄位中使用 ArcScript。選中後會顯示 <strong>ArcScript 編輯器</strong>按鈕（<img src="/public/images/rest_arcscript_editor.png" alt="ArcScript 編輯器按鈕" style={{
  display: 'inline',
  verticalAlign: 'middle',
  margin: 0
}} />）。
    </p>
    <p>
      （可選）輸入以逗號分隔的<strong>收件人</strong>電子郵件地址清單。
    </p>
  </>;

export const Message = () => <>
    <p><em>訊息設定確定端口如何搜尋訊息並在處理後管理它們。</em></p>
    <p><strong>注意：</strong>以下設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇<strong>顯示成功路徑</strong>，然後將成功路徑連線到 <a href="/26.3/self-hosted/zh/connectors/file">File 端口</a>。</p>
    <table>
      <thead>
        <tr><th>設定</th><th>描述</th></tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>儲存到已傳送資料夾</strong>（已棄用）</td>
          <td>將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受<a href="/26.3/self-hosted/zh/getting-started/administration/settings/encryption-at-rest">靜態加密</a>保護。</td>
        </tr>
        <tr>
          <td><strong>已傳送資料夾方案</strong>（已棄用）</td>
          <td>按所選時間間隔對 <strong>Sent</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 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/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.3/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>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>以常規格式計算系統的當前日期時間（例如，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.3/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.3/self-hosted/zh/getting-started/administration/settings/advanced-settings">進階設定</a> 頁面的 <a href="/26.3/self-hosted/zh/getting-started/administration/settings/performance-settings">效能設定</a> 部分的預設設定。</td>
        </tr>
        <tr>
          <td><strong>最大檔案數</strong></td>
          <td>分配給端口的每個執行緒傳送的最大檔案數。如果設定，則會覆蓋 <a href="/26.3/self-hosted/zh/getting-started/administration/settings/advanced-settings">進階設定</a> 頁面的 <a href="/26.3/self-hosted/zh/getting-started/administration/settings/performance-settings">效能設定</a> 部分的預設設定。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const siteNameShort = "知行之橋";

export const siteName = "知行之橋";

export const extraMacros = [{
  name: "AS4MessageId",
  description: "替換為端口接收到的 AS4 訊息的 MessageId。"
}, {
  name: "ConversationId",
  description: "替換為端口接收到的 AS4 訊息的 ConversationId。"
}, {
  name: "SenderRole",
  description: "替換為端口接收到的 AS4 訊息的 SenderRole。"
}, {
  name: "ReceiverRole",
  description: "替換為端口接收到的 AS4 訊息的 ReceiverRole。"
}, {
  name: "Service",
  description: "替換為端口接收到的 AS4 訊息的 Service。"
}, {
  name: "Action",
  description: "替換為端口接收到的 AS4 訊息的 Service Action。"
}];

AS4 端口支援透過 AS4 協議傳送和接收訊息。

## 概觀

AS4 連線配置在兩個位置。請在 AS4 [個人設定](../getting-started/administration/profiles)頁面配置本地 AS4 參與方識別碼和私密金鑰憑證。然後為各個 AS4 端口配置特定於單個交易夥伴的連線設定。當 AS4 端口處理輸入檔案時，該檔案會被打包並傳送到指定交易夥伴。

當 {siteName} 透過 AS4 接收檔案時，會嘗試將檔案路由到特定 AS4 端口。應用程式使用 AS4 訊息中的 AS4 參與方識別碼來確定哪個 AS4 端口應接收該檔案。檔案路由到 AS4 端口後，會放置在端口的輸出索引標籤中，或傳遞到流程中的下一個已連線端口。

## 個人設定

必須先配置 AS4 個人設定，然後才能與各個 AS4 端口建立連線。點選導覽列上的**個人設定**，然後點選 **AS4** 索引標籤。

### AS4 個人設定

#### 個人 ID

*用於標識本地個人設定的設定。*

| 設定           | 描述                                                                    |
| ------------ | --------------------------------------------------------------------- |
| **參與方識別碼**   | 你的 AS4 識別碼。{siteNameShort} 傳送的訊息必須定址到此識別碼，傳出訊息也使用此值標識訊息的發起方。識別碼區分大小寫。 |
| **參與方識別碼型別** | **參與方識別碼**的可選型別宣告。如果指定，請提供識別碼所屬的域。                                    |

#### 個人憑證

*與私密金鑰解密和簽章憑證相關的設定。*

| 設定         | 描述                                                                                           |
| ---------- | -------------------------------------------------------------------------------------------- |
| **私密金鑰憑證** | 用於解密傳入訊息和簽署傳出訊息的憑證。請勿與外部方共享此憑證。點選**建立憑證**按鈕可生成可用於 AS4 交易的自簽章憑證：同時還會生成同名且副檔名為 `.cer` 的對應公開金鑰。 |
| **憑證密碼**   | 存取**私密金鑰憑證**所需的密碼。                                                                           |

#### 應用程式 URL

*與從公共 Web 存取 {siteNameShort} 相關的設定和顯示值。*

| 設定         | 描述                                                |
| ---------- | ------------------------------------------------- |
| **接收 URL** | {siteNameShort} 偵聽傳入 AS4 訊息的 URL。請與所有交易夥伴共享此 URL。 |

#### 日誌

*管理日誌建立和儲存的設定。*

| 設定         | 描述                                  |
| ---------- | ----------------------------------- |
| **日誌級別**   | 端口生成的日誌詳細程度。請求支援時，請將其設定為 **Debug**。 |
| **日誌輪換間隔** | 建立新日誌檔案之前等待的天數。                     |
| **日誌刪除間隔** | 刪除舊日誌檔案之前等待的天數。                     |

#### 其他設定

<MiscConnector />

## 端口配置

配置全域 AS4 個人設定後，請在[工作流程](../flows/flows)頁面為每個交易夥伴建立並配置單獨的 AS4 端口。

### 設定

#### 配置

| 設定        | 描述                      |
| --------- | ----------------------- |
| **端口 Id** | 端口的靜態唯一識別碼。             |
| **端口型別**  | 顯示端口名稱及其功能說明。           |
| **端口描述**  | 可選欄位，用於自由描述端口及其在流程中的作用。 |

#### 交易夥伴資訊

*用於識別和連線到特定 AS4 交易夥伴的設定。*

| 設定           | 描述                                                                                      |
| ------------ | --------------------------------------------------------------------------------------- |
| **參與方識別碼**   | 目標交易夥伴的 AS4 參與方識別碼。此值包含在傳出的 AS4 訊息中，以確保訊息傳遞給預期接收者，並用於將傳入的 AS4 訊息路由到適當的 AS4 端口。識別碼區分大小寫。 |
| **參與方識別碼型別** | **參與方識別碼**的可選型別宣告。如果指定，請提供識別碼所屬的域。                                                      |
| **交易夥伴 URL** | 交易夥伴的公共端點，傳出的 AS4 訊息應傳送到此處。                                                             |
| **協議**       | 管理交換的共享 AS4 協議。ENTSOG 配置檔案需要此項。                                                         |

#### 連線資訊

*與指定交易夥伴的連線參數相關的設定。*

| 設定          | 描述                                                                                                                         |
| ----------- | -------------------------------------------------------------------------------------------------------------------------- |
| **訊息傳送安全性** | 是否對傳出的 AS4 訊息進行簽章和/或加密。知行軟體強烈建議使用簽章和加密。                                                                                    |
| **訊息接收安全性** | 是否要求傳入的 AS4 訊息存在簽章和加密。如果收到的訊息沒有必需的安全參數，將擲回錯誤。                                                                              |
| **壓縮**      | 是否壓縮傳出訊息的有效負載。                                                                                                             |
| **連線逾時時間**  | 端口在擲回逾時錯誤之前等待連線回應的時間長度（以秒為單位）。                                                                                             |
| **配置檔案**    | AS4 交換中使用的 AS4 配置檔案。配置檔案有助於確定共享配置設定，以確保夥伴之間的相容性。可用配置檔案包括：`Standard`、`ENTSOG`、`e-SENS`、`DBEW`、`ENTSOG V4` 和 `eDelivery V2`。 |
| **訊息分割區通道** | AS4 交換應透過的通道。如果未指定通道，則會隱式分配預設訊息分割區通道 (MPC)。MPC 在傳送或接收拉取請求時很重要，因為只有分配的 MPC 中排隊的訊息才會回應拉取請求傳回。                                |

#### 回執

*與傳送 AS4 訊息時請求回執相關的設定。*

| 設定       | 描述                                                                                                           |
| -------- | ------------------------------------------------------------------------------------------------------------ |
| **啟用回執** | 是否應回應傳入 AS4 訊息傳回回執，以及是否期望傳出 AS4 訊息傳回回執。                                                                      |
| **傳遞方式** | 回執應作為傳出 AS4 訊息的直接回應傳回（同步），還是稍後作為單獨連線的一部分傳回（非同步）。除非 AS4 訊息非常大（常見閾值為 50MB），處理訊息並傳遞同步回執可能會使連線逾時時間緊張，否則建議使用同步回執。 |

#### 交易夥伴憑證

*與交易夥伴提供的公開金鑰憑證相關的設定。*

| 設定            | 描述                                                                                                                                                    |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **加密憑證**      | 傳送訊息時用於 AS4 加密的公開金鑰憑證。該憑證必須與交易夥伴的私密金鑰憑證配對，交易夥伴在共享 AS4 配置詳細資訊時應提供公開金鑰憑證。                                                                               |
| **驗證憑證**      | 接收訊息時用於驗證 AS4 簽章的公開金鑰憑證。此欄位通常不需要；大多數 AS4 參與方使用同一私密金鑰憑證進行簽章和解密。如果未指定此值，應用程式會使用**加密憑證**驗證簽章。                                                            |
| **TLS 伺服器憑證** | 用於驗證 TLS/SSL 伺服器身份的公開金鑰憑證。僅當交易夥伴的 AS4 系統要求 HTTPS 而非 HTTP 時才需要。如果交易夥伴未提供 TLS 伺服器憑證，可以將此設定留空以允許底層 OS/JVM 執行憑證驗證，也可以設定為 `Any Certificate` 以無條件信任目標伺服器身份。 |

#### 業務協議詳情

*與 AS4 業務協議共享詳情相關的設定。配置前應與交易夥伴確認這些值。*

| 設定        | 描述                                                                                |
| --------- | --------------------------------------------------------------------------------- |
| **服務**    | 接受訊息的業務流程。                                                                        |
| **服務操作**  | 業務流程中執行的操作或活動。                                                                    |
| **服務型別**  | 為**服務**提供上下文的可選限定符。                                                               |
| **傳送方角色** | 訊息發起方的角色。根據夥伴協議，傳送和接收 AS4 請求時這些角色可以反轉或保持不變。此值用於生成的 AS4 SOAP 信封的 `PartyInfo` 元素。   |
| **接收方角色** | 訊息傳遞目標方的角色。根據夥伴協議，傳送和接收 AS4 請求時這些角色可以反轉或保持不變。此值用於生成的 AS4 SOAP 信封的 `PartyInfo` 元素。 |

### 自動化頁面 (Automation Tab)

#### 自動化設定

*與端口自動處理檔案相關的設定。*

| 設定              | 描述                                                                                                 |
| --------------- | -------------------------------------------------------------------------------------------------- |
| **傳送**          | 到達端口的檔案是否自動作為 AS4 訊息傳送。                                                                            |
| **重試間隔**        | 傳送失敗後重試前的分鐘數。當伺服器未回應傳送嘗試，或以否定回應表示未收到檔案時，會觸發重試。                                                     |
| **最大重試次數**      | 端口處理輸入檔案的最大次數。成功基於伺服器成功確認以及回執驗證（同步請求時）。如果設定為 0，端口會無限期重試檔案。                                         |
| **重發間隔**        | 未確認訊息重發前的分鐘數。當伺服器收到檔案但未在預期時間範圍內提供非同步回執時，會觸發重發。                                                     |
| **最大嘗試次數（非同步）** | 請求非同步回執時端口處理輸入檔案的最大次數。成功基於伺服器成功確認後在**重發間隔**內傳回非同步回執。如果未傳回伺服器成功確認，則改用**最大重試次數**。如果設定為 0，端口會無限期重發檔案。 |
| **接收**          | 端口是否應自動發出拉取請求以從交易夥伴接收訊息。                                                                           |
| **拉取間隔**        | 自動拉取請求之間的間隔。                                                                                       |
| **整點後分鍾數**      | 小時計劃的分鐘偏移量。僅在上方間隔設定為 *Hourly* 時適用。                                                                 |
| **時間**          | 應執行嘗試的一天中的時間。僅在上方間隔設定為 *Daily*、*Weekly* 或 *Monthly* 時適用。                                           |
| **日期**          | 應執行嘗試的日期。僅在上方間隔設定為 *Weekly* 或 *Monthly* 時適用。                                                       |
| **分鐘**          | 嘗試下載前等待的分鐘數。僅在上方間隔設定為 *Minute* 時適用。                                                                |
| **Cron 運算式**    | 表示 cron 運算式的五段字串，用於確定何時執行嘗試。僅在上方間隔設定為 *Advanced* 時適用。                                              |

#### 效能

<Performance />

### 通知索引標籤

<AlertsTab />

### SLA 索引標籤

<SlasTab />

### 高階頁面 (Advanced Tab)

#### 權杖身分驗證

*與使用和要求權杖身分驗證相關的設定。*

| 設定             | 描述                                                                       |
| -------------- | ------------------------------------------------------------------------ |
| **權杖身分驗證（接收）** | 傳入 AS4 訊息是否必須包含身分驗證權杖。如果啟用，傳入訊息必須包含與此選項下設定的**使用者名稱**和**密碼**欄位匹配的使用者名稱憑據。 |
| **權杖身分驗證（傳送）** | 傳出 AS4 訊息是否應包含身分驗證權杖。如果啟用，傳出訊息會包含與此選項下設定的**使用者名稱**和**密碼**欄位匹配的使用者名稱憑據。   |
| **密碼型別**       | 使用者名稱權杖應採用純文字還是加密摘要格式。                                                   |

#### 備用本地個人設定

*覆蓋此特定 AS4 端口在**個人設定**頁面上的 AS4 配置的設定。設定備用本地個人設定可為某些交易夥伴使用不同的本地憑證和識別碼。*

| 設定           | 描述                                       |
| ------------ | ---------------------------------------- |
| **參與方識別碼**   | 你的 AS4 識別碼。覆蓋個人設定頁面上的**參與方識別碼**。         |
| **參與方識別碼型別** | 你的 AS4 識別碼型別（可選）。覆蓋個人設定頁面上的**參與方識別碼型別**。 |
| **私密金鑰憑證**   | 用於解密傳入訊息和簽署傳出訊息的憑證。覆蓋個人設定頁面上的**私密金鑰憑證**。 |
| **憑證密碼**     | 存取本地私密金鑰憑證所需的密碼。                         |

#### TLS 用戶端身分驗證

*雙向 TLS 身分驗證時與用戶端身分驗證相關的設定。*

| 設定         | 描述                                               |
| ---------- | ------------------------------------------------ |
| **使用個人設定** | 是否使用個人設定頁面上配置的**私密金鑰憑證**作為 TLS 憑證進行用戶端身分驗證。      |
| **私密金鑰憑證** | TLS 用戶端身分驗證期間提供的私密金鑰憑證。僅當未使用個人設定頁面中的同一私密金鑰憑證時適用。 |
| **憑證密碼**   | 存取 TLS 用戶端憑證所需的密碼。                               |

#### 訊息屬性

一組以名稱-值對指定的自定義訊息屬性，將作為傳出訊息的一部分包含。

#### 其他設定

*未包含在先前類別中的設定。*

| 設定              | 描述                                                                                                                                            |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **協議參考 P-Mode** | 共享 AS4 協議的處理模式屬性。如果使用此項，請提供 `PMode.Id` 參數。                                                                                                    |
| **協議參考型別**      | 共享 AS4 協議的參考型別屬性。雙方應決定此值的語義。                                                                                                                  |
| **附加 XML 檔案**   | XML 有效負載應打包為 SOAP 訊息的 MIME 附件，還是直接包含在 SOAP 正文中。                                                                                               |
| **重複訊息操作**      | 當端口收到帶有之前見過的 Message Id 的 AS4 訊息時應如何表現。選項：**Continue**（像任何其他檔案一樣處理重複檔案）、**Ignore**（靜默忽略/丟棄入站檔案）、**Failure**（引發錯誤且不處理檔案）。                      |
| **重複間隔**        | 具有相同 Message Id 的訊息被視為重複訊息的分鐘數。如果設定為 0，Message Id 會一直儲存到伺服器重啟。                                                                                |
| **加密演算法**       | 如果需要訊息加密，要使用的加密演算法。                                                                                                                           |
| **拉取 URL**      | 拉取請求應傳送到的 URL 端點。僅當它與**交易夥伴 URL** 不同時才需要。                                                                                                     |
| **回執 URL**      | 回執應傳送到的 URL 端點。僅當它與**交易夥伴 URL** 不同時才需要。                                                                                                       |
| **安全權杖格式**      | 安全權杖（憑證引用）使用的格式。                                                                                                                              |
| **簽章演算法**       | 簽署傳出訊息時使用的演算法。相應回執會請求使用相同演算法。                                                                                                                 |
| **處理延遲**        | 對放置在**交易**索引標籤中的檔案延遲處理的時間（以秒為單位）。這是舊版設定。最佳實踐是[使用 File 端口](../flows/designing-a-flow#interacting-with-the-local-file-system)管理本地檔案系統，而不是使用此設定。 |
| **啟用的 TLS 協議**  | 建立傳出連線時支援的 TLS/SSL 協議清單。最佳實踐是僅使用 TLS 協議。一些過時的作業系統不支援 TLS 1.2。                                                                                 |

#### 代理設定

<CommonProxySettings />

#### 訊息

<Message />

#### 日誌

*管理日誌建立和儲存的設定。*

| 設定           | 描述                                                                                                                                                |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **日誌級別**     | 端口生成的日誌詳細程度。請求支援時，請將其設定為 **Debug**。                                                                                                               |
| **日誌子資料夾方案** | 指示端口根據所選間隔對 Logs 資料夾中的檔案進行分組。**Weekly** 選項（預設值）指示端口每週建立一個新子資料夾，並將該周的所有日誌儲存在該資料夾中。將此設定留空會使端口直接將所有日誌儲存在 Logs 資料夾中。對於處理大量交易的端口，使用子資料夾有助於保持日誌有序並提升效能。 |
| **日誌訊息**     | 勾選此項可使已處理檔案的日誌項目包含檔案本身的副本。如果停用此項，可能無法從**輸入**或**輸出**索引標籤下載檔案副本。                                                                                    |

#### 其他設定

<MiscConnector />

## 個人設定配置

AS4 個人設定包含用於向交易夥伴識別你的關鍵資訊。它在個人設定頁面的 AS4 索引標籤上配置。

首先，請指定以下資訊：

* 參與方識別碼
* 個人憑證

### 參與方識別碼

類似於電子郵件交換中的電子郵件地址，它標識 AS4 傳輸中的夥伴。

將**參與方識別碼**設定為有意義地標識你或組織的值。此處設定的值會在 {siteNameShort} 發起的 AS4 傳輸標頭中傳送。

參與方識別碼是在共享個人設定資訊時與交易夥伴交換的一項資訊。交易夥伴應在其 AS4 系統中使用此值，以便處理來自該識別碼的請求。

### 個人憑證

私密金鑰憑證用於簽署傳出訊息並解密傳入訊息。AS4 個人設定使用 PKCS#12 格式（.pfx 或 .p12 檔案）的私密金鑰憑證。

* 在**私密金鑰憑證**下拉式清單中點選**上傳憑證**，從磁碟選擇現有憑證。
* 點選**建立憑證**建立新的自簽章憑證。這會建立同名的新私密金鑰憑證和公開金鑰憑證（.cer 檔案）。

### 接收 URL

該值基於**設定 > 高階**中的**基本 URL** 和預設 {siteNameShort} 偵聽端點生成。

請與交易夥伴共享此值，以便他們可以成功向 {siteNameShort} 傳送 AS4 訊息。

## 交易夥伴設定

交易夥伴負責提供連線到其 AS4 端點所需的特定設定。每個 AS4 端口必須配置為單個交易夥伴關係。

以下 AS4 配置選項是必需的：

* 參與方識別碼
* 交易夥伴 URL
* 交易夥伴憑證
* 使用回執
* 服務和服務操作

### 參與方識別碼

交易夥伴提供其**參與方識別碼**，這是其個人設定中用於在 AS4 傳輸中標識組織的部分。

<Note>此值區分大小寫，因此配置新交易夥伴時，請確保大小寫正確。</Note>

### 交易夥伴 URL

**交易夥伴 URL** 是交易夥伴 AS4 系統偵聽傳入訊息的公共端點。從交易夥伴收到 URL 後，請使用 Web 瀏覽器測試該 URL，以檢測任何網路或連線問題。

在某些情況下，如果交易夥伴為推送 AS4 傳輸、拉取 AS4 傳輸和傳回非同步回執使用單獨的 URL，則可能提供多個 URL。請在[高階頁面](#高階頁面-advanced-tab)的**拉取 URL** 和**回執 URL** 下配置其他 URL。

### 交易夥伴憑證

每個 AS4 端口都必須配置目標交易夥伴的公開金鑰憑證。交易夥伴會提供與其交換 AS4 訊息所需的加密和驗證憑證。{siteNameShort} 接受 X.509 公開金鑰憑證（副檔名為 .cer、.der 或 .pem 的檔案）。

通常，交易夥伴會提供一個憑證，應在**加密憑證**欄位中配置該憑證。

如果交易夥伴提供多個憑證，他們必須闡明每個憑證的用途。如果夥伴提供完整憑證鏈（從商業憑證頒發機構取得），則只需配置葉憑證（鏈中的最後一個憑證）。有時，可能需要單獨的公開金鑰憑證來驗證夥伴的數字簽章。在這種情況下，請在[設定](#設定) > **交易夥伴憑證** > **驗證憑證**中設定簽章驗證憑證。

如果交易夥伴要求 TLS/SSL 連線，他們可以向你提供其 TLS 伺服器的公開金鑰憑證。應在 **TLS 伺服器憑證**下設定此憑證。或者，可以將此欄位設定為 <var>Any Certificate</var>，以隱式信任目標 TLS 伺服器的身份。

### 使用回執

請求回執可確保 AS4 訊息的不可否認性。我們強烈建議啟用**使用回執**欄位。請務必提前與交易夥伴就回執使用達成一致。

預設情況下，回執同步傳遞，這意味著它們會作為 AS4 訊息的直接回應傳回。非同步回執會稍後在單獨連線中傳遞。除非 AS4 訊息非常大，處理和傳遞同步回執可能會使連線逾時時間緊張，否則建議使用同步回執。

### 服務和服務操作

服務、服務操作和其他[業務協議詳情](#業務協議詳情)應與交易夥伴溝通。這些值有助於定義與交換的 AS4 訊息相關的業務邏輯，以及各方應如何解釋訊息。

### 從 SMP 匯入

如果交易夥伴具有服務中繼資料釋出者 (SMP) 配置檔案，可以透過點選[設定](#設定) > **交易夥伴資訊**中的**從 SMP 匯入**按鈕匯入這些設定。生成的提示需要用於取得 SMP 配置檔案的 SML 域、參與者 Id 和 Scheme，以及文件 Id 和 Scheme。端口設定會使用從 SMP 配置檔案讀取的值自動填充。

## 傳送和接收檔案

配置 AS4 個人設定和特定夥伴的 AS4 端口後，即可安全地傳送和接收檔案。

### 傳送檔案

在 AS4 端口中，輸入索引標籤顯示應傳送到目標交易夥伴的檔案。如果在[自動化頁面](#自動化頁面-automation-tab)上啟用了**傳送自動化**，到達端口輸入索引標籤的檔案會自動封裝並傳送。

**建立測試檔案**按鈕用於生成一系列簡單測試檔案，以傳送給交易夥伴。

### 重發和重試

當預期交易夥伴傳回非同步回執，但未能在**重發間隔**時長（預設為 60 分鐘）內傳回時，會觸發 AS4 重發。應用程式隨後嘗試重發傳輸。應用程式會持續重發訊息，直到收到回執或\*\*最大嘗試次數（非同步）\*\*用盡。

當來自交易夥伴的 HTTP 回應表明伺服器未收到傳輸（回應不是肯定的 200 OK 狀態）時，會觸發重試。這可能表示網路或連線問題，通常是暫時性的。應用程式會每隔**重試間隔**分鐘重試傳輸，直到收到傳輸或**最大重試次數**用盡。

### 接收檔案

在 AS4 端口中，輸出索引標籤顯示應用程式已接收並路由到該端口的檔案（基於傳入 AS4 訊息中的 AS4 識別碼）。展開每個檔案行可顯示該傳輸的可用日誌清單。

這些檔案可在端口輸出索引標籤中使用。如果端口連線到流程中的其他端口，檔案會自動從 AS4 端口的輸出索引標籤移動到流程中下一個端口的輸入索引標籤。

## 宏

<MacrosTable siteName={siteName} extraMacros={extraMacros} />

### 範例

<MacrosExamples siteName={siteName} extraMacros={extraMacros} />