Microsoft 365 API를 호출하여 API 기반 가져오기를 위해 조직 데이터 전송(3/2단계)(미리 보기)

중요

이 기능은 공개 미리 보기 고객 전용입니다. 미리 보기의 기능은 완전하지 않을 수 있으며, 광범위한 릴리스에서 사용할 수 있게 되기 전에 변경될 수 있습니다.

적용 대상: Microsoft 365 전역 관리자 또는 조직 데이터 원본 관리자 또는 인사 관리 정보 시스템 관리자

1. 설정된 빈도로 데이터를 준비하고 내보내기

회사의 모든 직원에 대한 조직 데이터를 내보내고 Workday RaaS(Report as a Service)와 같은 외부 소스에서 .csv 템플릿 또는 자동화된 .csv 출력에 가져오려는 모든 필드를 추가합니다. 이 데이터 파일의 구조를 만드는 방법을 알아봅니다.

결정한 빈도(예: 한 달에 한 번 또는 일주일에 한 번)에 따라 사용자 지정 앱 또는 외부 원본 통합이 원본 시스템에서 조직 데이터를 내보내도록 합니다.

2. API를 호출하여 데이터 가져오기

Microsoft 365로 데이터를 가져오려면 다음 5가지 옵션 중 하나를 선택할 수 있습니다.

  1. API를 사용하여 선택한 빈도로 데이터를 내보내고 가져오는 사용자 지정 앱을 빌드하세요. 방법을 알아보세요.

  2. 본체에서 API를 기반으로 하는 C# 솔루션을 실행합니다. 방법을 알아보세요.

  3. 역시 API를 기반으로 하는 PowerShell 스크립트를 실행합니다. 방법을 알아보세요.

  4. Azure Data Factory 템플릿을 사용하여 API 기반 가져오기로 데이터를 보냅니다. 방법을 알아보세요.

  5. 노드 스크립트를 실행하여 OAuth 토큰을 검색합니다. 그런 다음 해당 토큰을 사용하여 Workday와 같은 외부 소스에서 API 기반 가져오기로 직접 데이터를 보냅니다. 방법을 알아보세요.

참고

C# 및 PowerShell 솔루션은 Microsoft 365 조직 데이터 서비스로만 데이터를 가져옵니다. 원본 시스템에서 데이터를 내보내지는 않습니다.

