51黑料不打烊

使用计算字段对导出到云存储目标的数据进行转换 data-transformation-calculated-fields

要对导出到云存储目标的数据执行各种转换，您必须在导出工作流的映射步骤中使用计算字段功能。 有关计算字段的详细信息，请访问下面链接的页面。 这些页面包括对数据准备中计算字段的介绍，以及有关所有可用函数的更多信息：

先决条件 prerequisites

要将计算字段用于数据转换：

如何使用计算字段 how-to-export-calculated-fields

在云存储目标的激活工作流的映射步骤中，选择? 添加计算字段。

这将打开一个模式窗口，您可以在其中选择用于从Experience Platform中导出属性的函数和字段。

例如，使用如下所示的organizations字段上的array_to_string函数将组织数组导出为CSV文件中的字符串。 查看?下方的有关此示例和其他示例的详细信息。

选择? 保存 ?以保留计算字段并返回映射步骤。

返回工作流的映射步骤，使用导出文件中该字段所需的列标题值填写? 目标字段。

准备就绪后，选择? 下一步 ?以继续执行激活工作流的下一步。

用于执行数据转换的支持函数示例 supported-functions

将数据激活到基于文件的目标时，支持所有记录的数据准备功能。

以下专门用于处理数组的导出或对字段应用哈希的函数与示例一起进行了说明。

用于执行数据转换的函数示例 examples

有关上面列出的某些函数，请参阅以下部分中的示例和更多信息。 对于列出的其余函数，请参阅数据准备部分?中的常规函数文档。

array_to_string函数以导出数组 array-to-string-function-export-arrays

使用所需的分隔符（如_或|），使用array_to_string函数将数组的元素连接到字符串中。 当您想要将数组的元素从Experience Platform导出到CSV文件时，此函数非常有用。

例如，您可以使用array_to_string('_',organizations)语法将以下齿顿惭字段组合在一起，如映射屏幕快照中所示：

在这种情况下，您的输出文件将如下所示。 请注意如何使用_字符将数组的元素连接到单个字符串中。

First_Name,Last_Name,Personal_Email,Organization
John,Doe,johndoe@acme.org, "{'id':123,'orgName':'Acme Inc','founded':1990,'latestInteraction':1708041600000}_{'id':456,'orgName':'Superstar Inc','founded':2004,'latestInteraction':1692921600000}_{'id':789,'orgName':'Energy Corp','founded':2021,'latestInteraction':1725753600000}"

filterArray函数以导出筛选的数组 filter-array

使用filterArray函数筛选导出数组的元素。 您可以将此函数与上面进一步描述的array_to_string函数组合。

使用上面的organizations数组对象继续，您可以编写一个函数，如array_to_string('_', filterArray(organizations, org -> org.founded > 2021))，该函数返回在2021年或更近年份具有founded值的组织。

在这种情况下，您的输出文件将如下所示。 请注意数组中满足条件的两个元素如何使用_字符连接为单个字符串。

John,Doe,johndoe@acme.org, "{'id':123,'orgName':'Acme Inc','founded':1990,'latestInteraction':1708041600000}_{'id':789,'orgName':'Energy Corp','founded':2021,'latestInteraction':1725753600000}"

transformArray函数以导出转换后的数组 transform-array

使用transformArray函数转换导出数组的元素。 您可以将此函数与上面进一步描述的array_to_string函数组合。

使用上面的organizations数组对象继续，您可以编写一个函数，如array_to_string('_', transformArray(organizations, org -> ucase(org.orgName)))，返回已转换为全部大写的组织名称。

在这种情况下，您的输出文件将如下所示。 请注意如何使用_字符将数组的叁个元素转换并连接为单个字符串。

John,Doe,johndoe@acme.org,ACME INC_SUPERSTAR INC_ENERGY CORP

iif函数以导出数组 iif-function-export-arrays

使用iif函数在特定条件下导出数组的元素。 例如，继续使用上面的organizations数组对象，可以编写简单的条件函数，如iif(organizations[0].equals("Marketing"), "isMarketing", "isNotMarketing")。

