匯入資料

Adobe Campaign 允許您以文字、CSV、TAB 或 XML 格式從一個或多個檔案將資料匯入資料庫。這些檔案與表 (主要或連結) 相關聯，並且源檔的每個欄位與資料庫的欄位相關聯。可以保存匯入配置以便重複使用，以便您可以計劃匯入任務以自動執行複制作業。

在影片中探索此功能

要匯入的資料的結構

在源檔中，每行與記錄重合。記錄中的資料由分隔符 (空格、製表符、字符等) 分隔。這意味著以行的形式檢索資料，並且每行與資料庫的欄位相關聯。

匯入精靈

匯入精靈允許您配置匯入，定義其選項 (例如資料轉換) 和啟動執行。它是一系列屏幕，其內容取決於匯入類型 (簡單或多個) 和操作員權限。

第 1 步 - 選擇匯入範本

啟動匯入精靈時，首先必須選擇範本。例如，要配置收到簡報的收件者的匯入，請按照以下步驟操作：

1. 選擇​Profiles and Targets > Job > Generic imports and exports​資料夾。

2. 點擊​新建，然後點擊​匯入​以建立匯入範本。

   

3. 按一下​Import template​欄位右側的箭頭以選擇模板，或按一下​Select link​以瀏覽樹。

   原生範本為​New text import。 不得修改此範本，但您可以根據您的要求復制它以配置新範本。預設情況下，導入模板保存在​Profiles and targets > Templates > Job templates​節點中。

4. 在​Label​欄位中輸入此匯入的名稱。 您可以添加描述。

5. 在相應欄位中選擇匯入類型。匯入有兩種可能類型：Simple import​僅匯入一個檔案，Multiple import​在單次執行中匯入多個檔案。

   對於多重導入，請從導入嚮導第一個螢幕的​Import type​下拉清單中選擇​Multiple import。

   

6. 按一下​Add，指定您要匯入的欄位。

   

   每次添加檔案時，都會顯示​File to import​嚮導的螢幕。 請參閱步驟2 —— 源檔案選擇一節，並遵循嚮導中的步驟將導入選項定義為簡單導入。

   注意

   多次匯入應僅滿足特定需求，不建議使用。

高級參數

Advanced parameters​連結可讓您存取下列選項：

• General 頁籤

  • Stop execution if there are too many rejects

    按照預設選擇此選項。如果要繼續執行匯入而不考慮拒絕次數，可以取消選擇它。按照預設，如果拒絕前100行，則停止執行。

  • Trace mode

    選擇此選項可追蹤每行的匯入執行情況。

  • Start the job in a detached process

    按照預設選擇此選項。它允許您分離匯入的執行，以便它不會影響資料庫中正在進行的其他作業。

  • Do not update enumerations

    選擇此選項可避免增補資料庫中的枚舉值清單。請參閱管理枚舉。

• Variables 頁籤

  您可以定義與可在查詢編輯器和計算欄位中存取的作業關聯的變數。若要建立變數，請按一下​Add​並使用變數編輯器。

  注意

  Variables​標籤僅供工作流程類型程式設計使用，且應僅由專家使用者設定。

第 2 步 - 源檔選擇

源檔可以是文字格式 (txt、csv、tab、固定行) 或 xml。

預設情況下，選擇​Upload file on the server。 按一下​Local file​欄位右側的資料夾以瀏覽本地磁碟並選擇要導入的檔案。 您可以取消選擇此選項以輸入存取路徑以及要在伺服器上匯入的檔案名稱。

指定檔案後，可通過按一下​Auto-detect format​在窗口的下部查看其資料。 此預覽顯示源檔案的前 200 行。

使用此視圖上方提供的選項配置匯入。通過這些選項定義的參數將傳輸到預覽中。可以使用以下選項：

• Click here to change the file format… 可讓您檢查檔案格式並微調設定。
• Update on server… 可讓您將本機檔案傳輸至伺服器。此選項僅在選擇​Upload file on the server​時可用。
• Download 只有在伺服器上已上傳檔案時，才可使用。
• Auto-detect format 用於重新初始化資料源的格式。此選項可讓您將原始格式重新套用至透過​Click here to change the file format…​選項格式化的資料。
• Advanced parameters​連結可讓您篩選來源資料並存取進階選項。 在此屏幕中，您可以選擇僅匯入部分檔案。您還可以定義篩選器，例如，根據相應行的值僅匯入「潛在客戶」或「客戶」類型的用戶。這些選項僅供專業 JavaScript 用戶使用。

