Conector de salida de Qualtrics

Acerca del conector saliente de Qualtrics

Puede utilizar el conector de salida de Qualtrics para realizar las tareas que se enumeran a continuación.

• Actualice las encuestas de Qualtrics existentes con enriquecimientos de XM Discover.
• Envíe datos de exportación de XM Discover a Qualtrics a través de un evento JSON para desencadenar un flujo de trabajo de Qualtrics.

Póngase en contacto con su equipo de cuentas de Qualtrics si necesita orientación adicional.

ANTES DE COMENZAR

Requisitos previos:

Antes de configurar una tarea con el conector de salida de Qualtrics, asegúrese de que se cumplen las condiciones enumeradas a continuación.

• Los campos de datos para los enriquecimientos de XM Discover deben formar parte del registro de la encuesta de Qualtrics.
  Consejo Q: Para obtener más información sobre cómo añadir campos de datos para enriquecimientos de XM Discover a sus encuestas, consulte Datos embebidos.
• Los documentos de XM Discover deben contener un campo de datos con ID de encuesta cuando utilice el tipo de conector de salida de encuesta.

Credenciales necesarias:

Necesitará la siguiente información relacionada con sus cuentas de Qualtrics y XM Discover:

• Su dirección de instancia de Qualtrics.
• Su token de API de Qualtrics.
• Su punto final de la API de XM Discover Export.

CONFIGURACIÓN DE LA CONEXIÓN

1. Inicie sesión en Conectores.
2. Haga clic en el botón Nuevo trabajo en la esquina superior derecha de la página Trabajos.
3. En la página Conectores, vaya a la sección SELECCIONAR UNA FUENTE.
4. Haga clic en el botón Salida de Qualtrics.

Configuración de un trabajo de conector de salida de Qualtrics

Después de configurar la conexión, siga los pasos siguientes para configurar una tarea.

• Paso 1: Proporcionar nombre de job
• Paso 2: Especificar proyecto y descripción
• Paso 3: Seleccionar tipo de datos de Qualtrics
• Paso 4: Proporcionar credenciales de Qualtrics
• Paso 5: Configurar las credenciales de exportación de XM Discover
• Paso 6: Configuración de consulta
• Paso 7: Seleccionar encuesta para configuración (solo para tipo de datos SURVEY) -OR- Especifique el punto final de evento JSON (solo para tipo de datos JSON EVENTdata)
• Paso 8: Configuración de consulta de salida
• Paso 9: Asignar campos deseados a Qualtrics
• Paso 10: Especificar filtro (opcional) y límite de registros
• Paso 11: Configuración de notificación (opcional)
• Paso 12: Configurar opciones adicionales para el trabajo
• Paso 13: Confirmar todas las parametrizaciones de job

Paso 1: Proporcionar nombre de job

1. Introduzca un nombre de trabajo reconocible en el cuadro Nombre de trabajo en la parte superior izquierda de la página.
   Atención: El nombre que introduzca en el cuadro Nombre de job se añadirá a todos los documentos cargados mediante este job como un valor codificado para el atributo job_name.
   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 proyecto y descripción

1. En la página Especificar proyecto y descripción, seleccione un proyecto desde el que cargar datos desde el menú desplegable de proyectos.
   Consejo Q: Tiene la opción de introducir una nota sobre el trabajo en el cuadro Descripción del puesto. La descripción del trabajo que introduce en el cuadro Descripción del trabajo solo es accesible en la lista Conectores y no se carga como parte de los datos de un trabajo.
2. Haga clic en Siguiente.

Paso 3: Seleccionar tipo de datos de Qualtrics

1. En la página Seleccionar tipo de datos de Qualtrics, seleccione uno de los siguientes tipos de datos para cargar.
   • Encuesta: Seleccione este tipo de datos para actualizar las encuestas de Qualtrics existentes con enriquecimientos de XM Discover.
   • Evento JSON: seleccione este tipo de datos para enviar datos de exportación de XM Discover a Qualtrics a través de un evento JSON para desencadenar una tarea de automatización xFlow mediante enriquecimientos de XM Discover de cualquier fuente de datos.
     Consejo Q: Para obtener más información, consulte Evento JSON.
2. Haga clic en Siguiente.

