조직 데이터 업로드(첫 번째 업로드)

조직 데이터는 Microsoft Viva Insights 고급 인사이트 앱에 기본 원본인 Microsoft Entra ID 또는 관리자가 업로드하는 .csv 파일을 통해 두 가지 방법 중 하나로 표시할 수 있습니다.

이 문서에서는 두 번째 옵션인 .csv 파일 업로드에 대해 설명합니다.

중요

조직 데이터를 처음 업로드하는 경우에만 다음 단계를 사용합니다. 첫 번째 업로드가 아닌 경우 조직 데이터 업로드(후속 업로드) 를 참조하여 이전에 업로드한 데이터를 업데이트합니다.

레거시 앱에서 들어오는 고객의 경우:

레거시 고급 인사이트 앱에서 마이그레이션하고 조직 데이터를 처음으로 Viva Insights 업로드하는 경우 데이터 업로드에 새 앱만 사용하는 것이 좋습니다. 새 앱을 사용하면 데이터 불일치가 방지됩니다.

워크플로

원본 데이터를 준비한 후에는 다음 단계를 수행합니다.

1. .csv 파일을 업로드합니다.
2. 필드를 매핑합니다.
3. 앱은 데이터의 유효성을 검사합니다. 유효성 검사에 성공하지 못한 경우 유효성 검사 실패에 설명된 몇 가지 옵션 중에서 선택할 수 있습니다.
4. 앱은 데이터를 처리합니다. 처리에 성공하지 못한 경우 처리 실패에 설명된 몇 가지 옵션 중에서 선택할 수 있습니다.

데이터가 성공적으로 유효성을 검사하고 처리하면 전체 데이터 업로드 작업이 완료됩니다.

파일 업로드

.csv 파일을 업로드하려면 다음 단계를 수행합니다.

1. 고급 인사이트 앱의 관리자 환경을 엽니다.

2. 데이터 허브 페이지의 데이터 원본 아래 화면 오른쪽에 있는 .csv 업로드 카드 이동합니다.

3. 시작을 선택합니다.

4. 2단계 중 1단계: 준비 및 업로드:

   1. 업로드 이름을 입력합니다.
   2. 업로드 파일에서 업로드할 .csv 파일을 선택합니다.

   .csv 파일은 다음과 같은지 확인합니다.

   • UTF-8로 인코딩되었습니다.

   • 업로드 프로세스를 시작할 때 다른 프로그램에서 열리지 않습니다.

   • 1GB보다 크지 않습니다.

     

참고

.csv 파일에 대한 구조와 지침을 확인하고 업로드 중에 일반적인 문제를 방지하려면 .csv 템플릿 다운로드 링크를 통해 템플릿을 다운로드할 수 있습니다.

4. 업로드하려면 다음을 선택합니다. 업로드를 취소하려면 취소를 선택합니다.

필드 매핑

파일을 업로드하면 2단계 중 2단계: 매핑 페이지가 표시됩니다. 데이터에서 인사이트를 보려면 .csv 파일의 필드(열)를 앱이 인식하는 필드 이름으로 매핑해야 합니다.

두 가지 유형의 필드, 즉 시스템 기본값 과 사용자 지정이 있습니다.

시스템 기본값(필수 또는 선택 사항)

시스템 기본 필드는 PersonId, ManagerId 및 조직인 필수 필드이거나 예약 선택 사항일 수 있습니다. 이러한 필드는 그룹화 및 필터링 이외의 특정 계산에서 Viva Insights 알고 사용하는 특성을 나타냅니다.

중요

모든 필수 필드에는 모든 행에 Null이 아닌 유효한 값이 있어야 합니다. .csv 파일의 열 머리글이 Viva Insights 값 이름과 정확히 일치하지 않더라도 필요한 모든 Viva Insights 값을 매핑해야 합니다.

선택적 필드는 일반적으로 앱에서 사용하도록 제안하는 시스템 필드입니다. organization 데이터가 없는 경우 선택적 필드를 매핑할 필요가 없습니다.

필드가 필요한지 선택적 필드인지 확인하려면 매핑 목록 오른쪽의 Viva 특성 섹션을 참조하세요. 필수 특성에는 필드 이름 아래에 "필수" 레이블이 있고 선택적 특성에는 "예약된 선택 사항" 레이블이 있습니다.

필드 정의가 필요한 경우 정보 (i) 아이콘을 마우스로 가리킵니다.

사용자 지정

사용자 지정 필드는 만들 수 있는 선택적 특성입니다. 다음 섹션에서는 사용자 지정 특성의 매핑 및 이름을 설명합니다.

필드를 매핑하려면

아래 단계에 따라 .csv 데이터를 Viva Insights 특성에 매핑합니다.

중요

원본 열 이름 아래에 표시되는 모든 .csv 헤더 필드를 매핑해야 업로드 프로세스의 다음 부분으로 이동할 수 있습니다.

