가져오기 작업 구성

Adobe Campaign을 사용하면 하나 이상의 파일에서 텍스트, CSV, TAB 또는 XML 형식으로 데이터를 데이터베이스로 가져올 수 있습니다. 이러한 파일은 테이블(기본 또는 링크)과 연결되어 있으며 소스 파일의 각 필드는 데이터베이스의 필드와 연결됩니다.

노트

Import a list 함수를 사용하여 데이터베이스 데이터와 매핑하지 않고 데이터를 가져올 수 있습니다. 그런 다음 데이터를 Read list 개체를 통해 워크플로우에서만 사용할 수 있습니다. 자세한 정보는 이 페이지를 참조하십시오.

가져오기 마법사를 사용하여 가져오기를 구성하고, 해당 옵션(데이터 변형 등)을 정의하고, 실행을 시작할 수 있습니다. 가져오기 유형(단순 또는 다중) 및 연산자 권한에 따라 내용이 달라지는 일련의 화면입니다.

가져오기 마법사는 새 가져오기 작업을 만든 후 표시됩니다(가져오기 및 내보내기 작업 만들기 참조).

노트

IIS 웹 서버를 사용하는 경우 대용량 파일(>28MB)을 업로드하는 데 구성이 필요할 수 있습니다. 자세한 정보는 이 섹션을 참조하십시오.

소스 파일

소스 파일에서 각 행은 레코드와 일치합니다. 레코드의 데이터는 구분 기호(공백, 탭, 문자 등)로 구분됩니다. 즉, 데이터는 열 형태로 검색되고 각 열은 데이터베이스의 필드와 연결됩니다.

1단계 - 가져오기 템플릿 선택

가져오기 마법사를 시작할 때 먼저 템플릿을 선택해야 합니다. 예를 들어 뉴스레터를 받은 수신자의 가져오기를 구성하려면 아래 단계를 따르십시오.

  1. Profiles and Targets > Job > Generic imports and exports 폴더를 선택합니다.

  2. 새로 만들기​를 클릭한 다음 가져오기​를 클릭하여 가져오기 템플릿을 만듭니다.

  3. Import template 필드 오른쪽의 화살표를 클릭하여 템플릿을 선택하거나 Select link 을 클릭하여 트리를 찾습니다.

    기본 템플릿은 New text import​입니다. 이 템플릿은 수정할 수 없지만 요구 사항에 따라 새 템플릿을 구성하기 위해 복제할 수 있습니다. 기본적으로 가져오기 템플릿은 Profiles and targets > Templates > Job templates 노드에 저장됩니다.

  4. Label 필드에 이 가져오기의 이름을 입력합니다. 설명을 추가할 수 있습니다.

  5. 해당 필드에서 가져오기 유형을 선택합니다. 가져올 수 있는 가져오기 유형은 다음과 같습니다.한 파일만 가져오려면 Simple import, 한 번 실행으로 여러 파일을 가져오려면 Multiple import.

    여러 가져오기를 수행하려면 가져오기 마법사의 첫 번째 화면에 있는 Import type 드롭다운 목록에서 Multiple import​을 선택합니다.

  6. Add​을 클릭하여 가져올 필드를 지정합니다.

    파일이 추가될 때마다 File to import 마법사의 화면이 표시됩니다. 섹션 2단계 - 소스 파일 선택을 참조하고 마법사의 단계에 따라 가져오기 옵션을 간단하게 가져올 수 있도록 정의합니다.

    노트

    다중 가져오기는 특정 요구 사항만 충족해야 하며 권장되지 않습니다.

고급 매개 변수

