[也适用于v8]{class="badge positive" title="也适用于Campaign v8"}

使用数据包 working-with-data-packages

关于数据包 about-data-packages

使用 Adobe Campaign，您可以通过数据包系统导出或导入平台配置和数据。包可以包含不同类型的配置、元素，无论是否过滤。

数据包支持以 XML 格式文件的形式显示 Adobe Campaign 数据库的实体。数据包中包含的每个实体由其全部数据表示。

数据包 ​的原理是导出数据配置并将其集成到另一个Adobe Campaign系统中。 在此部分中了解如何维护一致的数据包集。

程序包类型 types-of-packages

有三种类型的可导出包：用户包、平台包和管理包。

数据结构 data-structure

数据包的描述是符合​ xrk：navtree ​数据架构语法的结构化XML文档。

数据包示例：

<package>
  <entities schema="nms:recipient">
    <recipient email="john.smith@adobe.com" lastName="Smith" firstName="John">
      <folder _operation="none" name="nmsRootFolder"/>
      <company _operation="none" name="Adobe"/>
    </recipient>
  </entities>
  <entities schema="sfa:company">
    <company name="Adobe">
      location city="London" zipCode="W11 2BQ"/>
    </company>
  </entities>
</package>

XML文档必须以​ <package> ​元素开始和结束。 后续的任何​ <entities> ​元素按文档类型分发数据。

<entities> ​元素包含包的数据，其格式为在​ 架构 ​属性中输入的数据架构的格式。

包中的数据不得包含基之间不兼容的内部键，例如自动生成的键（autopk ​选项）。

在本例中，“文件夹”和“公司”链接上的联接已被目标表中所谓的“高级”键替换：

<recipient>
  <folder _operation="none" name="nmsRootFolder"/>
  <company _operation="none" name="Adobe"/>
</recipient>

值为“none”的​ operation ​属性定义协调链接。

可以从任何文本编辑器手动构建数据包。 只需确保XML文档的结构符合“xtk：navtree”数据架构即可。 Adobe Campaign控制台具有数据包导出和导入模块。

导出资源包 exporting-packages

关于资源包导出 about-package-export

可通过三种不同的方式导出资源包：

导出资源包后，您将能够将其和所有添加的实体导入到另一个Campaign实例中。

导出资源包中的一组对象 exporting-a-set-of-objects-in-a-package

可通过Adobe Campaign客户端控制台的​ Tools > Advanced > Export package… ​菜单访问包导出助手。

对于三种类型的资源包，助理提供了以下步骤：

管理依赖项 managing-dependencies

导出机制使Adobe Campaign能够跟踪各种导出元素之间的链接。

此机制由两个规则定义：

导出营销活动 exporting-a-campaign

以下是如何导出营销活动的示例。 要导出的营销活动在“MyWorkflow”文件夹（节点：管理/生产/技术工作流/活动流程/MyWorkflow）中包含任务（标签：“MyTask”）和工作流（标签：“CampaignWorkflow”）。

任务和工作流将在与活动相同的资源包中导出，因为匹配的架构通过具有“自己的”类型完整性的链接进行连接。

包内容：

<?xml version='1.0'?>
<package author="Administrator (admin)" buildNumber="7974" buildVersion="7.1" img=""
label="" name="" namespace="" vendor="">
 <desc></desc>
 <version buildDate="AAAA-MM-DD HH:MM:SS.954Z"/>
 <entities schema="nms:operation">
  <operation duration="432000" end="AAAA-MM-DD" internalName="OP1" label="MyCampaign"
  modelName="opEmpty" start="AAAA-MM-DD">
   <controlGroup>
    <where filteringSchema=""/>
   </controlGroup>
   <seedList>
    <where filteringSchema="nms:seedMember"></where>
    <seedMember internalName="SDM1"></seedMember>
   </seedList>
   <parameter useAsset="1" useBudget="1" useControlGroup="1" useDeliveryOutline="1"
   useDocument="1" useFCPValidation="0" useSeedMember="1" useTask="1"
   useValidation="1" useWorkflow="1"></parameter>
   <fcpSeed>
    <where filteringSchema="nms:seedMember"></where>
   </fcpSeed>
   <owner _operation="none" name="admin" type="0"/>
   <program _operation="none" name="nmsOperations"/>
   <task end="2023-01-17 10:07:51.000Z" label="MyTask" name="TSK2" start="2023-01-16 10:07:51.000Z"
   status="1">
    <owner _operation="none" name="admin" type="0"/>
    <operation _operation="none" internalName="OP1"/>
    <folder _operation="none" name="nmsTask"/>
   </task>
   <workflow internalName="WKF12" label="CampaignWorkflow" modelName="newOpEmpty"
   order="8982" scenario-cs="Notification of the workflow supervisor (notifySupervisor)"
   schema="nms:recipient">
    <scenario internalName="notifySupervisor"/>
    <desc></desc>
    <folder _operation="none" name="Folder4"/>
    <operation _operation="none" internalName="OP1"/>
   </workflow>
  </operation>
 </entities>
</package>

在具有​ @pkgAdmin和 ​属性的架构中定义了包类型的关联@pkgPlatform 这两个属性都接收定义与包关联的条件的XTK表达式。

