사용자 일괄 CSV 업로드 문제 해결 | Adobe Admin Console

기업 및 팀에 적용됩니다.

개요

사용자 페이지에서 사용할 수 있는 CSV로 사용자 추가 기능을 사용하면 관리자가 CSV 파일을 사용하여 Admin Console에 여러 사용자 계정을 만들 수 있습니다. 사용자 계정 생성 프로세스의 상태 및 진행 상황은 일괄 작업 결과 페이지에 표시됩니다. 사용자 계정 생성 처리는 언제든지 취소할 수 있습니다.

참고:

이 문서에 설명된 절차에 사용되는 CSV 파일은 쉼표(,) 또는 세미콜론(;)을 구분자로 사용할 수 있습니다.

Admin Console에서 수행하는 사용자 관련 작업에 대한 자세한 내용은 사용자 관리를 참조하십시오.

파일 요구 사항

다음은 관리자가 파일을 업로드하기 전에 충족해야 하는 처리 요구 사항입니다.

  • 파일 형식 및 머리글
  • 파일 데이터 또는 행 요구 사항

파일 형식 및 머리글

  • 파일은 쉼표로 구분되었거나 세미콜론으로 구분된 값 형식이며 .csv 접미사가 있습니다. 각 레코드는 줄바꿈으로 구분된 별도의 줄에 있습니다(CRLF). 예: aaa,bbb,ccc CRLF. 자세한 내용은 RFC 4180(CSV 파일 사양)을 참조하십시오. 
  • 열 머리글은 유효합니다. 머리글 행은 필수입니다. 필수 또는 선택 필드 및 파일 형식에 대한 자세한 내용은 CSV 파일 형식 표를 참조하십시오.

해결 방법

경고:

다음에 설명된 변경 사항은 다른 애플리케이션 및 스프레드시트에 영향을 줄 수 있습니다. 따라서 CSV에서 필요한 사항을 변경한 다음 이들 설정을 되돌리십시오. 

Windows 10

  1. Windows 설정으로 이동합니다.

  2. 시간 및 언어 > 지역 및 언어 > 추가 날짜, 시간 및 지역 설정 > 날짜, 시간 및 숫자 형식 변경으로 이동합니다.

  3. 형식 드롭다운 목록에서 영어(영국)를 선택합니다.

Windows 7

  1. 제어판 > 모든 제어판 항목 > 지역 및 언어로 이동합니다.

  2. 형식 드롭다운 목록에서 영어(영국)를 선택합니다.

데이터 또는 행 요구 사항

각 데이터 행에 대해 다음 요구 사항이 충족되는지 확인합니다.

  • 유효한 이메일 주소로 구성되어 있습니다.
  • 제품 프로필(또는 구성)이 있는 경우 유효합니다.
참고:

팀 고객인 경우 제품 구성 열 제목을 팀 제품으로 변경합니다. 또한 이 열의 데이터에 대해 제품 이름(제품 프로필 이름이 아님)을 입력하십시오.

  • 옵션이 있는 경우 유효합니다.
참고:

국가 코드는 두 자리 ISO 3166(alpha-2) 코드여야 합니다.

파일 크기 요구 사항

CSV 파일에는 최대 25,000행(최적 성능을 위해서는 5,000행)이 포함될 수 있습니다. 파일이 5000행을 초과하면 Admin Console에서 파일을 처리할 때 성능 문제가 발생합니다(다음 섹션 파일 처리참조). 단, 25,000행을 초과하는 CSV 파일은 거부됩니다.

25,000행 이상의 사용자를 업로드해야 하는 경우 다음 중 하나를 권장합니다.

  1. CSV를 25,000행(최대)의 여러 파일로 분할합니다.  최적의 성능을 위해서는 5000행 이하를 사용하십시오.
  2. Adobe의 사용자 동기화 도구 사용. 조직의 기업 디렉터리 시스템(예: Active Directory 또는 기타 LDAP 시스템)에서 Adobe Admin Console의 조직 디렉터리로 사용자 및 그룹 정보를 이동하는 명령줄 도구입니다.
  3. Adobe의 User Management REST API 사용. 이 API를 조직의 관리 애플리케이션 및 프로세스에 통합할 수 있습니다.
  4. Microsoft Azure 또는 Google 페더레이션을 사용하여 Admin Console에서 Federated ID를 설정한 경우 해당 Admin Console 커넥터를 사용하십시오. Adobe를 통해 SSO에 대한 Google 페더레이션 설정 또는 Azure AD 커넥터로 SSO 설정을 참조하십시오.
  5. 위의 방법으로 사용자를 일괄 업로드할 수 없는 경우 Admin Console에 로그인하고 지원으로 이동한 다음 Adobe 고객 지원 센터에 문의하십시오.

