Azure Blob 가져오기를 사용하여 조직 데이터 가져오기

조직 데이터는 기본 원본인 Microsoft Entra ID 통해, Insights 관리자가 Viva Insights에 직접 업로드하는 개별 .csv 파일을 통해, API 기반 가져오기를 통해, Workday를 통해 또는 사용자, 원본 시스템 관리자 및 Azure Azure Blob 가져오기를 통해 5가지 방법 중 하나로 Viva Insights 웹앱에 표시될 수 있습니다. 기여자 설정합니다.

이 문서에서는 blob 가져오기를 Azure 다섯 번째 옵션에 대해 설명합니다.

Azure Blob 가져오기를 사용하면 Azure 기여자 Azure Portal Blob 컨테이너를 만들고 원본 시스템 관리자는 .csv 파일을 Blob 컨테이너의 위치로 주기적인 내보내기를 구성합니다. 그런 다음 이 위치 내의 .csv 파일에서 organization 데이터를 자동으로 끌어오도록 Viva Insights를 설정할 수 있습니다.

워크플로

1. 설정:

   1. Azure 기여자 Azure Portal 보안 Blob 컨테이너를 만듭니다. Blob 저장소 위치는 중요한 조직 데이터에 대해 안전해야 하며 고객의 Azure 구독에서 설정해야 합니다.

   2. Azure 기여자 서비스 주체 권한 부여를 선호하는 경우 Azure 기여자 서비스 주체에 권한을 부여하고 안전한 방식으로 공유하여 Insights 관리자 및 원본 시스템 관리자에게 Blob URL을 제공합니다. Azure 기여자 서비스 주체 권한 부여를 선호하지 않는 경우 SAS URL을 생성하여 Insights 관리자 및 원본 시스템 관리자에게 제공합니다.

   3. 원본 시스템 관리자는 .csv 파일 및 .json 매핑 파일의 데이터를 준비하고 HR 원본 시스템에서 Blob 컨테이너로 .csv 파일의 주기적인 내보내기를 구성합니다.

   4. Insights 관리자는 Viva Insights 앱의 URL을 입력하여 Azure Blob 저장소 위치에서 가져오기를 켭니다. Insights 관리자는 원본 시스템 관리자가 제공한 .json 매핑 파일도 업로드합니다.

2. 유효성 검사: Viva Insights는 데이터의 유효성을 검사합니다. 유효성 검사에 성공하지 못한 경우 유효성 검사 실패에 설명된 몇 가지 옵션 중에서 선택할 수 있습니다.

3. 처리: Viva Insights는 데이터를 처리합니다. 처리에 성공하지 못한 경우 처리 실패에 설명된 몇 가지 옵션 중에서 선택할 수 있습니다.

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

설정

1. 보안 Blob 컨테이너 만들기

적용 대상: Azure 기여자

1. 브라우저를 열고 organization Azure Portal 로그인합니다.

2. Azure 서비스에서스토리지 계정을 선택합니다.

3. 왼쪽 위에 있는 스토리지 계정 에서 만들기 를 선택하여 새 스토리지 계정을 만듭니다.

4. 프로젝트 세부 정보에서 기본 설정을 사용합니다.

5. 인스턴스 세부 정보에서 스토리지 계정 이름을 입력하고 지역을 선택합니다. 성능 및 중복성의 경우 변경할 필요가 없는 한 기본 설정을 사용할 수 있습니다.

6. 아래쪽에서 다음: 고급을 선택합니다.

7. 고급 페이지에서 "REST API 작업에 보안 전송 필요", "스토리지 계정 키 액세스 사용" 및 "계층 구조 네임스페이스 사용"을 선택합니다. "최소 TLS 버전"의 경우 버전 1.2 이상을 선택합니다.

8. 다른 모든 고급 설정의 경우 변경할 필요가 없는 한 기본 설정을 사용할 수 있습니다.

9. 아래쪽에서 다음: 네트워킹을 선택합니다.

10. 네트워크 연결에서 모든 네트워크에서 공용 액세스 사용 또는 선택한 가상 네트워크 및 IP 주소에서 사용을 선택합니다. 두 번째 옵션을 선택하는 경우 방화벽에서 클라이언트 IP 주소 추가를 선택하고 Insights 관리자가 공유하는 허용 목록에 대한 IP 주소를 제공합니다.

