중요
이 기능은 공개 미리 보기 고객만을 위한 것입니다. 미리 보기의 기능은 완료되지 않을 수 있으며 더 광범위한 릴리스에서 사용할 수 있게 되기 전에 변경될 수 있습니다.
이 문서에서는 전체 및 증분이라는 두 가지 종류의 가져오기에 대해 설명합니다. 이러한 가져오기는 Viva Insights 대한 연결을 설정할 때 제공한 데이터를 새로 고칩니다.
중요
조직 데이터를 처음 가져오는 것이 아닌 경우에만 다음 단계를 사용합니다. 첫 번째 가져오기인 경우 조직 데이터 가져오기(첫 번째 가져오기)를 참조하여 연결을 설정하고, 내보내기 앱을 빌드하고, 데이터를 Viva Insights.
후속 가져오기 정보
데이터를 Viva Insights 가져올 때 전체 또는 증분 새로 고침을 수행합니다. 필드를 삭제하려면 전체 새로 고침을 사용하여 이 작업을 수행할 수 있습니다.
조직 데이터 가져오기(첫 번째 가져오기)에서 만든 사용자 지정 내보내기 앱과 GitHub에서 만든 DescriptiveDataUploadApp은 아래에서 설명하는 새로 고침을 용이하게 합니다. 요약하면 DescriptiveDataUploadApp이 실행되면 GitHub에서 다운로드한 압축된 폴더에서 데이터를 가져옵니다. 이 압축된 폴더에는 다음 파일이 포함되어 있습니다.
- 가져올 필드가 포함된 data.csv.
- 원본 필드를 Viva Insights 필드에 매핑하는 metadata.json. 또한 다음 섹션에서 설명한 대로 metadata.json 사용하여 새로 고침이 전체인지 증분인지 Viva Insights 알려줍니다.
전체 또는 증분 새로 고침을 나타내는 방법
- metadata.json 3줄로 이동합니다.
-
“IsBootstrap”:속성을 다음 중 하나로 업데이트합니다.- 전체 새로 고침의 경우 를 사용합니다
“IsBootstrap” : “true”. - 증분 새로 고침의 경우 를 사용합니다
“IsBootstrap” : “false”.
- 전체 새로 고침의 경우 를 사용합니다
DescriptiveDataUploadApp이 실행되면 Viva Insights metadata.json 여기에 지정한 내용에 따라 데이터를 전체 또는 증분 새로 고침으로 처리하기 시작합니다.
중요
data.csv 파일에 포함되지 않은 metadata.json 필드를 삭제해야 합니다. metadata.json 파일에 data.csv 파일보다 많은 필드가 있거나 그 반대의 경우 가져오기에 대한 처리가 실패합니다.
metadata.json 및 필드를 매핑하는 데 사용하는 방법에 대한 자세한 내용은 조직 데이터 가져오기(첫 번째 가져오기) 를 참조하세요.
새로 고침 유형
Full
전체 새로 고침을 수행하면 Viva Insights 모든 organization 데이터를 대체합니다. 즉, 이미 가져온 데이터를 덮어씁 수 있습니다. 전체 새로 고침을 수행할 때 라이선스가 부여되고 허가되지 않은 모든 직원(Viva Insights 구독이 있는 직원과 그렇지 않은 직원)에 대한 데이터를 제공해야 합니다. 이 문서의 뒷부 분에서 제공할 필드에 대해 설명합니다.
삭제한 필드가 데이터에 표시되지 않으므로 전체 새로 고침을 사용하여 필드를 삭제할 수 있습니다. 다음 섹션에서는 데이터 삭제에 대해 설명합니다.
전체 새로 고침을 사용하여 필드 삭제
전체 새로 고침을 사용하여 필드를 삭제하려면 삭제하려는 필드를 제외한 모든 필드를 포함하는 .csv 데이터를 내보냅니다. 전체 새로 고침은 기존 데이터를 대체하므로 가져오기 중에 제외된 필드를 제외한 모든 필드로 끝납니다.
증분
Viva Insights 이미 업로드한 조직 데이터에 새 정보만 추가하려는 경우 증분 새로 고침을 수행합니다. 증분 새로 고침으로 수행할 수 있는 작업은 다음과 같습니다.
- 새 직원 추가
- 기존 직원에 대한 새 특성 추가
- 새 직원을 위한 새 특성 추가
- 기존 직원의 특성 편집
다음은 증분 새로 고침을 수행할 수 있는 경우의 몇 가지 예입니다.
신입사원 추가
조직 데이터에 5명의 신규 채용자를 추가하려는 경우를 가정해 보겠습니다. 가져오는 동안 다음을 포함합니다.
- 새 직원 데이터가 포함된 5개 행입니다.
- 필수 특성: PersonId, ManagerId, 조직 및 EffectiveDate.
- 이미 Viva Insights 가져온 모든 예약된 선택적 필드(예: HireDate)입니다.
가져오기가 완료되면 5개의 새 행과 해당 값만 변경됩니다.
새 특성 추가
모든 기존 직원에 대해 이전에 데이터에 없었던 선택적 예약 특성을 추가하려고 할 수 있습니다. 위치라고 가정해 보겠습니다. 데이터를 가져오러 이동하면 각 직원의 현재 및 기록 값이 있는 Location, PersonId 및 EffectiveDate만 .csv 파일에 포함됩니다. 가져오기가 완료되면 각 직원에 대한 새 열인 Location을 제외하고 이전과 동일한 데이터를 찾을 수 있습니다.
전체 및 증분 새로 고침을 위해 data.csv 포함할 필드
아래에 나열된 새로 고침 형식의 경우 data.csv 파일에 다음 필드를 포함합니다. 다음을 확인합니다.
- 조직 데이터 준비의 지침에 따라 이러한 필드의 서식 을 지정합니다.
- metadata.json 파일에서 포함하지 않는 필드를 제거합니다.
- data.csv 파일과 metadata.json 파일을 GitHub에서 다운로드한 압축된 폴더에 보관합니다. DescriptiveDataUploadApp을 실행하면 압축된 폴더 경로를 제공합니다. Viva Insights 이 위치에서 데이터를 끌어옵니다.
| 이러한 종류의 새로 고침 | 이러한 필드를 data.csv | 이러한 값 사용 | 이러한 직원의 경우 |
|---|---|---|---|
| Full | PersonId |
|
전체 |
| ManagerId |
|
전체 | |
| 조직 |
|
전체 | |
| EffectiveDate |
|
전체 | |
| 이미 Viva Insights 가져온 모든 예약된 선택적 필드(예: HireDate) |
|
전체 | |
| 전체 (예약된 선택적 필드를 삭제하는 경우) | PersonId |
|
전체 |
| ManagerId |
|
전체 | |
| 조직 |
|
전체 | |
| EffectiveDate |
|
전체 | |
| 삭제하려는 예약된 선택적 필드를 제외하고 이미 Viva Insights 가져온 모든 예약된 선택적 필드(예: HireDate) |
|
전체 | |
| 증분 (새 필드를 추가하거나 기존 필드를 편집하지만 새 직원을 추가 하지 않는 경우) | PersonId |
|
전체 |
| EffectiveDate |
|
전체 | |
| 추가하려는 예약된 선택적 필드(예: HireDate) |
|
전체 | |
| 증분 ( 신규 직원 추가용) | PersonId |
|
신입 사원만 |
| ManagerId |
|
신입 사원만 | |
| 조직 |
|
신입 사원만 | |
| EffectiveDate |
|
신입 사원만 | |
| 이미 Viva Insights 가져온 모든 예약된 선택적 필드(예: HireDate) |
|
신입 사원만 |
참고
- "모든 기록": 이전 기간의 값입니다. 예를 들어 월별 데이터를 포함하는 경우 이 데이터로 이어지는 매월 값을 포함합니다. 처음 Viva Insights 사용하기 시작하면 13개월 분량의 데이터를 사용하는 것이 좋습니다. 그 후에는 데이터를 정기적으로 업데이트하여 27개월 분량의 데이터로 빌드하는 것이 좋습니다.
- "마지막 업로드 이후의 모든 값": 업로드 사이의 기간 값입니다. 예를 들어 마지막 업로드가 3월이고 지금은 7월인 경우 4월, 5월 및 6월 값을 포함합니다.