沙盒工具
您需要具有以下两个基于角色的访问控制权限才能使用沙盒工具功能：
-
manage-sandbox或view-sandbox-
manage-package提高沙盒之间的配置准确性，并通过沙盒工具功能在沙盒之间无缝导出和导入沙盒配置。 使用沙盒工具缩短实现实施过程的价值时间，并在沙盒之间移动成功的配置。
您可以使用沙盒工具功能选择不同的对象并将它们导出到包中。 包可以包含单个对象或多个对象。包中包含的任何对象必须来自同一沙盒。
沙盒工具支持的对象 supported-objects
沙盒工具功能允许您将Adobe Real-Time Customer Data Platform和Adobe Journey Optimizer对象导出到包中。
实时客户数据平台对象 real-time-cdp-objects
多实体受众导入的变化
在B2B架构升级后，如果在升级之前发布了包含这些受众的包，则您将无法再导入具有B2B属性和体验事件的多实体受众。 这些受众将无法导入，且无法自动转换为新架构。
要解决此限制，您必须创建一个具有更新受众的新包，然后使用沙盒工具将它们导入各自的目标沙盒中。
下表列出了当前支持沙盒工具的Adobe Real-Time Customer Data Platform对象：
- 出于安全原因，源帐户凭据未复制到目标沙盒中，需要手动更新。
- 默认情况下，源数据流将以草稿状态复制。
- 仅支持 客户受众 类型 分段服务。
- 用于同意和管理的现有标签将复制到同一导入作业中。
- 检查合并策略依赖关系时，系统将自动选择具有相同XDM类的目标沙盒中的默认合并策略。
- 如果在导入受众时检测到具有相同名称的现有对象，则沙盒工具将始终重用现有对象，以避免对象扩散。
- 在Target沙盒中创建时，系统将自动删除重复的Adobe标准身份命名空间。
- 仅当在合并架构中启用受众规则中的所有属性时，才能复制受众。 必须先为统一配置文件移动和启用必要的架构。
- 用于同意和管理的现有标签将复制到同一导入作业中。
- 您可以灵活地导入未启用“统一配置文件”选项的架构。 架构关系边缘用例未包含在包中。
- 如果在导入架构/字段组时检测到具有相同名称的现有对象，则沙盒工具将始终重用现有对象，以避免对象扩散。
以下对象已导入，但处于草稿或已禁用状态：
Adobe Journey Optimizer对象 abobe-journey-optimizer-objects
下表列出了当前支持沙盒工具的Adobe Journey Optimizer对象和限制：
历程中使用的以下对象将作为依赖对象复制。 在导入工作流期间，您可以选择 新建 或 对以下各项使用现有：
- 受众
- 画布详细信息
- 内容模板
- 自定义操作
- 数据源
- 活动
- 字段组
- 片段
- 架构
系统复制历程中使用的事件和事件详细信息，并在目标沙盒中创建新版本。
可以复制历程中使用的更新配置文件操作。 自定义操作可以单独添加到资源包中。 旅程中使用的操作详细信息也会被复制。 它始终会在目标沙盒中创建新版本。
自定义操作可以单独添加到资源包中。 将自定义操作分配给历程后，便无法再编辑它。 要更新自定义操作，您应：
- 在迁移历程之前移动自定义操作
- 在迁移后更新自定义操作的配置（如请求标头、查询参数和身份验证）
- 使用您在第一步中添加的自定义操作迁移历程对象
促销活动中使用的以下对象将作为从属对象复制：
- 营销活动
- 受众
- 架构
- 内容模板
- 片段
- 消息/内容
- 渠道配置
- 统一的决策对象
- 试验设置/变体
- 营销活动可与所有与用户档案、受众、架构、内联消息和依赖对象相关的项目一起复制。 不会复制某些项目，例如数据使用标签和语言设置。 有关无法复制的对象的完整列表，请参阅将对象导出到另一个沙盒指南。
- 如果存在相同的配置，系统将自动检测并重新使用目标沙盒中的现有渠道配置对象。 如果未找到匹配的配置，则在导入期间跳过渠道配置，并且用户必须手动更新此历程的目标沙盒中的渠道设置。
- 用户可以重复使用目标沙盒中的现有试验和受众作为所选营销活动的依赖对象。
在复制决策对象之前，目标沙盒中必须存在以下对象：
- 在决策对象间使用的配置文件属性
- 自定义选件属性的字段组
- 用于跨规则、排名或上限的上下文属性的数据流架构。
- 当前不支持复制使用AI模型的排名公式。
- 决策项（优惠项）不会自动包含在内。 为确保它们已传输，请使用 添加到包 选项手动添加它们。
- 使用选择策略的策略要求在复制过程中手动添加关联的决策项。 使用手动或备用决策项目的策略会自动将这些项目作为直接依赖项包含在内。
- 必须先复制决策项目，然后再复制任何其他相关对象。
在决策对象间使用的配置文件属性，
自定义选件属性的字段组，
用于跨规则、排名或上限的上下文属性的数据流架构。
曲面（例如预设）不会被复制。 系统根据消息类型和表面名称，自动选择目标沙盒上最接近的匹配项。 如果在目标沙盒上未找到表面，则表面复制将失败，导致消息复制失败，因为消息需要表面才可供设置。 在这种情况下，需要为消息的正确渠道至少创建一个表面，以便副本正常工作。
导出历程时，不支持将自定义身份类型作为依赖对象。
将对象导入包 export-objects
此示例记录了导出架构并将其添加到包的过程。 您可以使用相同的流程导出其他对象，例如数据集、历程等。
将对象添加到新包 add-object-to-new-package
从左侧导航中选择 架构，然后选择 浏览 选项卡，该选项卡列出了可用的架构。 接下来，选择选定架构旁边的省略号(...)，下拉菜单将显示控件。 从下拉列表中选择 添加到包。
从 添加到包 对话框中，选择 创建新包 选项。 为您的包提供Name和可选的Description，然后选择 添加。
您返回到 架构 环境。 现在，您可以按照下面列出的后续步骤，将其他对象添加到您创建的资源包中。
将对象添加到现有包并发布 add-object-to-existing-package
要查看可用架构的列表，请从左侧导航中选择 架构，然后选择 浏览 选项卡。 接下来，选择所选架构旁边的省略号(...)，在下拉菜单中查看控制选项。 从下拉列表中选择 添加到包。
出现 添加到包 对话框。 选择 现有包 选项，然后选择 包名称 下拉列表并选择所需的包。 最后，选择 添加 以确认您的选择。
将列出添加到包中的对象列表。 要发布包并使其可以导入到沙盒中，请选择 发布。
选择 发布 以确认发布包。
您返回到 沙盒 环境中的包选项卡，您可以在其中查看新发布的包。
将资源包导入目标沙盒 import-package-to-target-sandbox
要将包导入目标沙盒，请导航到沙盒 浏览 选项卡，然后选择沙盒名称旁边的加号(+)选项。
使用下拉菜单，选择要导入到目标沙盒的 包名称。 添加将用于将来监视的 作业名称。 默认情况下，在导入包的架构时，将禁用统一配置文件。 切换 为配置文件 启用架构以启用它，然后选择 下一步。
包对象和依赖项页提供了此包中包含的所有资源的列表。 系统自动检测成功导入所选父对象所需的从属对象。 任何缺少的属性都会显示在页面顶部。 选择 查看详细信息 以获取更详细的细分。
要使用现有对象，请选择从属对象旁边的铅笔图标。
此时会显示创建新或使用现有内容的选项。 选择 使用现有。
字段组 对话框显示该对象可用的字段组列表。 选择所需的字段组，然后选择 保存。
返回到包对象和依赖项页。 从此处选择 完成 以完成包导入。
导出和导入整个沙盒
您可以将所有受支持的对象类型导出到完整的沙盒包中，然后跨各种沙盒导入包以复制对象配置。 例如，此功能允许您：
- 如果需要重置沙盒，请重新导入沙盒以重现对象的所有配置
- 将包导入其他沙盒并将它用作Blueprint沙盒以加快开发过程。
导出整个沙盒 export-entire-sandbox
要导出整个沙盒，请导航到沙盒 包 选项卡，然后选择 创建包。
在 创建包 对话框中，为包类型选择整个沙盒。 为您的新包提供包名称，然后从下拉列表中选择 沙盒。 最后，选择 创建 以确认您的条目。
已成功创建包，请选择 发布 以发布包。
您返回到 沙盒 环境中的包选项卡，您可以在其中查看新发布的包。
导入整个沙盒包 import-entire-sandbox-package
要将包导入目标沙盒，请导航到沙盒 浏览 选项卡，然后选择沙盒名称旁边的加号(+)选项。
使用下拉菜单，使用 包名称 下拉菜单选择完整的沙盒。 添加将用于将来监视的 作业名称 和可选的 作业描述，然后选择 下一步。
您将转到包对象和依赖项页，在该页中可以查看导入和排除对象的对象和依赖项的数目。 在此处，选择 导入 以完成包导入。
留出一段时间以完成导入。 完成时间会因包中的对象数而异。 您可以从沙盒 作业 选项卡监视导入作业。
监控导入详细信息 view-import-details
要查看导入的详细信息，请导航到沙盒 作业 选项卡，然后从列表中选择包。 或者，使用搜索栏搜索包。
在“沙盒”环境的 作业 选项卡中，从右侧详细信息窗格中选择 查看导入摘要。
导入摘要 对话框显示导入的划分以及进度百分比。
导入完成后，将在Experience Platform UI中收到通知。 您可以通过警报图标访问这些通知。 如果作业不成功，您可以在此处导航到疑难解答。
通过沙盒工具跨沙盒传输迭代对象配置更新 move-configs
您可以使用沙盒工具在不同沙盒之间传输对象配置。 以前，必须手动重新创建或重新导入对象（例如架构、字段组和数据类型）的配置更新才能传输到其他沙盒。 借助此功能，您可以使用沙盒工具通过在不同沙盒之间无缝传输配置更新来加快工作流并减少潜在错误。
- 访问沙盒工具的相应权限。
- 源沙盒中新创建或更新的对象（如架构）。
更新操作支持的对象类型
以下是支持更新的对象类型：
- 架构
- 字段组
- 数据类型
- 向资源中添加新字段/字段组。
- 将必填字段设为可选字段。
- 引入新的必填字段。
- 正在引入新的关系字段。
- 引入新的标识字段。
- 更改资源的显示名称和描述。
- 删除以前定义的字段。
- 为实时客户配置文件启用架构时，重新定义现有字段。
- 删除或限制以前支持的字段值。
- 将现有字段移动到架构树中的其他位置 — 这将在目标沙盒中创建一个新字段，但不会删除上一个字段。
- 启用或禁用架构以参与配置文件 — 比较时将跳过此操作。
- 访问控制标签。
请按照以下步骤了解如何使用沙盒工具在不同沙盒之间传输对象配置。
先前导入的对象
如果您的用例涉及源沙盒中要求在打包并导入到其他沙盒后进行配置更新的现有对象，请按照以下步骤操作。
首先，更新源沙盒中的对象。 例如，导航到 架构 工作区，选择您的架构，然后添加一个新的字段组。
更新架构后，导航到 沙盒，选择 包，然后找到现有包。
使用包界面验证更改。 选择 检查更新 以查看对包中项目的任何更改。 接下来，选择 查看diff，以接收对项目执行的所有更改的详细摘要。
出现视图diff界面。 有关源工件和目标工件以及要应用于它们的更改的信息，请参阅此收费。
在此步骤中，您还可以选择使用AI汇总，以分步汇总所有更改。
准备就绪后，选择 更新包，然后在出现的弹出窗口中选择 确认。 作业完成后，您可以刷新页面并选择 查看历史记录 以验证包的版本。
要导入更改，请导航回包目录并选择包旁边的省略号(...)，然后选择 导入包。 Experience Platform自动选择更新现有对象。 验证更改，然后选择 完成。
要进一步验证导入流程，请导航到目标沙盒，并手动从该沙盒中查看更新的对象。
在目标沙盒中手动创建的对象
如果您的用例涉及将配置更改应用到在单独的沙盒中手动创建的对象，请按照以下步骤操作。
首先，使用更新后的对象创建和发布新包。
接下来，将包导入包含要更新的对象的目标沙盒。 在导入过程中，选择 更新现有对象，然后使用对象导航器手动选择要应用更新的目标对象。
- 可以选择在不同的沙盒中为从属对象选择目标映射。 如果未选中任何项，则会创建一个新项。
- 对于身份命名空间，如果需要在目标沙盒中重用现有身份，系统会自动检测是否需要创建新身份。
标识要更新的目标对象后，选择 完成。
视频教程
以下视频旨在支持您了解沙盒工具，并概述如何创建新包、发布包和导入包。
后续步骤
本文档演示了如何在Experience Platform UI中使用沙盒工具功能。 有关沙盒的信息，请参阅沙盒用户指南。
有关使用沙盒API执行不同操作的步骤，请参阅沙盒开发人员指南。 有关Experience Platform中沙盒的高级概述，请参阅概述文档。