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

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

> 例如：將金蝶云星空的審批表單同步到釘釘審批中，采購人員只需在金蝶發(fā)起采購申請(qǐng)單，單據(jù)信息將自動(dòng)同步到釘釘?shù)牟少徤暾?qǐng)審批，對(duì)應(yīng)審批人員在釘釘進(jìn)行便捷審批。

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

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

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

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

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

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

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

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

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

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

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

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

**注意：務(wù)必選擇當(dāng)前表格的 “唯一標(biāo)識(shí)字段”**

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

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

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

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

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

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

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

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

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

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

### 2.2、配置目標(biāo)源

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

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

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

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

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

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

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

### 2.4、配置字段映射

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

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

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

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

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

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

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

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

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

### 2.5、配置運(yùn)行方式

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

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

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

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

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