用例

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

其目标是通过具有外部参数的API调用触发工作流。此工作流将从文件将数据加载到数据库中，并创建关联的受众。创建受众后，将触发第二个工作流，以发送使用API调用中定义的外部参数个性化的消息。

要执行此用例，您需要执行以下操作：

进行API调用 以使用外部参数触发工作流1。请参阅步骤1:配置API调用.
构建工作流1:工作流将传输文件并将其加载到数据库中。然后，测试数据是否为空，并最终将用户档案保存到受众中。最后，它将触发工作流2。请参阅步骤2:配置工作流1.
构建工作流2:工作流将读取在工作流1中创建的受众，然后使用使用参数自定义的段码向用户档案发送个性化消息。请参阅步骤3:配置工作流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 选项卡添加协调条件(在本例中为 电子邮件 字段。
选择 Fields to update 选项卡，然后指定要在数据库中更新的字段(在本例中为名字和 电子邮件 字段)。
检查是否从文件中检索数据。为此，请拖放 Test 活动，然后单击 Add an element 按钮以添加条件。
命名并定义条件。在本例中，我们希望测试叫客过渡是否包含使用以下语法的数据：
```
$long(vars/@recCount)>0
```
如果检索到数据，请将其保存到受众中。为此，请添加 Save audience 活动 目标不为空 过渡，然后将其打开。
选择 Use a dynamic label 选项，然后使用 fileToTarget 参数作为受众的标签：
```
$(vars/@fileToTarget)
```
拖放 End 活动，该活动将使用参数调用工作流2，然后将其打开。
选择 External signal 选项卡，然后指定要触发的工作流及其关联的信号活动。
定义要在工作流2中使用的参数及其关联值。

在本例中，我们希望传递最初在API调用中定义的参数(fileToTarget 和 discountDesc)和 segmentCode 参数（“20%折扣”）。

工作流1已配置，您现在可以构建工作流2。如需详细信息，请参阅此部分。

步骤3:配置工作流2

工作流2的构建如下所示：

External signal 活动：其中必须声明参数才能在工作流中使用。
Read audience 活动：读取在工作流1中保存的受众。
Email delivery 活动：向目标受众发送使用参数进行个性化的定期消息。

请按照以下步骤配置工作流：

声明已在工作流1中定义的参数。

为此，请打开 External signal 活动，然后添加 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 参数作为个性化字段。要实现此目的，请从个性化字段列表中选择它。
您现在可以完成消息的配置，然后照常发送消息。