조직 일괄 가져오기

주의: 데이터 가져오기는 현재 오픈 베타 버전입니다. 이 베타 기간 동안 관리 센터의 조직 가져오기 페이지를 계속 이용할 수 있습니다.

한 번에 조직을 하나씩 추가하기보다 CSV(쉼표로 여러 값 구분) 파일을 가져와서 일괄로 여러 개의 조직을 추가할 수 있습니다. 일괄 가져오기를 사용하여 조직을 추가 또는 업데이트할 수 있습니다. 관리자만 조직 일괄 가져오기를 수행할 수 있습니다. 한 번에 여러 사용자를 추가 또는 업데이트할 수 있습니다(사용자 일괄 가져오기 참조).

참고: 조직과 사용자 둘 다 일괄 가져오기를 하려면 먼저 조직을 일괄 가져오기해야 합니다. 사용자 일괄 가져오기에 대한 자세한 내용은 사용자 일괄 가져오기를 참조하세요.

조직 일괄 가져오기 작업은 실행 취소할 수 없습니다. 모든 조직의 정보가 포함된 CSV 파일을 가져오기 전에 단일 조직 레코드로 동일한 CSV 파일을 테스트하여 업로드가 의도된 대로 작동하는지 확인하세요.

이 문서는 다음 섹션으로 구성되어 있습니다.

• 사용자 및 조직 일괄 가져오기의 한계
• CSV 조직 데이터 파일 만들기
• CSV 조직 데이터 파일 가져오기

사용자 및 조직 일괄 가져오기의 한계

사용자와 조직에 대한 핵심 데이터 집합을 가져올 수 있습니다. 예를 들어 일괄 가져오기를 사용하여 아래 표에 설명된 데이터를 가져올 수 있지만 시간대, 사진, 언어 기본 설정 등은 가져올 수 없습니다. 아래 표에 나와 있지 않은 데이터를 가져오려면 대신 Zendesk REST API를 사용해야 합니다. Zendesk API를 통해 사용자 가져오기 또는 Zendesk API를 통해 조직 가져오기를 참조하세요.

또한 일괄 가져오기에는 다음과 같은 한계가 있습니다.

• 최대 행 수는 가져오기 방법에 따라 다릅니다.
  • 사용자 데이터 및 기존 조직 데이터 업데이트의 경우 가져오기 CSV 데이터 파일에는 최대 2,000개의 행 즉, 한 개의 헤더 행과 최대 1,999개의 데이터 행이 포함될 수 있습니다.
  • 데이터 가져오기(베타)를 사용한 새 조직 데이터의 경우 가져오기 CSV 파일 크기는 1GB를 초과할 수 없습니다. 최대 500,000개의 행 즉, 한 개의 헤더 행과 최대 499,999개의 데이터 행을 권장합니다. 또한 각 행의 크기는 128KB를 초과할 수 없습니다.
• 데이터 가져오기를 사용할 때 다음 제한 사항도 적용됩니다.
  • 가져오기 CSV 파일에는 최대 200개의 열이 포함될 수 있습니다.
  • 가져오기 CSV 파일은 행의 가져오기 순서를 보장할 수 없습니다.
• 한 번에 하나의 CSV 파일만 가져올 수 있습니다. 따라서 CSV 파일에 지원되는 최대 행 수보다 많은 데이터가 있는 경우에는 각 배치에 대해 별도의 파일을 만들어 하나씩 가져와야 합니다. 데이터 가져오기를 사용하고 있지 않은 경우에는 대기열에 최대 두 개의 배치 파일이 쌓이고 백그라운드에서 실행됩니다. 두 개 이상의 배치 파일을 가져오려면, 첫번째 배치 파일의 가져오기가 완료될 때까지 기다렸다가 다음 파일을 추가해야 합니다.
• 최종 사용자의 Facebook 또는 X(구 트위터) 계정에서 연락처 정보를 가져올 때에는 일괄 가져오기를 사용할 수 없습니다. 대신에 Zendesk REST API를 사용합니다. Zendesk API를 통해 사용자 가져오기를 참조하세요.

CSV 조직 데이터 파일 만들기

조직을 일괄 가져오기하려면 CSV 조직 데이터 파일을 사용해야 합니다. 이 섹션에서는 CSV 데이터 파일을 설정하는 방법에 대해 설명합니다.

다음은 파일을 만들 때에 주의해야 할 몇 가지 중요 사항입니다.

