Conector de entrada de archivos

Acerca del conector de entrada de archivos

Puede utilizar el conector de entrada de archivos para cargar datos de cliente mediante una carga de archivos. Estos jobs se pueden programar para que se repitan en una programación que fije o se pueden configurar para que sean una extracción de datos única.

Las tareas de entrada de archivos le permiten cargar datos en los siguientes formatos:

• Archivos de texto delimitados planos (CSV, TSV, etc.)
• XLS o XLSX
• JSON
• WebVTT

Configuración de un job de entrada de archivos

1. En la página Jobs, haga clic en Job nuevo.
   
2. Seleccione Archivos.
   
3. Asigne un nombre a su trabajo para que pueda identificarlo.
   
4. Seleccione el proyecto en el que desea cargar los datos.
5. Dele una descripción a su trabajo para que conozca su propósito.
6. Haga clic en Siguiente.
7. Elija una cuenta SFTP para utilizar o seleccione Añadir nueva para añadir una nueva.
   
8. Si añade una cuenta nueva, introduzca la siguiente información para su cuenta SFTP:
   • Nombre de conexión: Asigne un nombre a la conexión para que pueda reconocerla más adelante.
   • Nombre de usuario de SFTP: Introduzca el nombre de usuario para conectarse al servidor SFTP.
   • Contraseña de SFTP: Introduzca la contraseña para conectarse al servidor SFTP.
   • Host SFTP: introduzca la URL de host del servidor SFTP.
   • Puerto SFTP: Introduzca su puerto SFTP. Normalmente es 22.
   • Enviar notificaciones de vencimiento: si desea que sus credenciales de SFTP caduquen después de un cierto período de tiempo, seleccione esta opción.
   • Días antes del vencimiento: si activa las notificaciones de expiración, introduzca cuántos días desea que se le notifique antes del vencimiento. Puede introducir un valor entre 1 y 100 días.
   • Fecha de vencimiento: establezca la fecha en la que vencerán las credenciales. Haga clic en la casilla para abrir un calendario para elegir la fecha.
9. Haga clic en Siguiente.
10. Seleccione el tipo de archivo que desea cargar:
    
    • Archivos “planos” separados por delimitadores
    • Archivos Excel (XLS, XLSX)
    • Archivos JSON
    • Archivos WebVTT
11. En función del tipo de archivo seleccionado, hay opciones adicionales que puede seleccionar:
    • Archivos planos separados por delimitadores: para archivos separados por delimitadores, seleccione lo siguiente:
      
      • Codificación de archivos: elija el sistema de codificación del archivo (UTF-8, ASCII, etc.)
      • Carácter delimitador: introduzca el carácter utilizado para delimitar entradas de datos. De forma predeterminada, es una coma para los archivos CSV.
      • Carácter de cierre: introduzca el carácter que encierra la entrada de datos. Deje este campo en blanco si se selecciona Sin cierre.
      • Sin cierre: active esta opción si el archivo no contiene caracteres de cierre.
    • JSON: introduzca la ruta JSON que contiene los datos del documento que desea cargar en XM Discover. Deje este campo en blanco si sus documentos están en el nivel raíz.
      
    • Pase al siguiente paso para Excel y WebVTT.
12. Haga clic en Examinar y seleccione la ruta de la carpeta en el servidor SFTP que contiene el archivo que desea cargar.
    Consejo Q: Al elegir una ruta de carpeta, puede hacer clic en un icono de carpeta para expandirla. Haga clic en el nombre de la carpeta para seleccionarla y, a continuación, haga clic en Aceptar cuando haya terminado.
13. Introduzca la expresión regular del nombre de archivo que coincida con los archivos que desea cargar.
14. Si sus archivos están comprimidos, active Descomprimir archivo(s) e introduzca la expresión regular Nombre de archivo comprimido que coincida con los archivos que se deben descomprimir.
    
15. Si sus archivos están descifrados, active Descifrar archivos e introduzca lo siguiente:
    • Expresión regular de nombre de archivo cifrado: introduzca la expresión regular de nombre de archivo para los archivos que deben descifrarse.
    • Clave PGP/GPG: introduzca la clave PGP/GPG utilizada para el cifrado.
    • Frase de contraseña: Ingrese la frase de contraseña para el descifrado.