11. 네트워크 라우팅에서 라우팅 기본 설정을 선택합니다.

12. 아래쪽에서 다음: 데이터 보호를 선택합니다.

13. 데이터 보호 페이지에서 변경할 필요가 없는 한 기본 설정을 사용할 수 있습니다.

14. 아래쪽에서 다음: 암호화를 선택합니다.

15. 암호화 페이지에서 변경할 필요가 없는 한 기본 설정을 사용할 수 있습니다.

16. 아래쪽에서 다음: 태그를 선택합니다.

17. 선택 사항: 계정에 태그를 추가합니다.

18. 아래쪽에서 다음: 검토를 선택합니다.

19. 선택 항목을 검토합니다. 그런 다음, 왼쪽 아래에서 만들기를 선택합니다.

20. 다음 페이지에는 "배포가 진행 중"이라는 메시지가 표시됩니다. 배포가 완료되면 스토리지 계정 및 해당 설정이 표시됩니다.

21. 왼쪽의 데이터 스토리지에서 컨테이너를 선택합니다.

22. 새 컨테이너를 만들려면 맨 위에서 컨테이너를 선택합니다. 그런 다음 오른쪽에 컨테이너의 이름(예: "hrupload")을 입력합니다. 아래쪽에서 만들기를 선택합니다.

2. Blob 컨테이너 권한 부여

적용 대상: Azure 기여자 및 스토리지 Blob 데이터 기여자

다음으로 권한 부여를 위한 Blob SAS URL을 만들거나 서비스 주체 권한 부여를 사용하는 경우 Blob URL을 만들어야 합니다. 서비스 주체 권한 부여는 권장되고 더 안전한 방법입니다. Blob SAS 토큰에는 기본 제공 감사 기능이 없습니다. 선택한 메서드에 대해 아래의 적절한 단계를 따릅니다.

서비스 주체 권한 부여의 경우:

1. 왼쪽 패널에서 Access Control 선택합니다.

2. 맨 위에서 역할 할당을 선택합니다. 추가를 선택한 다음, 역할 할당 추가를 선택합니다.

3. 역할 목록에서 Storage Blob 데이터 판독기를 찾아 선택합니다.

4. 멤버 옆에 있는 멤버 선택을 선택합니다. 오른쪽의 검색 필드에 Workplace Analytics를 입력하고 선택합니다.

5. 왼쪽 아래에서 검토 + 할당을 선택합니다.

6. 왼쪽 패널의 데이터 스토리지에서 컨테이너를 선택합니다.

7. 위의 단계에서 만든 스토리지 컨테이너를 선택합니다.

8. 왼쪽 패널의 설정에서 속성을 선택합니다.

9. URL을 복사하여 Insights 관리자 및 원본 시스템 관리자와 안전하게 공유합니다.

SAS URL 권한 부여의 경우:

1. 만든 새 스토리지 컨테이너가 나타나면 선택합니다. 그런 다음, 설정 아래의 왼쪽에서 액세스 정책을 선택합니다.

2. 저장된 액세스 정책에서 정책 추가를 선택합니다. "BlobStore"와 같은 고유 식별자를 제공합니다. 읽기 및 권한 나열을 선택합니다. 지난 몇 분 동안의 시작 시간과 지금부터 1년 후의 종료 시간을 선택합니다.

3. 설정 아래의 왼쪽에서 공유 액세스 토큰을 선택합니다.

4. 서명 키에서 기본 옵션을 사용할 수 있습니다. 저장된 액세스 정책에서 위에서 만든 정책을 선택합니다. 그러면 만료 기간 및 사용 권한 목록이 자동으로 채워집니다.

5. 허용된 IP 주소 및허용된 프로토콜의 경우 기본 설정을 사용할 수 있습니다.

6. SAS 토큰 및 URL 생성을 선택합니다.

7. Blob SAS URL을 복사하고 Insights 관리자와 안전하게 공유합니다.

8. 원본 시스템 관리자에게 이 컨테이너의 데이터를 채울 사용자를 알릴 수 있습니다. 스토리지 Blob 데이터 기여자 액세스 권한이 필요합니다.

3. Blob 위치에서 데이터를 가져오도록 Viva Insights 설정

적용 대상: Insights 관리자

