使用计算出的字段将数组导出为字符串 use-calculated-fields-to-export-arrays-as-strings

了解如何通过计算字段将阵列作为字符串从Real-Time CDP导出到云存储目标。 请阅读本文档以了解此功能启用的用例。

获取有关计算字段的丰富信息 — 这些字段是什么以及它们为什么重要。 请阅读以下链接页面，了解有关数据准备中计算字段的介绍以及有关所有可用函数的更多信息：

Platform中的数组和其他对象类型 arrays-strings-other-objects

在Experience Platform中，您可以使用XDM架构管理不同的字段类型。 在添加对数组导出的支持之前，您可以将简单的键值对类型字段(如字符串不Experience Platform)导出到所需的目标。 以前支持导出的此类字段示例为personalEmail.address：johndoe@acme.org。

Experience Platform中的其他字段类型包括数组字段。 阅读有关Experience PlatformUI🔗中管理数组字段的更多信息。 除了以前支持的字段类型之外，您现在还可以使用array_to_string函数将数组对象（如下面的示例）导出为字符串。

organizations = [{
  id: 123,
  orgName: "Acme Inc",
  founded: 1990,
  latestInteraction: "2024-02-16"
}, {
  id: 456,
  orgName: "Superstar Inc",
  founded: 2004,
  latestInteraction: "2023-08-25"
}, {
  id: 789,
  orgName: 'Energy Corp',
  founded: 2021,
  latestInteraction: "2024-09-08"
}]

请参阅下面的大量示例，了解如何使用各种函数访问数组的元素、转换和筛选数组、将数组元素加入字符串等。

已知限制 known-limitations

请注意当前适用于此功能的以下已知限制：

先决条件 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函数将数组的元素连接到字符串中。

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

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

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函数以导出筛选的数组

使用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函数以导出转换后的数组

使用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函数以导出平面化数组

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

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

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

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

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

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

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

First_Name,Last_Name,hasPromotion
John,Doe,true

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

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

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

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

`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"