Tarea de extracción de datos de archivos SFTP
Contenidos de la página
Acerca de la Tarea Extraer datos de archivos SFTP
El Extraer datos de archivos SFTP La tarea le permite importar datos desde su servidor SFTP para usar en Qualtrics. Puede utilizar esta tarea para procesar solo uno o varios archivos a la vez. Puede combinar esta tarea con otras tareas, como la tarea Cargar datos en el XM Directory , para importar datos a otros lugares en Qualtrics.
Consejo Q: Qualtrics ofrece nuestros propios servidores SFTP para clientes a través de nuestro equipo de Servicios Profesionales. Hay un costo asociado con este servicio; sin embargo, garantizamos que estos servidores funcionarán con automatizaciones. Para obtener más información, póngase en contacto con nuestro Servicios profesionales equipo.
Atención: Su cuenta SFTP debe tener permisos de lectura, escritura y eliminación para que esta tarea se realice correctamente.
Cómo conectar una Cuenta SFTP
Antes de poder utilizar la Tarea Extraer datos de archivos SFTP , debe conectar una cuenta SFTP para que Qualtrics extraiga los datos. Los administradores de Marca/organización pueden agregar cuentas para que las utilicen otros usuarios de la marca/organización , o bien pueden hacerlo usuarios individuales para su uso personal.
Hay 3 opciones de autenticación diferentes:
- Contraseña: Autenticarse con nombre de usuario y contraseña.
- Clave SSH: Autenticación mediante una clave Secure Shell (SSH) que usted proporcione o una clave proporcionada por Qualtrics.
- Clave SSH cifrada: Autenticarse utilizando una clave SSH cifrada.
Consejo Q: Al configurar una conexión SFTP , recomendamos a su equipo de TI Incluir en la lista de permitidos los rangos de IP de Qualtrics.
Cómo agregar una Cuenta como administrador de Marca/organización
Si eres un Administrador de Marca/organización, siga los pasos de esta sección para agregar una cuenta SFTP para algunos o todos los usuarios en su licencia de uso.
Ejemplo: Comúnmente estos tienen el formato de sftp.ejemplo.com
- Contraseña:Proporcione un nombre de usuario y 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 encriptada con una frase de contraseña para la autenticación.
- Si utiliza una clave SSH generada por Qualtrics, ingrese una Nombre de usuario y luego haga clic Generar par de claves SSH.
Luego puedes hacer clic Descargar clave SSH pública para descargar la clave pública como un archivo .pem a su computadora. La clave privada asociada será almacenada por Qualtrics. Hacer clic Copiar al portapapeles para copiar la huella digital de la clave a su portapapeles. Guarde ambos en un lugar seguro para que pueda consultarlos si es necesario.
- Si usa su propia clave SSH , haga clic en Proporcionar una clave privada.
Luego, ingresa tu Nombre de usuario y el Clave SSH.
Consejo Q: Debe ingresar una clave privada no protegida con contraseña en este cuadro. La clave pública debe estar autorizada en su servidor SFTP .
Esta clave debe estar en formato codificado PEM. No se admiten otros formatos (como una clave privada PuTTY).Ejemplo: Las claves codificadas en PEM normalmente son legibles para humanos. Así es como se ve normalmente una clave (incluidas las líneas de clave RSA de inicio y fin):
—–INICIO CLAVE PRIVADA RSA—–
a1b2c3d4…
—–FIN DE LA CLAVE PRIVADA RSA—–
Agregar una cuenta como usuario individual
Siga los pasos de esta sección para agregar una cuenta SFTP para su uso personal. Sólo usted podrá utilizar la cuenta que conecte.
Probando la conexión
Después de haber agregado 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.
Descarga de claves SSH públicas
Si utiliza una clave SSH generada por Qualtrics, puede descargar la clave pública para la conexión. Al ver la lista de cuentas SFTP para usar, haga clic en el menú de tres puntos a la derecha de una cuenta y luego seleccione Descargar clave SSH pública. Esto descargará la clave a su computadora 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 rotar las claves después de un cierto período de tiempo.
Atención: Esta acción actualizará automáticamente la clave SSH de su cuenta y no se podrá revertir. Asegúrese de que desea regenerar la clave antes de seguir los pasos de esta sección.
Consejo Q: Asegúrese de hacer clic Descargar clave SSH pública y Copiar al portapapeles para guardar su nueva clave SSH .
Solución de problemas de la Tarea “Extraer datos de archivos SFTP “
A continuación se presentan las mejores prácticas, límites y consejos para la solución de problemas para procesar archivos con esta tarea:
- Límites de tamaño de archivo: La tarea Extraer datos de archivos SFTP tiene un límite de 200 archivos por ejecución, y cada archivo individual tiene un Límite de tamaño de archivo de 5 GB y un límite de tamaño de archivo total de 10 GB para todos los archivos. Si los archivos exceden estos límites, la tarea fallará, lo que significa que no se procesará ninguno de los archivos.
- Encabezados requeridos: Los archivos necesitan 1 fila de encabezados para ser procesados. Si a un archivo le falta una fila de encabezado, el archivo se considerará inválido.
- Archivos que provocan errores en la tarea : Si intenta extraer varios archivos y uno de ellos hace que la tarea falle, debe cambiar el archivo para evitar que el flujo de trabajo intente procesarlo nuevamente y, por lo tanto, falle. Por ejemplo, puede mover el archivo a un directorio diferente en su SFTP, eliminarlo o cambiar el prefijo del archivo a otro.
- Comillas escapadas: Barras invertidas ( \ ) son no comillas de escape válidas para archivos CSV . Asegúrese de utilizar comillas rectas ( “” ). No utilice comillas tipográficas ( “ ” ).
- Finales de línea: Si está utilizando un archivo que solo tiene finales de línea de retorno de carro, estos se reemplazarán con finales de línea de nueva línea.
- CSV codificados en UTF-8 : Si está utilizando un CSV, el único formato de codificación de archivos compatible para esta tarea es UTF-8. Algunos programas de hojas de cálculo guardan como Unicode UTF-8, que es diferente de UTF-8, en caso de que aparezcan errores inesperados. Asegúrese de exportar en formato UTF-8 y no Unicode UTF-8.
Consejo Q: Para obtener información sobre los límites generales que aplicar a los flujos de trabajo ETL , consulte Límites del Flujo de trabajo. Para conocer los límites específicos de cada tarea, consulte la información en esta página.
Para solucionar problemas de conexiones SFTP , consulte Solución de problemas de SFTP.
Configuración de una Tarea de extracción de datos de archivos SFTP
Ejemplo: Digamos que tengo un archivo llamado Qualtrics- csv. Puedo ingresar “Q” o “Qualtrics” como prefijo, dependiendo de si hay otros archivos en el servidor que quiero procesar.
Consejo Q: Haga clic en el Utilice expresiones regulares Casilla de verificación si desea utilizar expresiones regulares para su patrón de nombre de archivo.
Consejo Q: Esta ruta de 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 están en un directorio de nivel superior al especificado en el directorio de recogida.
Ejemplo: Dependiendo de la ruta que ingreses, los directorios de recogida potenciales podrían ser:
- /home/nombreusuario/miCarpeta (ruta absoluta)
- miCarpeta (ruta relativa)
Consejo Q: Solo se extraerán los archivos que coincidan con la expresión regular proporcionada. Utilice la sintaxis de expresión regular RE2.
Consejo Q: Sólo se admiten compresiones .zip. Los archivos en el archivo .zip se pueden cifrar, pero el archivo pgp en sí no (por ejemplo, csv es compatible, pero csv no).
Consejo Q: Un archivo se considera “no esquematizado” si no sigue el formato estándar requerido. Por ejemplo:
- El archivo es un tipo de archivo no compatible (consulte el paso 15 para conocer los tipos admitidos).
- Al archivo le faltan encabezados.
- El archivo tiene otros errores de formato.
Consejo Q: Al seleccionar “Es un archivo no esquematizado” se eliminan las configuraciones de tipo de archivo, delimitador y archivo de muestra .
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 hacer esto, es posible que necesites hablar con tu equipo de TI.
Consejo Q: “Omitir archivos defectuosos” no procesará archivos que superen el tamaño máximo ni archivos que no se puedan abrir, como aquellos que estén dañados de alguna manera. Si bien esta configuración reduce las posibilidades de que un flujo de trabajo falle, no tendrá en cuenta los problemas que podrían ocurrir en archivos que se pueden abrir, como encabezados y formatos incorrectos.
Consejo Q: Al configurar la tarea en datos conversacionales se eliminan las configuraciones de tipo de archivo y delimitador.
Sus opciones incluyen: CSV, TSV, JSON o Excel (. xlsx o . xls).
Atención: Cuando se selecciona un tipo de archivo Excel, la tarea solo lee la primera pestaña del documento. Además, los archivos . xlsx deben tener menos de 1 Gigabyte y los archivos . xls deben tener menos de 5 Megabytes.
Consejo Q: Los archivos JSON deben tener su contenido entre corchetes, []. Por ejemplo:
[
{
"fruta": "manzana",
"tamaño": "Grande",
"color": "Rojo"
}
]
Atención: Solo se pueden usar archivos UTF-8 sin BOM. Utilice espacios normales (no espacios de no separación) en los encabezados de columna. Los espacios de no separación parecen idénticos pero provocan fallos de coincidencia. Las exportaciones de Excel a menudo crean espacios de no separación; sustitúyalos por espacios normales.
- Eliminar el archivo procesado:Después de procesar el archivo, Qualtrics lo elimina de su servidor SFTP . Esta opción está activada de forma predeterminada. Consejo Q: Tenga en cuenta que esto sigue siendo cierto si varios flujos de trabajo acceden a los mismos archivos. En otras palabras, si un flujo de trabajo elimina un archivo y otro flujo de trabajo intenta ejecutarse con la misma lógica, el archivo ya habrá sido eliminado del SFTP y no será procesado por ningún flujos de trabajo adicional.
- Mueva el archivo procesado a un directorio diferente:Si eliges esta opción, aparecerá un campo donde podrás escribir la ruta URL de las diferentes carpetas donde deseas que se guarde el archivo procesado.
- Conservar el archivo procesado:Después de procesar el archivo, Qualtrics deja el archivo en su servidor SFTP .
Atención: Si su servidor SFTP está configurado para eliminar o mover archivos automáticamente después de ser tocados, la opción de posprocesamiento que seleccione puede no funcionar como se espera.
Consejo Q: Permitir Omitir filas mal formadas para cargar su archivo y excluir cualquier fila con problemas de formato.
Consejo Q: Descargue los archivos de muestra en la tarea, o descargue los archivos en el Sección de archivos de ejemplo para obtener plantillas sobre cómo estructurar sus datos en función de su caso de uso.
Consejo Q: Si todos sus datos se importan como una sola columna, está utilizando el delimitador incorrecto. La siguiente captura de pantalla demuestra cómo se ve esto en la ventana de tarea .
Archivos de ejemplo
A continuación se muestran archivos de ejemplo sobre cómo estructurar sus datos para la importación, según el tipo de datos que desee importar. Haga clic en el nombre de un archivo para descargar el archivo de ejemplo.
- Datos de Empleado
- Datos de la Cuenta
- Datos de Contacto
- Datos de respuesta de la Encuesta
- Datos de usuario
- Datos de miembros del equipo de Cuenta de Salesforce
- Datos conversacionales de chat
- Datos conversacionales de correo electrónico
Extracción de datos conversacionales de archivos SFTP
Atención: Esta función solo está disponible para los usuarios de los nuevos planes de precios y paquetes simplificados o clientes que participaron activamente en el Programa de vista previa para esta función. Para obtener más información, consulte Vista previa pública de Qualtrics. Si tiene preguntas sobre su plan de precios y paquetes de Qualtrics , comuníquese con Cuenta Servicios.
Los datos conversacionales son datos de chats y correos electrónicos. Por ejemplo, si tiene registros de interacciones de clientes y soporte, estos serían datos conversacionales. Este tipo de información puede contener opinión abiertos enriquecedores, así como brindar una oportunidad para capacitar a sus representantes de atención al cliente sobre cómo servir mejor a sus clientes. Puede realizar este tipo de análisis conversacional una vez que sus datos se hayan trasladado desde su servidor a Qualtrics, con nuestra serie de funciones de escucha Omnicanal .
Atención: Solo recomendamos utilizar la configuración de datos conversacionales si ha adquirido los Servicios de implementación. Esta función es para usar con charlar y correo electrónico proyectos como parte de Gestión de la escucha Omnicanal. Consulte la página vinculada para obtener más detalles y permisos.
Dar formato a los datos conversacionales
Los datos conversacionales deben estar en formato escrito. Por ejemplo, las transcripciones de chat transcritas se pueden trasladar a Qualtrics para su uso en análisis conversacionales. Sin embargo, un archivo de audio no puede.
Los archivos deben estar en formato de hoja de cálculo (consulte los tipos de archivos admitidos a continuación). Cada fila del archivo debe ser un registro separado y cada columna es un campo o entrada diferente en el mismo registro. Su archivo de ejemplo debe tener encabezados.
Atención: Le recomendamos encarecidamente que utilice nuestros archivos de ejemplo al guardar datos de conversación en su servidor:
Extracción de datos conversacionales de archivos SFTP
A continuación, le brindaremos una descripción general sobre cómo extraer datos conversacionales de su SFTP para que pueda analizarlos en Qualtrics:
Atención: Archivos no esquematizados no son compatibles con datos conversacionales. De lo contrario, todas las demás configuraciones de importación de archivos son compatibles.
- Charlar:Los datos están formateados como una serie de chats en línea. Estos pueden ser con un agente automatizado o humano.
- Correo electrónico:Los datos están formateados como una serie de correos electrónicos. Consejo Q: El hecho de que seleccione chat o correo electrónico afectará si carga los datos en un charlar o correo electrónico proyecto.
Preguntas frequentes
¿Tengo acceso a todas las extensiones disponibles a través de las plantillas de flujos de trabajo?
¿Tengo acceso a todas las extensiones disponibles a través de las plantillas de flujos de trabajo?
¿Hay un enlace a todos los desencadenantes de eventos de los flujos de trabajo, el flujo de control y las tareas?
¿Hay un enlace a todos los desencadenantes de eventos de los flujos de trabajo, el flujo de control y las tareas?
¿Qué son las plantillas de flujos de trabajo?
¿Qué son las plantillas de flujos de trabajo?
¿Qué son los flujos de trabajo? / ¿Dónde están las acciones?
¿Qué son los flujos de trabajo? / ¿Dónde están las acciones?
No hay cambios en la funcionalidad del flujo de trabajo como parte de esta actualización.
¿Cómo agrego o elimino una extensión de mi cuenta de Qualtrics?
¿Cómo agrego o elimino una extensión de mi cuenta de Qualtrics?
¡Genial! ¡Gracias por tus comentarios!
¡Gracias por tus comentarios!