Advanced parameters 링크를 사용하면 다음 옵션에 액세스할 수 있습니다.

  • General tab

    • Stop execution if there are too many rejects

      이 옵션은 기본적으로 선택되어 있습니다. 거부 수에 관계없이 가져오기를 계속 실행하려면 선택 취소할 수 있습니다. 기본적으로 처음 100개 줄이 거부되면 실행이 중지됩니다.

    • Trace mode

      각 라인에 대한 가져오기 실행을 추적하려면 이 옵션을 선택합니다.

    • Start the job in a detached process

      이 옵션은 기본적으로 선택되어 있습니다. 이 기능을 사용하면 데이터베이스의 진행 중인 다른 작업에 영향을 미치지 않도록 가져오기 실행을 분리할 수 있습니다.

    • Do not update enumerations

      데이터베이스의 열거된 값 목록을 풍성하게 만들지 않으려면 이 옵션을 선택합니다. 열거형 관리를 참조하십시오.

  • Variables tab

    쿼리 편집기 및 계산된 필드에서 액세스할 수 있는 작업과 연관된 변수를 정의할 수 있습니다. 변수를 만들려면 Add​을 클릭하고 변수 편집기를 사용합니다.

    중요

    Variables 탭은 워크플로우 유형 프로그래밍 용도로만 사용되며 전문가 사용자만 구성해야 합니다.

2단계 - 소스 파일 선택

소스 파일은 텍스트 형식(텍스트, csv, 탭, 고정 열) 또는 xml일 수 있습니다.

기본적으로 Upload file on the server​이(가) 선택됩니다. Local file 필드 오른쪽에 있는 폴더를 클릭하여 로컬 디스크를 찾고 가져올 파일을 선택합니다. 서버에 있는 경우 가져올 파일의 이름과 액세스 경로를 입력하려면 이 옵션을 선택 취소할 수 있습니다.

파일이 지정되면 Auto-detect format​을 클릭하여 창의 아래쪽 섹션에서 해당 데이터를 볼 수 있습니다. 이 미리 보기에는 소스 파일의 처음 200줄이 표시됩니다.

이 보기 위에 제공된 옵션을 사용하여 가져오기를 구성합니다. 이러한 옵션을 통해 정의된 매개 변수가 미리 보기로 전송됩니다. 다음 옵션을 사용할 수 있습니다.

  • Click here to change the file format… 파일 형식을 확인하고 구성을 세밀하게 조정할 수 있습니다.
  • Update on server… 로컬 파일을 서버로 전송할 수 있습니다. 이 옵션은 Upload file on the server​을(를) 선택한 경우에만 사용할 수 있습니다.
  • Download 은 파일이 서버에 업로드된 경우에만 사용할 수 있습니다.
  • Auto-detect format 는 데이터 소스의 형식을 다시 초기화하는 데 사용됩니다. 이 옵션을 사용하면 Click here to change the file format… 옵션을 통해 형식이 지정된 데이터에 원래 형식을 다시 적용할 수 있습니다.
  • Advanced parameters 링크를 사용하면 소스 데이터를 필터링하고 고급 옵션에 액세스할 수 있습니다. 이 화면에서 파일의 일부만 가져오도록 선택할 수 있습니다. 필터를 정의할 수도 있습니다. 예를 들어 해당 라인의 값에 따라 'Prospect' 또는 'Customer' 유형 사용자만 가져올 수 있습니다. 이러한 옵션은 전문 JavaScript 사용자만 사용해야 합니다.

파일 형식 변경

Click here to change the file format… 옵션을 사용하면 소스 파일의 데이터 형식을 지정할 수 있으며 특히 각 필드에 대한 열 구분 기호와 데이터 유형을 지정할 수 있습니다. 이 구성은 다음 창을 통해 수행됩니다.

이 단계에서는 파일 필드의 값을 읽어야 하는 방법을 설명할 수 있습니다. 예를 들어 날짜의 경우 날짜 또는 날짜 + 시간 데이터를 형식(dd/mm/yyyy, mm/dd/yy 등)과 연결할 수 있습니다. 입력 데이터가 예상 형식과 일치하지 않으면 가져오는 동안 거부가 발생합니다.

