## 數(shù)據(jù)同步介紹

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

> 例如：將金蝶云星空的審批表單同步到釘釘審批中，采購人員只需在金蝶發(fā)起采購申請單，單據(jù)信息將自動同步到釘釘?shù)牟少徤暾垖徟瑢獙徟藛T在釘釘進行便捷審批。

此外，數(shù)環(huán)通還支持將多個應用連接器之間的數(shù)據(jù)源，同步至目標源。

## 一、創(chuàng)建數(shù)據(jù)同步

在流程列表或項目里，找到并選中 “數(shù)據(jù)同步” 標簽，然后點擊 “創(chuàng)建數(shù)據(jù)同步” 選項。

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

先給數(shù)據(jù)同步流程命名，再選擇保存的項目位置或者創(chuàng)建所屬自己的文件（同一項目內(nèi)應用授權(quán)可互用）

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

## 二、數(shù)據(jù)同步配置

### 2.1、配置數(shù)據(jù)源

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

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

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

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

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

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

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

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

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

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

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

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

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

> 例如，假設(shè)有兩個表，一個是 Customers 表，里面包含客戶的詳細信息；另一個是 Orders 表，記錄著客戶的訂單信息。若要檢索出所有客戶的信息以及他們對應的訂單信息，就可以利用 Join 來連接這兩個表。具體連接條件可以設(shè)定為客戶 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
```

若僅需同步單個數(shù)據(jù)源，那么此刻可直接點擊 “下一步”，隨即進入目標源的配置環(huán)節(jié)。

### 2.2、配置目標源

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

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

### 2.3、配置同步規(guī)則

同步規(guī)則規(guī)定了數(shù)據(jù)源觸發(fā)數(shù)據(jù)同步的條件。在此，需先確定同步策略，目前有以下四種策略可供選擇：

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

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

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

### 2.4、配置字段映射

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

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

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

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

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

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

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

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

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

### 2.5、配置運行方式

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

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

## 三、數(shù)據(jù)同步流程發(fā)布

發(fā)布后會跳轉(zhuǎn)到流程詳情頁，點擊左側(cè)的步驟條可以快速切換預覽配置信息，點擊右上角可對流程狀態(tài)進行操作。

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