16. Si sus archivos están comprimidos y cifrados, debe elegir cuál debe suceder primero:
    • Descomprimir y luego Descifrar: Los archivos se descomprimen y luego se descifran.
    • Descifrar y luego descomprimir: los archivos se descifran y luego se descomprimen.
17. Seleccione el tipo de datos que desea importar:
    
    • Chat: Interacciones digitales con múltiples líneas de diálogo entre 2 o más participantes.
    • Llamada: Llame transcripciones con múltiples líneas de diálogo entre 2 o más participantes.
    • Feedback: documentos presentados como objetos de una sola fila o “planos”.
      Consejo Q: Dependiendo del tipo de archivo, algunos tipos de datos no son compatibles. Por ejemplo, los archivos WebVTT solo se pueden utilizar para cargar transcripciones de llamada.
18. Debe proporcionar un archivo de muestra, que se puede guardar en su equipo o en su servidor SFTP:
    • Seleccione Descargar muestra del almacenamiento de archivos si el archivo de muestra se guarda en su servidor SFTP.
    • Seleccione Cargar muestra de mi ordenador si la muestra se guarda en su ordenador.
19. Si es necesario, puede seleccionar un archivo Plantilla para descargar. Haga clic aquí para descargar la plantilla seleccionada. Utilice este archivo para añadir los datos que desea importar a XM Discover. Consulte la página de soporte XM Discover Data Formats para obtener información de formato específica sobre cada archivo y tipo de datos.
20. Haga clic en el botón Seleccionar archivo de muestra y elija el archivo de muestra en su equipo o en su servidor SFTP.
21. Aparecerá una vista previa del archivo. Si ve un mensaje de error o el contenido del archivo sin procesar en lugar de la vista previa, puede haber un problema con las opciones de formato de datos que seleccionó. Consulte la página Errores de archivo de muestra para obtener ayuda con la resolución de problemas del archivo.
22. Haga clic en Siguiente.
23. Si es necesario, ajuste sus asignaciones de datos. Consulte la página de soporte Asignación de datos para obtener información detallada sobre los campos de asignación en XM Discover. La sección Asignación de datos predeterminada tiene información sobre los campos específicos de este conector y la sección Asignación de campos conversacionales cubre cómo asignar datos para datos conversacionales.
    
24. Haga clic en Siguiente.
25. Si lo desea, puede añadir reglas de sustitución y edición de datos para ocultar datos confidenciales o sustituir automáticamente determinadas palabras y frases en los comentarios y las interacciones del cliente. Consulte la página de soporte Sustitución de datos y Redacción para obtener más información.
    
26. Haga clic en Siguiente.
27. Si lo desea, puede añadir un filtro de conector para filtrar los datos entrantes para limitar los datos que se importan.
    
28. También puede limitar el número de registros importados en un solo job introduciendo un número en el cuadro Especificar límite de registros. Introduzca “Todos” si desea importar todos los registros.
    Consejo Q: Para los datos conversacionales, el límite se aplica en función de las conversaciones en lugar de las filas.
29. Haga clic en Siguiente.
30. Elija cuándo desea que se le notifique. Consulte Notificaciones de job para obtener más información.
    
31. Haga clic en Siguiente.
32. Seleccione cómo se gestionan los documentos duplicados. Consulte Tratamiento de duplicados para obtener más información.
    
33. Seleccione Programar ejecuciones incrementales si desea que el job se ejecute periódicamente en una programación o Configurar pull único si desea que el job se ejecute solo una vez. Consulte Programación de jobs para obtener más información.
34. Seleccione un período de retención para los archivos procesados. Los archivos se borran después del período establecido.
    
35. Haga clic en Siguiente.
36. Revise su configuración. Si necesita cambiar una configuración específica, haga clic en el botón Editar para ir a ese paso en la configuración del conector.
    
37. Haga clic en Finalizar para grabar el job.

Asignación de datos predeterminados

Esta sección contiene información sobre los campos predeterminados para los jobs de entrada de archivos.

