配置導入作業

Adobe Campaign可讓您將資料從一或多個檔案匯入至資料庫,格式為文字、CSV、TAB或XML。 這些檔案與表 (主要或連結) 相關聯,並且源檔的每個欄位與資料庫的欄位相關聯。

注意

您可以使用​Import a list​函式導入資料,而不將其與資料庫資料映射。 然後,資料便可透過​Read list​物件專用於工作流程中。 有關詳細資訊,請參見此頁面

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

建立新導入作業後,將顯示導入嚮導(請參閱建立導入和導出作業)。

注意

如果使用 IIS Web 伺服器,則可能需要配置以授權上載大檔案 (> 28 MB)。如需詳細資訊,請參閱本區段

源檔案

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

步驟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​模式中,元素未導入,但未保留錯誤跟蹤。 此模式可讓您優化性能。
重要

重複資料刪除僅在內存中執行。因此,具有重複資料刪除的匯入的大小是有限的。限制取決於幾個參數 (應用程序伺服器的容量,活動,金鑰中的欄位數等)。重複資料刪除的最大大小為 1,000,000 行。

重複資料刪除涉及源檔和資料庫中都存在的記錄。它僅涉及更新操作(即​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 步 - 匯入收件者時的附加步驟

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

注意

在僅匯入收件者時以及使用預設的 Adobe Campaign 收件者表 (nms:recipient) 時,將顯示此步驟。

  • 按一下​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​按鈕。

然後,您可以監視導入作業的執行(請參見監視作業執行)。

本頁內容

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now