창의 아래쪽에 있는 미리 보기 영역에서 구성 결과를 볼 수 있습니다.

서식을 저장하려면 OK​을 클릭한 다음 Next​을 클릭하여 다음 단계를 표시합니다.

3단계 - 필드 매핑

그런 다음 대상 스키마를 선택하고 각 열의 데이터를 데이터베이스의 필드에 매핑해야 합니다.

  • Destination schema 필드를 사용하면 데이터를 가져올 스키마를 선택할 수 있습니다. 이 정보는 필수 사항입니다. Select link 아이콘을 클릭하여 기존 스키마 중 하나를 선택합니다. Edit link​을 클릭하여 선택한 테이블의 내용을 표시합니다.

  • 중앙 표는 소스 파일에 정의된 모든 필드를 보여줍니다. 대상 파일을 대상 파일과 연결하려면 가져올 필드를 선택합니다. 이러한 필드는 수동으로 또는 자동으로 매핑할 수 있습니다.

    필드를 수동으로 매핑하려면 확인란을 클릭하여 소스 필드를 선택하고 두 번째 열을 클릭하여 선택한 필드에 해당하는 셀을 활성화합니다. 그런 다음 Edit expression 아이콘을 클릭하여 현재 테이블의 모든 필드를 표시합니다. 대상 필드를 선택하고 OK​을 클릭하여 매핑의 유효성을 확인합니다.

    소스 필드와 대상 필드를 자동으로 연결하려면 필드 목록 오른쪽에 있는 Guess the destination fields 아이콘을 클릭합니다. 필요한 경우 제안된 필드를 수정할 수 있습니다.

    중요

    다음 단계로 진행하기 전에 이 작업의 결과를 항상 검증해야 합니다.

  • 가져온 필드에 변형을 적용할 수 있습니다. 이렇게 하려면 해당 필드와 관련된 Transformation 열의 셀을 클릭하고 적용할 변형을 선택합니다.

    중요

    가져온 시점에 변형이 적용됩니다. 대상 필드에 대한 제약 조건을 정의했지만 위의 예에서 @lastname 필드에서 이러한 제한 조건이 우선 순위를 갖습니다.

  • 중앙 표의 오른쪽에 있는 적절한 아이콘을 사용하여 계산된 필드를 추가할 수 있습니다. 계산된 필드를 사용하면 복잡한 변형을 수행하거나, 가상 열을 추가하거나, 여러 열의 데이터를 병합할 수 있습니다. 다양한 가능성에 대한 자세한 내용은 다음 섹션을 참조하십시오.

계산된 필드

계산된 필드는 소스 파일에 추가되고 다른 열에서 계산된 새 열입니다. 그런 다음 계산된 필드를 Adobe Campaign 데이터베이스의 필드와 연결할 수 있습니다. 하지만 조정 작업은 계산된 필드에서 수행할 수 없습니다.

계산된 필드에는 4가지 유형이 있습니다.

  • Fixed string:계산된 필드의 값은 소스 파일의 모든 행에 대해 동일합니다. 삽입되거나 업데이트된 레코드의 필드 값을 설정할 수 있습니다. 예를 들어 가져온 모든 레코드에 대해 마커를 "yes"로 설정할 수 있습니다.

  • String with JavaScript tags:계산된 필드의 값은 JavaScript 명령을 포함하는 문자열입니다.

  • JavaScript expression:계산된 필드의 값은 JavaScript 함수 평가의 결과입니다. 반환된 값은 숫자, 날짜 등이 될 수 있습니다.

  • Enumeration:필드의 값은 소스 파일에 포함된 값에 따라 결정됩니다. 편집기에서는 다음 예와 같이 소스 열을 지정하고 열거형 값 목록을 입력할 수 있습니다.

    Preview 탭에서는 정의된 구성의 결과를 볼 수 있습니다. 여기에서 Subscription 열이 추가되었습니다. 이 값은 상태 필드에서 계산됩니다.

