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

# SharePoint Configuration

> 配置 SharePoint 端口，用於在知行之橋中傳送和接收檔案。

建立與 SharePoint 的連線後，以下部分將幫助你配置端口，以便傳送和接收檔案。

## 端口配置

本節包含所有可配置的端口屬性。

### 設定索引標籤

#### 配置

有關如何建立 SharePoint 連線的詳細說明，請參閱 [SharePoint 連線設定](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/connectors/sharepoint/sharepoint.md)。

#### 傳送配置

與上傳到遠端儲存相關的設定。

| 設定 | 描述 |
| - | - |
| 遠端資料夾 | 端口處理的檔案會上傳到此資料夾。將滑鼠懸停在該欄位上可顯示支援的宏清單。 |
| 覆蓋 | 是否覆蓋或跳過現有檔案。 |

#### 接收配置

與從遠端儲存下載相關的設定。

| 設定 | 描述 |
| - | - |
| 遠端資料夾 | 從中下載檔案的遠端資料夾。使用逗號分隔的清單指定多個路徑。 |
| 檔案掩碼 | 用於確定應下載 **遠端路徑** 中哪些檔案的 glob 模式（例如，`*.txt`）。 |
| 刪除 | 選中此項可從遠端儲存中刪除成功下載的檔案。 |

#### 快取

與多次下載之間快取和比較檔案相關的設定。

| 設定 | 描述 |
| - | - |
| 檔案大小比較 | 選中此項可記錄已下載檔案的名稱和大小。除非檔案大小與上次下載不同，否則會跳過之前下載過的檔案。 |
| 時間戳比較 | 選中此項可記錄已下載檔案的名稱和上次修改時間戳。除非時間戳與上次下載不同，否則會跳過之前下載過的檔案。 |

> [!NOTE]
>
> 知行之橋會自動清理資源快取。此過程在每次接收週期的後臺執行，刪除遠端伺服器上已不存在的檔案對應的過期快取項目。這使得快取大小始終保持在可管理範圍內，無需任何手動操作。
>
> 預設情況下，檔案保留 30 天，但您可以在**進階**索引標籤的**其他設定**欄位中使用 `ResourceCacheRetentionDays` 設定來調整保留時間以適應您的環境。例如，`ResourceCacheRetentionDays=15` 表示檔案保留 15 天后將被刪除。
>
> 啟用快取時，檔名不區分大小寫。例如，端口無法區分 `TEST.TXT` 和 `test.txt`。

### 進階選項卡

#### 進階設定

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

| 設定 | 描述 |
| - | - |
| 遞迴遠端子目錄 | 是否下載目標遠端路徑子資料夾中的檔案。 |
| 分塊上傳配置 | 是否使用 SharePoint 上傳會話以分塊方式上傳大檔案（大於 250MB 的檔案需要此功能）。 |
| 分塊大小 | 上傳大檔案時的分塊大小（以 MB 為單位）。最小值為 1MB，預設值為 10MB。 |
| 接收過濾器 | 用於確定應下載哪些檔案的 glob 模式過濾器。你可以使用負模式來指示不應下載的檔案（例如，`-*.tmp`）。當需要多個 **檔案掩碼** 模式時，請使用此設定。多個模式可以用逗號分隔；除非找到完全匹配，否則後面的過濾器優先。 |
| 本地檔案方案 | 指示端口根據所選間隔在本地資料夾中對檔案進行分組。 |
| 處理延遲 | 端口處理檔案之前等待的時間（以秒為單位）。 |

#### 其他

| 設定 | 描述 |
| - | - |
| 逾時 | 伺服器在擲回逾時錯誤之前等待連線回應的時間長度（以秒為單位）。 |

#### 訊息

> [!NOTE]
>
> **儲存至 Sent 資料夾**和**Sent 資料夾方案**設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇**顯示成功路徑**，然後將成功路徑連線到[File 端口](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/connectors/file.md)。