Paso 4: Proporcionar credenciales de Qualtrics

En la página Proporcionar credenciales de Qualtrics, puede seleccionar un conjunto existente de credenciales del menú desplegable o añadir un nuevo conjunto de credenciales.

1. Para añadir un nuevo conjunto de credenciales, seleccione Añadir Nuevo en el menú desplegable de credenciales e introduzca los parámetros de conexión enumerados en la siguiente tabla en los cuadros correspondientes.
2. Introduzca el nombre del nuevo conjunto de credenciales en el cuadro NOMBRE DE CONEXIÓN.
3. Proporcione el token de API conectado a su cuenta de Qualtrics en el cuadro TOKEN DE API QUALTRICS OUTBOUND.
4. Introduzca la dirección de la instancia de Qualtrics en el cuadro QUALTRICS OUTBOUND DATACENTER ID.
5. Puede configurar sus credenciales para que caduquen después de un período de tiempo determinado (opcional).
6. Para definir una fecha de expiración para este conjunto de credenciales y establecer un recordatorio para todos los examinadores de tareas, marque la casilla de selección Enviar notificaciones de expiración. Esto habilita la casilla Días antes del vencimiento.
7. Introduzca un valor en la casilla Días antes de la expiración para establecer cuántos días antes de la expiración deben iniciarse las notificaciones. Los valores posibles van de 1 a 100 días.
   Consejo Q: Este recordatorio se desencadena cada vez que el trabajo se ejecuta una vez que la fecha de expiración es inferior al número de días establecido en la casilla Días antes de la expiración.
8. Seleccione la Fecha de vencimiento en el selector de fechas de calendario. La fecha de vencimiento se añadirá a la casilla Fecha de vencimiento.
9. Haga clic en Siguiente.

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

1. En la página Configurar credenciales de exportación de XM Discover, proporcione su punto final de la API de exportación de XM Discover en el cuadro HOST.
2. Haga clic en Siguiente.

Paso 6: Configuración de consulta

En la página Configuración de consulta, puede especificar qué datos utilizar para actualizar encuestas de Qualtrics (si ha seleccionado ENCUESTA como tipo de datos) o enviarlos a Qualtrics a través de un evento JSON (si ha seleccionado EVENTO JSON como tipo de datos).

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:
   • Sentencias: Utilice datos a nivel de oración.
   • Documentos: Utilizar datos a nivel de documento.
2. Proporcione una consulta para filtrar los datos de salida en el cuadro Introducir la consulta(opcional). Utilice la misma sintaxis utilizada para buscar datos en Designer.
   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 Introduzca el nombre de filtro(opcional).
4. Para actualizar los registros que se crearon desde la última vez que se ejecutó el job de salida, seleccione Por defecto: Cargar nuevos registros en Seleccionar qué registros desea recuperar. Para actualizar los registros que se crearon o actualizaron desde la última vez que se ejecutó el job de salida, seleccione Cargar registros nuevos y actualizados. Para actualizar solo los registros que se actualizaron desde la última vez que se ejecutó el job de salida, seleccione Cargar registros actualizados.
   Consejo Q: 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 incluirlos en los datos de salida desde el 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.
   • Actualmente clasificado: Devuelve las oraciones/documentos que fueron clasificados por los modelos seleccionados durante la ejecución de clasificación más reciente.
   • Ever Classified: Devuelve las oraciones/documentos que han sido clasificados por los modelos seleccionados en cualquier momento.
7. Marque la casilla de selección Devolver 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 una consulta de filtro con todas las rutas de nodos finales para añadir varios modelos con el parámetro “indicador solo hoja” a la llamada API de exportación (opcional).
9. Seleccione Ignorar valores vacíos si desea que el conector omita la actualización de un documento de encuesta si todos sus valores de salida están vacíos (opcional).
10. Haga clic en Siguiente.

Paso 7: Seleccionar encuesta para configuración -OR- Especificar el punto final del evento JSON

SELECCIONAR ENCUESTA PARA CONFIGURACIÓN

1. Seleccione una de las encuestas de Qualtrics disponibles para actualizar.
   Consejo Q: Si no ve la encuesta que está buscando, asegúrese de que se comparte con la cuenta que generó la clave API desde el entorno de Qualtrics.
