Compartir a través de

Llame 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 solo está destinada a clientes de versión preliminar pública. Es posible que las características de la versión preliminar no estén completas y puedan experimentar cambios antes de estar disponibles en la versión más amplia.

Se aplica a: Administrador global de Microsoft 365, Administrador de origen de datos organizativo o administrador del sistema de origen de HRIS

1. Preparación y exportación de los datos con una frecuencia establecida

Importe datos organizativos para todos los empleados de la empresa y agregue todos los campos que quiera importar en una plantilla de .csv. 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 exporte datos de la organización desde el sistema de origen.

2. Llame a la API para importar los datos.

Para importar los datos a Microsoft 365, puede elegir entre tres opciones:

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

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

  • Ejecute el script de PowerShell, que también se basa en nuestra API. [Vínculos a la opción 3 siguiente.]

Nota:

Nuestras soluciones de C# y PowerShell solo importan datos a datos de la organización en Microsoft 365. No exportan datos del sistema de origen.

Antes de trabajar con cualquiera de las opciones siguientes, asegúrese de que tiene esta información:

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

  • Secreto de cliente: se trata de una cadena secreta que la aplicación usa para demostrar 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 Azure Portal. Puede usar el nombre del certificado como alternativa al secreto de cliente.

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

  • Unidad de escalado: la unidad de escalado que se le proporciona para el inquilino, como "novaprdwus2-01".

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

Insertar datos

Aplicación de encuesta 1P/3P para llamar a la API de Microsoft 365 para insertar contenido

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

[Cuerpo] contenido del archivo como multipart/form-data

Tipo: Archivo zip

Contenido que se va a archivar:

Metadata.json

Data.csv

[Cuerpo de la solicitud]

Body: 

{ 

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

   "$multipart":  

    [ 

        { 

            "headers":  

                { 

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

                   }, 

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

         } 

    ] 

}

[Cuerpo de la respuesta]

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" 

}

En caso de que no se establezca el conector:

403: Forbidden

Si el conector está establecido pero la ingesta anterior aún no está completa:

400: Bad request: Previous ingestion is not complete.

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

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

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

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

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

Para ejecutar la solución:

  1. Clone esta aplicación en el equipo 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. Dé formato a la ruta de acceso de la siguiente manera: C:\\Users\\JaneDoe\\OneDrive - Microsoft\\Desktop\\info.csv
    • Microsoft Entra identificador de inquilino
    • 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 de PowerShell DescriptiveDataUpload 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 mediante la ejecución de 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 la galería de PowerShell para obtener instrucciones sobre la instalación.

  4. Establecer parámetros.

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

Realizar cambios en la conexión o los datos

  • Last updated on