• 파일은 적절한 형식을 준수하는 CSV 파일로 UTF-8 문자 인코딩을 사용해서 저장되어야 합니다.
• CSV 파일의 첫 번째 행은 헤더 행입니다.
• 헤더 행은 아래 표에 있는 모든 필수 필드를 포함해야 하며, 그 외에도 아래 표에 있는 필드 중 포함시키고자 하는 필드를 추가할 수 있습니다.
• 특정 필드에 대한 데이터를 가져오지 않는 경우에는 헤더 행에 추가하지 않습니다.
• 파일 내에 데이터 열이 비어있으면 해당 조직의 모든 기존 데이터를 덮어쓰게 됩니다.
• Windows에서는 ALT+ENTER 키를, macOS에서는 CTRL+OPTION+RETURN 키를 눌러서 메모 또는 멀티라인 사용자 지정 필드에 줄 바꾸기를 추가합니다.

다음 표는 파일에 포함할 수 있는 필드를 나열하고 있습니다.

표 1. 조직 가져오기 데이터

필드	설명
name	필수 사항으로 조직 이름입니다.
external_id	선택 사항이며 권장 사항은 아니지만 나중에 데이터 가져오기를 사용하여 이러한 레코드를 업데이트하려는 경우 필수입니다. 외부 시스템의 직원 또는 고객 식별 번호와 같은 고유한 식별 값입니다.
notes	조직에 대한 메모입니다. 최종 사용자를 제외한 상담사만 메모를 볼 수 있습니다.
details	주소 등 조직에 대한 자세한 정보로, 최종 사용자를 제외한 상담사만 이 정보를 볼 수 있습니다.
default	사용자를 조직에 맵핑할 때에 사용하는 값으로, 예를 들어 organization1.com organization2.com과 같이 띄어쓰기로 구분하여 하나 이상의 이메일 도메인을 입력합니다. 이메일 도메인을 기준으로 사용자를 조직에 자동으로 추가하기를 참조하세요.
shared	True 또는 False로, 조직을 공유 조직으로 설정합니다. 최종 사용자를 위한 공유 조직 설정하기를 참조하세요.
shared_comments	True 또는 False로, 조직 내의 모든 사용자가 서로의 티켓에 댓글을 추가할 수 있도록 허용합니다. 공유 필드도 true로 설정되어 있어야 합니다. 최종 사용자를 위한 공유 조직 설정하기를 참조하세요.
group	조직의 기본 그룹을 입력합니다. 그룹을 조직에 맵핑하기를 참조하세요.
tags	Zendesk Support에서 사용자 및 조직 태그 지정이 사용 설정되어 있는 경우(사용자 및 조직에 태그 추가하기 참조), 조직에 대한 태그를 설정할 수 있습니다. 각 태그는 띄어쓰기로 구분합니다. 조직 일괄 가져오기 시 CSV 파일의 태그가 기존 조직 태그를 대체합니다. 이런 일이 발생하지 않도록 하려면 대신 태그 API를 사용하여 태그를 업데이트하세요.
custom_fields.<field key>	조직 일괄 가져오기를 수행할 때 custom_fields. 접두어와 필드 키를 지정하여 사용자 지정 조직 필드를 가져올 수 있습니다.  예를 들어 subscription_date 필드 키에서는 다음을 이용하여 이 필드에 가져온 값을 설정합니다. custom_fields.subscription_date 사용자 지정 조직 필드의 키를 찾으려면, 관리자 아이콘()을 클릭하고 조직 필드를 선택한 다음 사용자 지정 필드의 이름을 클릭합니다. 오른쪽 특성 창에 필드 키가 나타납니다. 필드 값의 형식이 올바르지 않으면 가져오기는 실패하고 저장하지 못한 레코드를 명시한 오류 보고서를 받게 됩니다. 사용자 지정 날짜 필드는 YY/MM/DD 또는 YYYY-MM-DD 형식을 사용하세요. 확인란 필드에는 참 또는 거짓을 사용하세요. 드롭다운 목록 옵션의 값을 설정하려면 드롭다운 목록을 만들 때 추가한 태그를 사용합니다. 참고: 가져오고 있는 사용자 지정 조직 필드가 조회 관계 필드인 경우에는 관련 개체의 ID를 이 필드의 값으로 입력하세요. 예를 들어 조직에는 조직 ID를 입력하고 사용자에는 사용자의 ID를 입력합니다. 조직 또는 사용자 ID를 찾으려면 계정에서 데이터를 내보내거나 조직 API 또는 사용자 API를 사용할 수 있습니다. 데이터 가져오기 페이지에서 조직을 가져올 때 조회 관계 필드는 지원되지 않습니다. 조직에 사용자 지정 필드 추가하기를 참조하세요.