更改檔案格式

Click here to change the file format…​選項可讓您格式化來源檔案的資料，尤其是指定欄分隔符和每個欄位的資料類型。 此配置通過以下視窗執行：

此步驟允許您描述應如何讀取檔案欄位的值。例如，在日期的情況下，日期或日期+時間資料可以與某種格式 (dd/mm/yyyy、mm/dd/yy 等) 相關聯。如果輸入資料與預期格式不匹配，則在匯入期間將發生拒絕。

您可以在視窗下部的預覽區欄位中查看配置結果。

按一下​OK​以儲存格式，然後按一下​Next​以顯示下一步。

第 3 步 - 欄位對應

然後，您必須選擇目標架構並將每行的資料對應到資料庫中的欄位。

• Destination schema​欄位可讓您選取要匯入資料的架構。 此資訊是強制性的。按一下​Select link​表徵圖以選擇一個現有方案。 按一下​Edit link​以顯示選取表格的內容。

• 中央表顯示源檔中定義的所有欄位。選擇要匯入的欄位以將目標檔案與它們相關聯。可以手動或自動對應這些欄位。

  要手動對應欄位，請點擊核取方塊以選擇源欄位，然後點擊第二行以激活與所選欄位對應的儲存格。接著，按一下​Edit expression​圖示以顯示目前表格的所有欄位。 選擇目標欄位，然後按一下​OK​以驗證映射。

  要自動關聯源欄位和目標欄位，請按一下欄位清單右側的​Guess the destination fields​表徵圖。 如果需要，可以修改建議的欄位。

  注意

  在繼續執行下一步之前，必須始終驗證此操作的結果。

• 您可以將轉換應用於匯入的欄位。要執行此操作，請按一下與相關欄位相關的​Transformation​列的單元格，然後選擇要應用的轉換。

  

  注意

  轉換在匯入時應用。但是，如果已定義了對目標欄位的約束 (在上面的示例中為 @lastname 欄位)，則這些約束優先。

• 您可以使用位於中央表右側的相應圖示添加計算欄位。通過計算欄位，您可以執行複雜的轉換，添加虛擬行或合併多行的資料。有關各種可能性的詳細資訊，請參見以下部分。

計算欄位

計算欄位是添加到源檔並從其他行計算所得到的新行。然後，計算欄位可以與 Adobe Campaign 資料庫的欄位相關聯。但是，在計算欄位中無法進行對帳操作。

有四種類型的計算欄位：

• Fixed string:對於源檔案的所有行，計算欄位的值都相同。允許您設置插入或更新的記錄的欄位值。例如，您可以為所有匯入的記錄將標記設置為「是」。

• String with JavaScript tags:計算欄位的值是包含JavaScript指令的字元字串。

• JavaScript expression:計算欄位的值是JavaScript函式評估的結果。返回的值可以是數字、日期等。

• Enumeration:欄位的值根據源檔案中包含的值來分配。編輯器允許您指定源行並輸入枚舉值清單，如以下示例所示：

  

  使用​Preview​頁籤可以查看已定義配置的結果。 在這裡，Subscription​欄已新增。 該值計算自​狀態​欄位。

  

第 4 步 – 調解

匯入精靈的調解步驟允許您定義將檔案中的資料與資料庫中的現有資料進行調解的模式，並設置檔案資料和資料庫資料之間的優先級規則。配置視窗如下所示：

屏幕的中央部分包含一個樹結構，其中包含要匯入資料的 Adobe Campaign 資料庫的欄位和表。

每個節點 (表或欄位) 都有特殊選項。點擊清單中的相關節點時，其參數和簡要說明將顯示在下方。為每個元素定義的行為顯示在相應的​Behavior​列中。

操作類型

對於匯入相關的每個表，必須定義操作類型。以下操作可用於資料庫的主要元素：

• Update or insertion:如果記錄存在於資料庫中，則更新該記錄，如果不存在，則建立該記錄。
• Insertion:將記錄插入資料庫。
• Update:僅更新現有記錄（忽略其他記錄）。
• Reconciliation only:在資料庫中查找記錄，但不執行更新。例如，允許您根據檔案行關聯要匯入的收件者資料夾，而不更新資料夾中的資料。
• Deletion:可讓您銷毀資料庫中的記錄。

匯入所涉及的表中的每個欄位都有以下選項：