4단계 - 조정

가져오기 마법사의 조정 단계에서는 파일의 데이터를 데이터베이스의 기존 데이터와 조정하는 모드를 정의하고 파일 데이터와 데이터베이스 데이터 간의 우선순위 규칙을 설정할 수 있습니다. 구성 창은 다음과 같습니다.

화면의 중앙 섹션에는 데이터를 가져올 Adobe Campaign 데이터베이스의 필드와 테이블이 있는 트리가 있습니다.

각 노드(테이블 또는 필드)에 대해 특수 옵션을 사용할 수 있습니다. 목록에서 관련 노드를 클릭하면 해당 매개 변수와 간단한 설명이 아래에 표시됩니다. 각 요소에 대해 정의된 동작이 해당 Behavior 열에 표시됩니다.

작업 유형

가져오기가 관련된 각 테이블에 대해 작업 유형을 정의해야 합니다. 데이터베이스의 주 요소에 대해 다음 작업을 사용할 수 있습니다.

  • Update or insertion:레코드가 데이터베이스에 있을 경우 레코드를 업데이트하고, 없는 경우 만듭니다.
  • Insertion:레코드를 데이터베이스에 삽입합니다.
  • Update:기존 레코드만 업데이트합니다(다른 레코드 무시).
  • Reconciliation only:데이터베이스에서 레코드를 찾지만 업데이트를 수행하지 않습니다. 예를 들어 폴더의 데이터를 업데이트하지 않고 파일의 열에 따라 가져올 수신자의 폴더를 연결할 수 있습니다.
  • Deletion:데이터베이스의 레코드를 삭제할 수 있습니다.

가져오기에 의해 관련된 테이블의 각 필드에 대해 다음 옵션을 사용할 수 있습니다.

  • Update (empty) if source value is empty:업데이트 시 소스 파일에서 필드가 비어 있으면 필드의 값이 데이터베이스 값을 제거합니다. 그렇지 않으면 데이터베이스 필드가 유지됩니다.
  • Update only if destination is empty:데이터베이스 필드가 비어 있지 않으면 소스 파일의 값이 데이터베이스 필드의 값을 덮어쓰지 않습니다. 이 경우 소스 파일의 값이 사용됩니다.
  • Update the field only when the record is inserted:업데이트 또는 삽입 작업 중에 새 소스 파일 레코드만 가져옵니다.
노트

조정 키의 정의는 데이터 중복 제거 없이 삽입하는 경우를 제외하고 항상 필수​입니다.

조정 키

데이터 중복 제거를 관리하려면 하나 이상의 조정 키를 입력해야 합니다.

조정 키는 레코드를 식별하는 데 사용되는 필드 세트입니다. 예를 들어 받는 사람을 가져오기 위해 조정 키는 계정 번호, "이메일" 필드 또는 "성, 이름, 회사" 필드 등이 될 수 있습니다.

이 경우 파일 행이 데이터베이스의 기존 수신자와 일치하는지 확인하기 위해 가져오기 엔진은 파일의 값을 키의 모든 필드에 대한 데이터베이스 값과 비교합니다. 필드가 레코드에 특정할 경우 소스 데이터와 대상 데이터 간의 미세한 비교를 수행하여 가져온 후 데이터의 무결성을 보장합니다. 같은 테이블에 대해 두 번째 조정 키를 입력할 수 있습니다.첫 번째 키가 비어 있는 줄에 사용됩니다.

가져오는 동안 수정할 수 있는 필드를 선택하지 마십시오.이 경우 엔진은 추가 레코드를 만들 수 있습니다.

노트

받는 사람 가져오기의 경우 선택한 폴더의 ID가 키에 암시적으로 추가됩니다.

따라서 선택한 폴더가 없는 한 이 폴더에서만 조정이 수행됩니다.

중복 제거

노트

