使用資料包

關於資料包

使用 Adobe Campaign，您可以透過資料包系統匯出或匯入平台配置和資料。包可以包含不同類型的配置、元素、過濾或不過濾。

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

The principle of data packages is to export a data configuration and integrate it into another Adobe Campaign system. 瞭解如何在本節中維護一致的資料套 件。

包類型

可導出包有三種類型：使用者套件、平台套件和管理套件。

• 用戶包:它允許您選擇要導出的圖元清單。 此類軟體包可管理相依性並驗證錯誤。

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

  

• 管理套件:它包含所有新增的範本和商業物件（非標準）:範本、資料庫等。

  

資料結構

資料包的描述是符合 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>

具有 operation 值"none"的屬性定義協調連結。

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

匯出套件

關於套件匯出

可以以三種不同的方式導出包：

• 可 Package Export Wizard 以在單個包中導出一組對象。 有關詳細資訊，請參 閱導出包中的一組對象
• 單 個對象 ，可通過按一下右鍵並選擇直接導出到包中 Actions > Export in a package。
• 包定義 可讓您建立包結構，在其中添加將在以後在包中導出的對象。 有關詳細資訊，請參閱管 理包定義

在匯出套件後，您就可以將它和所有新增的實體匯入另一個促銷活動例項。

導出包中的一組對象

套件匯出精靈可透過Adobe Campaign用戶 Tools > Advanced > Export package… 端主控台的選單存取。

對於三種類型的包，嚮導提供了以下步驟：

1. 按文檔類型列出要導出的圖元：

   

   注意

   如果您匯出 Offer category、 Offer environment​或 Program 類型資料夾，請勿選取 Plan xtk:folder ​​，因為您可能會遺失一些資料。 選擇與資料夾對應的實體： nms:offerCategory for offer category , nms:offerEnv for offer environments, nms:program for programs, nms:plan for plans.

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

   按鈕 Detail 會編輯選取的設定。

   注意

   從屬機制控制實體導出序列。 For more on this, refer to Managing dependencies.

2. 實體配置螢幕定義要提取的文檔類型的過濾器查詢。

   必須為資料抽取配置過濾子句。

   

   注意

   此部分顯示查詢 編輯器。

3. 按一下 Next 並選擇排序列，以在提取過程中對資料進行排序：

   

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

   

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

   

管理相依性

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

此機制由兩個規則定義：

• 連結到具有自 己​或 owncopy類型完整性的連結的對象將導出到與導出對象相同的包中。
• 連結至具有中性或定 義類型​​ 完整性（定義的連結）的物件必須個別匯出。

匯出促銷活動

以下是如何匯出促銷活動的範例。 要匯出的行銷促銷活動包含一個工作(標籤：「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:授權建立連結的實體

管理包定義

關於包定義

包定義允許您建立包結構，在其中添加將在以後在單個包中導出的實體。 然後，您就可以將此套件及所有新增的實體匯入另一個促銷活動實例。

相關主題：

• 建立包定義
• 向包定義添加實體
• 配置包定義生成
• 從包定義導出包

Creating a package definition

可從菜單訪問包定 Administration > Configuration > Package management > Package definitions 義。

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

然後，可以將實體添加到包定義中，並將其導出到XML檔案包中。

相關主題：

• 向包定義添加實體
• 配置包定義生成
• 從包定義導出包

向包定義添加實體

在頁籤 Content 中，按一下按 Add 鈕以選擇要與包一起導出的實體。 在「導出包中的一組對象」( Exporting a set of objects in a package )部分中顯示了選擇圖元時的最佳做法。

實體可直接從實體在實例中的位置添加到包定義中。 要執行此操作，請遵循下列步驟：

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 鈕啟動導出。

   

導入包

關於包導入

套件匯入精靈可透過Adobe Campaign用戶端主控台 Tools > Advanced > Package import… 的主功能表存取。

您可以從先前執行的匯出匯入套件，例如從其他Adobe Campaign例項或內建套件匯入 套件，視授權條款而定。

從檔案安裝軟體包

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

然後，要導入的包的內容將顯示在編輯器的中間部分。

按一 Next 下並 Start 啟動匯入。

安裝內置軟體包

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

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

For more information on built-in packages, refer to this page.

資料套件最佳實務

本節介紹如何在整個項目生命週期中以一致的方式組織資料包。

包可以包含不同種類的配置和元素，無論是否經過篩選。 如果您遺漏某些元素或未以正確順序匯入元素／封裝，平台組態可能會中斷。

此外，由於同一平台上有許多不同的功能，使得封裝規格資料夾的複雜度很快。

雖然不是強制性的，但本節提供解決方案，協助您在Adobe Campaign中組織及使用套件以進行大型專案。

主要限制如下：

• 組織套件並追蹤變更的項目及變更時間
• 如果更新了配置，將破壞未直接與更新連結的內容的風險降至最低

建議

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

注重模式和資料庫結構。 導入具有模式的包後必須生成模式。

解決方案

包類型

首先，定義不同類型的包。 僅使用4種類型：

實體

• 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首碼的套件）。