使用案例

以下使用案例說明如何使用工作流程中的參數呼叫工作流程。

目標是從含有外部參數的API呼叫觸發工作流程。此工作流程會從檔案將資料載入至您的資料庫，並建立相關的對象。建立對象後，將觸發第二個工作流程，以傳送以API呼叫中定義之外部參數個人化的訊息。

若要執行此使用案例，您必須執行下列動作：

發出API呼叫 以使用外部參數觸發工作流程1。請參閱步驟1:設定API呼叫。
建置工作流程1:工作流程會傳輸檔案並將其載入資料庫。接著會測試資料是否空白，並最終將設定檔儲存至對象。最後，它會觸發工作流程2。請參閱步驟2:設定工作流程1。
建置工作流程2:工作流程將讀取在工作流程1中建立的對象，然後傳送個人化訊息至設定檔，並使用參數自訂的區段代碼。請參閱步驟3:設定工作流程2。

先決條件

在設定工作流程之前，您需要先建立工作流程1和2，每個工作流程中都包含External signal活動。如此一來，您就可以在呼叫工作流程時鎖定這些訊號活動。

步驟1:設定API呼叫

進行API呼叫以使用參數觸發工作流程1。如需API呼叫語法的詳細資訊，請參閱Campaign StandardREST API檔案。

在我們的案例中，我們想使用下列參數呼叫工作流程：

fileToTarget:要導入資料庫的檔案的名稱。
discountDesc:要顯示在折扣傳送中的說明。

-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/<TRIGGER_URL>
-H 'Authorization: Bearer <ACCESS_TOKEN>' 
-H 'Cache-Control: no-cache' 
-H 'X-Api-Key: <API_KEY>' 
-H 'Content-Type: application/json;charset=utf-8' 
-H 'Content-Length:79' 
-i
-d {
-d "source:":"API",
-d "parameters":{
-d "fileToTarget":"profile.txt",
-d "discountDesc":"Running shoes"
-d }

步驟2:配置工作流1

工作流程1的建置如下：

External signal 活動：其中，必須聲明外部參數才能在工作流程中使用。
Transfer file 活動：會以參數中定義的名稱匯入檔案。
Load file 活動：將資料從導入的檔案載入到資料庫。
Update data 活動：插入或更新資料庫，使用從導入的檔案中獲取的資料。
Test 活動：檢查是否有匯入的資料。
Save audience 活動：如果檔案包含資料，會將設定檔儲存至對象。
End activity 活動：使用您要在其中使用的參數呼叫工作流程2。

請依照下列步驟來設定工作流程：

宣告API呼叫中已定義的參數。要執行此操作，請開啟External signal活動，然後新增參數的名稱和類型。
新增Transfer file活動以將資料匯入資料庫。若要這麼做，請拖放活動、開啟它，然後選取Protocol標籤。
選取Use a dynamic file path選項，然後使用fileToTarget參數作為要傳輸的檔案：
```
$(vars/@fileToTarget)
```
將資料從檔案載入資料庫。

若要這麼做，請將Load file活動拖放至工作流程中，然後根據您的需求進行設定。
插入資料庫，並使用匯入檔案中的資料更新資料庫。

若要這麼做，請拖放Update data活動，然後選取Identification標籤以新增調解標準（在此例中是email欄位）。
選取Fields to update標籤，然後指定要在資料庫中更新的欄位（在此例中是firstname和email欄位）。
檢查是否從檔案中擷取資料。若要這麼做，請將Test活動拖放至工作流程中，然後按一下Add an element按鈕以新增條件。
命名並定義條件。在本例中，我們要測試出站轉變是否包含具有下列語法的資料：
```
$long(vars/@recCount)>0
```
如果擷取資料，則將其儲存至對象中。若要這麼做，請將Save audience活動新增至非空的轉變，然後開啟它。
選取Use a dynamic label選項，然後使用fileToTarget參數作為對象的標籤：
```
$(vars/@fileToTarget)
```
拖放將使用參數呼叫Workflow 2的End活動，然後開啟它。
選取External signal標籤，然後指定要觸發的工作流程及其相關訊號活動。
定義您要在工作流程2中使用的參數及其關聯值。

在本例中，我們想傳遞API呼叫（fileToTarget和discountDesc）中最初定義的參數，以及具有常數值("20% discount")的額外segmentCode參數。

工作流程1已設定，您現在可以建置工作流程2。如需詳細資訊，請參閱本章節。

步驟3:配置工作流2

工作流程2的建置方式如下：

External signal 活動：其中，必須聲明參數，才能在工作流程中使用。
Read audience 活動：讀取儲存在工作流程1中的對象。
Email delivery 活動：傳送循環訊息給目標對象，並使用參數個人化。

請依照下列步驟來設定工作流程：

聲明已在工作流1中定義的參數。

要執行此操作，請開啟External signal活動，然後新增在工作流1的End活動中定義之每個參數的名稱和類型。
使用已儲存在工作流程1中的對象。若要這麼做，請將Read audience活動拖放至工作流程中，然後開啟它。
選取Use a dynamic audience選項，然後使用fileToTarget參數作為要讀取的對象名稱：
```
$(vars/@fileToTarget)
```
根據segmentCode參數為出站轉變命名。

要執行此操作，請選擇Transition頁簽，然後選擇Use a dynamic segment code選項。
使用segmentCode參數作為出站轉變的名稱：
```
$(vars/@segmentCode)
```
拖放Email delivery活動以傳送訊息給對象。
識別訊息中要使用的參數，以使用discountDesc參數進行個人化。若要這麼做，請開啟活動的進階選項，然後新增參數名稱和值。
您現在可以設定訊息。開啟活動，然後選取Recurring email。
選取要使用的範本，然後根據您的需求定義電子郵件屬性。
使用discountDesc參數作為個人化欄位。若要這麼做，請從個人化欄位清單中選取它。
您現在可以完成訊息的設定，然後照常傳送。