파일 처리

파일을 처리할 때 특정 도메인을 기준으로 다음 표와 같이 각 항목이 개별적으로 처리됩니다.

모든 처리가 완료되면 요약이 시작 관리자에게 이메일로 전송됩니다. 가져오기 작업이 취소되면 처리가 중지됩니다. 단, 이미 처리된 행은 롤백되지 않습니다.

ID 유형

작업

예외 사항

Federated ID

  • 지정된 사용자 이름으로 사용자 레코드가 생성됩니다.
  • 계정이 지정된 제품 프로필에 추가됩니다.
  • 이메일 주소는 도메인을 확인하는 것 외에는 사용되지 않습니다.
  • 제품 프로필 알림 설정이 활성화된 경우 사용자에게 이메일이 전송됩니다.

  • 사용자 이름이 존재합니다
  • 국가(있는 경우)가 Adobe 비즈니스에 개방되어 있지 않습니다*
  • 조직 또는 계약 유형에 따라 지정된 제품 프로필을 통해 사용할 수 있는 라이선스가 충분하지 않은 경우 다음 중 하나가 발생합니다.
    • : “라이선스 부족” 오류 발생
    • VIP: 계정이 지정된 제품 프로필에 추가됩니다. 단, 라이선스 할당량을 초과하여 사용자는 제품을 사용할 수 없습니다.
    • ETLA: 계정이 지정된 제품 프로필에 추가됩니다. 사용자는 지정된 제품에 액세스할 수 있습니다. 갱신 시 트루업으로 청구됩니다.

Enterprise ID

  • 주어진 이메일 주소로 계정이 생성됩니다.
  • 계정이 지정된 제품 구성에 추가됩니다.
  • 시작 이메일이 사용자에게 전송됩니다.

  • 이미 진행 중인 초대가 있거나 주어진 이메일 계정이 있습니다
  • 국가(있는 경우)가 Adobe 비즈니스에 개방되어 있지 않습니다*
  • 조직 또는 계약 유형에 따라 지정된 제품 프로필을 통해 사용할 수 있는 라이선스가 충분하지 않은 경우 다음 중 하나가 발생합니다.
    • : “라이선스 부족” 오류 발생
    • VIP: 계정이 지정된 제품 프로필에 추가됩니다. 단, 라이선스 할당량을 초과하여 사용자는 제품을 사용할 수 없습니다.
    • ETLA: 계정이 지정된 제품 프로필에 추가됩니다. 사용자는 지정된 제품에 액세스할 수 있습니다. 갱신 시 트루업으로 청구됩니다.

Adobe ID

  • 주어진 해당 이메일 주소로 계정이 생성됩니다.
  • 지정된 제품 구성에 계정이 추가됩니다.
  • 제품 프로필 편집사용자에게 이메일 알림 옵션을 활성화하는 경우 시작 이메일이 사용자에게 전송됩니다.

 

  • 이미 진행 중인 초대가 있거나 주어진 이메일 계정이 있습니다.
  • 국가(있는 경우)가 Adobe 비즈니스에 개방되어 있지 않습니다*
  • 조직 또는 계약 유형에 따라 지정된 제품 프로필을 통해 사용할 수 있는 라이선스가 충분하지 않은 경우 다음 중 하나가 발생합니다.
    • : “라이선스 부족” 오류 발생
    • VIP: 계정이 지정된 제품 프로필에 추가됩니다. 단, 라이선스 할당량을 초과하여 사용자는 제품을 사용할 수 없습니다.
    • ETLA: 계정이 지정된 제품 프로필에 추가됩니다. 사용자는 지정된 제품에 액세스할 수 있습니다. 갱신 시 트루업으로 청구됩니다.

 

