Fuentes de importación de archivos para automatizaciones
Acerca de las fuentes de importación de archivos para automatizaciones
Con automatizaciones de importación de contactos y automatizaciones de importación de empleados, puede optimizar la gestión de su directorio. Cuando la automatización está programada para ejecutarse, procesará cualquier archivo designado que la automatización aún no haya procesado, incluidos los archivos recién cargados. Sin embargo, antes de poder hacerlo, la automatización debe saber de dónde extraer los archivos.
La fuente del archivo para automatizaciones de importación de contactos y automatizaciones de importación de empleados puede ser:
- Qualtrics File Service
- Su servidor SFTP
- Almacenamiento de archivos OAuth (Google Drive o Dropbox)
Qualtrics File Service
Qualtrics File Service es una API de almacenamiento de archivos segura que le permite cargar archivos para importar esta automatización. Puede cargar un archivo en un punto final HTTPS, que se proporcionará en un cuadro gris (que se muestra a continuación), como datos de formulario multiparte.
Cuando la automatización esté programada para ejecutarse, procesará cualquier archivo que la automatización aún no haya procesado, incluidos los que se acaban de cargar.
Para utilizar Qualtrics File Service, tendrá que llamar al punto final HTTPS proporcionado. Si el archivo se genera desde el sistema, deberá proporcionar la documentación de API y la siguiente implementación de ejemplo a su equipo de TI o Ingeniería de software para integrarlo con nuestro servicio.
Ejemplo: Este ejemplo está en formato cURL. Consulte la página de soporte Resumen de API para saber cómo generar un token de API.
Para usuarios de Mac y Unix:
curl -X POST -H "X-API-TOKEN: [TOKEN DE SU API]" \
-F 'file=@/path/to/import/file/sample-file.txt' \
https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files
Para usuarios de Windows:
curl -X POST -H "X-API-TOKEN: [SU API TOKEN]" ^
-F "fichero=@/path/to/import/file/sample-file.txt" ^
https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files
Ejemplo: Este es un ejemplo de solicitud. Consulte la página de soporte Resumen de API para saber cómo generar un token de API.
POST https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files HTTP/1.1
Content-Type: multipart/form-data
X-API-TOKEN: [YOUR API TOKEN]
-----------------------------
Content-Disposition: form-data; name="upfile"; filename="sample-file.txt"
Content-Type: text/plain
[FILE DATA]
-----------------------------
Gestionar manualmente ficheros cargados con API
También puede gestionar manualmente los archivos cargados con la API de Qualtrics. Los siguientes enlaces explican cómo interactuar con la API de Qualtrics File Service:
- Enumerar todos los archivos cargados para esta automatización.
- Cargue un archivo para que esta automatización lo utilice.
- Obtener los metadatos asociados con un archivo.
- Obtener el contenido de un archivo.
- Eliminar un archivo.
A veces, estas llamadas a la API solicitarán un ID de automatización. Qualtrics le proporcionará esta información, con el formato AU_XXXXX.
Siguientes pasos: Automatización de importación de contactos de XM Directory
Ahora que ha terminado de configurar el servicio de archivos de Qualtrics como su fuente de importación, es hora de que termine de crear su automatización de importación de contactos.
- Paso 3: Cifrado PGP
- Paso 4: Seleccionar rutas de acceso a la carpeta
- Paso 5: Asignación de campos de datos y listas de distribución
- Paso 6: Vinculación con automatizaciones de distribución
- Paso 7: Envío de informes de ejecución y activación de la automatización
Siguientes pasos: Automatización de importación de personas del directorio de empleados
Servidor SFTP
Es posible que desee integrar sus propios registros de contactos con Qualtrics mediante el Protocolo de transferencia segura de archivos (SFTP). Por ejemplo, es posible que desee importar contenido de una descarga de archivos diaria alojada y, a continuación, importar y programar distribuciones de encuestas para esos contactos, todo en los métodos de transferencia más seguros.
Cuando la automatización esté programada para ejecutarse, procesará cualquier archivo que la automatización aún no haya procesado, incluidos los que se acaban de cargar. Cuando se procesa un archivo, se elimina del servidor SFTP.
En el paso Configurar fuente de importación, hay 2 opciones SFTP: Nombre de usuario y amp; Contraseña y nombre de usuario y clave SSH.
- En el paso Configurar fuente de importación, seleccione uno de los servidores SFTP.
- Haga clic en Continuar.
- Introduzca la URL del host.
Consejo Q: La URL generalmente se parece a sftp.example.com. - Introduzca el Nombre de usuario. Distingue entre mayúsculas y minúsculas.
- Introduzca el Puerto. Esto es opcional. Se introduce 22 como valor por defecto.
- Haga clic en Continuar.
Dependiendo de si ha seleccionado la contraseña o la clave SSH, sus siguientes pasos variarán.
Configuración mediante nombre de usuario y contraseña
- Introduzca su contraseña.
Consejo Q: Si ya se han proporcionado el host, el nombre de usuario y el puerto exactos, no se le pedirá una contraseña. - Haga clic en Continuar.
Configuración mediante nombre de usuario & clave SSH
- Si aún no hay una clave presente, seleccione la opción para Generar nuevo par de claves SSH.
Consejo Q: El par Generar nueva clave SSH aún está presente aunque ya se haya generado una clave. Esta opción puede seleccionarse si el usuario desea crear una clave nueva; sin embargo, esto no es necesario si se utilizan las mismas credenciales de SFTP para la nueva automatización. El par de claves se comparte en todas las automatizaciones con las mismas credenciales de SFTP dentro de una única cuenta de usuario. - Haga clic en Descargar la clave pública.
- Cargue la clave pública en su servidor SFTP.
Cifrados admitidos
Conectarse a un servidor SFTP requiere una serie de handshakes SSH para coordinar el cifrado utilizado entre el servidor y la automatización. Para establecer una conexión, el servidor SFTP tendrá que tener al menos un cifrado para cada tipo de cifrado que coincida con un cifrado admitido por automatizaciones. A continuación se muestra la lista de cifrados admitidos por automatizaciones agrupados por el tipo de cifrado.
Cifrados de intercambio de claves admitidos:
- curve25519-sha256@libssh.org
- diffie-hellman-group14-sha1
- diffie-hellman-group1-sha1
- diffie-hellman-group-exchange-sha256
- ecdh-sha2-nistp256
- ecdh-sha2-nistp384
- ecdh-sha2-nistp521
Cifrados Mac admitidos:
- hmac-sha2-256
- hmac-sha2-512
Cifrados de cifrado admitidos:
- aes128-ctr
- aes192-ctr
- aes256-ctr
- aes128-cbc
- Arcfour256
- Arcfour128
- Arcfour
- 3des-cbc
Suites de cifrado admitidas:
- chacha20-poly1305@openssh.com: Chacha20 es un algoritmo de cifrado simétrico, mientras que Poly1305 es un cifrado de autenticación.
- aes128-gcm@openssh.com: Advanced Encryption Standard (AES) con una clave de 128 bits utilizando el Galois/Counter Mode (GCM).
Si el servidor SFTP no admite los cifrados adecuados, recomendamos utilizar una de las otras fuentes de importación presentadas en esta página.
Siguientes pasos: Automatización de importación de contactos de XM Directory
Ahora que ha terminado de configurar un servidor SFTP como fuente de importación, es hora de que termine de crear su automatización de importación de contactos.
- Paso 3: Cifrado PGP
- Paso 4: Seleccionar rutas de acceso a la carpeta
- Paso 5: Asignación de campos de datos y listas de distribución
- Paso 6: Vinculación con automatizaciones de distribución
- Paso 7: Envío de informes de ejecución y activación de la automatización
Siguientes pasos: Automatización de importación de personas del directorio de empleados
Google Drive y Dropbox
Puede utilizar su cuenta de Google Drive o Dropbox como almacenamiento de archivos para sus automatizaciones de importación de contactos. Su información de inicio de sesión para estos servicios será privada; el almacenamiento de archivos OAuth permite que Qualtrics utilice la información de cuenta de un usuario final sin exponer la contraseña del usuario. Esta información de cuenta se utiliza para conectarse al almacenamiento de archivos desde automatizaciones en XM Directory, comportándose de forma similar a una configuración SFTP.
Cuando la automatización esté programada para ejecutarse, procesará cualquier archivo que la automatización aún no haya procesado, incluidos los que se acaban de cargar. Cuando se procesa un archivo, se elimina del almacenamiento de archivos OAuth.
- En el paso Configurar origen de importación, seleccione Google Drive o Dropbox.
- Haga clic en Continuar.
- Deberá iniciar sesión en su cuenta de Google o Dropbox haciendo clic en Iniciar sesión. Esto le redirigirá a una nueva ventana en la que puede iniciar sesión mediante OAuth.
- Una vez que el inicio de sesión se haya realizado correctamente, se le redirigirá para finalizar la configuración o, si lo desea, Cambiar cuentas a otro usuario OAuth. También puede eliminar la cuenta OAuth haciendo clic en Modificar en la fuente de datos y seleccionando una fuente de datos alternativa.
- Vaya a la sección Seleccionar fuente de archivo de importación después de haber configurado la Fuente de importación. Podrá declarar su ruta de carpeta aquí (por ejemplo, “Nombre de carpeta/Carpeta2”).
Siguientes pasos: Automatización de importación de contactos de XM Directory
Ahora que ha terminado de configurar un servidor SFTP como fuente de importación, es hora de que termine de crear su automatización de importación de contactos.
- Paso 3: Cifrado PGP
- Paso 4: Seleccionar rutas de acceso a la carpeta
- Paso 5: Asignación de campos de datos y listas de distribución
- Paso 6: Vinculación con automatizaciones de distribución
- Paso 7: Envío de informes de ejecución y activación de la automatización
Siguientes pasos: Automatización de importación de personas del directorio de empleados
- Paso 3: Cifrado PGP
- Paso 4: Seleccionar rutas de acceso a la carpeta
- Paso 5: Asignación de campo de datos
- Paso 6: Envío de informes de ejecución y activación de la automatización