用例

以下用例展示了如何使用工作流中的参数调用工作流。

其目标是通过具有外部参数的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)
```
拖放将使用参数调用工作流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参数用作个性化字段。要实现此目的，请从个性化字段列表中选择它。
您现在可以完成消息的配置，然后照常发送消息。