次の方法で共有

Microsoft 365 API を呼び出して、API ベースのインポート用の組織データを転送する (手順 2/3) (プレビュー)

重要

この機能は、パブリック プレビューのお客様専用です。 プレビューの機能が完了していない可能性があり、より広範なリリースで利用できるようになる前に変更が加えられる可能性があります。

適用対象: Microsoft 365 グローバル管理者または組織データ ソース管理者または HRIS ソース システム管理者

1. 設定された頻度でデータを準備してエクスポートする

社内のすべての従業員の組織データをインポートし、インポートするすべてのフィールドを .csv テンプレートに追加します。 このデータ ファイルを構成する方法について説明します。

決定した頻度 (月に 1 回、週に 1 回など) で、カスタム アプリで組織データをソース システムからエクスポートします。

2. API を呼び出してデータをインポートする

Microsoft 365 にデータをインポートするには、次の 3 つのオプションから選択できます。

  • API を使用して、選択した頻度でデータをエクスポートおよびインポートするカスタム アプリを構築します。 詳細情報を参照してください。

  • API に基づいて、本体で C# ソリューションを実行します。 詳細情報を参照してください。

  • PowerShell スクリプトを実行します。これは、API にも基づいています。 詳細情報を参照してください。

注:

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

コネクタが設定されていない場合:

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
    • テナント ID のMicrosoft Entra
    • 証明書名

オプション 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