Conector de salida de archivos

Acerca del conector de salida de archivos

Puede utilizar el conector de salida de archivos para extraer datos enriquecidos de XM Discover con fines de cumplimiento y copia de seguridad de datos, o para actuar en consecuencia dentro de aplicaciones externas.

Puede exportar datos a nivel de frase y de documento, limitarlos a registros nuevos y actualizados y seleccionar qué campos, enriquecimientos y clasificaciones se van a exportar. El conector de salida de archivos guarda datos en un servidor de protocolo seguro de transferencia de archivos (SFTP).

ANTES DE EMPEZAR

Antes de configurar un job con el conector de salida de archivos, asegúrese de tener:

• El nombre de usuario y la contraseña de su cuenta SFTP.
• Una clave PGP/GPG si desea cifrar archivos entregados por XM Discover.

Los formatos de archivo admitidos son:

• Archivos de texto delimitados (CSV).
• Archivos JavaScript Object Notation (JSON).

CONFIGURACIÓN DE LA CONEXIÓN

1. Inicie sesión en Conectores.
2. Haga clic en el botón Nuevo job en la esquina superior derecha de Jobs.
   
3. En la página Conectores, vaya a FUENTES DE SALIDA.
   
4. Haga clic en Archivos Salida.

Configuración de un job de conector de salida de archivos

Después de configurar la conexión, siga los pasos siguientes para configurar un job:

• Paso 1: Proporcionar nombre de job
• Paso 2: Especificar el proyecto y la descripción
• Paso 3: Proporcionar credenciales para una carpeta SFTP de Qualtrics
• Paso 4: Configurar las credenciales de exportación de XM Discover
• Paso 5: Configuración de consulta
• Paso 6: Proporcionar configuración de archivos
• Paso 7: Asignar los campos deseados a Qualtrics
• Paso 9: Especificar el filtro (opcional) y el límite de registros
• Paso 10: Configuración de notificación (opcional)
• Paso 11: Configurar opciones adicionales para el job
• Paso 12: Confirmar todas las opciones de job

Consejo Q: Haga clic en los botones Atrás y Siguiente para desplazarse por las páginas o utilice las teclas de flecha: IZQUIERDA para retroceder, DERECHA para ir a continuación. Si desea cancelar la configuración, haga clic en el botón Cancelar.

Paso 1: Proporcionar nombre de job

1. Introduzca un nombre de job reconocible en el cuadro Nombre de job en la parte superior izquierda de la página.
   
   Consejo Q: Puede modificar el nombre del trabajo 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.
2. Haga clic en Siguiente.

Paso 2: Especificar el proyecto y la descripción

1. En la página Especificar proyecto y descripción, seleccione un proyecto del que extraer datos del menú desplegable de proyectos.
   
   Consejo Q: El proyecto debe coincidir con el identificado por la clave API de exportación. Si hay una discrepancia, el job utilizará el proyecto identificado por la clave API.
   Consejo Q: Tiene la opción de introducir una nota sobre el job en el cuadro Descripción del job. La descripción del trabajo que introduce en el cuadro Descripción del trabajo solo es accesible en la lista Conectores y no se exporta como parte de los datos de un trabajo.
2. Haga clic en Siguiente.

Paso 3: Proporcionar credenciales para una cuenta SFTP de Qualtrics

1. En la página Proporcionar credenciales para una carpeta SFTP de Qualtrics, puede seleccionar un conjunto existente de credenciales en el menú desplegable o puede añadir un nuevo conjunto de credenciales. Consulte la sección Añadir nuevas credenciales SFTP para obtener información sobre cómo añadir un nuevo conjunto de credenciales.
   
2. Haga clic en Siguiente.

Paso 4: Configurar las credenciales de exportación de XM Discover

1. En la página Configurar credenciales de exportación de XM Discover, proporcione la URL del servicio API de exportación de XM Discover relevante para su región (sin el tipo de punto final) en el cuadro HOST.
   
   Consejo Q: Para obtener más información, consulte Exportar puntos finales de API v2.
2. Haga clic en Siguiente.

Paso 5: Configuración de consulta

En la página Configuración de consulta, puede especificar el nivel para exportar datos de XM Discover y elegir qué registros desea recuperar.