• Update (empty) if source value is empty:如果源檔案中的欄位為空，則在更新時，欄位中的值將刪除資料庫值。否則，保留資料庫欄位。
• Update only if destination is empty:源檔案中的值不會覆蓋資料庫欄位中的值，除非資料庫欄位為空。在這種情況下，它採用源檔的值。
• Update the field only when the record is inserted:在更新或插入操作期間，將只導入新的源檔案記錄。

調解金鑰

必須至少填寫一個調解金鑰才能管理重複資料刪除。

調解金鑰是用於標識記錄的一組欄位。例如，要匯入收件者，調解金鑰可以是帳號，「電子郵件」欄位或「姓氏、名字、公司」欄位等。

在這種情況下，要查明檔案的某一行是否與資料庫中的現有收件者匹配，匯入引擎會將該檔案的值與該鍵的所有欄位的資料庫值進行比較。當欄位特定於記錄時，可以執行源資料和目標資料之間的精細比較，從而保證匯入後資料的完整性。可以為同一個表填寫第二個調解金鑰；它用於第一個金鑰為空的行。

避免選擇在匯入期間可能被修改的欄位；如果發生這種情況，引擎可以建立其他記錄。

重複資料刪除

Management of doubles​欄位可讓您配置重複資料消除。 重複資料刪除涉及​在源檔中​多次出現的記錄 (或多檔案匯入時的源檔)，即調解金鑰的欄位相同的行。

• 在​Update​模式（預設模式）中的重複管理不執行重複資料消除。 因此，最後一條記錄具有優先權 (因為它更新了先前記錄的資料)。在此模式下不執行重複計數。
• 在​Ignore​模式或​Reject entity​中進行重複管理會從導入中排除重複管理。 在這種情況下，不會匯入任何記錄。
• 在​Reject entity​模式中，元素不會匯入，而匯入記錄檔中會產生錯誤。
• 在​Ignore​模式中，元素未導入，但未保留錯誤跟蹤。 此模式可讓您優化性能。

重複資料刪除涉及源檔和資料庫中都存在的記錄。它僅涉及更新操作(即​Update and insertion​或​Update)。 Duplicate management​選項可讓您更新或忽略記錄（如果記錄同時位於源檔案和資料庫中）。 Update or insert based on origin​選項屬於可選模組，不能用於標準上下文。

選項​Reject​和​Ignore​如上所示。

發生錯誤時的行為

大多數資料傳輸操作會產生各種類型的錯誤 (不一致的行格式，無效的電子郵件地址等)。匯入引擎生成的所有錯誤和所有警告都將儲存並連結到匯入執行個體。

您可以透過​Rejects​標籤來檢視這些拒絕的詳細資訊。

有兩種類型的拒絕（類型顯示在​Connector​列中）:

• 拒絕文字連接器涉及在處理檔案行時發生的錯誤 (計算欄位、資料分析等)。在這種情況下，如果發生錯誤，則始終拒絕整行。
• 資料庫連接器拒絕涉及資料調解或寫入資料庫期間發生的錯誤。在匯入到多個表的情況下，拒絕只涉及記錄的一部分 (例如，對於收件者和相關事件的匯入，錯誤可以阻止更新事件而不拒絕接收者)。

在資料調解頁面中，您可以按欄位和逐個表定義所需的錯誤管理類型欄位。

• Ignore and log a warning:除了生成錯誤的欄位外，所有欄位都將導入資料庫。

• Reject parent element:記錄的整行被拒絕，不僅是導致錯誤的欄位。

• Reject all elements:導入停止，並拒絕記錄的所有元素。

  

匯入執行個體的拒絕屏幕中的樹結構指示哪些欄位被拒絕以及錯誤發生的位置。

您可以通過​Export rejects​表徵圖生成包含這些記錄的檔案：

第 5 步 - 匯入收件者時的附加步驟

匯入精靈的下一步允許您選擇或建立將匯入資料的資料夾，自動將匯入的收件者對應於 (新的或現有的) 清單，並將收件者訂閱到服務。