CSV 조직 데이터 파일 가져오기

일괄 가져오기를 사용하여 새 조직을 만들거나 기존 조직의 정보를 업데이트할 수 있습니다.

가져오기 파일이 대기열에 추가되고 가져오기 과정이 완료되면 Zendesk Support에 조직이 추가됩니다. 완료하는 데 파일당 대략 1시간이 소요되지만 실제 시간은 파일 크기와 대기열 크기에 따라 다릅니다. 사용자 및 조직 일괄 가져오기의 한계를 참조하세요.

데이터 가져오기를 사용하여 새 조직 만들기(베타)

데이터 가져오기는 베타 릴리스 버전입니다. 이 기능을 사용하여 새 조직을 만드는 CSV 파일을 가져오고 데이터 가져오기 페이지를 통해 시도된 모든 가져오기 로그를 캡처할 수 있습니다. 베타 기간에는 데이터 가져오기를 사용하여 기존 조직 데이터를 업데이트할 수 없습니다.

데이터 가져오기를 통해 새 조직을 만들려면 다음과 같이 하세요.

1. 관리 센터의 사이드바에서 개체 및 규칙을 클릭한 다음 도구 > 데이터 가져오기를 선택합니다.
2. 가져오기를 클릭합니다.
3. 대상에서 조직을 선택합니다.
4. 파일 업로드 아래에서 파일을 드래그 앤 드롭하거나 클릭하여 업로드로 파일 브라우저에서 CSV 파일을 선택할 수 있습니다.

   선택한 파일을 변경해야 하는 경우에는 파일 이름 옆의 삭제 아이콘()을 클릭합니다.

5. 다음을 클릭합니다.
6. 필드 맵핑 목록을 검토합니다.
   • 필드 맵핑이 올바르면 다음을 클릭합니다.
   • 필드 맵핑이 올바르지 않으면 뒤로를 클릭합니다. 서식 요건에 맞게 CSV 파일을 편집한 후 파일을 다시 업로드합니다.
7. 확인 대화 상자에서 가져오기 세부 정보의 요약을 검토한 후 가져오기 시작을 클릭합니다.

   가져오기가 시작된 후에는 가져온 변경 내용을 되돌릴 수 없습니다. 가져오기의 상태를 확인하려면 가져오기 기록을 확인하세요.

CSV 가져오기를 사용하여 기존 조직 데이터 업데이트하기

데이터 가져오기 페이지는 베타 기간 동안 CSV 가져오기를 통해 새 조직을 만드는 데만 사용할 수 있습니다. CSV 가져오기를 사용하여 기존 조직을 업데이트해야 하는 경우에는 관리 센터 > 사람 > 일괄 작업 > 조직 가져오기 페이지를 사용해야 합니다. 이 페이지를 사용하여 새 조직을 만들 수도 있습니다. 가져오기가 완료되면 이메일을 받게 됩니다.

CSV 가져오기로 조직을 업데이트하려면 다음과 같이 하세요.

1. 관리 센터의 사이드바에서 사람을 클릭한 다음 일괄 작업 > 조직 가져오기를 선택합니다.
2. 수행하려는 가져오기 유형을 선택합니다.

   • 새 조직 만들기

   • 기존 조직 업데이트: CSV 파일에 나열된 조직의 기존 데이터를 바꾸려면 이 가져오기 유형을 사용합니다.

     조직이 식별될 수 있도록 조직의 external_id나 이름이 CSV에 포함되어야 합니다. 조직 식별자 필드 외에 파일에는 업데이트할 필드만 포함하세요. 조직의 행에 공백 필드가 있으면 해당 조직의 기존 데이터를 덮어쓰게 됩니다.

3. 파일 선택 또는 직접 데이터에 붙여넣기 링크를 클릭합니다.
4. 가져오기를 클릭합니다.

   가져오기가 시작된 후에는 가져온 변경 내용을 되돌릴 수 없습니다.

5. (선택 사항) 관리 센터 > 개체 및 규칙 > 도구 > 데이터 가져오기 페이지에서 진행 중인 가져오기의 상태를 봅니다. 가져오기가 완료된 후에는 가져오기 기록 로그에 캡처됩니다.