1. 데이터 허브 페이지 또는 데이터 연결 아래의 조직 데이터 페이지 중 하나에서 가져오기를 시작합니다.

   1. 데이터 허브에서:

      1. 데이터 원본 섹션의 Azure Blob 가져오기에서 시작을 선택합니다.

   2. 데이터 연결에서:

      1. 현재 원본 옆에 있는 데이터 원본 관리를 선택합니다.
      2. Azure Blob 가져오기 창이 나타납니다. 시작을 선택합니다.

2. 연결 이름에서 가져오기의 고유한 이름을 입력합니다.

3. 권한 부여 유형에서 서비스 주체 권한 부여 또는 SAS URL 권한 부여를 선택합니다. 여기서 선택하는 방법은 위의 2단계에서 Azure 기여자 사용하는 권한 부여 방법에 따라 달라집니다.

4. 허용 목록에 대한 IP 주소를 Azure 기여자 보냅니다.

5. 2단계의 Azure 기여자 제공한 가져오기에 대한 Blob SAS URL 또는 Blob URL을 입력합니다.

6. 원본 시스템 관리자가 제공한 .json 매핑 파일을 업로드합니다.

7. 사용을 선택한 다음, 저장을 선택합니다.

8. 오류 메시지가 표시되면 검사 위에서 설명한 모든 단계를 수행했는지 확인하고 입력한 Blob SAS URL 또는 Blob URL이 정확한지 확인하는 검사. 다시 시도를 선택합니다.

4. 조직 데이터 .csv 파일 및 .json 매핑 파일 준비 및 Blob 저장소로 보내기

적용 대상: 원본 시스템 관리자

작업 1 - 데이터 준비

데이터 내보내기 및 가져오기를 시작하기 전에 조직 데이터 파일 업로드 준비의 1~4단계에 따라 파일을 준비해야 합니다. 이 문서를 사용하여 필수 및 예약된 선택적 특성에 대해 알아볼 수도 있습니다.

데이터 준비 팁

• 새 데이터의 경우 모든 직원의 전체 기록 데이터를 포함합니다.

• 라이선스가 부여된 직원 및 라이선스가 없는 직원을 포함하여 회사의 모든 직원에 대한 조직 데이터를 가져옵니다.

• 너무 많거나 너무 적은 고유 값, 중복 필드, 잘못된 데이터 형식 등과 같은 일반적인 문제를 방지하려면 데이터 구조 및 지침에 대한 샘플 .csv 템플릿 을 참조하세요. 파일 규칙 및 유효성 검사 오류에 대해 자세히 알아봅니다.

작업 2 - 원본 시스템에서 데이터 내보내기

선택한 빈도에서(한 달에 한 번, 일주일에 한 번 등) 프로그래밍 방식으로 원본 시스템에서 조직 데이터를 .csv 파일로 내보냅니다. 이 샘플 .csv 템플릿을 참조하세요. 지침에 따라 파일의 서식 을 지정합니다.

1단계에서 Azure 기여자 만든 Blob 위치에 파일을 수동으로 업로드하려면 .csv 파일을 Azure 기여자 또는 Storage Blob Data 기여자 보내고(이러한 역할이 이미 할당되지 않은 경우) 다음 단계를 수행하도록 요청합니다.

1. 브라우저를 열고 Azure 기여자 제공하는 Blob SAS URL을 입력합니다.

2. 위쪽에서 업로드를 선택합니다. 그런 다음 오른쪽에서 위의 지침을 사용하여 만든 .csv 파일을 업로드합니다.

.json 매핑 파일을 준비하고 Insights 관리자에게 보냅니다.

수행 중인 새로 고침 유형과 Viva Insights가 필드를 매핑하는 방법을 나타냅니다.

• “DatasetType”: “HR” (줄 2). 그대로 둡니다.

• “IsBootstrap”: (줄 3). "true"를 사용하여 전체 새로 고침을 나타내고 "false"를 사용하여 증분 새로 고침을 나타냅니다.

• "매핑": Viva Insights에서 사용하는 이름 이외의 이름을 사용하는 경우 원본 시스템에서 사용하는 것과 일치하도록 각 열 머리글 이름을 변경합니다.

매핑 예제

다음 예제에서는 샘플 .json 파일에서 찾을 수 있는 하나의 필드를 나타냅니다.