옵션 1, 2, 3 또는 4를 사용하는 경우 다음 정보가 있어야 합니다.

  • 앱(클라이언트) ID입니다. 애플리케이션(클라이언트) ID 아래의 Microsoft Entra 관리 센터에 있는 등록된 앱 정보에서 이 ID를 찾습니다.

  • 클라이언트 암호: 토큰을 요청할 때 애플리케이션이 해당 ID를 입증하는 데 사용하는 비밀 문자열입니다. 응용 프로그램 암호라고도 합니다. 이 비밀은 클라이언트 비밀이 만들어질 때만 처음 표시됩니다. 새 클라이언트 암호를 만들려면 다음 단계를 수행합니다.

  • 인증서 이름입니다. 이 이름은 등록된 애플리케이션에 구성됩니다. 인증서를 업로드하면 인증서 이름이 Azure Portal의 설명 아래에 표시됩니다. 인증서 이름을 클라이언트 암호 대신 사용할 수 있습니다.

  • Microsoft Entra 테넌트 ID입니다. 디렉터리 (테넌트) ID 아래의 앱 개요 페이지에서 이 ID를 찾을 수 있습니다.

  • 배율 단위: 테넌트에 대해 제공된 배율 단위입니다(예: "novaprdwus2-01."

  • .csv 파일 및 .csv 파일의 경로입니다.

또는 옵션 5를 사용하는 경우 다음 정보가 있어야 합니다.

  • 앱(클라이언트) ID입니다. 응용 프로그램(클라이언트) ID 아래의 Microsoft 365 관리 센터에 있는 등록된 앱 정보에서 이 ID를 찾습니다.

  • 클라이언트 암호: 토큰을 요청할 때 애플리케이션이 해당 ID를 입증하는 데 사용하는 비밀 문자열입니다. 응용 프로그램 암호라고도 합니다. 이 비밀은 클라이언트 비밀을 만들 때만 표시됩니다. 새 클라이언트 암호를 만드는 방법을 알아봅니다.

  • Microsoft Entra 테넌트 ID입니다. 디렉터리 (테넌트) ID 아래의 앱 개요 페이지에서 이 ID를 찾을 수 있습니다.

  • 커넥터 ID: Microsoft 365 관리 센터에서 API 기반 커넥터를 선택하면 나타나는 URL 끝에 있는 문자열입니다. 예: https://admin.cloud.microsoft/OrganizationalDataInM365/connection-details/[Connector ID here].

  • 배율 단위: 테넌트에 대해 제공된 배율 단위입니다(예: "novaprdwus2-01."

푸시 데이터

Microsoft 365 API를 호출하여 콘텐츠를 푸시하는 앱

[POST] https://api.orginsights.viva.office.com/v1.0/tenants/{tenantid}/modis/connectors/HR/ingestions/fileIngestion

커넥터가 설정되지 않은 경우:

403: Forbidden

커넥터가 설정되었지만 이전 수집이 아직 완료되지 않은 경우:

400: Bad request: Previous ingestion is not complete.

옵션 1: Microsoft 365 API를 사용하여 사용자 지정 가져오기/내보내기 앱 빌드

Microsoft 365 API를 사용하여 원본 시스템에서 데이터를 자동으로 내보낸 다음 Microsoft 365 관리 센터로 가져오는 사용자 지정 앱을 빌드할 수 있습니다.

앱은 PowerShell 스크립트와 같은 모든 형식을 사용할 수 있지만 선택한 빈도에 따라 원본 데이터를 .csv 파일로 내보내고 해당 파일을 Microsoft 365 앱 및 서비스로 가져와야 합니다.

옵션 2: 사용자 지정 앱을 통해 데이터를 내보낸 후 C# 솔루션을 통해 데이터 가져오기

선택한 빈도로 원본 데이터를 .csv 파일로 내보낸 후 콘솔에서 DescriptiveDataUploadApp C# 솔루션을 실행할 수 있습니다. 그런 다음 DescriptiveDataUploadApp C# 솔루션이 로컬에 저장된 데이터를 Microsoft 365로 가져옵니다. GitHub에서 자세히 알아보세요.

솔루션을 실행하려면 다음을 수행합니다.

  1. 명령줄에서 다음 명령을 실행하여 이 앱을 컴퓨터에 복제합니다.

    git clone https://github.com/microsoft/orgdata_apibasedimport.git.

  2. 다음 콘솔 값을 포함합니다.

    • AppID/ClientID
    • .csv 파일의 절대 경로입니다. 다음과 같이 경로 서식을 지정합니다. C:\\Users\\JaneDoe\\OneDrive - Microsoft\\Desktop\\info.csv
    • Microsoft Entra 테넌트 ID
    • 인증서 이름

옵션 3: 사용자 지정 앱을 통해 데이터를 내보낸 후 DescriptiveDataUpload PowerShell 솔루션 실행

옵션 2와 마찬가지로 선택한 빈도로 원본 데이터를 .csv 파일로 내보낸 후 콘솔에서 DescriptiveDataUpload PowerShell 솔루션을 실행할 수 있습니다. 그런 다음 DescriptiveDataUpload PowerShell 솔루션이 로컬에 저장된 데이터를 Microsoft 365로 가져옵니다. GitHub에서 자세히 알아보세요.

  1. 명령줄에서 다음 명령을 실행하여 소스 코드를 컴퓨터에 복제합니다.

    git clone https://github.com/microsoft/orgdata_apibasedimport.git.

  2. 새 PowerShell 창을 관리자로 엽니다.

  3. PowerShell 창에서 다음 명령을 실행합니다.

    Install-Module -Name MSAL.PS

    또는 이 PowerShell 갤러리 링크 로 이동하여 설치 지침을 확인하세요.

  4. 매개 변수를 설정합니다.

    • ClientID
    • pathTocsvFile
    • TenantId
    • novaScaleUnit
    • ingressDataType: HR
    • ClientSecret 또는 certificateName

연결 또는 데이터 변경

  • Last updated on