• 按一下​Edit​連結以選擇要與收件人關聯或預訂的資料夾、清單或服務。

  1. 匯入到資料夾中

     Import into a folder​區段的​Edit…​連結可讓您選擇或建立要將收件者匯入的資料夾。 按照預設，如果未定義分區，則會將資料匯入到操作員的預設資料夾中。

     注意

     操作員的預設資料夾是操作員具有寫存取權限的第一個資料夾。請參閱資料夾存取管理。

     要選擇導入資料夾，請按一下​Folder​欄位右側的箭頭，然後選擇相關資料夾。 您也可以使用​Select link​表徵圖在新窗口中顯示樹或建立新資料夾。

     

     要建立新資料夾，請選擇要從中添加資料夾的節點，然後按滑鼠右鍵。選取 Create a new ‘Recipients’ folder。

     

     該資料夾添加到當前節點下方。輸入新資料夾的名稱，按一下Enter以確認，然後按一下​OK。

     

  2. 與清單相關聯

     Add recipients to a list​區段中的​Edit…​連結可讓您選擇或建立要將收件者匯入的清單。

     

     您可以按一下​Select link，然後按一下​Create，為這些收件者建立新清單。 建立和管理清單在建立和管理清單中顯示。

     

     您可以決定將收件者添加到清單中已存在的收件者，或者使用新收件者重新建立清單。在這種情況下，如果清單已包含收件者，則它們將被刪除並由匯入的收件者替換。

  3. 訂閱服務

     要將所有導入的收件人預訂到資訊服務，請按一下​Subscribe recipients to a service​部分的​Edit…​連結，以選擇或建立收件人將預訂的資訊服務。 您可以選擇​Send a confirmation message​選項：此訊息的內容是在與訂閱服務相關的傳送範本中定義。

     

     您可以按一下​Select link，然後按一下​Create​圖示，為這些收件者建立新服務。 本節介紹了資訊服務的管理。

• 使用​Origin​欄位，將收件者來源的相關資訊新增至其描述檔。 此資訊在多重匯入的框架內特別有用。

按一下​Next​以驗證此步驟並顯示下列步驟。

第 6 步 - 啟動匯入

精靈的最後一步允許您啟動資料匯入。要執行此操作，請按一下​Start​按鈕。

工作狀態

作業狀態表示作業的當前狀態。每個狀態都由一個特殊的圖示和標籤表示。此資訊顯示在作業清單中。狀態及其圖示如下：

• 正在編輯

  正在建立工作。

• 正在執行

  這項工作正在執行。

• 取消

  按一下​Cancel​按鈕：正在進行的作業被取消。

• 取消正在進行中

  取消命令已接收並且作業正在取消。

• 暫停進行中

  按一下​Pause:工作正在暫停。

• 已暫停

  按一下​Pause:工作暫停。 按一下​Start​可重新啟動它。

• 已完成

  執行作業已完成。

• 完成出現錯誤

  由於技術錯誤，該作業未執行。

• 伺服器正在關閉

  正在進行的作業因 Adobe Campaign 伺服器已關閉而中斷。

一般匯入示例

範例：從收件者清單匯入

要從清單概述建立和提供收件者清單，請應用以下步驟：

1. 建立清單

   • 按一下Adobe Campaign首頁​Profiles and targets​功能表中的​Lists​連結。
   • 按一下​Create ，然後按一下​Import a list​按鈕。

2. 選擇要匯入的檔案

   按一下​Local file​欄位右側的資料夾，並選取包含要匯入之清單的檔案。

   

3. 清單名稱和儲存

   輸入清單的名稱，然後選擇應保存的目錄。

   

4. 啟動匯入

   按一下​Next ，然後按一下​Start​開始導入清單。

   

示例：從文字檔中匯入新記錄

要將儲存在文字檔中的新收件者設定檔匯入 Adobe Campaign 資料庫，請使用以下步驟：

1. 選擇範本

   • 從Adobe Campaign首頁，按一下​Profiles and targets​連結，然後按一下​Jobs。 在作業清單的上方，按一下​New import。
   • 依預設保留​New text import​範本。
   • 更改標籤和描述。
   • 選取 Simple import。
   • 保留預設作業資料夾。
   • 按一下​Advanced parameters​並選擇​Tracking mode​選項，以查看執行過程中導入的詳細資訊。

2. 選擇要匯入的檔案

   按一下​Local file​欄位右側的資料夾，然後選取您要匯入的檔案。

   

3. 關聯欄位

   按一下​Guess the destination fields​表徵圖可自動映射源和目標方案。 在按一下​Next​之前，請查看此窗口中的資訊。

   

4. 調解

   • 轉到​收件者 (nms:recipient) 表。

   • 選擇​Insertion​操作，並將預設值保留在其它欄位中。

     

5. 匯入收件者

   • 如有必要，請為要匯入的記錄指定一個資料夾。

     