2. Haga clic en Siguiente.

ESPECIFICAR EL ENDPOINT DEL EVENTO JSON

1. Especifique la URL de punto de acceso del evento JSON para enviar los datos de exportación de XM Discover a Qualtrics a través de un evento JSON.
2. Consejo Q: Para obtener más información sobre la configuración de un evento JSON, consulte Evento JSON.
3. Haga clic en Siguiente.

Paso 8: Configuración de consulta de salida

1. Seleccione el atributo del proyecto XM Discover que almacena el ID de encuesta de Qualtrics.
   Consejo Q: Solo se actualizarán los documentos con ID de encuesta que coincidan con la encuesta seleccionada en el paso anterior.
2. Haga clic en Siguiente.

Paso 9: Asignar campos deseados a XM Discover

En la página Asignar campos deseados a XM Discover, puede asignar atributos de XM Discover y resultados de clasificación a campos de datos embebidos definidos en Qualtrics.

1. Haga clic en el cuadro de campo personalizado vacío y seleccione el campo XM Discover que desea añadir a una encuesta en Qualtrics.
2. Seleccione el tipo de datos de un campo incrustado correspondiente creado en XM Engage en el menú desplegable Tipo de datos.
3. Introduzca el nombre del campo incrustado en XM Engage que debe rellenarse con los valores del campo XM Discover seleccionado en el cuadro Nombre de atributo.
4. Haga clic en el icono del signo más (+) para añadir más campos personalizados y asignarlos a campos incrustados de Qualtrics, si es necesario.
5. Haga clic en Siguiente.

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

1. En la página Especificar filtro, puede definir una condición de filtro para que un job cargue solo registros que lo cumplan (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 valor predeterminado Todos si desea que todos los registros se devuelvan en un solo push.
   Consejo Q: El límite de registros es un límite por ejecución del trabajo. Si lo fija en 1.000, el job se ejecutará en la programación que fije y se detendrá después de extraer 1.000 registros. Si lo fija en diario, significa que se ejecutará una vez al día y obtendrá hasta 1.000 registros por 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 11: Configuración de notificación (opcional)

1. En la página Configuración de notificación, puede seleccionar las notificaciones que deben recibir los examinadores de un trabajo si se produce alguno de los eventos enumerados a continuación.
   • Se cargan registros cero en el proyecto.
   • Se han encontrado valores faltantes consecutivos.
   • Se produce un error en la ejecución de un job.
   • Una ejecución de trabajo parcialmente se realiza correctamente.
   • 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 trabajo no reciben ninguna notificación.
     Consejo Q: Para obtener más información sobre los ajustes de configuración de notificaciones, consulte Notificaciones de tareas.
2. Haga clic en Siguiente.

Paso 12: Configurar opciones adicionales para el trabajo

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 extracciones de datos incrementales.
     Consejo Q: Utilice la opción Crear tarea pero no extraer datos si desea validar la tarea y su configuración antes de que se actualicen los datos. Para obtener más información sobre la programación de ejecuciones incrementales, consulte Programación de tareas.
   • Configurar pull único para realizar una extracción de datos única.
     Consejo Q: Puede modificar las opciones de programación más tarde; consulte Recuperación de datos para obtener más información sobre las ejecuciones únicas y Programación de jobs para obtener más información sobre las ejecuciones regulares.
2. En la sección Datos incrementales adicionales, puede especificar cuántos datos adicionales (en días u horas) se deben obtener 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 30 días.
3. Haga clic en Siguiente.

Paso 13: Confirmar todas las parametrizaciones de job

1. En la página Confirmar todas las opciones de trabajo, puede ver un resumen de todas las opciones de un trabajo y editar las opciones, si es necesario, antes de ejecutar la carga de datos. Para ejecutar la carga de datos, haga clic en el botón Finalizar cuando esté listo para ejecutar la carga de datos. Se mostrará un mensaje de confirmación confirmando que el trabajo se envió correctamente.
2. Al hacer clic en Finalizar, sucede lo siguiente: Los pulls únicos se ejecutan inmediatamente. A menos que habilite la opción “Crear tarea pero no extraer datos”, las extracciones programadas se ejecutan inmediatamente y, a continuación, se configuran para que se ejecuten según la programación

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