csv 소스 태그가 지정되며, 업데이트된
파일을 다시 업로드하면 동기화된 상태로 유지됩니다. CSV 가져오기는 초기 로드 및 일회성
업데이트에 적합합니다. HR 시스템이 지속적인 신뢰할 수 있는 정보 소스인 경우 대신
HR 동기화를 사용하세요.
정의한 사용자 지정 속성을 파일의 열로
포함할 수도 있습니다. Directory → Users에서 + User 옆의 화살표를 선택한 다음
Import via CSV를 선택합니다.
목록이 변경될 때마다 다시 업로드하세요. CSV 가져오기와 HR 동기화를 결합할 수
있습니다. 많은 팀이 CSV로 디렉터리를 초기 구성한 다음 HR 시스템을 연결하여 최신 상태로
유지합니다. HR 동기화를 사용해야 하는 경우를
참조하세요.
파일 요구 사항
열
가져오기 대화 상자에는 파일에 포함할 수 있는 모든 열(필수 핵심 열, 선택적 핵심 열 및 스키마의 사용자 지정 속성 열)이 나열됩니다. Download sample.csv의 샘플을 헤더 템플릿으로 사용하세요. 열 이름이 샘플과 일치하면 각 행의 값이externalId로 식별된 사용자의 일치하는 프로필 필드를 채웁니다.
필수
모든 행에는 다음 각 열에 대해 비어 있지 않은 값이 포함되어야 합니다.선택 사항
값이 필요하지 않은 경우 셀을 비워 두거나 열을 완전히 생략하세요.domain이 비어 있으면
Iru가 이메일 주소에서 도출합니다.
사용자 지정 속성
스키마에서 사용자 지정 속성을 정의하면 가져오기 대화 상자의 Custom attribute columns 아래에 카테고리 슬러그와 속성 슬러그로 구성된categorySlug.attributeSlug 이름으로
나열됩니다. 예를 들어 슬러그가 extrainfo인 카테고리의 department와 title은
extrainfo.department 및 extrainfo.title로 표시됩니다.
CSV 헤더에 속성당 하나의 열을 추가하세요. 핵심 열 이름은 정확히 일치해야 하며, 사용자
지정 속성 열 이름은 대/소문자와 공백을 무시합니다.
샘플 파일
가져오기 대화 상자에서 Download sample.csv를 선택하면 모든 핵심 열과 예제 사용자 한 명이 포함된 시작 파일을 받을 수 있습니다. 스키마에 사용자 지정 속성이 포함된 경우 Download sample.csv 옆의 화살표를 선택한 다음 With custom attributes를 선택합니다. 이 샘플은 스키마의 각 사용자 지정 속성에 대한 열을 추가하고 예제 행에서 해당 셀을 비워 두어 직접 채울 수 있도록 합니다. 핵심 열과 예제 사용자는 동일하게 유지됩니다. 예제 사용자를 자신의 행으로 바꾸고 헤더 이름은 변경하지 마세요.필드 동작
도메인 도출
domain이 비어 있으면 Iru가 이메일 주소에서 가져옵니다(jane.doe@example.com은example.com이 됨).domain이 제공되면 해당 값이 그대로 사용됩니다.- 아직 존재하지 않는 도메인은 자동으로 생성됩니다.
전화번호
전화번호 값은 Iru Identity의 다른 모든 곳에서 전화번호가 저장되는 방식과 동일하게 E.164(선행+, 국가 코드, 숫자로 구성되며 공백이나 구두점 없음)로 정규화됩니다.
주소
Iru는 주소 열 중 하나라도 값이 있으면 주소를 저장합니다. 부분 주소(예:locality와
country만)도 괜찮으며, 누락된 부분은 비어 있는 상태로 유지됩니다. 모든 주소 열이 비어
있으면 주소가 저장되지 않습니다.
가져오기 실행
Import users via CSV 대화 상자에는 필수 및 선택적 핵심 열, 스키마의 사용자 지정 속성 열, 그리고 With custom attributes 화살표가 있는 Download sample.csv가 표시됩니다. 파일을 업로드 영역으로 끌어다 놓거나 찾아보기로 선택하세요.1
가져오기 시작
Directory → Users에서 + User 옆의 화살표를 선택한 다음 Import via CSV를
선택합니다. 대화 상자의 열 목록을 위 표와 비교하여 검토합니다.
2
파일 준비
Download sample.csv를 선택하여 핵심 열과 예제 사용자 한 명이 포함된 파일을
받습니다. 파일에 사용자 지정 속성 열이 포함된 경우 Download sample.csv 옆의
화살표를 선택한 다음 With custom attributes를 선택합니다. 예제 사용자를 자신의
행으로 바꾸고 샘플 헤더 이름을 유지하여 각 행이 올바른 사용자 및 프로필 필드에
매핑되도록 합니다.
3
파일 선택
CSV를 선택하거나 업로드 영역으로 끌어다 놓습니다.
4
업로드 및 유효성 검사
Iru는 먼저 전체 파일의 유효성을 검사합니다. 유효성 검사를 통과하면 행이 수락되고
백그라운드에서 사용자가 생성되거나 업데이트됩니다. 유효성 검사에 실패하면 대화 상자에
보고서가 표시되고 아무것도 가져오지 않습니다.
5
결과 검토
업로드에 성공하면 스테이징된 사용자 수가 보고되고 가져오기가 기록에 추가되며, 여기에서
각 행의 결과를 검토할 수 있습니다.
생성 대 업데이트: 다시 업로드
사용자는csv 소스 내에서 externalId로 매칭됩니다.
- **새
externalId**는end-user역할을 가진 새 사용자를 생성합니다. - **기존
externalId**는 행에서 해당 사용자의 프로필을 업데이트합니다. 역할과 그룹 멤버십은 변경되지 않습니다.
externalId는 고유해야 합니다.
변경한 행만이 아니라 현재 전체 파일을 매번 다시 업로드하세요. 각 가져오기는
externalId로 매칭됩니다.유효성 검사 및 오류
유효성 검사는 두 단계로 실행됩니다. 파일이 완전히 수락될 때까지 아무것도 가져오지 않습니다.파일 문제(전체 파일이 거부됨)
파일 문제(전체 파일이 거부됨)
파일을 처리할 수 없습니다. 일반적인 원인으로는 중복 열, 누락된 필수 열, 빈 파일,
데이터 행이 없는 헤더 또는 제한을 초과하는 행 수가 있습니다. 파일을 수정하고 다시
업로드하세요.
행 문제(여전히 아무것도 가져오지 않음)
행 문제(여전히 아무것도 가져오지 않음)
파일 형식은 올바르지만 하나 이상의 행이 유효하지 않습니다. Iru는 모든 문제를
줄(헤더가 1번 줄이므로 첫 번째 데이터 행은 2번 줄), 문제가 있는 열(전체 행
문제의 경우 비어 있음) 및 메시지와 함께 반환합니다. 예:
나열된 행을 수정하고 다시 업로드하세요.
적용 오류(정상 파일이 수락된 후)
적용 오류(정상 파일이 수락된 후)
파일이 수락되면 행이 백그라운드에서 적용됩니다. 예를 들어 이메일이 이미 다른 사용자에
의해 사용 중이거나 값이 고유 속성과 충돌하는 경우
이 단계에서도 행이 실패할 수 있습니다. 이러한 적용 오류는 행의
externalId,
username 및 오류 세부 정보와 함께 가져오기 배치에 기록됩니다. 해당 행을 수정하고
다시 가져오세요.HR 동기화를 사용해야 하는 경우
목록이 변경될 때마다 CSV를 다시 업로드하면 Iru가 모든 행을 다시 검사합니다. 지속적이고 수동 개입 없는 프로비저닝을 위해서는 대신 HR 시스템을 신뢰할 수 있는 기록으로 연결하세요.둘 다 사용할 수 있습니다. HR 동기화 설정은
Directory Sync에서 다룹니다.
다음 단계
HR 시스템 연결
일정에 따라 생성, 업데이트 및 제거를 자동화합니다.
먼저 스키마 설계
가져오기 전에 필수 속성과 고유 속성을 정의합니다.
개별 사용자 관리
가져온 사용자를 편집, 일시 중지 및 초대합니다.
그룹으로 구성
가져온 사용자를 할당 가능한 그룹으로 만듭니다.