Llamar a la API de Microsoft 365 para transferir datos de la organización para la importación basada en API (paso 2 de 3) (versión preliminar)

Importante

Esta característica es solo para clientes de la versión preliminar pública. Es posible que las características de la versión preliminar no estén completas y experimenten cambios antes de que estén disponibles en la versión más amplia.

Se aplica a: Administrador global de Microsoft 365 o administrador del origen de datos de la organización o administrador del sistema de información de recursos humanos

1. Preparar y exportar los datos con una frecuencia establecida

Exporte los datos de la organización de todos los empleados de la empresa y agregue todos los campos que desee importar en una plantilla de .csv o en una salida de .csv automatizada en un origen externo, como Workday Report as a Service (RaaS). Obtenga información sobre cómo estructurar este archivo de datos.

Con la frecuencia que decida (por ejemplo, una vez al mes o una vez a la semana), haga que la aplicación personalizada o la integración de origen externo exporten datos organizativos del sistema de origen.

2. Llame a la API para importar los datos

Para importar los datos a Microsoft 365, puede elegir entre una de cinco opciones:

  1. Utilice nuestra API para crear una aplicación personalizada que exporte e importe los datos con la frecuencia que elija. Obtenga más información.

  2. Ejecuta nuestra solución C# en la consola, que se basa en nuestra API. Obtenga más información.

  3. Ejecute nuestro script de PowerShell, que también se basa en nuestra API. Obtenga más información.

  4. Use una plantilla de Azure Data Factory para enviar datos a la importación basada en API. Obtenga más información.

  5. Ejecute el script de Node para recuperar los tokens de OAuth. A continuación, use esos tokens para enviar datos directamente desde un origen externo como Workday a la importación basada en API. Obtenga más información.

Nota:

Nuestras soluciones de C# y PowerShell solo importan datos al Servicio de datos de organización de Microsoft 365. No exportan datos desde el sistema de origen.

Si trabaja con la opción 1, 2, 3 o 4, asegúrese de que tiene esta información:

  • Id. de aplicación (cliente). Busque este identificador en la información de la aplicación registrada en el Centro de administración de Microsoft Entra en Id. de aplicación (cliente).

  • Secreto de cliente: se trata de una cadena de secreto que la aplicación usa para probar su identidad al solicitar un token. También se conoce como contraseña de aplicación. Este secreto solo se muestra por primera vez cuando se crea el secreto de cliente. Para crear un nuevo secreto de cliente, siga estos pasos.

  • Nombre del certificado. Este nombre se configura en la aplicación registrada. Después de cargar el certificado, el nombre del certificado aparece en Descripción en el Portal de Azure. Puede utilizar el nombre del certificado como alternativa al secreto de cliente.

  • Id. de inquilino de Microsoft Entra. Puede encontrar este identificador en la página de información general de la aplicación, en Id. de directorio (inquilino).

  • Unidad de escala: la unidad de escala que se le proporcionó para el inquilino, como "novaprdwus2-01".

  • El archivo .csv y la ruta de acceso al archivo .csv.

O bien, si está trabajando con la opción 5, asegúrese de que tiene esta información:

  • Id. de aplicación (cliente). Busque este identificador en la información de la aplicación registrada en el Centro de administración de Microsoft 365, en Id. de aplicación (cliente).

  • Secreto de cliente: se trata de una cadena de secreto que la aplicación usa para probar su identidad al solicitar un token. También se conoce como contraseña de aplicación. Este secreto solo se muestra cuando se crea el secreto de cliente. Obtenga información sobre cómo crear un nuevo secreto de cliente.

  • Id. de inquilino de Microsoft Entra. Puede encontrar este identificador en la página de información general de la aplicación, en Id. de directorio (inquilino).

  • Id. de conector: esta es la cadena al final de la dirección URL que aparece al seleccionar el conector basado en API en el Centro de administración de Microsoft 365, como https://admin.cloud.microsoft/OrganizationalDataInM365/connection-details/[Connector ID here].

  • Unidad de escala: la unidad de escala que se le proporcionó para el inquilino, como "novaprdwus2-01".

Insertar datos

Aplicación para llamar a Microsoft 365 API para insertar contenido

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

En caso de que el conector no esté establecido:

403: Forbidden

Si se ha establecido el conector, pero la ingesta anterior no se ha completado todavía:

400: Bad request: Previous ingestion is not complete.

Opción 1: Usar la API de Microsoft 365 para crear una aplicación de importación o exportación personalizada

Puede usar la API de Microsoft 365 para crear una aplicación personalizada que exporte automáticamente los datos desde el sistema de origen y, a continuación, los importe al Centro de administración de Microsoft 365.

La aplicación puede adoptar cualquier forma, como un script de PowerShell, pero necesita exportar los datos de origen como un archivo .csv con la frecuencia que elija e importar ese archivo en las aplicaciones y servicios de Microsoft 365.

Opción 2: Importar datos a través de nuestra solución de C# después de exportar los datos a través de la aplicación personalizada

Después de exportar los datos de origen como un archivo de .csv con la frecuencia que elija, puede ejecutar la solución DescriptiveDataUploadApp C# en la consola. A continuación, la solución DescriptiveDataUploadApp C# incorpora los datos almacenados localmente a Microsoft 365. Obtenga más información en GitHub.

Para ejecutar la solución:

  1. Clona esta aplicación en tu máquina ejecutando el siguiente comando en la línea de comandos:

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

  2. Incluya los siguientes valores de consola.

    • AppID/ClientID
    • Ruta de acceso absoluta al archivo .csv. Aplique formato a la ruta de acceso de la siguiente manera: C:\\Users\\JaneDoe\\OneDrive - Microsoft\\Desktop\\info.csv
    • Id. de inquilino de Microsoft Entra
    • Nombre del certificado

Opción 3: Ejecutar la solución de PowerShell DescriptiveDataUpload después de exportar datos a través de la aplicación personalizada

De forma similar a la opción 2, después de exportar los datos de origen como un archivo .csv con la frecuencia que elija, puede ejecutar la solución DescriptiveDataUpload de PowerShell en la consola. A continuación, la solución de PowerShell DescriptiveDataUpload lleva los datos almacenados localmente a Microsoft 365. Obtenga más información en GitHub.

  1. Clone el código fuente en la máquina ejecutando este comando en la línea de comandos:

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

  2. Abra una nueva ventana de PowerShell como administrador.

  3. En la ventana de PowerShell, ejecute el siguiente comando:

    Install-Module -Name MSAL.PS

    O bien, vaya a este vínculo de galería de PowerShell para obtener instrucciones sobre la instalación.

  4. Establecer parámetros.

    • ClientID
    • pathTocsvFile
    • TenantId
    • novaScaleUnit
    • ingressDataType: HR
    • ClientSecret o certificateName

Realice cambios en la conexión o los datos

  • Last updated on