'double'은 가져올 파일에 두 번 이상 존재하는 항목입니다.

'duplicate'는 가져올 파일과 데이터베이스에 모두 있는 항목입니다.

Management of doubles 필드에서 데이터 중복 제거를 구성할 수 있습니다. 데이터 중복 제거 관련 문제는 소스 파일​(또는 여러 파일을 가져오는 경우 소스 파일)에​이 여러 번 나타나는 기록(즉, 조정 키의 필드가 동일한 행)입니다.

  • Update 모드(기본 모드)에서 중복 관리를 수행할 수 없습니다. 따라서 마지막 레코드에는 우선 순위가 있습니다(이전 레코드의 데이터를 업데이트하므로). 이 모드에서는 중복 개수가 수행되지 않습니다.
  • Ignore 모드 또는 Reject entity​의 중복 관리는 가져오기에서 중복 항목을 제외합니다. 이 경우 레코드를 가져오지 않습니다.
  • Reject entity 모드에서는 요소를 가져오지 않고 가져오기 로그에 오류가 생성됩니다.
  • Ignore 모드에서는 요소를 가져올 수 없지만 오류의 추적은 유지되지 않습니다. 이 모드를 사용하면 성능을 최적화할 수 있습니다.
중요

데이터 중복 제거는 메모리에서만 수행됩니다. 따라서 데이터 중복 제거가 포함된 가져오기의 크기는 제한됩니다. 제한은 여러 매개 변수(응용 프로그램 서버의 용량, 활동, 키의 필드 수 등)에 따라 달라집니다. 데이터 중복 제거의 최대 크기는 1,000,000개 라인입니다.

데이터 중복 제거는 소스 파일과 데이터베이스에 모두 있는 기록입니다. 업데이트 전용(예:Update and insertion 또는 Update). Duplicate management 옵션을 사용하면 소스 파일과 데이터베이스에 있을 경우 레코드를 업데이트하거나 무시할 수 있습니다. Update or insert based on origin 옵션은 옵션 모듈에 속하며 표준 컨텍스트에서 사용할 수 없습니다.

RejectIgnore 옵션은 위에서 설명한 대로 작동합니다.

오류가 발생한 경우

대부분의 데이터 전송 작업은 다양한 유형의 오류(일관되지 않은 줄 형식, 잘못된 이메일 주소 등)를 생성합니다. 가져오기 엔진에서 생성된 모든 오류 및 모든 경고가 저장되고 가져오기 인스턴스에 연결됩니다.

이러한 거부에 대한 세부 사항은 Rejects 탭을 통해 볼 수 있습니다.

거부에는 두 가지 유형이 있습니다(유형은 Connector 열에 표시됨).

  • 텍스트 커넥터의 거부 문제는 파일 행을 처리하는 동안 발생하는 오류(계산된 필드, 데이터 분석 등)와 관련이 있습니다. 이 경우 오류가 발생하면 전체 줄이 항상 거부됩니다.
  • 데이터베이스 커넥터는 데이터 조정 또는 데이터베이스에 쓰는 동안 발생하는 오류에 대해 거부합니다. 여러 테이블로 가져오는 경우, 거부자는 레코드의 일부(예: 받는 사람 가져오기 및 관련 이벤트 가져오기에 오류가 있으면 수신자를 거부하지 않고 이벤트 업데이트를 방지할 수 있습니다.)

데이터 조정 페이지에서 필드 및 테이블별로 원하는 오류 관리 유형 필드를 정의할 수 있습니다.

  • Ignore and log a warning:오류가 발생한 필드를 제외한 모든 필드를 데이터베이스로 가져옵니다.

  • Reject parent element:오류가 발생한 필드뿐만 아니라 레코드의 전체 줄이 거부됩니다.

  • Reject all elements:가져오기 중지 및 레코드의 모든 요소가 거부됩니다.

가져오기 인스턴스의 거부 화면에 있는 트리는 거부된 필드와 오류가 발생한 위치를 나타냅니다.

