v7 v8

使用資料包

關於資料套件

使用 Adobe Campaign，您可以透過資料包系統匯出或匯入平台配置和資料。套件可以包含不同型別的設定、元素、已篩選或不篩選。

資料包可以 XML 格式檔案的形式顯示 Adobe Campaign 資料庫的實體。資料包中包含的每個實體都會以其所有資料表示。

的原則 資料套件 是匯出資料設定，並將其整合至另一個Adobe Campaign系統。 在此瞭解如何維持一組一致的資料包 區段.

封裝型別

可匯出的套件型別有三種：使用者套件、平台套件和管理套件。

• 使用者套件：可讓您選取要匯出的實體清單。 這種型別的套件管理相依性並驗證錯誤。

• 平台套件：包括所有新增的技術資源（非標準）：結構描述、JavaScript程式碼等。

  

• 管理套件：包括所有新增的範本和業務物件（非標準）：範本、物件庫等。

  

資料結構

資料封裝的描述是符合 xrk：navtree 資料結構描述。

資料封裝範例：

<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>

此 operation 值為「none」的屬性會定義調解連結。

您可以從任何文字編輯器手動建構資料套件。 只要確保XML檔案的結構符合「xtk：navtree」資料結構描述即可。 Adobe Campaign主控台有資料包匯出和匯入模組。

匯出套件

關於封裝匯出

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

• 此 Package Export Wizard 可讓您匯出單一封裝中的一組物件。 如需詳細資訊，請參閱 匯出封裝中的一組物件
• A 單一物件 以滑鼠右鍵按一下並選取「 」，可直接匯出到套件中 Actions > Export in a package.
• 套件定義 可讓您建立封裝結構，在其中新增稍後將在封裝中匯出的物件。 有關詳細資訊，請參閱 管理封裝定義

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

匯出封裝中的一組物件

套件匯出精靈可透過 Tools > Advanced > Export package… Adobe Campaign使用者端主控台功能表。

針對三種型別的套裝程式，精靈會提供下列步驟：

1. 按檔案型別列出要匯出的實體：

   

   注意

   如果您匯出 Offer category， Offer environment， Program 或 Plan 輸入資料夾，請勿選取 xtk：folder 因為您可能會遺失部分資料。 選取與資料夾對應的實體： nms：offerCategory 若為優惠方案類別， nms：offerEnv 若為優惠方案環境， nms：program 適用於計畫，以及 nms：plan 適用於計畫。

   清單管理可讓您新增或刪除要從設定匯出的實體。 按一下 Add 以選取新圖元。

   此 Detail 按鈕編輯選取的組態。

   注意

   相依性機制會控制實體匯出順序。 有關詳細資訊，請參閱 管理相依性.

2. 實體設定畫面會針對要擷取的檔案型別定義篩選查詢。

   您必須設定資料擷取的篩選子句。

   

   注意

   查詢編輯器的顯示位置為 本節.

3. 按一下 Next 並選取排序欄以在擷取期間排序資料：

   

4. 在執行匯出之前，先預覽要擷取的資料。

   

5. 套件匯出精靈的最後一頁可讓您開始匯出。 資料將會儲存在 File 欄位。

   

管理相依性

匯出機制可讓Adobe Campaign追蹤各種匯出元素之間的連結。

此機制由兩個規則定義：

• 連結至連結的物件，具有 擁有 或 owncopy 型別完整性會匯出到與匯出物件相同的封裝中。
• 連結至連結的物件 中立 或 定義 型別完整性（定義的連結）必須單獨匯出。

匯出行銷活動

以下是如何匯出行銷活動的範例。 要匯出的行銷活動包含「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="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：授權建立連結的實體

管理封裝定義

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

相關主題：

• 建立套件定義
• 將實體新增至封裝定義
• 設定封裝定義產生
• 從封裝定義匯出封裝

建立套件定義

套件定義可從以下位置存取： Administration > Configuration > Package management > Package definitions 功能表。

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

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

相關主題：

• 將實體新增至封裝定義
• 設定封裝定義產生
• 從封裝定義匯出封裝

將實體新增至封裝定義

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

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

1. 以滑鼠右鍵按一下所需的實體，然後選取 Actions > Export in a package.

   

2. 選取 Add to a package definition，然後選取您要新增實體的套件定義。

   

3. 實體會新增至封裝定義，隨封裝一併匯出(請參閱 本節)。

   

設定封裝定義產生

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

• Include the definition：包含封裝定義中目前使用的定義。

• Include an installation script：可讓您新增javascript指令碼，以在匯入套件時執行。 選取時， Script 索引標籤會新增到封裝定義畫面中。