1. Seleccione una de las siguientes opciones del menú desplegable Seleccionar el nivel de datos para seleccionar el nivel de granularidad de datos asociado con los datos de salida:
   
   • Frases: Utilice la exportación a nivel de frase para obtener información más detallada y enriquecimientos a nivel de frase, como temas, opiniones, puntuaciones de esfuerzo, etc.
   • Documentos: utilice la exportación a nivel de documento cuando desee exportar valores para atributos estructurados relacionados con un documento completo.
     Atención: Cuando use enriquecimientos a nivel de frase, establezca el nivel de datos en oraciones.
   • Para obtener más información sobre los enriquecimientos disponibles para cada nivel, consulte Atributos listos para usar.
2. Proporcione una consulta para filtrar los datos de salida en el cuadro Introducir la consulta(opcional).
   Consejo Q: Utilice la misma sintaxis que utilizaba para buscar datos en Designer. Para obtener más información sobre las consultas de búsqueda admitidas, consulte Consultas de búsqueda.
   Ejemplo: Puede especificar uno o más ID de encuesta para actualizar solo los registros de encuesta seleccionados con la siguiente sintaxis: Surveyid:sv_01.
3. Proporcione el nombre del filtro de su proyecto que se debe aplicar a los datos de salida en el cuadro Introducir el nombre del filtro(opcional).
4. En Elegir qué registros desea recuperar, seleccione qué registros extraer:
   • Cargar registros nuevos (por defecto). Extraiga solo los registros que se crearon desde la última vez que se ejecutó el job de salida.
   • Cargar registros nuevos y actualizados. Extraiga los registros que se crearon o actualizaron desde la última vez que se ejecutó el job de salida.
   • Cargar registros actualizados. Extraiga solo los registros que se actualizaron desde la última vez que se ejecutó el job de salida.
     Consejo Q: Las tareas del conector de salida de archivos fijadas en Cargar registros nuevos y actualizados o Cargar registros actualizados solo se pueden programar para que se ejecuten con una frecuencia semanal o mensual.
     Atención: Ejecutar o volver a ejecutar la categorización actualiza un registro en el sistema XM Discover.
5. Puede definir qué datos de clasificación incluir en los datos de salida (opcional). Marque la casilla de selección Todos los modelos para incluir los datos de clasificación para todos los modelos disponibles en el proyecto. No marque la casilla de selección Todos los modelos si solo desea incluir los modelos seleccionados. Si la opción Todos los modelos no está seleccionada, puede seleccionar modelos específicos para incluir en los datos de salida del menú desplegable.
   
6. Seleccione una de las siguientes opciones de los resultados de Filtros aplicando el menú desplegable de reglas de modelo:
   • Ignorar: No se aplica ningún filtrado basado en los modelos seleccionados.
   • Clasificado actualmente: Devuelve las frases/documentos clasificados por los modelos seleccionados durante la ejecución de clasificación más reciente.
   • Devuelve las oraciones/documentos que han sido clasificados por los modelos seleccionados en cualquier momento.
7. Marque la casilla de selección Si se devuelven los ID de categoría (verdadero) en lugar de los nombres de categoría (falso) para utilizar los ID de categoría en lugar de los nombres de categoría (opcional).
8. Seleccione los resultados de Filtros aplicando la consulta de filtro con todas las rutas de nodos finales para añadir varios modelos con el parámetro “flex_only” a la llamada de API de exportación (opcional).
9. Haga clic en Siguiente.

Paso 6: Proporcionar configuración de archivos

En la página Proporcionar configuración de archivos, seleccione el tipo de archivo que desea utilizar para la exportación de datos y, a continuación, según el tipo de archivo seleccionado, apunte a la ubicación en la que se deben guardar los archivos y especifique otros ajustes.

1. En la sección Configuración de archivos, seleccione el tipo de archivo de las siguientes dos opciones:
   
   • Archivos de texto delimitados (CSV): seleccione esta opción para exportar datos utilizando archivos de texto delimitado (CSV).
   • Archivos de notación de objetos JavaScript (JSON): seleccione esta opción para exportar datos mediante archivos JavaScript Object Notation (JSON).
