조직 구조 및 제품 할당 내보내기 또는 가져오기
적용 대상: Enterprise
글로벌 관리자가 Global Admin Console의 내보내기 및 가져오기 기능을 통해 조직과 제품 관리를 간소화하는 방법에 대해 알아봅니다.
조직 구조를 내보내거나 가져오려면 Global Admin Console에서 조직 탭에 액세스하십시오. 할당 데이터를 보려면 제품 할당 탭으로 이동하십시오. 추가 옵션(⋮) 아이콘을 선택한 다음 내보내기 또는 가져오기를 선택하십시오. Global Admin Console에 로그인하려면 여기로 이동하세요.
조직 구조 내보내기
전역 관리자로서 조직 계층 구조를 내보낼 수 있습니다. 전체 조직 계층 또는 해당 하위 집합의 JSON, CSV 또는 XLSX 표현을 다운로드할 수 있습니다. 그런 다음 분석 또는 수정에 이 데이터를 사용할 수 있습니다.
선택한 내보내기 형식은 내보낸 데이터의 구조에 영향을 줍니다.
- CSV 형식 — 한 번에 한 종류의 데이터만 내보낼 수 있습니다. 제품 프로필을 CSV 형식으로 내보낼 때 프로필과 리소스는 하나의 표로 결합됩니다. 제품 프로필에는 각 리소스에 대해 하나씩 여러 항목이 있습니다.
- XLSX 형식 — 각 조직의 세부 정보가 별도의 시트에 표시됩니다. 레코드는 참조 ID에 의해 서로 다른 개체 유형 간에 연결됩니다. 일부 경우들에서, 특정 객체(예를 들어, 주어진 리소스와 연관된 값들의 세트가 있을 때 리소스 객체들)에 대한 다수의 행들이 있을 수 있다.
- JSON 포맷 — 가장 유연합니다. 내보낸 객체(예: 조직의 제품이 조직 요소에 직접 표시됨) 간의 구조적 관계를 활용할 수 있습니다. 동일한 필드를 세 가지 형식으로 모두 내보내지만 일부 값은 JSON 형식에서 중복됩니다.
내보내기 단계
-
Global Admin Console에 로그인합니다. 조직 탭에서 조직 선택기를 사용하여 내보낼 조직 계층을 선택합니다. 계층의 모든 조직에 대한 데이터를 내보냅니다.
-
추가 옵션 ⋮ 아이콘을 선택하고 내보내기를 선택합니다.
-
내보내기 대화 상자에서 내보낼 내용과 데이터를 내보낼 형식을 선택합니다.
-
내보내기를 선택합니다. 내보내기 파일을 생성하는 데 몇 분 정도 걸릴 수 있습니다. 보고서가 완료되면 Global Admin Console > 인사이트 > 보고서 내보내기로 이동합니다.
파일을 다운로드한 후 데이터를 조작한 다음 다시 가져올 수 있습니다. 가져온 업데이트는 데이터를 수동으로 편집한 것처럼 Global Admin Console에 표시됩니다.
조직 구조 가져오기
전역 관리자로서 잠재적으로 수정된 데이터를 가져올 수 있습니다. 업로드하면 새 데이터가 현재 데이터와 비교되고 모든 변경 사항이 조직 계층에 적용됩니다. 모든 가져오기 작업은 조직 계층의 업데이트된 사본에서 수행됩니다. 보류 중인 변경 사항이 있으면 계층의 기존 보류 중인 변경 사항 위에 가져온 변경 사항이 추가됩니다.
가져오기 단계
- Global Admin Console에 로그인합니다. 조직 탭에서 조직 선택기를 사용하여 가져오기를 수행할 조직 계층을 선택합니다.
- 추가 옵션 ⋮ 아이콘을 선택하고 가져오기를 선택합니다. 가져오기 파일의 크기와 복잡성에 따라 처리 시간이 몇 초에서 몇 분 정도 걸릴 수 있습니다.
- 파일 선택을 선택하고 업로드할 JSON, CSV 또는 XLSX 파일을 선택하십시오. CSV의 경우 한 번에 하나의 조직 세부 사항만 가져올 수 있으며 제품 가져오기는 지원되지 않습니다. 가져온 변경 사항은 데이터를 수동으로 편집한 것처럼 표시됩니다.
- 닫기를 선택합니다.
- 보류 중인 변경 내용 검토를 선택합니다. 그런 다음 변경 내용 제출을 선택하여 실행합니다. 변경 사항을 실행하기 전에 보류 중인 작업은 Global Admin Console에서 수동으로 편집할 때와 동일한 방식으로 표시됩니다.
스키마 내보내기 및 가져오기
CSV 파일을 사용하여 데이터를 가져오는 동안 필드는 모든 순서로 표시될 수 있지만 항상 해당 헤더 행과 일치해야 합니다.
데이터를 가져오는 동안 각 요소에 대한 작업을 지정해야 합니다. 작업은 다음 중 하나일 수 있습니다.
- 업데이트: 편집을 나타냅니다.
- 생성: 새 객체(예: 조직, 사용자 그룹 또는 관리자) 생성을 나타냅니다.
- 삭제: 객체(예: 조직, 사용자 그룹 또는 관리자)의 삭제를 나타냅니다.
작업 필드가 없거나 비어 있는 입력 레코드는 무시됩니다.
조직
가져오기 요구 사항:
- 업데이트 또는 삭제를 위해 orgId는 계층 구조의 기존 조직을 참조해야 합니다.
- 새 조직을 만드는 경우 orgId 필드를 비워 두거나 구성할 수 있는 고유 ID(예: new-1 또는 new-2)로 설정할 수 있습니다. 만들 조직을 참조하는 데 사용할 수 있는 ID를 제공합니다.
- 국가 코드가 유효해야 합니다.
- 업데이트 및 삭제 작업의 orgId가 조직 계층에 이미 있어야 합니다.
- 삭제(으)로 표시된 orgId는 업데이트 또는 만들기 작업이 있는 조직의 parentOrgId로 선택하면 안 됩니다.
- 동일한 수준과 동일한 상위의 하위 조직에는 동일한 orgNames가 없어야 합니다.
- 조직을 만들거나 조직 이름을 업데이트하려면 조직 이름이 동일한 상위의 기존 하위 이름과 일치하지 않아야 합니다.
관리자
가져오기 요구 사항:
- orgId, email, adminType 및 userType에는 유효한 값이 있어야 합니다.
- countryCode가 유효해야 합니다.
- 사용자가 이미 존재하고 업데이트 중인 경우 userType은 사용자와 일치해야 합니다.
- 조직에서 중복 이메일 주소를 확인합니다.
제품 프로필
제품 프로필의 내보내기 및 가져오기는 제품 프로필 세부 사항과 제품 프로필과 연관된 리소스 세트의 두 부분으로 구성됩니다. 이러한 리소스는 일반적으로 서비스를 활성화 또는 비활성화하기 위해 구성할 수 있는 서비스를 식별합니다.
- 리소스 개체는 제품 프로필 내에 JSON 형식으로 중첩됩니다.
- 제품 프로필과 함께 CSV 또는 XLSX를 사용하는 경우 프로필과 리소스는 하나의 표로 결합됩니다. 제품 프로필에는 각 리소스마다 하나씩 여러 항목이 있습니다.
- 리소스의 선택된 필드는 서비스 활성화 여부를 제어합니다.
- 제품 프로필을 가져올 때 제품 프로필 자체와 업데이트하거나 만들 리소스 개체에 대해 만들기 또는 업데이트 작업이 있어야 합니다.
가져오기 요구 사항:
-
productProfileId, licenseId 및 orgId에는 유효한 값이 있어야 합니다.
-
제품 프로필을 만들 때 productProfileName은 유효한 이름이어야 하며 동일한 조직의 다른 제품 프로필 이름 또는 사용자 그룹 이름과 중복되지 않아야 합니다.
-
할당량 필드에는 단위 형식에 대한 유효한 값이 있어야 합니다. resourceType=QUOTA일 때 숫자이거나 제한이 없습니다. 그렇지 않으면 비어 있습니다.
-
알림 필드는 true 또는 false여야 합니다.
-
CSV 및 XLSX 가져오기의 경우 productProfileId의 유효성을 검사하십시오. 모든 항목의 orgId, licenseId 및 productProfileName은 동일해야 합니다.
-
입력 파일 및 조직에서 중복 productProfileName의 유효성을 검사합니다.
-
업데이트 및 삭제할 프로필이 조직에 있어야 합니다.
-
업데이트하고 삭제(비활성화)할 리소스는 프로필에 있어야 합니다.
-
프로필을 만들려면 다음을 확인하십시오.
- orgId는 새 조직이거나 기존 조직이어야 합니다.
- licenseId는 새 제품이거나 기존 제품이어야 합니다.
- 프로필에 대한 리소스의 유효성을 확인합니다.
제품 프로필의 리소스
가져오기 요구 사항:
- 리소스가 속한 제품 프로필에 삭제 또는 만들기(으)로 설정된 작업이 있는 경우 리소스의 작업 필드가 무시됩니다.
- 리소스를 삭제하도록 표시해서는 안 됩니다. 잘못된 작업입니다.
- 제품 프로필을 만들려면 리소스 수는 소스 제품 프로필의 리소스 수와 일치해야 합니다.
- 업데이트 작업이 있는 리소스의 경우 리소스가 제품 프로필에 있어야 합니다.
사용자 그룹
가져오기 요구 사항:
-
orgId는 동일한 가져오기에서 생성 중인 기존 조직 또는 조직을 참조해야 합니다.
-
userGroupId는 업데이트 또는 삭제를 위해 기존 그룹을 참조해야 하며 새 사용자 그룹에 대해 정의한 id일 수 있습니다.
-
업데이트 또는 작성의 경우 userGroupName은 비워 둘 수 없으며 동일한 조직의 다른 사용자 그룹 또는 제품 프로필 이름과 중복되지 않아야 합니다.
-
userGroupName이 입력 파일 및 조직에서 중복되지 않았는지 확인합니다.
-
업데이트 및 삭제할 userGroups가 조직에 있어야 합니다.
-
사용자 그룹에서 제거할 프로필은 사용자 그룹에 있어야 합니다. 사용자 그룹의 프로필에 대해서는 업데이트 작업을 수행할 수 없습니다.
-
사용자 그룹을 만들려면 다음을 확인하십시오.
- orgId는 새 조직이거나 기존 조직이어야 합니다.
- licenseId는 해당하는 경우 새 제품 또는 기존 제품이어야 합니다.
- productProfileId는 새 제품 프로필 또는 기존 제품 프로필이어야 합니다.
도메인
도메인 정보는 각 조직에서 사용할 수 있는 도메인에 대한 읽기 전용 정보를 제공합니다. 이 데이터는 편집할 수 없습니다.
제품 및 리소스 products-and-resources
XLSX 파일에는 제품용 시트 및 리소스용 시트 등 두 개의 시트가 있습니다. JSON에서 리소스 개체는 제품 개체에 중첩됩니다.
제품
가져오기 요구 사항:
- 만들기에서 licenseId는 만드는 고유 ID여야 합니다.
- 업데이트하려면 licenseId가 지정된 조직의 기존 제품 ID여야 합니다.
- orgId는 기존 조직 또는 동일한 가져오기 작업에서 생성 중인 조직을 참조해야 합니다.
- 만들기의 경우 sourceLicenseId는 기존 제품 또는 동일한 가져오기 작업에서 만드는 제품에 대해 정의한 ID를 참조해야 합니다.
- 만들기 작업이 있는 제품에 대해 licenseId와 sourceLicenseId가 동일하면 안 됩니다.
- 제품 조직의 유효성을 검사합니다. 조직은 새 조직이거나 조직 계층에 이미 있어야 합니다.
- 업데이트 및 삭제 작업의 경우 제품이 이미 조직 계층에 있어야 합니다.
- Delete(으)로 표시된 licenseId는 만들기 및 업데이트 작업이 있는 제품의 sourceLicenseId로 사용할 수 없습니다.
- 만들기 작업이 있는 제품의 경우 sourceLicenseId가 상위 조직에 있는지 확인하십시오.
제품에 대한 리소스
리소스 개체는 제품 및 제품 프로필에 표시될 수 있습니다.
가져오기 요구 사항:
리소스가 속한 제품에 삭제 또는 만들기(으)로 설정된 작업이 있는 경우 리소스의 작업 필드가 무시됩니다.
- 리소스를 삭제하도록 표시해서는 안 됩니다. 잘못된 작업입니다.
- 제품을 만들려면 리소스 수가 소스 제품의 리소스 수와 일치해야 합니다.
- 업데이트 작업이 있는 리소스의 경우 리소스가 제품에 있어야 합니다.
제품 할당 데이터 가져오기 및 내보내기
전역 관리자로서 제품 할당 데이터를 JSON 또는 CSV 파일로 내보낼 수 있습니다. 그런 다음 이 데이터를 수정하고 업로드하여 변경 사항을 가져올 수 있습니다. 수정될 가능성이 있는 데이터가 업로드되면 새 데이터가 현재 데이터와 비교되고 모든 변경 사항이 제품 할당 데이터에 적용됩니다. 그런 다음 보류 중인 변경 내용을 검토하고 제출하여 적용할 수 있습니다.
제품 할당 모델 내보내기
제품 할당 모델을 내보내려면 다음을 수행합니다.
- Global Admin Console에 로그인하고 제품 할당 탭으로 이동합니다.
- 추가 옵션 ⋮ 아이콘을 선택한 다음 CSV 내보내기 또는 JSON 내보내기를 선택합니다. 파일이 다운로드되었습니다. 내보내기 형식에 대해 자세히 알아보세요.
제품 할당 모델 가져오기
데이터를 내보내고 수정한 다음 수정된 파일을 가져올 수 있습니다. 제품 할당 모델을 가져오려면 다음을 수행합니다.
- Global Admin Console에 로그인하고 제품 할당 탭으로 이동합니다.
- 추가 옵션 ⋮ 아이콘을 선택하고 가져오기를 선택합니다.
- 업로드할 JSON 또는 CSV 파일을 선택하십시오.
- 보류 중인 변경 내용 검토를 선택합니다. 변경 내용을 검토한 후 변경 내용 제출을 선택하여 실행합니다.
제품 할당을 위한 내보내기 및 가져오기 형식
내보내기 및 가져오기 형식은 동일합니다. CSV 형식으로 가져오는 동안 필드는 임의의 순서로 표시될 수 있지만 머리글 행과 일치해야 합니다. JSON 형식으로 가져오는 동안 필드는 모든 순서로 표시될 수 있습니다.
제품 할당 데이터를 가져오는 동안 작업을 지정해야 합니다. 작업은 다음 중 하나일 수 있습니다.
- 갱신: 편집을 나타냅니다(grantedQuantity, allowOverAllocation 값으로 변경).
- 생성: 제품 리소스를 지정된 조직에 추가하는 것을 나타냅니다.
- 삭제: 제품의 삭제를 나타냅니다.
작업이 제공되지 않으면 해당 행에 대한 데이터를 CSV로 가져오거나 JSON으로 가져올 때 변경 사항이 발생하지 않습니다.
내보낸 파일에는 각 제품 리소스에 대해 하나의 행 또는 레코드가 있습니다. 일부 제품에는 둘 이상의 리소스가 있습니다.
제품에 둘 이상의 자원이 있는 경우 갱신 작업이 독립적인 자원에 적용될 수 있고 삭제 작업이 모든 자원을 포함하는 제품을 조직에서 삭제하고 생성 작업이 가져오기 파일의 각 자원에 대한 레코드가 있어야 각 자원의 적절한 수량을 지정할 수 있습니다. allowOverAllocation 필드는 제품 전체에 해당하므로 이 필드에 대한 업데이트가 있는 리소스는 중요하지 않습니다.
헤더 설명
가져오기 요구 사항
데이터 유효성 검사
-
작업 필드에는 유효한 작업이 있어야 합니다.
-
제품 가져오기 데이터에는 필수 필드에 대한 속성과 값이 있어야 합니다.
-
제품 가져오기 데이터 속성의 형식이 올바른지 확인하십시오.
-
다른 리소스에 대해 제품 정책 필드(overAllocation)를 제공해서는 안 됩니다.
-
grantedQuantity 필드:
- 아직 unlimited이(가) 아닌 경우 unlimited(으)로 변경할 수 없습니다.
- 음수가 아닌 정수이거나 문자열 값 unlimited.이어야 합니다.
권한/액세스 가능한 유효성 검사
- 가져오기 데이터와 연결된 조직이 있어야 합니다. 업데이트하는 경우, 가져오기 데이터와 연관된 제품 및 리소스가 실제로 존재하는지 확인하십시오.
제품 유효성 검사 추가
- SourceLicenseId가 있어야 합니다.
- 새 제품과 연계된 조직이 있어야 합니다.
- 생성 중인 제품이 없어야 합니다(동일한 licenseId를 가진 제품).
- 만들어지는 제품과 관련된 리소스에는 해당 제품과 일치하는 해당 productId가 있어야 합니다.