데이터 패키지 작업 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> 요소에 schema 특성에 입력한 데이터 스키마 형식의 패키지 데이터가 포함되어 있습니다. 패키지의 데이터에는 자동 생성 키(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

패키지를 업데이트할 때 항상 설명 필드에 설명을 추가하여 수정 사항 및 이유를 자세히 설명해야 합니다(예: "새 스키마 추가" 또는 "오류 수정").

또한 업데이트 날짜를 입력하는 것이 좋습니다.