2. Si selecciona Archivos de texto delimitados (CSV), aplique las opciones de configuración para este tipo de archivo.
   • Codificación de archivos: seleccione el sistema de codificación que se utilizará en el archivo.
   • Carácter delimitador: especifique el carácter para delimitar las entradas de datos en el archivo. Solo un carácter. Si utiliza un CSV, el delimitador es una coma.
   • Carácter de cierre: especifique el carácter para encerrar cada campo de datos en el archivo. Solo un carácter.
   • Sin cierre: Marque esta casilla de selección si los caracteres de cierre son opcionales.
3. Haga clic en Examinar en la sección Ubicación de archivos para señalar la carpeta en la que se deben almacenar los archivos en el servidor SFTP.
4. En la ventana Seleccionar ubicación de archivos, seleccione la carpeta en la que se deben almacenar los archivos.
   
   Consejo Q: Haga clic en el nombre de la carpeta para seleccionarla y, a continuación, haga clic en el icono de carpeta para abrirla.
5. Una vez seleccionada la carpeta en la que se almacenan los archivos, haga clic en Aceptar.
6. En la sección Convenciones para fijar nombres, puede seleccionar las siguientes opciones:
   
   • Proporcione un nombre de archivo para el prefijo: seleccione esta opción para proporcionar un prefijo que se añadirá al nombre de archivo generado. Utilice esta opción para aplicar convenciones de nomenclatura personalizadas para comprender mejor qué archivos corresponden a una tarea o ejecución de tarea en particular.
     Consejo Q: El valor no puede contener [ ] \ / y debe tener un máximo de 100 caracteres.
   • Proporcione un nombre de archivo para el sufijo: seleccione esta opción para proporcionar un sufijo que se agregará al nombre de archivo generado. Utilice esta opción para aplicar convenciones de nomenclatura personalizadas para comprender mejor qué archivos corresponden a una tarea o ejecución de tarea en particular.
     Consejo Q: El valor no puede contener [ ] \ / y debe tener un máximo de 100 caracteres.
7. Puede cifrar los archivos suministrados por XM Discover y proporcionar una clave PGP/GPG para el cifrado en el cuadro de claves PGP/GPG(opcional). Marque la casilla de selección Cifrar archivos entregados por XM Discover para garantizar que los datos se transfieran de forma segura de XM Discover y proporcione una clave PGP/GPG para el cifrado. Como alternativa, desmarque la casilla de selección Cifrar archivos entregados por XM Discover si no se necesita cifrado.
8. Haga clic en Siguiente.

Paso 7: Asignar los campos deseados a los archivos

En la página Asignar campos deseados en archivos, puede seleccionar los atributos de XM Discover y los resultados de clasificación que se incluirán en la exportación.

1. Haga clic en el cuadro de campo personalizado vacío y seleccione el campo XM Discover que desea incluir en la exportación.
2. Seleccione el formato en el que desea exportar los datos desde el menú desplegable Tipo de datos.
3. Introduzca el nombre del campo que se va a utilizar en el archivo exportado en el cuadro Nombre de atributo.
4. Haga clic en el icono más (+ ) para añadir más campos personalizados y asignarlos a campos en el archivo exportado, si es necesario.
5. Haga clic en Siguiente.

Paso 8: Especificar el filtro (opcional) y el límite de registros

1. En la página Especificar filtro, puede definir una condición de filtro para que un job exporte solo los registros que lo satisfagan (opcional).
   
   Consejo Q: Para obtener más información sobre cómo aplicar un filtro, consulte Filtro de conector.
2. Puede especificar un límite de registros en el cuadro Especificar límite de registros. Como alternativa, puede dejar el límite de registros como el Todos predeterminado si desea que todos los registros se exporten en un solo push.
   Consejo Q: El límite de registros es un límite por ejecución de la tarea. Si lo fija en 1.000, el job se ejecutará en la programación que fije y se detendrá después de exportar 1.000 registros. Si lo fija en diario, significa que se ejecutará una vez al día y obtendrá hasta 1.000 registros exportados para cada día.
   Consejo Q: Para los datos conversacionales, el límite se aplica en función de las conversaciones en lugar de las filas.
3. Haga clic en Siguiente.

Paso 9: Configuración de notificación (opcional)

