한 번에 하나씩 사용자 지정 개체 레코드를 추가하는 대신 CSV(쉼표로 구분된 값) 파일을 가져와서 많은 레코드를 한 번에 일괄 추가하고 업데이트할 수 있습니다. 관리자만 사용자 지정 개체 레코드 일괄 가져오기를 수행할 수 있습니다.
이 문서에서는 다음과 같은 주제를 다룹니다.
요구 사항 및 제한 사항
일괄 가져오기에는 다음과 같은 제한 사항이 적용됩니다.
- 가져오기 CSV 파일의 크기는 1GB를 초과할 수 없습니다. 최대 500,000개의 행 즉, 한 개의 헤더 행과 최대 499,999개의 데이터 행을 권장합니다. 또한 각 행의 크기는 32KB를 초과할 수 없습니다.
- 가져오기 CSV 파일에는 최대 102개의 열이 포함될 수 있습니다.
- CSV 파일 내에 동일한 레코드를 두 번 이상 포함하지 마세요. 그렇게 하면 가져오기에 실패할 수 있습니다.
- CSV 파일에 나타나는 순서대로 레코드가 작성되거나 업데이트된다는 보장은 없습니다.
- 한 번에 하나의 CSV 파일만 가져올 수 있습니다. 따라서 CSV 파일에 지원되는 최대 행 수보다 많은 데이터가 있는 경우에는 각 배치에 대해 별도의 파일을 만들어 하나씩 가져와야 합니다.
- 사용자 지정 개체 레코드 일괄 가져오기는 실행 취소할 수 없습니다. 모든 현재 레코드의 정보가 포함된 CSV 파일을 가져오기 전에 단일 레코드로 동일한 CSV 파일을 테스트하여 업로드가 의도한 대로 수행되는지 확인하세요.
사용자 지정 개체 레코드 CSV 파일 만들기
사용자 지정 개체 레코드를 일괄 가져오려면 CSV 파일을 사용합니다. 다음은 파일을 만들 때에 주의해야 할 몇 가지 중요 사항입니다.
- 파일은 적절한 형식을 준수하는 CSV 파일로 UTF-8 문자 인코딩을 사용해서 저장되어야 합니다.
- CSV 파일의 첫 번째 행은 헤더 행입니다.
- 헤더 행에는 이름 필드가 포함되어야 합니다. 선택 사항으로 나중에 레코드를 일괄 업데이트하려면 external_id 필드도 포함해야 합니다. 헤더 행의 모든 다른 필드 이름은 사용자 지정 개체에 있는 필드 키와 정확하게 일치해야 합니다.
- 드롭다운 필드에 대한 값을 가져오려면 사용자 지정 드롭다운 필드의 field_key를 열 머리글로 사용하고 사용자에게 친숙한 값이 아닌 옵션 태그를 지정합니다.
- 조회 관계 필드에 대한 값을 가져오려면 사용자 지정 조회 관계 필드의 field_key를 열 머리글로 사용하고 레코드의 id 또는 external id를 제공합니다. 레코드의 ID를 사용하는 경우에는 값을 제공합니다. 외부 ID를 사용하는 경우에는 external_id:값 형식을 사용합니다. 여기서 값은 관련 레코드의 외부 ID 값으로 대체됩니다.
- 특정 필드에 대한 데이터를 가져오지 않는 경우에는 헤더 행에 추가하지 않습니다.
- Windows에서는 ALT+ENTER 키를, macOS에서는 CTRL+OPTION+RETURN 키를 눌러서 메모 또는 멀티라인 사용자 지정 필드에 줄 바꾸기를 추가합니다.
새 사용자 지정 개체에 기존 데이터를 시드하기 위해 레코드의 일괄 업로드를 수행하는 경우에는 사용자 지정 개체 워크플로우 계획하기를 단계별로 살펴볼 것을 권합니다. 프로세스 중에 각 사용자 지정 개체에 대한 이 데이터로 스프레드시트를 만드는 것이 좋습니다. Zendesk에서 만든 사용자 지정 개체와 위의 가이드라인에 맞게 신중하게 구성하면 이 스프레드시트를 CSV 파일로 내보내서 일괄 업데이트에 사용할 수 있습니다. 이 경우 반드시 external_id에 대한 열을 추가하고 나중에 일괄 업데이트하려는 각 레코드의 ID를 추가하세요.
사용자 지정 개체 레코드 CSV 파일 가져오기
데이터 가져오기를 사용하여 새 사용자 지정 개체 레코드를 만들거나 기존 레코드를 업데이트하는 CSV 파일을 가져오고 데이터 가져오기 페이지를 통해 시도된 모든 가져오기 로그를 캡처할 수 있습니다.
데이터 가져오기로 사용자 지정 개체 레코드를 만들거나 업데이트하려면 다음과 같이 하세요.
- 사용자 지정 개체의 레코드를 일괄 업데이트하기 전에 Zendesk에서 사용자 지정 개체를 만들어야 합니다.
- 관리 센터의 사이드바에서 개체 및 규칙을 클릭한 다음 도구 > 데이터 가져오기를 선택합니다.
- 가져오기를 클릭합니다.
-
가져오기 유형에서 다음 중 하나를 선택합니다.
- 만들기만: 새 사용자 지정 개체 레코드만 만듭니다. 기존 레코드와 관련된 CSV 파일의 모든 데이터는 무시됩니다.
- 업데이트만: CSV 파일에 나열된 기존 사용자 지정 개체 레코드에 대한 데이터를 바꿉니다. 새 레코드와 관련된 모든 데이터는 무시됩니다.
- 만들기 및 업데이트: 새 사용자 지정 개체 레코드를 만들고 CSV 파일에 나열된 기존 사용자 지정 개체 레코드에 대한 데이터를 업데이트합니다.
- 대상 아래에서 사용자 지정 개체의 이름을 선택합니다.
-
파일 업로드 아래에서 파일을 드래그 앤 드롭하거나 클릭하여 업로드로 파일 브라우저에서 CSV 파일을 선택할 수 있습니다.
선택한 파일을 변경해야 하는 경우에는 파일 이름 옆의 삭제 아이콘()을 클릭합니다.
- 다음을 클릭합니다.
-
필드 맵핑 목록을 검토합니다.
- 필드 맵핑이 올바르면 다음을 클릭합니다.
- 필드 맵핑이 올바르지 않으면 뒤로를 클릭합니다. 서식 요건에 맞게 CSV 파일을 편집한 후 파일을 다시 업로드합니다.
- 확인 대화 상자에서 가져오기 세부 정보의 요약을 검토한 후 가져오기 시작을 클릭합니다.
가져오기가 시작된 후에는 가져온 변경 내용을 되돌릴 수 없습니다. 가져오기의 상태를 확인하려면 가져오기 기록을 확인하세요.