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 combinar esta tarea con otras tareas, como la tarea Cargar datos en XM Directory, para importar datos al Centro de comandos de gestión de cuentas y en 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.

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 que la utilicen algunos o todos los usuarios de su licencia.

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 normalmente parece una clave SSH (incluyendo las líneas de 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.

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. Haga clic en el menú de navegación en la parte superior izquierda.
   
2. Seleccione Workflows.
3. Haga clic en Crear un flujo de trabajo.
4. Seleccione Iniciado a una hora específica.
5. Si lo desea, cambie el nombre del flujo de trabajo haciendo clic en el nombre del flujo de trabajo en la parte superior.
   
6. Determine cuándo se desencadena el workflow programado. Consulte los workflows programados para obtener más información sobre la configuración de workflows programados.
7. Haga clic en el signo más ( + ) y seleccione Tarea.
8. Seleccione la tarea Extraer datos de archivos SFTP.
   
9. 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í.
   
10. Si desea añadir nuevas credenciales de cuenta SFTP, haga clic en Añadir cuenta nueva y siga los pasos de la sección de conexión de una cuenta SFTP.
11. Haga clic en Siguiente.
12. 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.
13. 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 vía de acceso que introduzca, los directorios de recogida potenciales podrían ser:

    • /home/username/myFolder (vía de acceso absoluta)
    • myFolder (ruta relativa)
14. Seleccione el Delimitador para los archivos SFTP que se van a procesar. Sus opciones incluyen coma, punto y coma, tabulador y barra vertical.
15. 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.
16. 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.
17. 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.
    
18. Haga clic en Cargar.
19. 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.

    

20. Si sus datos parecen correctos, haga clic en Guardar.
21. Haga clic en el signo más (+ ), seleccione Tarea y configure la tarea que debe seguir su extracción de datos SFTP. Debería ser una tarea del cargador de datos. 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