Export rejects 아이콘을 통해 이러한 레코드가 포함된 파일을 생성할 수 있습니다.

5단계 - 받는 사람을 가져올 때의 추가 단계

가져오기 마법사의 다음 단계에서는 데이터를 가져올 폴더를 선택하거나 만들 수 있고, 가져온 수신자를 새 목록 또는 기존 목록으로 자동 매핑하고, 수신자를 서비스에 가입할 수 있습니다.

노트

이 단계는 받는 사람만 가져올 때와 기본 Adobe Campaign 받는 사람 테이블(nms:recipient)을 사용할 때 나타납니다.

  • Edit 링크를 클릭하여 수신자를 연결하거나 가입할 폴더, 목록 또는 서비스를 선택합니다.

    1. 폴더로 가져오기

      Import into a folder 섹션의 Edit… 링크를 사용하면 수신자를 가져올 폴더를 선택하거나 만들 수 있습니다. 기본적으로 파티션이 정의되지 않은 경우 데이터를 연산자의 기본 폴더로 가져옵니다.

      노트

      연산자의 기본 폴더는 연산자에 쓰기 액세스 권한이 있는 첫 번째 폴더입니다. 폴더 액세스 관리에서 자세히 알아보십시오.

      가져오기 폴더를 선택하려면 Folder 필드 오른쪽의 화살표를 클릭하고 관련 폴더를 선택합니다. Select link 아이콘을 사용하여 새 창에 트리를 표시하거나 새 폴더를 만들 수도 있습니다.

      새 폴더를 만들려면 폴더를 추가할 노드를 선택하고 마우스 오른쪽 단추를 클릭합니다. Create a new ‘Recipients’ folder​을(를) 선택합니다.

      폴더가 현재 노드 아래에 추가됩니다. 새 폴더의 이름을 입력하고 Enter 키를 눌러 확인한 다음 OK​을 클릭합니다.

    2. 목록과 연결

      Add recipients to a list 섹션의 Edit… 링크를 사용하면 수신자를 가져올 목록을 선택하거나 만들 수 있습니다.

      Select link​을 클릭한 다음 Create​을(를) 클릭하여 이러한 받는 사람의 새 목록을 만들 수 있습니다. 목록의 생성 및 관리는 이 섹션에 있습니다.

      목록에 이미 있는 사람에게 받는 사람을 추가하거나 새 받는 사람과 함께 목록을 다시 만들 수 있습니다. 이 경우 목록에 이미 받는 사람이 포함되어 있으면 해당 수신자는 삭제되고 가져온 받는 사람으로 대체됩니다.

    3. 서비스 가입

      가져온 받는 사람을 모두 정보 서비스에 가입하려면 받는 사람이 가입할 정보 서비스를 선택하거나 만들려면 Subscribe recipients to a service 섹션의 Edit… 링크를 클릭하십시오. Send a confirmation message 옵션을 선택할 수 있습니다.이 메시지의 내용은 구독 서비스와 관련된 배달 템플릿에 정의됩니다.

      Select link​을 클릭한 다음 Create 아이콘을 클릭하여 해당 수신자에 대한 새 서비스를 만들 수 있습니다. 정보 서비스 관리는 이 섹션에 있습니다.

  • 수신자의 프로필에 수신자의 원본에 대한 정보를 추가하려면 Origin 필드를 사용합니다. 이 정보는 여러 가져오기 프레임워크에서 특히 유용합니다.

Next​을 클릭하여 이 단계의 유효성을 확인하고 다음 단계를 표시합니다.

6단계 - 가져오기 시작

마법사의 마지막 단계에서는 데이터 가져오기를 시작할 수 있습니다. 이렇게 하려면 Start 단추를 클릭합니다.

그런 다음 가져오기 작업의 실행을 모니터링할 수 있습니다(작업 실행 모니터링 참조).

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now