使用資料套件 data-packages

開始使用封裝 gs-data-packages

您可以使用資料包來匯出和匯入平台自訂設定和資料。 套件可包含不同型別的設定和元件，不論是否經過篩選。

在Campaign資料套件中，Adobe Campaign資料庫的實體會顯示為XML檔案。 在套件中，每個實體由其所有資料表示。

資料套件 ​的原理是匯出資料組態，並將其整合到另一個Adobe Campaign環境中。 瞭解如何在此區段中維持一組一致的資料封裝。

封裝型別 types-of-packages

您可以在Adobe Campaign中使用三種型別的套件：使用者套件、平台套件和管理套件。

資料結構 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 ​選項）。

在我們的範例中，folder和company連結上的聯結已由目的地資料表上的所謂「高階」索引鍵取代：

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

值為none的operation屬性定義了調解連結。

您可以從任何文字編輯器手動建立資料套件。 您必須確保XML檔案的結構符合xtk:navtree資料結構描述。 使用者端主控台具有資料包匯出與匯入模組。

匯出套件 export-packages

套件可以三種不同的方式匯出：

套件匯出後，您可以將它和所有新增的實體匯入另一個Campaign執行個體。

匯出封裝中的一組物件 export-a-set-of-objects-in-a-package

若要匯出資料封裝中的物件集，請遵循下列步驟：

管理相依性 manage-dependencies

匯出程式會追蹤各種匯出元素之間的連結。 此機制由兩個規則定義：

匯出行銷活動 export-a-campaign

以下是如何匯出行銷活動的範例。 要匯出的行銷活動包含：

任務和工作流程會匯出到與行銷活動相同的封裝中，因為相符的結構描述是由具有own型別整合性的連結所連線。

封裝內容為：

<?xml version='1.0'?>
<package author="Administrator (admin)" buildNumber="7974" buildVersion="7.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 and @pkgPlatform屬性的結構描述中定義套裝型別的附屬關係。 這兩個屬性都會接收定義套裝軟體附屬關係條件的XTK運算式。

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

最後，@pkgStatus屬性可讓您定義這些元素或屬性的匯出規則。 根據屬性的值，可在匯出的封裝中找到元素或屬性。 此屬性的三個可能值包括：

管理封裝定義 manage-package-definitions

封裝定義可讓您建立封裝結構，在其中新增稍後將在單一封裝中匯出的實體。 然後，您就可以將此套件和所有新增的實體匯入另一個Campaign執行個體。

建立套件定義 create-a-package-definition

可從​ Administration > Configuration > Package management > Package definitions ​功能表存取封裝定義。

若要建立封裝定義，請按一下​ New ​按鈕，然後填寫封裝定義的一般資訊。

然後，您可以將實體加入封裝定義中，並將其匯出至XML檔案封裝。

相關主題：

將實體新增至封裝定義 add-entities-to-a-package-definition

在​ Content ​索引標籤中，按一下​ Add ​按鈕以選取要與封裝一起匯出的實體。 選取實體時的最佳實務會顯示在此區段中。

實體可以直接從其在執行個體中的位置新增到套件定義中。 要執行此操作，請遵循下列步驟：

設定封裝定義產生 configure-package-definitions-generation

封裝產生可從封裝定義​ Content ​標籤進行設定。 若要這麼做，請按一下​ Generation parameters ​連結。

從封裝定義匯出封裝 export-packages-from-a-package-definition

若要從封裝定義匯出封裝，請遵循下列步驟：

匯入套件 import-packages

可以透過使用者端主控台的主功能表​ Tools > Advanced > Import package ​存取套件匯入小幫手。

從檔案安裝套件 install-a-package-from-a-file

若要匯入現有的資料套件，請執行下列步驟：

然後，要匯入的封裝內容會顯示在編輯器的中間區段中。

按一下​ Next ​和​ Start ​以啟動匯入。

安裝內建套件 install-a-standard-package

內建套件(亦稱為 標準套件)會在設定Adobe Campaign時安裝。 您可以匯入新的標準套件，具體取決於您的許可權、部署模式和產品。

請參閱您的授權合約，以檢查您可以安裝哪些套件。

資料套件最佳實務 data-package-best-practices

本節說明如何在專案的整個生命週期中，以一致的方式組織資料套件。

版本

您必須一律匯入相同版本的平台。 您必須檢查是否要在具有相同組建的兩個執行個體之間部署套件。 切勿強制匯入，並一律先更新平台（如果組建不同）。

請留意結構描述和資料庫結構。 匯入具有結構描述的套件後必須產生結構描述。

封裝型別 package-types

從定義不同型別的封裝開始。 僅使用四種型別：

個實體

如果您需要在新執行個體上部署設定，可以匯入所有實體套件。

功能

此型別的封裝：

行銷活動

此封裝不是強制性的。 有時候，為所有行銷活動建立特定型別會很有用，即使行銷活動可視為一項功能。

更新

設定之後，功能就可以匯出至另一個環境。 例如，套件可從開發環境匯出至測試環境。 在此測試中，會顯示缺陷。 首先，它需要在開發環境中修正。 接著，應該將修補程式套用至測試平台。

第一個解決方案是再次匯出整個特徵。 但是，為避免任何風險（更新不需要的元素），僅包含更正的套件比較安全。

這就是我們建議建立「更新」封裝的原因，它只包含特徵的一個圖元型別。

更新不僅可以是修正，也可以是實體/功能/行銷活動封裝的新元素。 若要避免部署整個套件，您可以匯出更新套件。

命名慣例 data-package-naming

現在已定義型別，我們應該指定命名慣例。 Adobe Campaign不允許根據套件規格建立子資料夾，這表示數字是保持井然有序的最佳解決方案。 數字前置碼封裝名稱。

例如，您可以使用以下慣例：

實體套件順序 entity-packages-order

為協助匯入，實體套件應按照匯入順序排序。

例如：

套件檔案 package-documentation

更新套件時，您應該一律在說明欄位中加上註解，以詳細說明任何修改和原因（例如「新增結構」或「修正缺陷」）。

最佳實務也是輸入更新日期。