| 設定 | 描述 |
| - | - |
| **儲存至 Sent 資料夾**（已棄用） | 將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。 |
| **Sent 資料夾方案**（已棄用） | 按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用**儲存至 Sent 資料夾**時適用。 |

#### 日誌

| 設定 | 描述 |
| - | - |
| 日誌級別 | 端口生成日誌的詳細程度。請求支援時，請將其設定為 **Debug**。 |
| 日誌子資料夾方案 | 指示端口根據所選間隔在 Logs 資料夾中對檔案進行分組。**Weekly** 選項會指示端口每週建立一個新的子資料夾。 |
| 記錄訊息 | 選中此項可使已處理檔案的日誌項目包含檔案本身的副本。 |

#### 其它設定

| 設定 | 描述 |
| - | - |
| 其它設定 | 允許你使用分號分隔的清單配置隱藏的端口設定（例如，`setting1=value1;setting2=value2`）。正常的端口使用場景和功能不應需要使用這些設定。 |

### 自動化索引標籤

#### 自動化設定

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

| 設定 | 描述 |
| - | - |
| 傳送 | 到達端口的檔案是否自動上傳。 |
| 重試間隔 | 重試失敗上傳之前的時間量。 |
| 最大嘗試次數 | 端口處理輸入檔案的最大次數。如果設定為 0，則會無限期重試。 |
| 接收 | 端口是否應自動輪詢遠端下載路徑以查詢要下載的檔案。 |
| 間隔 | 自動下載嘗試之間的時間間隔。 |
| 整點後的分鐘數 | 小時計劃的分鐘偏移量。僅當間隔為“每小時”時適用。例如，如果此值設定為 5，自動化服務會在 1:05、2:05、3:05 等時間下載。 |
| 時間 | 嘗試執行的具體時間。僅當間隔為“每天”、“每週”或“每月”時適用。 |
| 日期 | 嘗試執行的日期。僅當間隔為“每週”或“每月”時適用。 |
| 分鐘 | 等待的分鐘數。僅當間隔為“分鐘”時適用。 |
| Cron 運算式 | 五段式 cron 運算式。僅當間隔為“進階”時適用。 |

#### 效能

| 設定 | 描述 |
| - | - |
| 最大工作執行緒數 | 從執行緒池中消耗的最大工作執行緒數。 |
| 最大檔案數 | 每個執行緒傳送的最大檔案數。 |

### 警示索引標籤

*與配置通知相關的設定。*

在執行服務級別協議 (SLA) 之前，需要設定電子郵件通知以接收通知。預設情況下，知行之桥 使用 [通知](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/alerts.md) 索引標籤上的全域設定。要為此端口使用其他設定，請啟用 **覆蓋全域設定**。

預設情況下，錯誤通知處於啟用狀態，這意味著每當出現錯誤時都會傳送電子郵件。要關閉錯誤通知，請取消選中 **啟用** 核取方塊。

