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