Show Menu
화제×

데이터 패키지 작업

데이터 패키지 정보

Adobe Campaign을 사용하면 패키지 시스템을 통해 플랫폼 구성 및 데이터를 내보내거나 가져올 수 있습니다. 패키지에는 서로 다른 종류의 구성, 요소, 필터링되거나 필터링되지 않을 수 있습니다.
데이터 패키지를 사용하면 Adobe Campaign 데이터베이스의 엔터티가 XML 형식의 파일을 통해 표시될 수 있습니다. 패키지에 포함된 각 엔티티는 모든 데이터로 표현됩니다.
데이터 패키지의 원리는 데이터 구성을 내보내고 다른 Adobe Campaign 시스템에 통합하는 것이다. 이 섹션에서 일관된 데이터 패키지 세트를 유지 관리하는 방법을 살펴볼 수 있습니다 .

패키지 유형

내보낼 수 있는 패키지는 다음과 같은 세 가지가 있습니다. 사용자 패키지, 플랫폼 패키지 및 관리 패키지.
  • 사용자 패키지 : 내보낼 엔티티 목록을 선택할 수 있습니다. 이 유형의 패키지는 종속성을 관리하고 오류를 확인합니다.
  • Platform 패키지 : 여기에는 추가된 모든 기술 리소스(비표준)가 포함됩니다. 스키마, 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> schema 특성에 입력된 데이터 스키마 형식의 패키지 데이터를 포함합니다.
패키지의 데이터에는 자동 생성된 키(자동 생성 옵션)와 같이 기본 간에 호환하지 않는 내부 키가​ 들어 있으면 안 됩니다.
이 예제에서는 "folder" 및 "company" 링크의 조인이 대상 테이블의 "상위 수준" 키로 대체되었습니다.
<recipient>
  <folder _operation="none" name="nmsRootFolder"/>
  <company _operation="none" name="Adobe"/>
</recipient>

값 "none"이 있는 operation 속성은 조정 링크를 정의합니다.
데이터 패키지는 모든 텍스트 편집기에서 수동으로 구성할 수 있습니다. XML 문서의 구조가 "xtk:navtree" 데이터 스키마를 따르는지 확인하기만 하면 됩니다. Adobe Campaign 콘솔에는 데이터 패키지 내보내기 및 가져오기 모듈이 있습니다.

패키지 내보내기

패키지 내보내기 정보

패키지는 다음과 같은 세 가지 방법으로 내보낼 수 있습니다.
  • Package Export Wizard 를 사용하면 하나의 패키지에서 객체 세트를 내보낼 수 있습니다. 자세한 내용은 패키지에서 개체 세트 내보내기를 참조하십시오.
  • 오브젝트를 마우스 오른쪽 버튼으로 클릭하고 선택하여 패키지로 단일 객체를 내보낼 수 있습니다 Actions > Export in a package .
  • 패키지 정의를 사용하면 나중에 패키지에서 내보낼 개체를 추가할 패키지 구조를 만들 수 있습니다. 자세한 내용은 패키지 정의 관리를 참조하십시오.
패키지를 내보내면 패키지 및 추가된 모든 엔티티를 다른 Campaign 인스턴스로 가져올 수 있습니다.

패키지에서 객체 집합 내보내기

