配置资源的数据结构 configuring-the-resource-s-data-structure
创建新的自定义资源后,必须配置数据结构。
编辑资源时,您可以在 Data structure 选项卡中添加:
向资源添加字段 adding-fields-to-a-resource
您可以向资源添加新字段,以存储不属于现成数据模型的数据。
-
使用 Create element 按钮可创建字段。
-
指定标签、ID、字段类型,并定义为此字段授权的最大长度。
ID 字段是必填字段,并且对于添加的每个字段都必须是唯一的。
note note NOTE 最多使用 30 个字符。 -
要修改其中一个字段,请使用 Edit Properties 按钮。
-
在 Field definition 屏幕中,您可以定义用于受众和定向的类别,甚至可以添加描述。
-
如果需要定义提供给用户的值(枚举值),请选中 Specify a list of authorized values 选项。
然后,单击 Create element 并指定 Label 和 Value。根据需要,添加相应数量的之。
-
添加字段后,勾选 Add audit fields 方框可加入多个字段,用于详细说明创建日期、创建资源的用户、日期和上次修改的作者。
-
选中 Add access authorization management fields 方框,可加入声明哪些人有权访问该特定资源的字段。
这些字段显示在数据和元数据中,执行数据库更新后即可显示。有关更多信息,请参阅更新数据库结构。
-
选中 Add automatic ID 字段可自动生成 ID。请注意,现有实体仍保持为空。有关更多信息,请参阅为用户档案和自定义资源生成唯一 ID。
-
要修改资源元素名称在列表和创建步骤中的显示方式,请选中 Customize the title of the resource elements 方框。从为此资源创建的字段中选择一个字段。
note note NOTE 如果不选中此选项,则在从此表格列出所有实体时,将使用自动主键值(每次将实体添加到表格时都会自动创建)。
资源的字段现已定义完成。
定义标识键 defining-identification-keys
每个资源都必须至少拥有一个唯一键。例如,您可以指定一个键,使购买表中两个产品不能具有相同的 ID。
-
如果希望自动生成技术键并以增量方式生成,请在 Automatic primary key 部分中指定存储的大小。
-
使用 Create element 按钮创建一个键。
Label 和 ID 字段默认已填写,但您可以编辑它们。
note note NOTE 最多使用 30 个字符。 -
要定义构成此键的元素,请单击 Create element 并选择为此资源创建的字段。
创建的键都会显示在 Custom keys 部分中。
资源的标识键现已创建完成。
定义索引 defining-indexes
索引可以引用一个或多个资源字段。利用索引,数据库可对记录进行排序,以便更轻松地取回记录。索引可优化 SQL 查询的性能。
建议定义索引,但并不强制。
-
使用 Create element 按钮可创建索引。
-
Label 和 ID 字段默认已填写,但您可以编辑它们。
note note NOTE 最多使用 30 个字符。 -
要定义构成此索引的元素,请选择为此资源创建的字段。
-
单击 Confirm。
创建的索引将显示在 Index 部分的列表中。
定义与其他资源的链接 defining-links-with-other-resources
链接详细列出了一个表格与其他表格的关联。
-
使用 Create element 按钮可创建指向目标资源的链接。
-
单击 Select a target resource。
-
资源按字母顺序显示,并可按名称筛选。其技术名称显示在括号中。
从列表中选择元素,然后单击 Confirm。
-
根据基数选择 Link type。根据所选基数类型,可能会选择删除或复制记录的不同行为。
各种链接类型如下所示:
- 1 cardinality simple link:源表格的一个存在最多可以拥有目标表格的一个对应存在。
- N cardinality collection link:源表格的一个存在可以拥有目标表格的多个对应存在,但目标表格的一个存在最多可以具有源表格的一个对应存在。
- 0 or 1 cardinality simple link:源表格的一个存在最多可以拥有目标表格的一个或零个对应存在。请注意,这种类型的 Link type 可能导致性能问题。
-
在 New link 屏幕中,Label 和 ID 字段默认已填写,但您可以编辑它们。
note note NOTE 最多使用 30 个字符。 创建后无法重命名链接。要重命名链接,必须删除该链接并重新创建链接。 -
利用 Category for the audience and targeting 列表,可将此链接分配给类别,使其在查询编辑器工具中更加显眼。
-
如果需要,可利用 Reverse link definition 部分在定向资源中显示资源的标签和 ID。
-
在 Behavior if deleted/duplicated 部分中定义链接所引用记录的行为。
默认情况下,一旦链接不再引用目标记录,该记录将被删除。
-
在 Join definition 部分中,默认选项 Use the primary keys to make the join 处于选中状态,但您可以选择以下两个选项:
- Use the primary key to make the join:利用此连接定义,可使用用户档案主键与购买的主键进行协调。
- Define specific join conditions:利用此连接定义,可手动选择将连接两个资源的字段。请注意,如果数据配置不正确,则不会显示 购买 记录。
创建的链接将显示在 Links 部分的列表中。
示例:将创建的资源与“Profiles”资源链接到一起
在本例中,我们要将新资源 Purchase 与 Profiles 自定义资源链接到一起:
-
创建新的 Purchase 资源。
-
要将其与 Profiles 自定义资源链接到一起,请展开 Data structure 选项卡中的 Links 部分,然后单击 Create element。
-
选择目标资源,在本例中为 Profiles (profile)。
-
在本例中,将默认 1 cardinality simple link 链接类型保持选中状态。
-
选择连接定义,本例中保留默认 Use the primary key to make the join 即可。
-
如果需要,您可以定义详细信息屏幕,以便能够编辑 Purchase 并将其链接到用户档案。
展开 Detail screen configuration 部分并勾选 Define a detail screen 以配置对应于资源各个元素的屏幕。如果不勾选此框,将无法访问此资源元素的详细视图。
-
单击 Create element。
-
选择您链接的资源,然后单击 Add。
然后,即可选择 Client data > Purchase,通过高级菜单访问新的资源。
-
完成配置后,单击 Confirm。
您现在可以发布新资源。
通过添加此链接,Purchase 选项卡会从 Profiles & audiences > Profiles 菜单添加到用户档案详细信息屏幕中。请注意,这是特定于 Profile 资源的。
定义发送日志扩展 defining-sending-logs-extension
利用发送日志扩展,您可以:
- 通过 添加用户档案自定义字段 扩展动态报告功能
- 用 段代码和用户档案数据 扩展发送日志数据
通过段代码扩展
用户可以使用来自工作流引擎的段代码扩展日志。
段代码必须定义到工作流中
要激活此扩展,请选中选项 Add segment code。
有关段代码的更多信息,请参阅分段一节。
使用用户档案字段扩展
单击 Add field 并从用户档案资源中选择任意自定义字段。
要生成链接到用户档案维度的新子维度,请选中 Add this field in Dynamic reporting as a new dimension 选项。
您可以将自定义字段维度从动态报告拖放到自由形式表格中。
有关动态报告的详细信息,请参阅组件列表。
编辑资源属性 editing-resource-properties
在自定义资源屏幕中,Summary 窗格可指示新创建资源的状态。您可以管理其访问权限及其常规属性。
-
单击 Edit properties 按钮可添加说明。
-
如果需要,请修改资源的标签和 ID。
note note NOTE 最多使用 30 个字符。 -
如果需要将此资源的访问权限限制为特定组织单位,请在此处指定这些单位。只有授权单位的用户才能在应用程序中使用此资源。
-
保存修改。
您的修改已保存。您需要再次发布资源以应用它们。
为用户档案和自定义资源生成唯一ID generating-a-unique-id-for-profiles-and-custom-resources
默认情况下,用户档案和自定义资源在创建时没有业务 ID。您可以启用一个选项,以在创建元素时自动生成唯一 ID。该 ID 可用于:
- 轻松识别外部工具中的导出记录。
- 在其他应用程序中处理导入更新数据时,协调记录。
只能为用户档案和自定义资源启用此功能。
-
创建用户档案资源的扩展或创建新资源。
-
在数据结构定义中,选中 Fields 部分下的 Add automatic ID field 选项。
note note NOTE 只有新记录拥有 ACS ID。激活此选项之前创建的用户档案或元素,ACS ID 字段将保留为空。 -
保存并发布对资源所作的修改。如果希望将此机制应用于通过 API 创建的元素,请勾选相应的选项以扩展 API。
ACS ID 字段现已可用,手动从 API 创建新元素时或从导入工作流中插入新元素时,会自动填充该字段。ACS ID 字段是 UUID 字段,且已编制索引。
现在,在导出用户档案或自定义资源时,如果已为该资源启用了 ACS ID 列,则可以添加该列。您可以在外部工具中重新利用此 ID,以标识记录。
重新导入已在其他应用程序(例如 CRM)中处理/更新的数据时,您可以轻松将其与此唯一 ID 协调。