1. 각 필수 Viva Insights 필드에 대해 다음을 수행합니다.

   1. 원본 열 이름 아래에서 해당 열 머리글을 찾습니다. 나중에 유효성 검사 오류를 방지하려면 이 열이 올바른 데이터 형식인지 확인합니다.
   2. Viva Insights 매핑 필드 열 아래에서 드롭다운 목록을 열고 1a단계에서 식별한 열 머리글에 해당하는 Viva Insights 특성을 선택합니다.

2. 사용자 지정 및 선택적 필드에 대해 1a 및 1b단계를 반복합니다.

   사용자 지정 필드를 추가하려면 데이터 파일에 열로 포함하기만 하면 됩니다. 앱은 자동으로 이름을 할당하고 매핑합니다. 이 Viva Insights 릴리스에서는 모든 사용자 지정 특성에 기본 이름이 할당되며 문자열 데이터 형식으로만 분류할 수 있습니다.

   중요

   TimeZone을 열로 업로드하지 마세요. 오류가 발생합니다.

3. 특성 매핑을 완료한 후 화면 왼쪽 아래에 있는 다음 단추를 선택합니다.

필드를 매핑한 후 앱은 다음 섹션에 설명된 대로 데이터의 유효성을 검사하고 처리합니다. 유효성 검사 및 처리가 성공하면 업로드 프로세스에서 사용자 파트로 완료됩니다.

확인

특성을 매핑한 후 앱은 데이터 유효성 검사를 시작합니다.

대부분의 경우 파일 유효성 검사가 신속하게 완료되어야 합니다. 조직 데이터 파일이 큰 경우 유효성 검사에 최대 1~2분이 걸릴 수 있습니다.

이 단계가 완료되면 유효성 검사가 성공하거나 실패합니다. 결과에 따라 데이터 연결 화면의 오른쪽 위 모서리에 성공 알림 또는 실패 알림이 표시됩니다.

다음에 수행되는 작업에 대한 자세한 내용은 적절한 섹션으로 이동하세요.

유효성 검사 성공

유효성 검사 실패

유효성 검사 성공

유효성 검사가 성공하면 Viva Insights 새 데이터 처리를 시작합니다. 처리는 몇 시간에서 하루 정도 걸릴 수 있습니다. 처리하는 동안 진행 중인 데이터 연결 > 업로드 또는 삭제 테이블에 "처리" 상태 표시됩니다.

처리가 완료되면 성공하거나 실패합니다. 결과에 따라 데이터 연결 화면의 오른쪽 위 모서리에 성공 알림 또는 실패 알림이 표시됩니다.

처리 성공

처리에 성공하면 기록 업로드 또는 삭제 테이블에 "성공" 상태 표시됩니다. 이 시점에서 업로드 프로세스가 완료됩니다.

"성공" 상태 받은 후 다음을 수행할 수 있습니다.

• 보기(눈) 아이콘을 선택하여 유효성 검사 결과의 요약을 확인합니다.
• 매핑 아이콘을 선택하여 워크플로에 대한 매핑 설정을 확인합니다.

참고

각 테넌트는 한 번에 하나의 업로드만 진행 중일 수 있습니다. 하나의 데이터 파일의 워크플로를 완료해야 합니다. 즉, 다음 데이터 파일의 워크플로를 시작하기 전에 성공적인 유효성 검사 및 처리로 안내하거나 중단해야 합니다. 업로드 워크플로의 상태 또는 단계는 데이터 연결 탭에 표시됩니다.

처리 실패

처리가 실패하면 진행 중인 업로드 또는 삭제 테이블에 실패한 상태 표시됩니다. 상태 링크를 선택하면 실패에 대한 설명이 표시됩니다.

편집을 선택하거나 새 업로드를 시작합니다. 이 단추를 사용하면 업로드 프로세스를 다시 시작할 수 있습니다.

참고

처리 실패는 일반적으로 백 엔드 오류로 인해 발생합니다. 지속적인 처리 오류가 표시되고 업로드된 파일의 데이터를 수정한 경우 지원 티켓을 Microsoft에 기록합니다.

유효성 검사 실패

데이터 유효성 검사에 실패하면 "유효성 검사 실패" 오류와 오류에 대한 일부 정보가 포함된 새 화면이 표시됩니다. 업로드 프로세스를 진행하지 않으려면 업로드 취소 단추를 선택할 수 있습니다.

원본 파일을 변경하고 업로드를 다시 시도하기 전에 문제 다운로드를 선택할 수 있습니다. 이 로그 파일은 유효성 검사 오류를 발생시킨 데이터 문제를 설명합니다. 이 정보를 사용하여 다음에 수행할 작업을 결정합니다. 원본 데이터를 수정하거나 매핑 설정을 변경합니다.

데이터 오류를 수정하기 위한 지침

데이터 행 또는 열에 잘못된 특성 값이 있는 경우 원본 파일을 수정하거나 특성 매핑을 수정할 때까지 전체 업로드가 실패합니다.

오류를 방지하기 위해 파일의 서식을 지정하는 방법에 대한 자세한 내용은 파일 규칙 및 유효성 검사 오류를 참조하세요.

관련 항목

조직 데이터 준비