Extraer datos de la tarea de archivos SFTP
Acerca de la tarea Extraer datos de archivos SFTP
La tarea Extraer datos de archivos SFTP le permite importar datos de su servidor SFTP para utilizarlos en Qualtrics. Puede utilizar esta tarea para procesar uno o varios archivos a la vez. Puede combinar esta tarea con otras tareas, como la tarea Cargar datos en XM Directory, para importar datos a otros lugares de Qualtrics.
Conexión de una cuenta SFTP
Antes de poder utilizar la tarea Extraer datos de archivos SFTP, debe conectar una cuenta SFTP para Qualtrics para extraer los datos de. Los administradores de organización pueden añadir cuentas para que otros usuarios de la organización las utilicen, o usuarios individuales para su uso personal.
Existen 3 opciones de autenticación diferentes:
- Contraseña: Autenticar con un nombre de usuario y contraseña.
- Clave SSH: Autentique con una clave de Secure Shell (SSH) que proporcione o una clave proporcionada por Qualtrics.
- Clave SSH cifrada: autentificar con una clave SSH cifrada.
Consejo Q: Al configurar una conexión SFTP, le recomendamos a su equipo de TI que incluya los rangos de IP de Qualtrics en una lista de elementos autorizados.
Añadir una cuenta como administrador de organización
Si es administrador de organización, siga los pasos de esta sección para añadir una cuenta SFTP para algunos o todos los usuarios de su licencia para utilizarla.
- Mediante el menú de navegación en la parte superior izquierda, vaya a Admin.
- Vaya a Extensiones.
- Haga clic en la extensión Extraer datos de archivos SFTP.
- Haga clic en Añadir cuenta.
- Asigne un nombre a la cuenta. Este nombre se utiliza para fines organizativos y para identificar la cuenta.
- Introduzca el nombre de host del servidor SFTP asociado.
Ejemplo: normalmente están en el formato sftp.example.com
- Introduzca el número de puerto. Por lo general, esto es 22.
- Seleccione su método de autenticación. Sus opciones incluyen:
- Contraseña: Proporcione un nombre de usuario y una contraseña para la autenticación.
- Clave SSH: Proporcione un nombre de usuario y una clave SSH para la autenticación, o utilice una clave SSH generada por Qualtrics.
- Clave SSH cifrada: proporcione su propia clave SSH cifrada con una frase de contraseña para la autenticación.
- Si elige la contraseña, introduzca el Nombre de usuario y la Contraseña para la cuenta SFTP.
- Si se autentica con una clave SSH, realice una de las siguientes acciones:
- Si utiliza una clave SSH generada por Qualtrics, introduzca un Nombre de usuario y haga clic en Generar par de claves SSH.
A continuación, puede hacer clic en Descargar clave SSH pública para descargar la clave pública como un archivo .pem en su ordenador. Qualtrics almacenará la clave privada asociada. Haga clic en Copiar en el portapapeles para copiar la huella digital de la clave en el portapapeles. Guarde ambos en un lugar seguro para que pueda hacer referencia a ellos si es necesario. - Si utiliza su propia clave SSH, haga clic en Proporcionar una clave privada.
A continuación, introduzca su nombre de usuario y la clave SSH.Consejo Q: Debe introducir una clave privada no protegida por contraseña en este cuadro. Además, la clave pública debe estar autorizada en su servidor SFTP.Ejemplo:
Esto es lo que suele ser una clave SSH (incluyendo las líneas clave RSA de inicio y fin):
—–BEGIN RSA PRIVATE KEY—–
a1b2c3d4…
—–END RSA PRIVATE KEY—–
- Si utiliza una clave SSH generada por Qualtrics, introduzca un Nombre de usuario y haga clic en Generar par de claves SSH.
- Si se autentica con la clave SSH cifrada, introduzca el nombre de usuario, la clave SSH cifrada y la frase de contraseña asociadas a su clave.
- Una vez que termine, haga clic en Conectar cuenta.
Añadir una cuenta como usuario individual
Siga los pasos de esta sección para añadir una cuenta SFTP para su uso personal. Solo usted podrá utilizar la cuenta a la que se conecte.
- Siga los pasos de la sección Configuración de datos de extracción de archivos SFTP hasta que llegue al paso en el que selecciona una cuenta para utilizar.
- Haga clic en Añadir cuenta de usuario.
- Siga las instrucciones de la subsección “Añadir una cuenta como administrador de organización” anterior para obtener más información sobre cómo conectar su cuenta. Las mismas opciones y opciones de autenticación están disponibles al añadir una cuenta como usuario individual.
Testing the Connection
After you’ve added an account, you can test the connection from within the Extract data from SFTP files task. At the bottom of the task, click Test connection. This will upload a small test file to your server, read its contents, and then delete the file.
Descargando claves SSH públicas
Si utiliza una clave SSH generada por Qualtrics, puede descargar la clave pública para la conexión. Al visualizar la lista de cuentas SFTP a utilizar, haga clic en el menú de tres puntos situado a la derecha de una cuenta y, a continuación, seleccione Descargar clave SSH pública. Esto descargará la clave en su ordenador como un archivo .pem.
Actualización de claves SSH generadas por Qualtrics
Si utiliza una clave SSH generada por Qualtrics, puede regenerar la clave si es necesario. Esto es útil si cree que la clave se ha visto comprometida o si su empresa requiere que gire las teclas después de un cierto período de tiempo.
- Al visualizar la lista de cuentas SFTP a utilizar, haga clic en el menú de tres puntos situado a la derecha de la cuenta y haga clic en Editar cuenta.
- Haga clic en el hipervínculo para generar un nuevo par de claves.
Configuración de una tarea Extraer datos de archivos SFTP
- Cree un flujo de trabajo ETL.
- Seleccione Fuente de datos (extractor ETL).
- Seleccione la tarea Extraer datos de archivos SFTP.
- Seleccione la cuenta SFTP de la que extraer archivos. Todas las cuentas añadidas por los administradores de organización, así como las cuentas que haya añadido usted mismo, se enumerarán aquí.
- If you want to add new SFTP account credentials, click Add a user account and follow the steps in the connecting an SFTP account section.
- Haga clic en Siguiente.
- Introduzca el patrón de nombre de archivo, que se utiliza para identificar qué archivos se deben procesar consultando el prefijo del archivo. Se procesarán todos los archivos con el prefijo especificado. Introduzca el prefijo deseado en la casilla.
Ejemplo: Supongamos que tengo un archivo llamado Qualtrics-DataImport.csv. Puedo introducir “Q” o “Qualtrics” como prefijo, dependiendo de si hay otros archivos en el servidor que desee procesar. - Introduzca el directorio de recogida o la ruta de acceso al directorio para encontrar el archivo en el servidor. Puede introducir una vía de acceso relativa o una vía de acceso absoluta.
Consejo Q: esta ruta del directorio distingue entre mayúsculas y minúsculas y debe apuntar a una carpeta existente o el flujo de trabajo fallará. Qualtrics no podrá acceder a los archivos si se encuentran en un directorio de nivel superior al especificado en el directorio de recogida.
Ejemplo: Dependiendo de la ruta que introduzca, los directorios de recogida potenciales podrían ser:
- /home/username/myFolder (vía de acceso absoluta)
- myFolder (ruta relativa)
- Seleccione un tipo de archivo. Sus opciones incluyen:
- CSV
- TSV
- JSON
Consejo Q: Los archivos JSON deben incluir su contenido entre corchetes, []. Por ejemplo:
[ { "fruta": "Apple", "tamaño": "Grande", "color": "Rojo" } ]
- Excel (.xslx o .xls)
- Seleccione el Delimitador para los archivos SFTP que se van a procesar. Sus opciones incluyen coma, punto y coma, tabulador y barra vertical.
- Si lo desea, seleccione Descifrar archivos antes de importar con PGP. Para obtener más información sobre este medio adicional de cifrado y protección de datos, consulte Cifrado PGP.
Consejo Q: Asegúrese de que los archivos que desea importar están cifrados con la clave pública de Qualtrics antes de cargarlos en su servidor SFTP. Para ello, es posible que deba hablar con su equipo de TI.
- Si desea omitir archivos que no se pueden procesar, seleccione Omitir archivos incorrectos. Si no se selecciona esta opción, todo el flujo de trabajo fallará cuando intente procesar el archivo incorrecto.
Consejo Q: Hay varias razones por las que no se puede procesar un archivo. La más común es que es demasiado grande o sus datos se corrompen de alguna manera.
- Seleccione lo que desea que suceda después de procesar el archivo. Sus opciones incluyen:
- Eliminar el archivo procesado: Después de procesar el archivo, Qualtrics lo elimina del servidor SFTP. Esta opción está activada de forma predeterminada.
- Conservar el archivo procesado: Después de procesar el archivo, Qualtrics lo deja en el servidor SFTP.
- Decide if you’d like to Use strict validation, which will automatically reject extracted files if they have certain formatting issues. Read the message in the task for more information about which files will be rejected.
- Haga clic en Elegir archivo y cargue un archivo de muestra, que indicará a Qualtrics los campos que desea importar y determinará las tareas posteriores que puede utilizar con esta tarea. El archivo que cargue debe contener los campos que desea importar como parte de esta tarea.
Consejo Q: Descargue los archivos de muestra en la tarea o descargue los archivos en la sección de archivos de ejemplo para las plantillas sobre cómo estructurar sus datos en función de su caso de uso. El único formato de codificación de archivo admitido es UTF-8. Algún software de hoja de cálculo guarda como Unicode UTF-8, que es diferente a UTF-8, si obtiene errores inesperados. Asegúrese de que está exportando en formato UTF-8 y no Unicode UTF-8.
- Verifique de nuevo que su archivo esté importando los datos correctamente. Si necesita modificar su configuración, haga clic en Atrás en la parte superior de la tarea.
- Si sus datos parecen correctos, haga clic en Guardar.
- Finalice la creación de su flujo de trabajo ETL. Cuando selecciona una tarea de cargador, decide el destino de los datos que ha extraído. Consulte las tareas de cargador disponibles para obtener una lista de opciones.
Archivos de ejemplo
A continuación se muestran archivos de ejemplo sobre cómo estructurar los datos para la importación, en función del tipo de datos que desee importar. Haga clic en un nombre de archivo para descargar el archivo de ejemplo.