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

개요

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

CSV로 사용자 추가

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

파일 요구 사항

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

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

파일 형식 및 머리글

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

업로드하는 CSV 파일은 필드를 구분하기 위한 구분 기호로 쉼표(“,”)를 사용해야 합니다. 

일부 로케일에서 운영 체제는 세미콜론(“;”)을 필드 구분 기호로 사용합니다. 이로 인해 Microsoft Excel에서 구분 기호로 세미콜론이 포함된 파일을 저장하여 처리가 실패하는 원인이 됩니다. 이 문제를 해결하기 위해 지역 설정을 일시적으로 업데이트할 수 있습니다. 또는 Excel에 파일을 저장할 때 다른 이름으로 저장을 선택하고 인코딩 유형으로 UTF -8를 선택하여 파일을 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 유형

작업

예외 사항

Business ID

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

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

참고:

당사는 현재 기업 스토리지 및 기타 기업 수준의 기능과 같은 이점을 제공하기 위해 기존의 모든 Adobe ID를 Business ID로 마이그레이션하고 있습니다. 모든 신규 비즈니스 고객은 팀 멤버용 Business ID를 사용하게 됩니다.

조직에서 해당 업그레이드를 예약할 때 사전 통지 메시지를 수신하게 됩니다. 자세한 내용은 Business ID 및 새로운 스토리지 기능 소개를 참조하십시오. 조직이 마이그레이션되기 전까지 계속해서 Adobe ID 유형을 사용하여 조직에 액세스할 수 있습니다. 이후 Adobe ID에 대한 지원은 개인 사용자 고객에게만 제공됩니다.

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 값이어야 합니다” 메시지가 결과 화면의 상태 열에 표시됩니다.

국가 코드 오류

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

조직이 새 Business ID로 마이그레이션된 경우 CSV에 ID 유형으로 Adobe ID를 입력하면 이 오류가 발생합니다.

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

조직이 새 Business ID로 마이그레이션되지 않은 경우 CSV에 ID 유형으로 Business ID를 입력하면 이 오류가 발생합니다.

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

이 오류가 발생하면 조직이 Adobe의 새 Business ID로 마이그레이션되었으며 CSV에 Adobe ID의 ID 유형을 입력했음을 의미합니다.

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

이 오류가 발생하면 조직이 Adobe의 새 Business ID로 마이그레이션되었으며 Adobe ID를 사용자 그룹에 추가하고 있음을 의미합니다.

사용자 그룹에 추가하려면 Business ID, Enterprise ID 또는 Federated ID 유형 사용자 중에서 선택해야 합니다.

Business ID 사용자의 이름, 성, 국가를 편집하려고 하면 이 오류가 발생합니다. 이 작업은 Business ID 유형 사용자에게 허용되지 않습니다.

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

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

Adobe 로고

내 계정 로그인