輸入 **主題**（必填）。勾選**允許在主題中使用 ArcScript**，即可在**主題**欄位中使用 ArcScript。選中後會顯示 **ArcScript 編輯器**按鈕（![ArcScript 編輯器按鈕](https://docs.kasoftware.com/26.4/images/rest_arcscript_editor.png)）。

（可選）輸入以逗號分隔的**收件人**電子郵件地址清單。

### SLA 索引標籤

*與配置服務級別協議 (SLA) 相關的設定。*

SLA 允許配置預期流程中端口傳送或接收的資料量，並設定預期達到該資料量的時間範圍。當 SLA 未達到時，知行之桥 會傳送電子郵件警告使用者，並將 SLA 標記為 *存在風險*，這意味著如果 SLA 未能儘快達到，則會被標記為 *已違反*。這讓使用者有機會介入並確定 SLA 未達到的原因，並採取適當的措施。如果在風險時間段結束時仍未達到 SLA，則會將 SLA 標記為已違反，並再次通知使用者。

SLA 轉換為 *存在風險* 或 *已違反* 狀態時，也會寫入[應用程式日誌](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/activity.md#应用程序日志)，這意味著應用程式效能監控 (APM) 和日誌擷取工具也可以針對這些狀態發出警示。

要定義 SLA，請啟用 **預期資料量**，然後點選 **設定** 索引標籤。

![SLA Empty](https://docs.kasoftware.com/26.4/images/sla_empty.png)
<ul><li>如果端口具有單獨的傳送和接收操作，請使用選項按鈕指定 SLA 適用的方向。</li>
<li>在視窗的 **預計至少** 部分中：
<ul><li>設定預計處理的最小交易數量（交易量）</li>
<li>使用 **每個** 欄位指定時間範圍</li>
<li>指示 SLA 生效的時間。如果選擇 **開始於**，請填寫日期和時間欄位。</li>
<li>勾選希望 SLA 生效的星期幾對應的核取方塊。如有必要，請使用下拉功能表選擇 **每天**。</li></ul></li>
<li>在視窗的 **將狀態設定為“有風險”** 部分中，指定應將 SLA 標記為有風險的時間。
<ul><li>預設情況下，只有在違反 SLA 的情況下才會傳送通知。要更改此設定，請勾選 **傳送“有風險”通知**。</li></ul></li></ul>

以下範例顯示了為端口配置的 SLA，該端口預計在週一至週五每天接收 1000 個檔案。如果尚未收到 1000 個檔案，則會在時間段結束前 1 小時傳送風險通知。

![SLA Configuration Example](https://docs.kasoftware.com/26.4/images/sla_defined.png)

> [!NOTE]
>
> 如果有必要，可以關閉 SLA 通知。這在維護視窗期間非常有用。點選導覽列上的 **設定**，然後跳轉到 **通知 > 通用通知**。點選平板和鉛筆圖示進行編輯，並取消勾選 **SLA 通知** 設定。

## 傳送和接收

### 傳送檔案到 SharePoint

要傳送檔案，請將 **系統設定** 頁面中 [傳送配置](#傳送配置) 部分的 **遠端資料夾** 設定為檔案應上傳到的資料夾。每個 SharePoint 端口都會上傳到單個資料夾位置。

使用 **覆蓋遠端檔案** 選項指定是否應覆蓋或跳過容器中已存在的檔案。

配置完成後，放置在端口 **交易** 索引標籤中的檔案會上傳到遠端儲存。如果啟用了 **傳送自動化**，上傳會自動進行；否則，你可以從“交易”索引標籤傳送單個檔案。

### 從 SharePoint 接收檔案

要接收檔案，請將 **系統設定** 頁面中 [接收配置](#接收配置) 部分的 **遠端資料夾** 設定為應下載檔案的資料夾。使用逗號分隔的清單指定多個資料夾。

使用 **檔案掩碼** 設定 glob 過濾器（例如 `*.txt`），將下載限制為與過濾器匹配的檔案。要指定多個過濾器，請使用 [進階選項卡](#進階選項卡) 上的 **接收過濾器** 選項。

使用 **刪除** 指定是否應從遠端儲存中移除成功下載的檔案。

## 宏

| 宏 | 描述 |
| - | - |
| ConnectorID | 端口的端口 ID。 |
| Ext | 檔案的副檔名（例如，`xml`、`csv`）。 |
| Filename | 訊息的原始檔名。 |
| FilenameNoExt | 訊息的原始檔名，不包含副檔名。 |
| MessageId | 分配給訊息的唯一識別碼。 |
| RegexFilename | 基於原始檔名上的規則運算式派生出的檔名。 |
| Header | 按名稱引用的訊息標頭中的值。 |
| LongDate | 長格式的當前日期/時間。 |
| ShortDate | 短格式的當前日期/時間。 |
| DateFormat | 自定義格式的當前日期/時間。 |
| Vault | 按名稱引用的 vault 項目中的值。 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.