在这种情况下，您的输出文件将如下所示。 在这种情况下，数组的第一个元素是营销，因此人员是营销部门的成员。

`First_Name,Last_Name, Personal_Email, Is_Member_Of_Marketing_Dept
John,Doe, johndoe@acme.org, "isMarketing"

add_to_array函数以导出数组 add-to-array-function-export-arrays

使用add_to_array函数将元素添加到导出的数组。 您可以将此函数与上面进一步描述的array_to_string函数组合。

使用上面的organizations数组对象继续，您可以编写函数，如source: array_to_string('_', add_to_array(organizations,"2023"))，返回人员在2023年所属的组织。

在这种情况下，您的输出文件将如下所示。 请注意如何使用字符_将数组的叁个元素连接到单个字符串中，并将2023也附加到字符串的末尾。

`First_Name,Last_Name,Personal_Email,Organization_Member_2023
John,Doe, johndoe@acme.org,"Marketing_Sales_Finance_2023"

flattenArray函数以导出平面化数组 flatten-array

使用flattenArray函数扁平化导出的多维数组。 您可以将此函数与上面进一步描述的array_to_string函数组合。

继续使用上面的organizations数组对象，您可以编写函数，如array_to_string('_', flattenArray(organizations))。 请注意，array_to_string函数默认将输入数组扁平化为字符串。

结果输出与上面进一步描述的array_to_string函数输出相同。

coalesce函数以导出数组 coalesce-function-export-arrays

使用coalesce函数访问数组的第一个非苍耻濒濒元素并将其导出到字符串中。

例如，通过使用coalesce(subscriptions.hasPromotion)语法返回数组中false值的前true个，您可以组合下面的齿顿惭字段，如映射屏幕快照中所示：

在这种情况下，您的输出文件将如下所示。 请注意如何在文件中导出数组中的第一个非空true值。

First_Name,Last_Name,hasPromotion
John,Doe,true

size_of函数以导出数组 sizeof-function-export-arrays

使用size_of函数指示数组中存在多少个元素。 例如，如果您有一个具有多个时间戳的purchaseTime数组对象，则可以使用size_of函数来指示某个人分别进行了多少次购买。

例如，您可以合并下面的以下齿顿惭字段，如映射屏幕快照中所示。

在这种情况下，您的输出文件将如下所示。 请注意第二列如何指示数组中的元素数，对应于客户进行的单独购买次数。

`Personal_Email,Times_Purchased
johndoe@acme.org,"5"

基于索引的阵列访问 index-based-array-access

您可以访问数组的索引以从数组导出单个项。 例如，与上述针对size_of函数的示例类似，如果您只想在客户购买特定产物时访问和导出，则可以使用purchaseTime[0]导出时间戳的第一个元素，使用purchaseTime[1]导出时间戳的第二个元素，使用purchaseTime[2]导出时间戳的第叁个元素，依此类推。

在这种情况下，您的输出文件如下所示，在客户首次购买时导出：

`Personal_Email,First_Purchase
johndoe@acme.org,"1538097126"

first和last函数以导出数组 first-and-last-functions-export-arrays

使用first和last函数导出数组中的第一个或最后一个元素。 例如，使用前面示例中具有多个时间戳的purchaseTime数组对象继续，您可以使用这些对函数进行导出，以导出人员进行的首次购买或上次购买时间。

在这种情况下，您的输出文件将如下所示，导出客户第一次和最后一次购买的时间：

`Personal_Email,First_Purchase, Last_Purchase
johndoe@acme.org,"1538097126","1664327526"

哈希函数 hashing-functions

其他可用函数专门用于从数组导出数组或元素。 您可以使用散列函数对导出文件中的属性进行散列。 例如，如果您在属性中有任何个人身份信息，则可以在导出这些字段时对其进行哈希处理。

您可以直接散列字符串值，例如md5(personalEmail.address)。 如果需要，您还可以散列数组字段的各个元素，假定数组中的元素是字符串，如下所示： md5(purchaseTime[0])

支持的哈希函数包括：