Opción 4: Usar la plantilla de Azure Data Factory para enviar datos a nuestra importación basada en API

Siga los pasos siguientes para usar una plantilla de Azure Data Factory a fin de enviar datos a la importación basada en API.

1. Crear nueva instancia de Azure Data Factory

  1. Inicie sesión en https://adf.azure.com/en/datafactories.

  2. Cree una nueva factoría de datos o use una existente. Complete los campos y, a continuación, seleccione Crear.

    Captura de pantalla que muestra cómo crear una nueva factoría de datos o usar una existente.

2. Crear una nueva canalización y actividad

  1. Cree una nueva canalización y escriba un nombre para la canalización.

    Captura de pantalla que muestra cómo crear una nueva canalización.

  2. En Actividades, agregue Copiar datos.

    Captura de pantalla que muestra cómo agregar datos de copia.

3. Configuración de la actividad de copia de datos: General

Seleccione su actividad de copia de datos y, a continuación, seleccione General para completar cada campo siguiendo las instrucciones siguientes.

Captura de pantalla que muestra cómo copiar la configuración de la actividad de datos.

  • Nombre: introduzca un nombre para su actividad.
  • Descripción: escriba una descripción para su actividad.
  • Estado de actividad: Seleccione Activado. O seleccione Desactivado para excluir la actividad de la ejecución y validación de la canalización.
  • Tiempo de espera: esta es la cantidad máxima de tiempo que se puede ejecutar una actividad. El valor predeterminado es 12 horas, el mínimo es 10 minutos y la cantidad máxima de tiempo permitida es de siete días. El formato está en D.HH:MM:SS.
  • Reintentar: el número máximo de reintentos. Se puede dejar como 0.
  • Intervalo de reintento (s): el número máximo de reintentos. Se puede dejar como 30 si el reintento se establece en 0.
  • Salida segura: cuando se selecciona, la salida de la actividad no se captura en el registro. Puedes dejar esto claro.
  • Entrada segura: cuando se selecciona, la entrada de la actividad no se captura en el registro. Puedes dejar esto claro.

4. Copiar configuración de la actividad de datos: Origen

  1. Seleccione el origen.

  2. Seleccione un conjunto de datos de origen existente o seleccione +Nuevo para crear un nuevo conjunto de datos de origen. Por ejemplo, en Nuevo conjunto de datos, seleccione Azure Blob Storage y, a continuación, seleccione el tipo de formato de los datos.

    Captura de pantalla que muestra cómo crear un nuevo conjunto de datos de origen.

  3. Configure las propiedades del archivo .csv. Escriba un nombre y, en Servicio vinculado, seleccione una ubicación existente o seleccione +Nuevo.

    Captura de pantalla que muestra cómo establecer las propiedades del archivo CSV.

  4. Si ha seleccionado +Nuevo, escriba los detalles del nuevo servicio vinculado siguiendo las instrucciones que aparecen a continuación.

    Captura de pantalla que muestra cómo agregar detalles para el nuevo servicio vinculado.

  5. Junto a Conjunto de datos de origen, seleccione Abrir.

    Captura de pantalla que muestra cómo abrir el conjunto de datos de origen.

  6. Seleccione Primera fila como encabezado.

    Captura de pantalla que muestra cómo seleccionar la primera fila como encabezado.

5. Copiar configuración de la actividad de datos: receptor

  1. Seleccione Sink.

  2. Seleccione +Nuevo para configurar un nuevo recurso REST que se conectará a la API. Busque "Descanso" y seleccione Continuar.

    Captura de pantalla que muestra cómo configurar un nuevo recurso REST para conectarse a la API.

  3. Asigne un nombre al servicio. En Servicio vinculado , seleccione +Nuevo.

    Captura de pantalla que muestra cómo asignar un nombre al servicio y agregar un nuevo servicio vinculado.

  4. Busque "Descanso" y selecciónelo.

    Captura de pantalla que muestra cómo buscar el conjunto de datos REST.

  5. Escriba los campos siguiendo las instrucciones que se indican a continuación.

    Captura de pantalla que muestra cómo introducir los campos del conjunto de datos.

  • Nombre: escriba un nombre para el nuevo servicio vinculado.
  • Descripción: escriba una descripción para el nuevo servicio vinculado.
  • Conexión mediante el entorno de ejecución de integración: escriba el método preferido.
  • Dirección URL base: use la dirección URL siguiente y reemplace {tenantid} por su id. de inquilino: https://api.orginsights.viva.office.com/v1.0/tenants/{tenantid}/modis/connectors/HR/ingestions/fileIngestion
  • Tipo de autenticación: seleccione el tipo de autenticación como entidad de servicio y, a continuación, seleccione Secreto o Certificado. Ejemplo de entidad de servicio:

    • En línea: selecciónelo.

    • Id. de entidad de servicio: escriba el id. de aplicación autorizado para el conector de API.

    • Clave de entidad de servicio: introduzca la clave.

      Captura de pantalla que muestra cómo escribir la clave de entidad de servicio.

    • Inquilino: escriba el ID. de inquilino.

    • Recurso de Microsoft Entra ID:https://api.orginsights.viva.office.com

    • Tipo de nube de Azure: seleccione el tipo de nube de Azure.

    • Validación del certificado del servidor: seleccione Habilitado.

  1. Introduzca la configuración del receptor siguiendo las instrucciones que se indican a continuación.

    Captura de pantalla que muestra cómo introducir la configuración del receptor.

  • Conjunto de datos del receptor: seleccione el conjunto de datos existente o recién creado.
  • Método de solicitud: Seleccione POST.
  • Tiempo de espera de la solicitud: cinco minutos es la opción predeterminada.
  • Intervalo de solicitud (ms): 10 es el valor predeterminado.
  • Tamaño del lote de escritura: El tamaño del lote debe ser mayor que el número máximo de líneas del archivo.
  • Tipo de compresión Http: Ninguno es el predeterminado. O puedes usar GZip.
  • Encabezados adicionales: Seleccione +Nuevo.
    • Caja 1: x-nova-scaleunit
    • Valor: Para recuperar el valor, vaya a la página Conexiones de datos de la página Servicio de datos de organización de Microsoft 365 (configuración>del hogar>,migración e importaciones>Conexiones de datosdel servicio de datos de organización de> Microsoft 365). A continuación, selecciona Nueva importación> Seleccionar el tipo > de conexión Iniciar la configuración> basada en APIPágina Configurar conexión basada en API.

6. Configuración de la actividad de copia de datos: Asignación

  1. Seleccione Asignación.

  2. Para la carga de arranque, asegúrese de incluir PersonId, ManagerId y Organization en la asignación (nombre de destino). Para la carga incremental, compruebe que los nombres de destino son coherentes con los de la carga anterior, junto con PersonId. No puedes realizar cargas incrementales con nuevas columnas y se requiere PersonId en todas las cargas.

    Captura de pantalla que muestra cómo especificar la configuración de actividad para la asignación.

7. Configuración de la actividad de copia de datos: Configuración y propiedades de usuario

No se requieren otras personalizaciones para la Configuración o las Propiedades de usuario. Puede editar estas opciones de configuración caso por caso si es necesario.

8. Actividad de copia de datos: Configuración del desencadenador (automatización)

Para agregar un desencadenador a la configuración de automatización, seleccione Agregar desencadenador. La automatización recomendada es semanal. También puedes personalizar la frecuencia.

Captura de pantalla que muestra cómo configurar el desencadenador.

Realice cambios en la conexión o los datos

  • Last updated on