1. En la página Configuración de notificación, puede seleccionar las notificaciones que los examinadores de un trabajo deben recibir si se produce alguno de los eventos enumerados a continuación.
   • Se exportan cero registros.
   • Se han encontrado valores que faltan consecutivos.
   • Se ha producido un error en la ejecución de un job.
   • Una ejecución de job tiene éxito parcialmente.
   • Un job finaliza con un timeout.
   • Se produce un error en un job.
     Consejo Q: Puede seleccionar cualquier combinación de notificaciones o decidir no elegir ninguna. En este caso, las vigilancias de un job no reciben ninguna notificación. Para obtener más información sobre las opciones de configuración de notificaciones, consulte Notificaciones de job.
     Consejo Q: El tiempo de espera predeterminado para los jobs de conector de salida de archivos es de 48 horas.
2. Haga clic en Siguiente.

Paso 10: Configurar opciones adicionales para el job

1. En la página Configurar opciones adicionales para job, en la sección Programar job histórico/incremental, seleccione una de las siguientes opciones:
   • Programar ejecuciones incrementales para configurar una programación para exportaciones de datos incrementales.
     Consejo Q: Las tareas del conector de salida de archivos fijadas en Cargar registros nuevos y actualizados o Cargar registros actualizados solo se pueden programar para que se ejecuten con una frecuencia semanal o mensual.
     Consejo Q: Utilice la opción Crear trabajo, pero no extraer datos si desea validar el trabajo y su configuración antes de exportar los datos. Para obtener más información sobre la programación de ejecuciones incrementales, consulte Programación de jobs.
   • Configure Pull único para realizar una exportación de datos única.
     Consejo Q: Puede modificar las opciones de programación más tarde; consulte Recuperación de datos para ejecuciones únicas y Programación de tareas para ejecuciones regulares.
2. En la sección Datos incrementales adicionales, puede especificar cuántos datos adicionales (en días u horas) se deben extraer durante una ejecución incremental para garantizar que todos los datos históricos relevantes estén disponibles para la transferencia de salida (opcional).
   Consejo Q: El valor máximo para este campo es de 30 días.
3. Haga clic en Siguiente.

Paso 11: Confirmar todas las opciones de job

1. En la página Confirmar todas las opciones de job, puede ver un resumen de todas las opciones de una tarea y editar las opciones, si es necesario, antes de ejecutar la exportación de datos. Para ejecutar la exportación de datos, haga clic en el botón Finalizar cuando esté listo para ejecutar la exportación de datos. Aparecerá un mensaje de confirmación que confirmará que el job se ha enviado correctamente.
2. Al hacer clic en Finalizar, sucede lo siguiente: Las exportaciones únicas se ejecutan inmediatamente. A menos que haya activado la opción “Crear job pero no extraer datos”, las exportaciones programadas se ejecutan inmediatamente y, a continuación, se configuran para que se ejecuten según la programación que ha definido.

Para obtener más información sobre los jobs de supervisión, consulte Resumen de página de jobs.

Añadir nuevas credenciales SFTP

1. Seleccione Añadir nuevo.
2. Introduzca el nombre del nuevo conjunto de credenciales en el cuadro NOMBRE DE CONEXIÓN.
   
3. Introduzca el nombre de usuario de SFTP en el cuadro NOMBRE DE USUARIO DE SFTP.
4. Introduzca la contraseña de SFTP en el cuadro CONTRASEÑA DE SFTP.
5. Introduzca la dirección del servidor SFTP en el cuadro HOST SFTP.
6. Introduzca el puerto SFTP en el cuadro PUERTO SFTP.
   Consejo Q: El puerto predeterminado es 22.
7. Puede fijar sus credenciales para que caduquen después de un período de tiempo determinado (opcional). Para definir una fecha de vencimiento para este conjunto de credenciales y establecer un recordatorio para todos los examinadores de trabajos, marque la casilla de selección Enviar notificaciones de expiración. Esto activa la casilla Días antes del vencimiento.
8. Introduzca un valor en el cuadro Días antes del vencimiento para establecer cuántos días antes del vencimiento deben comenzar las notificaciones. Los valores posibles van de 1 a 100 días.
   Consejo Q: Este recordatorio se desencadena cada vez que el job se ejecuta una vez que la fecha de vencimiento es inferior al número de días establecido en el cuadro Días antes del vencimiento.
9. Seleccione la Fecha de vencimiento del selector de fecha de calendario. La fecha de vencimiento se agregará a la casilla Fecha de vencimiento.