## 數據同步介紹

數環通數據同步流程，可以將多個應用連接器之間的數據，通過簡單的配置即可實現數據自動同步，解決每次都要手動錄入數據的繁瑣。

> 例如：將金蝶云星空的審批表單同步到釘釘審批中，采購人員只需在金蝶發起采購申請單，單據信息將自動同步到釘釘的采購申請審批，對應審批人員在釘釘進行便捷審批。

此外，數環通還支持將多個應用連接器之間的數據源，同步至目標源。

## 一、創建數據同步

在流程列表或項目里，找到并選中 “數據同步” 標簽，然后點擊 “創建數據同步” 選項。

![](/media/202502/2025-02-17_104421_0548670.6251164119122505.png)

先給數據同步流程命名，再選擇保存的項目位置或者創建所屬自己的文件（同一項目內應用授權可互用）

![](/media/202502/2025-02-17_104523_6857240.422291171116723.png)

## 二、數據同步配置

### 2.1、配置數據源

1. 首先點擊右上角添加“數據源選項按鈕”

![](/media/202502/2025-02-17_104838_3954460.9267453255582457.png)

2. 進入數據源編輯頁面，按提示依次選擇應用、賬戶、操作，最后選定要同步的表單。選定表單后，下方會列出該表單包含所有字段的表格，勾選所需同步的字段就行。

![](/media/202401/image3_1706673001.png)

**注意：務必選擇當前表格的 “唯一標識字段”**

> 唯一標識字段極為關鍵，它必須保證在數據源里不存在重復值 ，以此防止數據沖突與混淆。就像每個商品都具有商品 ID 作為唯一標識符。商品從創建伊始，歷經修改、查詢直至刪除等一系列操作，都離不開這個 ID。如此一來，當用戶購買商品時，系統憑借這個唯一標識符，能夠迅速且精準地定位到對應的商品信息，進而確保數據處理既準確又可靠。

以及，選擇“最近更新字段”，一般為時間類型（創建時間/更新時間）；

> 最近更新標識字段：用于追蹤數據變更歷史與基于時間的數據檢索，記錄數據行最后修改或更新的時間戳 / 日期時間，便于快速檢索近期修改的數據行。如用戶信息表設有 “LastUpdated” 字段，用戶更新信息時，系統自動將該字段設為當前系統時間。

3. 當完成所有必選項目的配置，點擊 “確定”，成功完成配置，頁面會自動跳轉回數據源列表頁。在此處，你能夠預覽到剛才勾選的、即將用于同步的字段數據。

![](/media/202401/image4_1706673311.png)

4. 如果你存在多個數據源需同步，可再次點擊右上角添加數據源。要留意，當數據源達到 2 個或更多時，必須設置數據匹配字段 。這是為了讓不同數據源的數據能準確關聯，確保同步的準確性與邏輯性。

![](/media/202502/2025-02-17_110823_3581490.7750033343528951.png)

> 1. 數據匹配字段（Join to other Data source）的作用是把一個數據源與另一個數據源進行連接或整合，最終生成一個包含連接結果的新表。在數環通中，目前運用的是 Left Join（左連接）方式。這種左連接方式以左表作為主表，它會返回左表的全部記錄。然后，依據指定的連接條件，將右表中的記錄與左表記錄進行匹配。要是右表中不存在與左表記錄相匹配的記錄，那么在結果集中對應字段的值就會顯示為 NULL。

> 例如，假設有兩個表，一個是 Customers 表，里面包含客戶的詳細信息；另一個是 Orders 表，記錄著客戶的訂單信息。若要檢索出所有客戶的信息以及他們對應的訂單信息，就可以利用 Join 來連接這兩個表。具體連接條件可以設定為客戶 ID，也就是 Customers 表中的 customer_id 字段和 Orders 表中的 customer_id 字段相等。通過這樣的連接操作，就能獲取到整合后的客戶及訂單信息。

```sql
舉例：select * from  Customers as a LEFT JOIN orders AS B on  a.customer_id  = b.customer_id
```

若僅需同步單個數據源，那么此刻可直接點擊 “下一步”，隨即進入目標源的配置環節。

### 2.2、配置目標源

目標源是將前面配置好的數據源同步過來，根據提示依次選擇好應用——賬戶——最后選擇需要同步的表單即配置完成。

![](/media/202401/image6_1706680335.png)

### 2.3、配置同步規則

同步規則規定了數據源觸發數據同步的條件。在此，需先確定同步策略，目前有以下四種策略可供選擇：

1. 更新或增加：若目標源已存在某記錄，一旦數據源該記錄有更新，目標源也會隨之更新；若目標源不存在該記錄，當數據源有新增或更新操作時，目標源同樣會同步新增或更新。
2. 只增加：僅對目標源中不存在的記錄進行增加操作，現有記錄不會更新。
3. 只更新：僅對目標源已有的記錄執行更新，不會增加新記錄。
4. 只同步歷史記錄：僅同步過去特定時間段內數據源產生的數據記錄。
5. 在選定大的同步策略后，還能依據實際需求進一步設置同步條件。如此一來，數據會經過額外過濾，只有滿足所有條件的數據才會被同步至目標源。

同時，在大的同步策略基礎上，可以根據需求繼續增加同步條件的設置，這樣數據會再進行一層過濾，只有滿足條件的數據才會被同步到目標源里。

![](/media/202502/2025-02-17_132806_9373590.6109930754975652.png)

### 2.4、配置字段映射

在選定用于同步的應用以及相應規則之后，接下來必須開展字段映射工作。只有完成映射的字段，才會在數據同步過程中實現同步傳輸。

1. 首先需要設置數據源和目標源之間唯一標識的映射，系統可以通過這個唯一標識符快速準確地找到對應的數據信息進行同步。

![](/media/202401/image8_1706680660.png)

2.在數據源與目標源的下拉選項里，能夠看到之前選擇數據源和目標源時所勾選的待同步字段 ，將它們一一對應起來，就能完成映射配置。 這樣做能確保數據源的特定字段準確無誤地同步到目標源的相應字段，實現數據的精準傳輸與整合。

![](/media/202401/image9_1706680736.png)

3. 完成字段映射的選擇后，要是你還需要對字段數據進行處理，只需點擊每組映射字段右側的設置圖標 ，這樣就能打開數據處理窗口，以便進一步對數據進行調整和優化。
> 例如，將數據源的 age 字段 +1，這樣同步到目標源中的結果將會是 +1 后的數據。

![](/media/202401/image10_1706680833.png)

如果沒有你想使用的字段，可以構建自定義字段，點擊添加自定義字段，并定義字段類型與名稱。注意，自定義變量需要進行數據處理。

![](/media/202401/image11_1706680873.png)

### 2.5、配置運行方式

目前，數環通提供 5 種運行方式，分別為自動運行、手動運行、定時運行、間隔運行以及通過 CRON 表達式運行。不過，若同步策略設定為 “只同步歷史記錄” ，那么運行方式僅支持手動運行這一種。在完成上述各項配置后，點擊 “發布” 按鈕，即可完成整個數據同步流程的設置。

![](/media/202401/image12_1706680930.png)

## 三、數據同步流程發布

發布后會跳轉到流程詳情頁，點擊左側的步驟條可以快速切換預覽配置信息，點擊右上角可對流程狀態進行操作。

![](/media/202401/image13_1706680982.png)