6. 啟動匯入

   • 按一下 Start。

     在編輯器的中心區欄位，您可以檢查匯入操作是否成功並查看已處理的記錄數。

     

     Tracking​模式可讓您追蹤來源檔案中每個記錄的匯入詳細資訊。 若要這麼做，請在首頁按一下​Profiles and Targets，然後按一下​Processes，選取相關的匯入，並查看​General、Journal​和​Rejects​標籤。

     • 檢查匯入進度

       

     • 處理每條記錄的查看

       

範例：更新並插入收件者

我們希望更新資料庫中的現有記錄，並從文字檔中建立新記錄。以下是該過程的示例：

1. 選擇範本

   重複上面示例 2 中描述的步驟。

2. 要匯入的檔案

   選擇要匯入的檔案。

   在我們的示例中，檔案第一行的概述顯示該檔案包含三個記錄的更新和記錄的建立。

   

3. 關聯欄位

   應用上面示例 2 中的過程。

4. 調解

   • 依預設將​Update or insert​保持選取狀態。

   • 將選項​Management of duplicates​保留在​Update​模式中，以便使用文本檔案中的資料修改資料庫中的現有記錄。

   • 選擇​Birth date、Name​和​Company​欄位，並為其分配協調密鑰。

     

5. 啟動匯入

   • 按一下 Start。

     在追蹤視窗中，您可以檢查匯入是否成功並查看已處理的記錄數。

     

   • 查看收件者表以檢查此操作已修改記錄。

     

範例：使用外部檔案的值豐富值

我們希望從文字檔中修改資料庫表中的某些欄位，優先考慮資料庫中包含的值。

在此示例中，您可以看到文字檔中的某些欄位具有值，而資料庫中的相應欄位為空。其他欄位包含與資料庫中包含的值不同的值。

• 要匯入的文字檔的內容。

  

• 匯入前的資料庫狀態

  

應用以下步驟：

1. 選擇範本

   應用上面示例 2 中的過程。

2. 要匯入的檔案

   選擇要匯入的檔案。

3. 關聯欄位

   應用上面示例 2 中的過程。

   在預覽檔案的第一行時，您可以看到該檔案包含某些記錄的更新。

4. 調解

   • 轉到表並選擇​Update​操作。

   • 為​Management of doubles​欄位選擇​Reject entity​選項。

   • 將選項​Management of duplicates​保留在​Update​模式中，以便使用文本檔案中的資料修改資料庫中的現有記錄。

   • 將游標置於​Last name (@lastName)​節點上，然後選擇​Update only if destination is empty​選項。

   • 對​Company (@company)​節點重複此操作。

   • 為​Birth date、E-mail​和​First name​欄位分配協調密鑰。

     

5. 啟動匯入

   按一下 Start。

   查看收件者表以檢查匯入已修改記錄。

   

   只有空值才被文字檔中的值替換，但資料庫中的現有值未被匯入檔案中的值覆寫。

範例：更新並豐富外部檔案中的值

我們希望使用文字檔修改資料庫表中的某些欄位，優先套用文字檔中包含的值。

在此示例中，您將看到文字檔中的某些欄位具有空值，而資料庫中的相應欄位不為空。其他欄位包含與資料庫中的值不同的值。

• 要匯入的文字檔的內容。

  

• 匯入前的資料庫狀態

  

1. 選擇範本

   應用上面示例 2 中的過程。

2. 要匯入的檔案

   選擇要匯入的檔案。

   在預覽檔案的第一行時，您可以看到該檔案包含空欄位和某些記錄的更新。

3. 關聯欄位

   應用上面示例 2 中的過程。

4. 調解

   • 轉到表並選擇​Update。

   • 為​Management of doubles​欄位選擇​Reject entity​選項。

   • 將​Management of duplicates​選項保留在​Update​模式下，以便使用文本檔案中的資料修改資料庫中的現有記錄。

   • 將游標置於​Account number (@account)​節點上，然後選擇​Take empty values into account​選項。

   • 選擇​Birth date、E-mail​和​First name​欄位，並為其分配協調密鑰。

     

5. 啟動匯入

   • 按一下 Start。

   • 查看收件者表以檢查操作已修改記錄。

     

     空文字檔的值已覆寫資料庫中的值。資料庫中的現有值已更新為導入檔案中的值，與步驟4中為複製項選擇的​Update​選項保持一致。

從工作流程匯入資料

工作流程可以用來自動執行某些匯入過程。無論是從本地檔案還是從 SFTP 匯入資料，都可以使用工作流程來標準化資料管理過程。

要了解有關從工作流程匯入資料的更多資訊，請參見本節。