알림:

Adobe 서비스 및 소프트웨어는 쿠바, 이란, 북한, 수단, 시리아 및 우크라이나 크림 반도를 포함하되 이에 국한되지 않는 특정 지역에서 Adobe 서비스 및 소프트웨어의 수출 및 사용을 제한하는 미국 수출법의 통제를 받습니다.

참고:

사용자 가져오기 기능에서는 쉼표(,) 또는 세미콜론(;)과 같은 특수 문자를 포함하는 사용자 닉네임이 지원되지 않습니다.

성능 세부 정보

과부하를 피하기 위해 66.6% 듀티 사이클 규칙이 처리의 일부로 있습니다.  항목 처리 시간이 롤링 평균과 10% 이상 차이가 나면 요청 처리가 실시간의 2/3만 소비하도록 제한이 조정됩니다.

또한 운영 팀에서 관리하는 조절 제어도 처리 속도를 제한합니다.  조절 제어가 명시적으로 설정된 경우 듀티 사이클 제어가 비활성화됩니다. 듀티 사이클 기반 조절로 다시 전환하기 위한 API 호출이 있습니다.

성능에 대한 피드백을 제공하기 위해 초당 처리된 요청 수를 표시합니다.

각각 2개의 제품 구성에 추가된 1000개의 계정 생성에 대한 목표 속도는 초당 계정 1개(66.6% 듀티 사이클을 계산하지 않음)이므로 겉보기 처리 속도는 초당 계정 0.66개 또는 분당 계정 약 40개일 수 있습니다.  이 속도로 1000개의 계정을 만드는 데 25분이 걸립니다.  이 속도로 5000개의 계정을 만드는 데 2시간 5분이 걸립니다.

문제 해결

문제 해결 섹션은 Adobe Admin Console에서 대량 가져오기 기능을 사용하는 동안 발생할 수 있는 오류 조건 또는 기타 문제를 해결하는 데 도움이 됩니다.

업로드 오류

특정 조건이 충족되지 않으면 파일 업로드가 실패하는 경우가 있습니다.

오류 메시지는 다음 조건에서 표시됩니다.

  • 파일이 CSV 형식이 아닙니다.
  • 필수 열 머리글(예: 이메일)이 잘못되었거나 누락되었습니다.
  • 필수 열이 누락되었습니다.

다음 작업을 수행하십시오.

  • .csv 파일 형식만 사용합니다.
  • 열 머리글이 유효한지 확인합니다.
  • 열 값이 유효한지 확인합니다.

필수 또는 선택 필드 및 파일 형식에 대한 자세한 내용은 CSV 파일 형식 표를 참조하십시오.

CSV 파일의 데이터 형식 문제를 해결하려면

  1. Microsoft Excel에서 CSV 파일을 엽니다.

  2. 시트에 데이터가 포함된 열을 선택(강조 표시)합니다.

  3. 데이터 탭으로 이동하여 텍스트 나누기를 클릭합니다.

  4. 표시되는 대화 상자에서 다음 버튼이 비활성화되고 마침 버튼이 활성화될 때까지 다음을 계속 클릭하십시오.

  5. 마침을 클릭한 다음 파일을 저장하고 닫습니다.

  6. 업데이트된 CSV 파일을 Admin Console에 업로드합니다.

오류 메시지는 다음 조건에서 표시됩니다.

  • 필수 열 머리글(예: 이메일)은 있지만 해당 행 값은 누락된 경우.

각 행에 해당하는 값을 입력했는지 확인하십시오.

처리 오류

시스템이 업로드된 파일의 데이터 행을 처리할 수 없는 경우 처리 오류가 발생합니다. 자세한 내용을 보려면 일괄 작업 결과를 참조하십시오.

원인

INTERNAL_SERVER_ERROR 오류는 게이트웨이 시간 초과로 인해 발생합니다. INTERNAL_SERVER_ERROR가 오류 결과 화면의 상태 열에 표시됩니다.

해결 방법

나중에 다시 시도할 수 있습니다.

원인

변경하지 않고 기존 사용자를 다시 업로드하면 사용자가 이미 추가됨이 상태 열에 표시됩니다.

