用例 use-case

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

中级
开发人员

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

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

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

进行API调用 以使用外部参数触发工作流1。请参阅步骤1：配置API调用。
生成工作流1：工作流将传输文件并将其加载到数据库中。然后，它将测试数据是否为空，并最终将用户档案保存到受众。最后，它会触发工作流2。请参阅步骤2：配置工作流1。
生成工作流2：工作流将读取在工作流1中创建的受众，然后向用户档案发送个性化消息，并使用参数自定义区段代码。请参阅步骤3：配置工作流2。

先决条件 prerequisites

在配置工作流之前，您需要创建工作流1和2，其中每个工作流1和2均具有 External signal 活动。这样，您就可以在调用工作流时定位这些信号活动。

步骤1：配置API调用 step-1--configuring-the-api-call

进行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 step-2--configuring-workflow-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 参数作为要传输的文件：

code language-none
`$(vars/@fileToTarget)`

将数据从文件加载到数据库中。

为此，请将 Load file 活动拖放到工作流中，然后根据您的需要进行配置。
使用导入文件中的数据插入并更新数据库。

为此，请拖放 Update data 活动，然后选择 Identification 选项卡以添加协调条件（在我们的示例中为 电子邮件 字段）。
选择 Fields to update 选项卡，然后指定要在数据库中更新的字段（在我们的示例中为 firstname 和 email 字段）。
检查是否从文件检索数据。为此，请将 Test 活动拖放到工作流中，然后单击 Add an element 按钮以添加条件。

命名并定义条件。在本例中，我们希望测试叫客过渡是否包含使用以下语法的数据：

code language-none
`$long(vars/@recCount)>0`

如果检索到数据，则将其保存到受众中。为此，请将 Save audience 活动添加到 Target not empty 过渡，然后打开它。

选择 Use a dynamic label 选项，然后使用 fileToTarget 参数作为受众的标签：

code language-none
`$(vars/@fileToTarget)`

拖放将使用参数调用工作流2的 End 活动，然后将其打开。
选择 External signal 选项卡，然后指定要触发的工作流及其关联的信号活动。
定义要在工作流2中使用的参数及其关联值。

在本例中，我们希望传递最初在API调用中定义的参数（fileToTarget 和 discountDesc），以及带有常量值（“20%折扣”）的附加 segmentCode 参数。