<element name="offerEnv" img="nms:offerEnv.png"
template="xtk:folder" pkgAdmin="@id != 0">

最后，@pkgStatus ​属性允许您定义这些元素或属性的导出规则。 根据属性的值，可在导出的资源包中找到元素或属性。 此属性的三个可能值是：

管理包定义 managing-package-definitions

包定义允许您创建包结构，其中添加稍后将在单个包中导出的实体。 然后，您可以将此资源包和所有添加的实体导入另一个Campaign实例。

相关主题：

创建包定义 creating-a-package-definition

可从​ Administration > Configuration > Package management > Package definitions ​菜单访问包定义。

要创建包定义，请单击​ New ​按钮，然后填写包定义常规信息。

然后，可以将实体添加到包定义中，并将其导出到XML文件包中。

相关主题：

将实体添加到包定义 adding-entities-to-a-package-definition

在​ Content ​选项卡中，单击​ Add ​按钮以选择要与包一起导出的实体。 此部分部分介绍了选择实体时的最佳实践。

实体可以直接从其在实例中的位置添加到包定义中。 为此请执行以下操作步骤：

配置包定义生成 configuring-package-definitions-generation

可以从包定义​ Content ​选项卡配置包生成。 为此，请单击​ Generation parameters ​链接。

从资源包定义导出资源包 exporting-packages-from-a-package-definition

要从资源包定义导出资源包，请执行以下步骤：

导入包 importing-packages

可通过Adobe Campaign客户端控制台的主菜单​ Tools > Advanced > Import package ​访问包导入助手。

您可以从先前执行的导出导入包，例如从其他Adobe Campaign实例或内置包，具体取决于您的许可条款。

从文件安装包 installing-a-package-from-a-file

要导入现有的数据包，请选择XML文件并单击​ Open。

然后，要导入的包的内容将显示在编辑器的中间部分。

单击​ Next ​和​ Start ​启动导入。

安装内置软件包 installing-a-standard-package

标准包是内置包，在配置Adobe Campaign时安装。 根据您的权限和部署模式，如果您获取新选项或插件，或者如果您升级到新选件，则可以导入新的标准资源包。

请参阅您的许可协议，查看可以安装的软件包。

有关内置软件包的详细信息，请参阅此页面。

数据包最佳实践 data-package-best-practices

本节介绍如何在项目的整个生命周期中以一致的方式组织数据包。

包可以包含不同类型的配置和元素，无论是否进行了过滤。 如果缺少某些元素或未按正确顺序导入元素/包，则平台配置可能会中断。

此外，如果多个人员在同一平台上工作，并且具有许多不同的功能，则包规范文件夹会快速变得复杂。

虽然此部分并不强制要求，但提供了一个解决方案，可帮助整理和使用Adobe Campaign中的包以用于大型项目。

主要限制因素如下：

推荐做法 data-package-recommendations

始终在同一平台版本中导入。 您必须检查是否在具有相同内部版本的两个实例之间部署包。 切勿强制导入，并始终先更新平台（如果内部版本不同）。

注意架构和数据库结构。 导入带架构的包后必须生成架构。

解决方案 data-package-solution

包类型 package-types

首先定义不同类型的资源包。 将只使用四种类型：

个实体

如果您需要在新实例上部署配置，则可以导入所有实体包。

功能

此类型的包：

营销活动

此包不是强制性的。 有时，为所有营销活动创建特定类型会很有用，即使营销活动被视为一项功能也是如此。

更新

配置功能后，可将其导出到其他环境中。 例如，可以将包从开发环境导出到测试环境。 在此测试中，发现了一个缺陷。 首先，它需要在开发环境中进行修复。 然后，将修补程序应用到测试平台。

第一个解决方案是再次导出整个功能。 但是，为了避免任何风险（更新不需要的元素），只包含修正值的套餐更加安全。

因此，我们建议创建一个“更新”包，其中只包含该特征的一个图元类型。

更新不仅可以是修复，也可以是实体/功能/营销活动包的新元素。 要避免部署整个包，可以导出更新包。

命名约定 data-package-naming

现在已定义了类型，我们应该指定命名约定。 Adobe Campaign不允许为包规范创建子文件夹，这意味着数字是保持有条不紊的最佳解决方案。 数字前缀包名称。 您可以使用以下约定：

包 data-packages

实体包顺序 entity-packages-order

为帮助导入，实体包应按照导入时的顺序排序。 例如：

包200 package-200

包编号“200”不应用于特定营销活动：此编号将用于更新涉及所有营销活动的内容。

更新包 update-package

最后一点涉及更新包的编号。 它是以“5”为前缀的程序包编号（实体、功能或营销活动）。 例如：

更新包应仅包含一个特定实体，以便易于重用。 要拆分它们，请添加新数字（从1开始）。 这些软件包没有特定的排序规则。 为了更好地理解，假设我们有一个101功能，一个社交应用程序：

包文档 package-documentation

更新包时，应始终在描述字段中添加注释以详细说明任何修改和原因（例如，“添加新架构”或“修复缺陷”）。

您还应设置评论的日期。 始终将您对更新包的注释报告给“父级”（不带5前缀的包）。