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.

Para obtener más información sobre la configuración y resolución de problemas de SFTP, consulte Solución de problemas de SFTP.

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.

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.

1. Mediante el menú de navegación en la parte superior izquierda, vaya a Admin.
   
2. Vaya a Extensiones.
3. Haga clic en la extensión Extraer datos de archivos SFTP.
4. Haga clic en Añadir cuenta.
   
5. Asigne un nombre a la cuenta. Este nombre se utiliza para fines organizativos y para identificar la cuenta.
   
6. Introduzca el nombre de host del servidor SFTP asociado.
   Ejemplo: normalmente están en el formato sftp.example.com
7. Introduzca el número de puerto. Por lo general, esto es 22.
8. 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.
9. Si elige la contraseña, introduzca el Nombre de usuario y la Contraseña para la cuenta SFTP.
   
10. 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—–
11. 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.
12. 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.

1. 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.
2. Haga clic en Añadir cuenta de usuario.
   
3. 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.

Probando la conexión

Después de agregar una cuenta, puede probar la conexión desde la tarea Extraer datos de archivos SFTP. En la parte inferior de la tarea, haga clic en Conexión de prueba. Esto cargará un pequeño archivo de prueba a su servidor, leerá su contenido y luego eliminará el archivo. 

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.

1. 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.
2. Haga clic en el hipervínculo para generar un nuevo par de claves.
   

Configuración de una tarea Extraer datos de archivos SFTP

1. Cree un flujo de trabajo ETL.
2. Seleccione Fuente de datos (extractor ETL).
   
3. Seleccione la tarea Extraer datos de archivos SFTP.
   
4. 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í.
   
5. Si desea agregar nuevas credenciales de cuenta SFTP, haga clic en Agregar una cuenta de usuario y siga los pasos en el sección Conexión de una cuenta SFTP.
6. Haga clic en Siguiente.
7. 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.
   Bastoncillo de algodón: Haga clic en el Utilice expresiones regulares Casilla de verificación si desea utilizar expresiones regulares para su patrón de nombre de archivo.
8. 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)
9. Si su archivo está comprimido, habilite la ¿Estás extrayendo de un archivo zip? opción. A continuación, ingrese el Prefijo para el archivo dentro del zip que se utilizará para encontrar el archivo correcto para importar desde el archivo zip.
   Bastoncillo de algodón: Sólo se admiten compresiones .zip. Los archivos en el archivo .zip se pueden cifrar, pero el archivo .zip en sí no (por ejemplo, filename.csv.pgp.zip es compatible, pero filename.csv.zip.pgp no).
10. 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)
11. Si está procesando un CSV, seleccione la opción Delimitador para el archivo. Sus opciones incluyen coma, punto y coma, tabulador y barra vertical.
12. 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.
13. 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.
14. 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.
15. Decide si quieres Utilice una validación estricta, que rechazará automáticamente los archivos extraídos si tienen ciertos problemas de formato. Lea el mensaje en la tarea para obtener más información sobre qué archivos serán rechazados.
    
    Bastoncillo de algodón: Permitir Omitir filas mal formadas para cargar su archivo y excluir cualquier fila con problemas de formato.
16. 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.
    
17. 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.
    

    Consejo Q: Si todos los datos se están importando como una columna, está utilizando el delimitador incorrecto. La siguiente captura de pantalla muestra cómo es esto en la ventana de tareas.

    

18. Si sus datos parecen correctos, haga clic en Guardar.
19. 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.

• Datos de usuario
• Datos de respuesta de encuesta
• Datos de contacto de Salesforce
• Datos de cuenta de Salesforce
• Datos de miembro del equipo de cuenta de Salesforce
• Datos de empleado

Preguntas frecuentes