사용자가 이미 추가됨

해결 방법

기존 사용자를 다시 업로드하지 않도록 하십시오. 기존 사용자의 세부 정보가 포함된 행을 제거하십시오.

원인

이 오류는 Azure Sync 또는 Google Sync 관련 디렉터리에서 발생합니다. 사용자는 ID 공급자 측에서 관리됩니다.

해결 방법

ID 공급자 포털에서 동기화된 데이터를 편집하고 관리하며 동기화를 통해 변경 내용이 반영되도록 하는 것이 좋습니다. 반드시 필요한 경우가 아니라면 Admin Console에서 데이터를 수동으로 변경하지 마십시오.

원인

필수 열 머리글(예: 이메일)은 있지만 해당 행 값은 누락된 경우 데이터 구문 분석 오류 메시지가 결과 화면의 상태 열에 표시됩니다. 

구문 분석 오류

해결 방법

각 행에 해당하는 값을 입력했는지 확인하십시오.

원인

도메인이 다음 기준을 충족하지 않는 경우 Enterprise ID 또는 Federated ID 사용자에게 오류가 발생합니다.

  • 도메인 열의 유효한 도메인 이름
  • 유효한 도메인 이름이 포함된 이메일 ID
  • 유효한 도메인 이름이 포함된 사용자 이름

조직에서 도메인을 찾을 수 없습니다 메시지가 상태 열에 표시됩니다.

참고:

잘못된 도메인 이름을 사용할 때 오류가 발생합니다. 도메인을 조직에서 요청하지 않았거나 조직에서 신뢰할 수 없다는 것입니다.

해결 방법

다음 작업을 수행하십시오.

  • Enter the 유효한 도메인 이름 도메인 열에 입력합니다.
  • ID 유형에 따라 유효한 이메일 ID를 입력합니다.
  • ID 유형에 따라 유효한 사용자 이름을 입력합니다.

원인

조직이 사용자를 추가하려는 도메인을 소유하지 않은 경우에는 오류가 발생합니다.

해결 방법

도메인에 사용자를 추가하려면 다음 중 하나를 수행하십시오.

원인

국가 코드 머리글이나 데이터 값이 누락되거나 둘 다 누락된 경우 Enterprise ID 또는 Federated ID 사용자에게 오류가 발생합니다.

국가 코드는 2자 ISO-3166 값이어야 합니다” 메시지가 결과 화면의 상태 열에 표시됩니다.

국가 코드 오류

해결 방법

국가 코드 열 머리글과 유효한 해당 행 값을 입력했는지 확인합니다.

원인

이 오류는 조직이 Adobe의 기업 스토리지 모델로 업데이트되었으며 CSV에 Adobe ID의 ID 유형을 입력한 경우 발생합니다.

해결 방법

Enterprise ID 또는 Federated ID 유형 사용자 중에서 선택해야 합니다.

원인

이 오류는 일반적으로 CSV 파일의 사용자 이름이 조직의 Admin Console에 있는 사용자와 일치하지 않는 경우 발생합니다. 이러한 오류는 Adobe Admin Console에서 사용 가능한 기존 사용자의 작업 중에 트리거됩니다.

조직에 없는 사용자

해결 방법

관리자는 CSV 필드에 제공된 사용자 이름 값이 Adobe Admin Console에서 사용 가능한 사용자 정보에 이미 존재하는지 확인해야 합니다.

원인

이 오류는 사용자 ID 전환 도중에만 발생합니다. CSV 파일에서 지정된 사용자 이름은 일치하지만 이메일은 Admin Console 디렉터리의 이메일과 일치하지 않습니다.

이메일이 일치해야 합니다.

해결 방법

이메일이 Admin Console의 디렉터리에 정의된 도메인과 일치하는지 확인하십시오.

사용자를 일괄 업로드하는 데 여전히 문제가 있는 경우 사례를 만들거나 채팅을 시작하거나 Admin Console 지원에서 기존 사례를 관리하십시오(시스템 또는 지원 관리자인 경우).

추가 도움말은 지원 사례 만들기를 참조하십시오. 

쉽고 빠르게 지원 받기

신규 사용자이신가요?