"PersonId": { 
    "name": "PersonId", 
    "type": "EmailType"

• "PersonId": { 은 원본 열 이름에 해당합니다.

• “name” : “PersonId”는 Viva Insights 필드 이름에 해당합니다.

• "type": "EmailType" 는 필드의 데이터 형식에 해당합니다.

원본 시스템에서 PersonId 대신 이 필드 헤더에 Employee를 사용한다고 가정해 보겠습니다. 필드가 올바르게 매핑되었는지 확인하려면 아래의 첫 번째 줄을 편집하여 다음과 같이 표시합니다.

"Employee": {
    "name": "PersonId",
    "type": "EmailType"

데이터를 업로드하면 직원 필드가 Viva Insights의 PersonId가 됩니다.

그런 다음 .json 매핑 파일을 Insights 관리자에게 전송하여 Azure Blob 가져오기에 대한 연결을 설정하는 동안 Insights에 업로드합니다.

5. 유효성 검사

적용 대상: Insights 관리자

원본 시스템 관리자가 데이터를 내보내고 가져오기를 설정하면 앱이 유효성 검사를 시작합니다. 대부분의 경우 파일 유효성 검사가 신속하게 완료되어야 합니다.

이 단계가 완료되면 유효성 검사가 성공하거나 실패합니다. 결과에 따라 조직 데이터 데이터 > 연결의 기록 가져오기 테이블에서 성공 상태 또는 실패 상태 받게 됩니다.

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

• 유효성 검사 성공
• 유효성 검사 실패

유효성 검사 성공

유효성 검사가 성공하면 Viva Insights에서 새 데이터 처리를 시작합니다. 처리는 몇 시간에서 하루 정도 걸릴 수 있습니다. 처리하는 동안 가져오기 기록 테이블에 "처리" 상태 표시됩니다.

처리가 완료되면 성공하거나 실패합니다. 결과에 따라 가져오기 기록 테이블에서 "성공" 또는 "실패" 상태 찾을 수 있습니다.

처리 성공

가져오기 기록 테이블에서 "성공" 상태 찾으면 업로드 프로세스가 완료됩니다.

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

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

처리 실패

처리에 실패하면 가져오기 기록 테이블에 "처리 실패" 상태 있습니다. 처리가 성공하려면 원본 시스템 관리자가 오류를 수정하고 데이터를 Viva Insights에 다시 푸시해야 합니다.

유효성 검사 실패

데이터 유효성 검사가 실패하면 가져오기 기록 테이블에 "유효성 검사 실패" 상태 표시됩니다. 유효성 검사가 성공하려면 원본 시스템 관리자가 오류를 수정하고 데이터를 Viva Insights에 다시 푸시해야 합니다. 작업에서 다운로드 아이콘을 선택하여 오류 로그를 다운로드합니다. 데이터를 다시 보내기 전에 수정해야 할 사항을 알 수 있도록 원본 시스템 관리자에게 이 로그를 보냅니다.

원본 시스템 관리자는 내보내기 파일의 데이터 오류를 해결하는 데 도움이 되는 다음 섹션을 찾을 수 있습니다.

데이터의 오류 정보

적용 대상: 원본 시스템 관리자

모든 데이터 행 또는 열에 특성에 대한 잘못된 값이 있는 경우 데이터 원본 관리자가 원본 데이터를 수정할 때까지 전체 가져오기가 실패합니다.

발생한 오류를 resolve 데 도움이 될 수 있는 특정 서식 규칙에 대한 조직 데이터 준비를 참조하세요.

유효성 검사 오류 및 경고에 대해 자세히 알아봅니다.

일시 중단됨 상태

가져오기 기록 테이블에 "일시 중단됨" 상태 표시되거나 데이터 원본 관리를 선택하면 권한 부여 자격 증명이 만료되었거나 액세스가 해지되었음을 의미합니다. 자격 증명을 업데이트하고 데이터 원본을 다시 연결해야 합니다.

데이터 원본 관리 및 변경

적용 대상: Insights 관리자

데이터 가져오기를 설정한 후 아래 단계를 사용하여 새 Blob 저장소 URL을 설정하거나 자동화된 가져오기를 끄는 등의 변경을 수행합니다.

1. 데이터 연결 아래의 조직 데이터 페이지에서 데이터 원본 관리를 선택합니다.
2. Azure Blob 가져오기에서 관리를 선택합니다.

다음 페이지에서 연결 이름, Blob SAS URL 또는 Blob URL을 편집할 수 있습니다. SAS URL 또는 URI를 업데이트하는 경우 새 위치가 향후 데이터 새로 고침에 사용됩니다.

자동화된 가져오기를 켜거나 끌 수도 있습니다. 작업을 마치면 저장을 선택합니다.

기존 Blob SAS URL 또는 Blob URL을 사용하여 조직 데이터를 바꾸거나 편집하려면 원본 시스템 관리자에게 문의하세요. Viva Insights로 데이터를 가져올 때 전체 또는 증분 새로 고침을 수행합니다. 필드를 삭제하려면 전체 새로 고침을 사용하여 이 작업을 수행할 수 있습니다.

전체 또는 증분 새로 고침을 나타내는 방법

1. .json 매핑 파일에서 3줄로 이동합니다.
2. “IsBootstrap”: 속성을 다음 중 하나로 업데이트합니다.
   1. 전체 새로 고침의 경우 를 사용합니다 “IsBootstrap” : “true”.
   2. 증분 새로 고침의 경우 를 사용합니다  “IsBootstrap” : “false”.

가져오기가 실행되면 Viva Insights는 .json 매핑 파일에 지정한 내용에 따라 데이터를 전체 또는 증분 새로 고침으로 처리하기 시작합니다.

새로 고침 유형

Full

전체 새로 고침을 수행하면 Viva Insights에서 모든 organization 데이터를 대체합니다. 즉, 이미 가져온 데이터를 덮어씁니다. 전체 새로 고침을 수행할 때 라이선스가 부여되고 허가되지 않은 모든 직원(Viva Insights 구독이 있는 직원과 그렇지 않은 직원)에 대한 데이터를 제공해야 합니다. 이 문서의 뒷부분에서 제공할 필드에 대해 설명합니다.

삭제한 필드가 데이터에 표시되지 않으므로 전체 새로 고침을 사용하여 필드를 삭제할 수 있습니다. 다음 섹션에서는 데이터 삭제에 대해 설명합니다.

전체 새로 고침을 사용하여 필드 삭제

전체 새로 고침을 사용하여 필드를 삭제하려면 삭제하려는 필드를 제외한 모든 필드를 포함하는 .csv 데이터를 내보냅니다. 전체 새로 고침은 기존 데이터를 대체하므로 가져오기 중에 제외된 필드를 제외한 모든 필드로 끝납니다.

증분

Viva Insights에 이미 업로드한 조직 데이터에 새 정보만 추가하려는 경우 증분 새로 고침을 수행합니다. 증분 새로 고침으로 수행할 수 있는 작업은 다음과 같습니다.

• 새 직원 추가
• 기존 직원에 대한 새 특성 추가
• 새 직원을 위한 새 특성 추가
• 기존 직원의 특성 편집

다음은 증분 새로 고침을 수행할 수 있는 경우의 몇 가지 예입니다.

예 - 신입사원 추가

조직 데이터에 5명의 신규 채용자를 추가하려는 경우를 가정해 보겠습니다. 가져오는 동안 다음을 포함합니다.

• 새 직원 데이터가 포함된 5개 행입니다.
• 필수 특성: PersonId, ManagerId, 조직 및 EffectiveDate.
• Viva Insights로 이미 가져온 모든 예약된 선택적 필드(예: HireDate)입니다.

가져오기가 완료되면 5개의 새 행과 해당 값만 변경됩니다.

예제 – 새 특성 추가

모든 기존 직원에 대해 이전에 데이터에 없었던 선택적 예약 특성을 추가하려고 할 수 있습니다. 위치 라고 가정해 보겠습니다. 데이터를 가져오러 이동하면 각 직원의 현재 및 기록 값이 있는 Location, PersonId 및 EffectiveDate만 .csv 파일에 포함됩니다. 가져오기가 완료되면 각 직원에 대한 새 열인 Location을 제외하고 이전과 동일한 데이터를 찾을 수 있습니다.

전체 및 증분 새로 고침을 위해 .csv 파일에 포함할 필드

아래에 나열된 새로 고침 형식의 경우 .csv 파일 내의 다음 표에 필드를 포함합니다. 조직 데이터 준비의 지침에 따라 이러한 필드의 서식 을 지정합니다.

관련 항목

조직 데이터 준비