패키지 내보내기 마법사는 Adobe Campaign 클라이언트 콘솔의 Tools > Advanced > Export package... 메뉴를 통해 액세스할 수 있습니다.
세 가지 유형의 패키지의 경우 마법사에서 다음 단계를 제공합니다.
  1. 문서 유형별로 내보낼 엔티티를 나열합니다.
    폴더 Offer category , 폴더 Offer environment Program 또는 Plan 유형을 내보내면 데이터가 손실될 수 있으므로 xtk: 폴더를 선택하지 마십시오. 폴더에 해당하는 엔티티를 선택합니다. nms:offer 카테고리, 오퍼 환경을 위한 nms:offerEnv , nms:프로그램 nms:계획에 대한계획
    목록 관리를 사용하면 구성에서 내보낼 엔티티를 추가하거나 삭제할 수 있습니다. 아이콘을 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 : 연결된 엔티티 생성 권한 부여
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 : 가 모든 엔티티 속성의 값을 패키지에 추가합니다.
    긴 내보내기를 피하기 위해 이 옵션은 기본적으로 선택되어 있지 않습니다. 즉, 기본값('empty string', '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 구성 시 설치되는 내장 패키지입니다. 사용 권한 및 배포 모델에 따라 새 옵션이나 추가 기능을 획득하거나 새 오퍼로 업그레이드하는 경우 새로운 표준 패키지를 가져올 수 있습니다.
설치할 수 있는 패키지를 확인하려면 라이선스 계약을 참조하십시오.
내장 패키지에 대한 자세한 내용은 이 페이지를 참조하십시오 .

데이터 패키지 우수 사례

이 섹션에서는 프로젝트 수명 전체에서 일관적으로 데이터 패키지를 구성하는 방법에 대해 설명합니다.
패키지에 서로 다른 종류의 구성 및 요소가 포함될 수 있으며 필터링되거나 그렇지 않을 수도 있습니다. 일부 요소가 없거나 요소/패키지를 올바른 순서로 가져오지 않으면 플랫폼 구성이 중단됩니다.
또한 여러 가지 다양한 기능을 갖춘 동일한 플랫폼을 사용하는 사용자가 여러 명 있으므로 패키지 사양 폴더가 빠르게 복잡해질 수 있습니다.
필수 사항은 아니지만 이 섹션에서는 대규모 프로젝트에서 패키지를 구성하고 사용하는 데 도움이 되는 솔루션을 제공합니다.
기본 제한 사항은 다음과 같습니다.
  • 패키지를 구성하고 변경된 내용과 시기를 추적할 수 있습니다
  • 구성이 업데이트되는 경우, 업데이트에 직접 연결되지 않은 항목을 끊을 위험을 최소화합니다
패키지를 자동으로 내보내는 워크플로우 설정에 대한 자세한 내용은 이 페이지를 참조하십시오 .

Recommendations

항상 동일한 플랫폼 버전 내에서 가져오기 빌드가 동일한 두 인스턴스 사이에 패키지를 배포하는지 확인해야 합니다. 가져오기 작업을 강제 수행하지 않고, 항상 먼저 플랫폼을 업데이트합니다(빌드가 다른 경우).
다른 버전 간 가져오기는 Adobe에서 지원하지 않습니다.
스키마 및 데이터베이스 구조에 주의를 기울입니다. 스키마가 있는 패키지 가져오기 뒤에 스키마를 생성해야 합니다.

솔루션

패키지 유형

다양한 유형의 패키지를 정의하여 시작합니다. 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부터 시작). 이러한 패키지에 대한 특정 순서 규칙이 없습니다. Adobe가 101 기능인 소셜 애플리케이션을 보유하고 있다고 가정해 보십시오.
  • 여기에는 webApp 및 외부 계정이 포함됩니다.
    • 패키지 레이블은 다음과 같습니다. 101 - 소셜 애플리케이션(socialApplication).
  • webApp에 결함이 있습니다.
    • wepApp이 수정되었습니다.
    • 다음 이름으로 수정 패키지를 만들어야 합니다. 5101 - 1 - Social application webApp(socialApplication_webApp)
  • 소셜 기능을 사용하려면 새 외부 계정을 추가해야 합니다.
    • 외부 계정이 만들어집니다.
    • 새로운 패키지: 5101 - 2 - Social 응용 프로그램 외부 계정(socialApplication_extAccount).
    • 101 패키지는 외부 계정에 추가되도록 업데이트되지만 배포되지는 않습니다.

패키지 설명서

패키지를 업데이트할 때는 항상 설명 필드에 모든 수정 사항과 이유를 자세히 설명하는 설명을 입력해야 합니다(예: "새 스키마 추가" 또는 "결함 수정").
또한 댓글을 날짜로 지정해야 합니다. 업데이트 패키지에 대한 주석을 항상 "parent"로 보고합니다(5개의 접두사가 없는 패키지).
설명 필드에는 최대 2.000자까지 입력할 수 있습니다.