• Include default values：將所有實體的屬性值新增至封裝中。

  為了避免冗長的匯出作業，預設不會選取此選項。 這表示具有預設值（「空字串」、「0」和「false」，如果未在結構描述中另外定義）的實體屬性將不會新增到封裝中，因此將不會匯出。

  注意

  取消選取此選項會導致本機版本與匯入版本的合併。

  如果匯入封裝的執行個體包含與封裝相同的實體（例如具有相同的外部ID），則其屬性不會更新。 如果前一個執行處理的屬性具有預設值，則可能會發生這種情況，因為它們未包含在封裝中。

  在該情況下，選取 Include default values 選項會防止版本合併，因為先前執行個體中的所有屬性都會隨套件匯出。

從封裝定義匯出封裝

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

1. 選取要匯出的封裝定義，然後按一下 Actions 按鈕並選取 Export the package.

2. 依預設，會選取與匯出封裝相對應的XML檔案。 它會根據套件定義名稱空間和名稱來命名。

3. 定義封裝名稱和位置後，按一下 Start 按鈕以啟動匯出。

   

匯入套件

套件匯入精靈可透過主功能表存取 Tools > Advanced > Import package Adobe Campaign使用者端主控台的。

您可以從先前執行的匯出動作匯入套件，例如從另一個Adobe Campaign執行個體匯入，或 內建套件，視您的授權條款而定。

從檔案安裝套件

若要匯入現有的資料套件，請選取XML檔案，然後按一下 Open.

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

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

安裝內建套件

標準套件是內建套件，在設定Adobe Campaign時安裝。 如果您取得新選項或附加元件，或升級至新選件，則根據您的許可權和部署模式，可以匯入新的標準套件。

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

如需內建套件的詳細資訊，請參閱 此頁面.

資料套件最佳實務

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

套件可以包含不同型別的設定和元素，無論是否經過篩選。 如果您遺漏了某些元素或未以正確順序匯入元素/套件，平台設定可能會中斷。

此外，如果同一個平台上有多名人員同時使用許多不同的功能，封裝規格資料夾可能會很快變得複雜。

雖然並非強制性，本節提供的解決方案可協助組織及使用Adobe Campaign中的套件以用於大型專案。

主要限制如下：

• 組織套件並追蹤變更內容及變更時間
• 如果更新設定，將破壞未直接連結到更新的專案的風險降至最低

建議

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

請留意結構描述和資料庫結構。 匯入含有結構描述的封裝後，必須產生結構描述。

解決方案

封裝型別

從定義不同型別的封裝開始。 系統只會使用四種型別：

實體

• Adobe Campaign中的所有「xtk」和「nms」特定元素，例如結構描述、表單、資料夾、傳遞範本等，
• 您可以將實體同時視為「管理員」和「平台」元素。
• 在Campaign執行個體上傳時，封裝中不應包含多個實體。

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

功能

此型別的封裝：

• 回答使用者端需求/規格。
• 包含一或多個功能。
• 應該包含所有相依性，才能在不使用任何其他封裝的情況下執行功能。

行銷活動

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

更新

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

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

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

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

命名慣例

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

• 實體：從1到99
• 功能：從100到199
• 促銷活動：從200到299
• 更新：從5000到5999

套件

實體套件順序

為協助匯入，實體套件應依匯入時的順序排序。 例如：

• 001 — 結構描述
• 002 — 表單
• 003 — 影像
• 等等。

封裝200

套件編號「200」不應用於特定行銷活動：此編號將用於更新與所有行銷活動有關的專案。

更新封裝

最後一點與更新封裝編號有關。 它是以「5」為前置詞的套件編號（實體、功能或促銷活動）。 例如：

• 5001以更新一個結構描述
• 5200可更新所有行銷活動
• 5101以更新101功能

更新套件應僅包含一個特定實體，以便可輕鬆重複使用。 若要進行分割，請新增數字（從1開始）。 這些套件沒有特定的排序規則。 若想進一步瞭解，假設我們有101功能、社交應用程式：

• 它包含webApp和外部帳戶。
  • 套件標籤為： 101 — 社交應用程式(socialApplication)。
• webApp上存在缺陷。
  • wepapp已更正。
  • 需要建立修正套件，其名稱如下： 5101 - 1 — 社交應用程式webApp (socialApplication_webApp)。
• 需要為社交功能新增新的外部帳戶。

  • 已建立外部帳戶。

  • 新封裝為： 5101 - 2 — 社交應用程式外部帳戶(socialApplication_extAccount)。

  • 同時更新101套件以新增至外部帳戶，但未部署。

    

套件檔案

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

您也應該指定註解的日期。 請一律將您對更新套件的評論報告給「父級」（不含5首碼的套件）。