使用 Adobe Campaign,您可以通过数据包系统导出或导入平台配置和数据。包可以包含不同类型的配置、元素、筛选或不筛选。
数据包支持以 XML 格式文件的形式显示 Adobe Campaign 数据库的实体。数据包中包含的每个实体由其全部数据表示。
数据包的原理是导出数据配置并将其集成到另一个Adobe Campaign系统中。 了解如何在此部分中保持一组一致的数据包。
有三种类型的可导出包:用户包、平台包和管理员包。
用户包:它允许您选择要导出的图元的列表。此类型的包管理依赖关系并验证错误。
平台包:它包括所有附加的技术资源(非标准):模式、JavaScript代码等。
管理程序包:它包括所有添加的模板和业务对象(非标准):模板、库等。
platform和admin类型包含要导出的实体的预定义列表。 每个实体都链接到过滤条件,这些条件允许您删除已创建包的现成资源。
数据包的描述是符合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控制台具有数据包导出和导入模块。
可以通过三种不同的方式导出包:
导出包后,您将能够将它和所有添加的实体导入另一个活动实例。
包导出向导可通过Adobe Campaign客户端控制台的Tools > Advanced > Export package…菜单访问。
对于三种类型的包,向导将优惠以下步骤:
列表要按文档类型导出的实体:
如果导出Offer category、Offer environment、Program或Plan类型文件夹,则不要选择xtk:folder,因为您可能会丢失一些数据。 选择与文件夹对应的实体:nms:offerCategory用于优惠类别,nms:offerEnv用于优惠环境,nms:项目用于项目,nms:plan用于计划。
列表管理允许您添加或删除要从配置中导出的实体。 单击Add以选择新实体。
Detail按钮编辑所选配置。
依赖关系机制控制实体导出序列。 有关详细信息,请参阅管理依赖项。
实体配置屏幕定义要提取的查询类型的筛选器文档。
必须为数据提取配置过滤子句。
查询编辑器显示在此部分中。
单击Next并选择排序列,在提取期间对数据进行排序:
预览要提取的数据,然后运行导出。
包导出向导的最后一页允许您开始导出。 数据将存储在File字段中指示的文件中。
导出机制使Adobe Campaign能够跟踪各种导出元素之间的链接。
此机制由两个规则定义:
链接到模式元素的完整性类型在本节中定义。
以下是如何导出活动的示例。 要导出的营销活动包含任务(标签:“MyTask”)和工作流(标签:“MyWorkflow”文件夹(节点:管理/生产/技术工作流/活动流程/ MyWorkflow)。
任务和工作流将导出到与活动相同的包中,因为匹配模式通过具有“自己”类型完整性的链接连接。
打包内容:
<?xml version='1.0'?>
<package author="Administrator (admin)" buildNumber="7974" buildVersion="6.1" img=""
label="" name="" namespace="" vendor="">
<desc></desc>
<version buildDate="2013-01-09 10:30:18.954Z"/>
<entities schema="nms:operation">
<operation duration="432000" end="2013-01-14" internalName="OP1" label="MyCampaign"
modelName="opEmpty" start="2013-01-09">
<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="2013-01-17 10:07:51.000Z" label="MyTask" name="TSK2" start="2013-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属性允许您定义这些元素或属性的导出规则。 根据属性的值,元素或属性将在导出的包中找到。 此属性的三个可能值是:
preCreate值仅允许链接类型事件。 它授权您创建或指向尚未加载到导出包中的实体。
包定义允许您创建包结构,在其中添加稍后将在单个包中导出的实体。 然后,您将能够将此包和所有添加的实体导入另一个活动实例。
相关主题:
可以从Administration > Configuration > Package management > Package definitions菜单访问包定义。
要创建包定义,请单击New按钮,然后填写包定义一般信息。
然后,可以向包定义中添加实体,并将其导出到XML文件包。
相关主题:
在Content选项卡中,单击Add按钮以选择要与包一起导出的实体。 在导出包中的一组对象部分介绍了选择实体时的最佳实践。
实体可以直接从它们在实例中的位置添加到包定义。 为此请执行以下操作步骤:
右键单击所需的实体,然后选择Actions > Export in a package。
选择Add to a package definition,然后选择要向其添加实体的包定义。
实体被添加到包定义中,它将随包一起导出(请参阅从包定义导出包)。
可以通过包定义Content选项卡配置包生成。 为此,请单击Generation parameters链接。
Include the definition:包括当前在包定义中使用的定义。
Include an installation script:允许您添加要在包导入时执行的javascript脚本。选中后,Script选项卡会添加到包定义屏幕中。
Include default values:向包中添加所有实体属性的值。
为避免冗长的出口,默认情况下不选择此选项。 这意味着,具有默认值(“空字符串”、“0”和“false”(如果未在模式中另行定义)的实体属性不会添加到包中,因此不会导出。
取消选择此选项可能会导致合并本地版本和导入的版本。
如果导入包的实例包含与包相同的实体(例如,具有相同的外部ID),则不会更新其属性。 如果前实例的属性具有默认值,则会发生这种情况,因为包中不包含这些属性。
在这种情况下,选择Include default values选项将阻止版本合并,因为以前的实例的所有属性都将与包一起导出。
要从包定义中导出包,请执行以下步骤:
选择要导出的包定义,然后单击Actions按钮并选择Export the package。
默认情况下,将选择与导出的包对应的XML文件。 它根据包定义命名空间和名称命名。
定义包名称和位置后,单击Start按钮启动导出。
包导入向导可通过Adobe Campaign客户端控制台的主菜单Tools > Advanced > Package import…访问。
您可以从以前执行的导出导入包,例如,从另一个Adobe Campaign实例或内置包导入包,具体取决于许可证条款。
要导入现有数据包,请选择XML文件,然后单击Open。
随后,要导入的包的内容将显示在编辑器的中间部分。
单击Next和Start以启动导入。
标准包是内置包,在配置Adobe Campaign时安装。 根据您的权限和部署模型,如果您获得了新选项或加载项,或者升级到新优惠,则可以导入新的标准包。
请参阅您的许可协议,检查可以安装哪些包。
有关内置软件包的详细信息,请参阅此页。
本节介绍如何在项目的整个生命周期中以一致的方式组织数据包。
包可以包含不同类型的配置和元素,无论是否已过滤。 如果缺少某些元素或未按正确的顺序导入元素/包,平台配置可能会中断。
此外,由于同一平台上有多人工作,具有许多不同的功能,因此包装规范文件夹会很快变得复杂。
虽然这并非强制性要求,但本节优惠了一个解决方案,帮助在大型项目的Adobe Campaign中组织和使用包。
主要限制如下:
有关设置工作流以自动导出包的详细信息,请参阅此页。
始终在平台的同一版本内导入。 必须检查是否在具有相同内部版本的两个实例之间部署包。 切勿强制导入并始终先更新平台(如果版本不同)。
Adobe不支持在不同版本之间导入。
注意模式和数据库结构。 进口包装时必须模式,然后生成模式。
开始。 只使用四种类型:
实体
如果需要在新实例上部署配置,可以导入所有实体包。
功能
此类包:
营销策划
此包不是强制的。 有时,为所有活动创建特定类型很有用,即使活动可以看作是功能。
更新
配置后,功能可导出到其他环境。 例如,可以将包从开发环境导出到测试环境。 在本试验中,发现了缺陷。 首先,它需要在开发环境上修复。 然后,应将该修补程序应用到测试平台。
第一个解决方案是再次导出整个功能。 但是,为了避免任何风险(更新不需要的元素),更安全的方法是只包含修正的包。
因此,我们建议创建一个“更新”包,它只包含一个功能实体类型。
更新不仅可以是修复,也可以是实体/功能/活动包的新元素。 要避免部署整个包,您可以导出更新包。
既然已定义类型,我们应指定命名约定。 Adobe Campaign不允许为包规范创建子文件夹,这意味着数字是保持条理井然的最佳解决方案。 编号作为包名称前缀。 您可以使用以下约定:
最好设置规则来定义正确数量的包。
为了帮助导入,实体包应按导入时的顺序进行排序。 例如:
Forms只有在模式更新后才应进口。
包编号“200”不应用于特定活动:此数字将用于更新与所有活动相关的内容。
最后一点涉及更新包编号。 它是您的包编号(实体、功能或活动),前缀为“5”。 例如:
更新包应仅包含一个特定实体,以便能够轻松地重用。 要拆分它们,请添加一个新数字(开始自1)。 这些包没有特定的订购规则。 为了更好地了解情况,请设想我们有一个101功能,一个社交应用程序:
外部帐户已创建。
新包为:5101 - 2 —— 社交应用程序外部帐户(socialApplication_extAccount)。
并行更新101包以添加到外部帐户,但它未部署。
更新包时,您应始终在描述字段中添加注释以详细说明任何修改和原因(例如,“添加新模式”或“修复缺陷”)。
您还应该对评论进行日期设置。 始终将更新包的注释报告给“parent”(包不带5前缀)。
描述字段最多只能包含2.000个字符。