• feedback_type: identifica los datos en función de su tipo. Esto es útil para la generación de informes cuando su proyecto contiene diferentes tipos de datos (por ejemplo, encuestas y opiniones de medios sociales). Por defecto, el valor de este atributo se fija en “llamada” para transcripciones de llamada, “chat” para interacciones digitales o “feedback” para feedback individual. Utilice transformaciones personalizadas para establecer un valor personalizado, definir una expresión o asignarla a otro campo.
• source_value: identifica los datos obtenidos de una fuente específica. Puede ser cualquier cosa que describa el origen de los datos, como el nombre de una encuesta o una campaña de marketing móvil. De forma predeterminada, el valor de este atributo se fija en “Archivos”. Utilice transformaciones personalizadas para establecer un valor personalizado, definir una expresión o asignarla a otro campo.
• document_date: el campo de fecha principal asociado a un documento. Esta fecha se utiliza en informes, tendencias, alertas, etc. de XM Discover. Puede utilizar cualquier campo de fecha en su conjunto de datos para la fecha de documento. También puede fijar una fecha de documento específica.
• natural_id: un identificador único de un documento. Se recomienda encarecidamente tener un ID único para cada documento para procesar duplicados correctamente. Para el ID natural, puede seleccionar cualquier campo de texto o numérico de sus datos. Como alternativa, puede generar automáticamente ID añadiendo un campo personalizado.
• feedback_provider: identifica los datos obtenidos de un proveedor específico. Para las cargas de archivos, el valor de este atributo está fijado en “Archivos” y no se puede modificar.
• job_name: identifica los datos según el nombre del job utilizado para cargarlos. Puede modificar el valor de este atributo durante la configuración mediante el campo Nombre del trabajo que se muestra en la parte superior de cada página durante la configuración.
• loadDate: indica cuándo se cargó un documento en XM Discover. Este campo se fija automáticamente y no se puede modificar.

Actualizando configuración de muestra

Los conectores de entrada de archivos requieren un archivo de muestra para generar asignaciones de datos. Si desea modificar las asignaciones de datos después de crear un job, realice lo siguiente:

1. Anule la asignación de los campos que no están presentes en el nuevo archivo de muestra.
2. Actualice la configuración de muestra cargando un nuevo archivo de muestra con un nuevo conjunto de campos. Los pasos para actualizar la configuración de ejemplo son los siguientes.
3. Actualice las asignaciones de datos según el nuevo archivo de muestra.

Actualizando configuración de ejemplo

1. En el menú de opciones de job, seleccione Actualizar configuración de muestra para un job de archivos existente.
   
2. Seleccione Hacer clic en Seleccionar archivo para cargar y seleccione el archivo de muestra guardado en su ordenador.
   
   Consejo Q: Si su archivo contiene campos que no están en su asignación de datos, recibirá un error. Para solucionar este problema, edite la asignación de datos para que tenga los mismos campos que su archivo de muestra.
3. Vuelva a comprobar la configuración del archivo. Consulte la página Conector de entrada de archivos para obtener más información sobre las opciones de archivo de muestra.
4. Haga clic en OK.

Actualizando ruta y máscara de archivo

Los conectores de entrada de archivos requieren una ruta y una máscara de archivo (expresión regular de nombre de archivo) para encontrar los archivos correctos para importar. Puede actualizar la ruta y la máscara de archivo para cualquier job de archivos existente.

1. En el menú de opciones de job, seleccione Actualizar vía de acceso y máscara de fichero para un job de ficheros existente.
   
2. Haga clic en Examinar.
   
3. Seleccione la carpeta en la que se almacenan los archivos.
   
   Atención: solo se procesan los archivos de la carpeta seleccionada; las subcarpetas deben procesarse por separado.
4. Haga clic en OK.
5. En el campo Expresión regular de nombre de archivo, introduzca la máscara de archivo (expresión regular de nombre de archivo) que coincida con los archivos que desea importar.
   
6. Haga clic en Guardar.

XM Discover Supported Key Exchange Ciphers

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.

Here’s a list of key exchange ciphers supported by XM Discover SFTP servers:

• diffie-hellman-group14-sha256
• diffie-hellman-group18-sha512
• ecdh-sha2-nistp256
• ecdh-sha2-nistp384
• ecdh-sha2-nistp521
• curve25519-sha256
• curve25519-sha256@libssh.org
• diffie-hellman-group16-sha512
• ecdh-nistp256-kyber-512r3-sha256-d00@openquantumsafe.org
• ecdh-nistp384-kyber-768r3-sha384-d00@openquantumsafe.org
• ecdh-nistp521-kyber-1024r3-sha512-d00@openquantumsafe.org
• x25519-kyber-512r3-sha256-d00@amazon.com