다음을 통해 공유

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

중요

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

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

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

회사의 모든 직원에 대한 조직 데이터를 가져오고 .csv 템플릿에서 가져올 모든 필드를 추가합니다. 이 데이터 파일을 구성하는 방법을 알아봅니다.

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

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

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

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

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

  • API를 기반으로 하는 PowerShell 스크립트를 실행합니다. [아래 옵션 3에 대한 링크.]

참고

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

아래 옵션으로 작업하기 전에 다음 정보가 있는지 확인합니다.

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

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

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

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

  • 배율 단위: "novaprdwus2-01"과 같이 테넌트용으로 제공되는 배율 단위입니다.

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

데이터 푸시

Microsoft 365 API를 호출하여 콘텐츠를 푸시하는 1P/3P 설문 조사 앱

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

[본문] 파일 콘텐츠(multipart/form-data)

형식: Zip 보관

보관할 콘텐츠:

Metadata.json

Data.csv

[요청 본문]

Body: 

{ 

   "$content-type": "multipart/form-data", 

   "$multipart":  

    [ 

        { 

            "headers":  

                { 

                    "Content-Disposition": "form-data; name=\"file\"; filename=info" 

                   }, 

            "body": @{body('Get_blob_content_(V2)')} 

         } 

    ] 

}

[응답 본문]

200:  
{ 

  "FriendlyName": "Data ingress", 

  "Id": "<ingestion Id>", 

  "ConnectorId": "<connector Id>", 

  "Submitter": "System", 

  "StartDate": "2023-05-08T19:07:07.4994043Z", 

  "Status": "NotStarted", 

  "ErrorDetail": null, 

  "EndDate": null, 

  "Type": "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