Plantilla de artículo

Acerca de los servicios web

A veces es posible que desees incluir características más complejas en tu encuesta. Tal vez desee incluir los 10 titulares principales de un sitio web de noticias en su encuesta , o desee automatizar la distribución de una segunda encuesta para enviarla por correo electrónico a los encuestados de una primera encuesta exactamente 2 horas después. A Servicio web Le permitiría hacer exactamente eso realizando solicitudes a una URL designada.

Agregar un servicio web

1. Mientras edita su encuesta, haga clic en el Flujo de la encuesta icono en la barra de navegación izquierda.
   
2. Hacer clic Agregar a continuación o Añade un nuevo elemento aquí.
   
3. Seleccionar Servicio web.
4. En el URL En el campo, pegue la URL de su servicio web externo.
   
   Consejo Q: Puedes utilizar texto dinámico para pasar información de la encuesta a la URL de su punto final a través de cadenas de consulta.
5. Seleccione una Método para su servicio web. Explicaremos más sobre los diferentes métodos en la siguiente sección.

Métodos

Nuestra función de servicio web le permite elegir entre una serie de Métodos para solicitar información de la URL especificada.

Si está utilizando nuestras llamadas API , el documentación Le indicará qué método utilizar, como se indica en la captura de pantalla a continuación.

Parámetros

Actualmente existen 3 tipos de Parámetros Puedes adjuntarlo a tu solicitud.

1. Parámetro de consulta:En lugar de agregar un cadena de consulta Al final de la URL de su servicio web, coloque aquí los parámetros de consulta.
2. Parámetros corporales:Este parámetro no está disponible para solicitudes GET o DELETE. Viene con 2 opciones de formato:
   a) aplicación/x-www-form-urlencoded:En lugar de ingresar los parámetros de su cuerpo en el área especificada del servicio web, agréguelos como un cadena de consulta al final de la URL especificada.
   b) aplicación/ json:Ingrese sus claves en notación de puntos. Por ejemplo, nuestra llamada API puede solicitarle que especifique un encabezado [fromEmail]. En notación de puntos, esto se convierte en header.fromEmail.
   Atención: Cada clave y valor en un objeto JSON , así como cada elemento en una matriz JSON (incluido el texto dinámico), debe tener comillas dobles alrededor.
3. Encabezado personalizado: Inserte los encabezados de URL aquí.
   Consejo Q:Las URL de autenticación deben agregarse al encabezado personalizado.

Si está utilizando nuestras llamadas API , el documentación Le dirá qué tipo de parámetros incluir. El siguiente ejemplo proporciona parámetros de cuerpo para configurar.

Cómo agregar parámetros a su servicio web

1. Seleccione cualquiera de los 3 Agregar un parámetro para enviar al servicio web opciones indicadas en el apartado anterior. En el ejemplo anterior, estamos indicando los parámetros de consulta.
2. Escriba el nombre del parámetro en el Parámetros del servicio web caja de la izquierda.
3. Escriba el valor correspondiente del parámetro en el Valor Caja a la derecha.
4. Haga clic en el signo más (+) signo a la derecha del parámetro para agregar otro.
5. Hacer clic Aplicar Cuando termine.

Poniendo a prueba tus parámetros

Una vez que haya pegado su URL y configurado sus parámetros, puede probar su URL para ver qué campos puede extraer.

1. Hacer clic URL de prueba para ver qué información puedes extraer del servicio web externo.
   
2. Seleccione cualquier campo que desee utilizar o registrar en su encuesta. El nombre del campo aparece a la izquierda y el valor de ejemplo correspondiente aparece a la derecha.
   
3. Hacer clic Agregar datos integrados para agregar campos seleccionados a sus datos.
   Consejo Q:Puede cambiar los nombres de los datos embebidos asociados con los campos de su servicio web en Establecer datos incrustados columna. Los nombres de los datos embebidos están a la izquierda del signo igual (=) señal, indicada por un color verde Depresión icono. El lado derecho no debe alterarse. Los nombres que configure a la izquierda serán los nombres de los campos tal como aparecen en sus datos.
4. Si seleccionas Dispara y olvida, No guardará ninguno de los datos devueltos por la llamada al servicio web. Esta función es útil cuando no necesita guardar los datos devueltos.
   
   Consejo Q:Fire and Forget permite que su encuesta realice una solicitud a un servicio web sin esperar una respuesta. Esto significa que sus encuestados podrán completar la encuesta completa sin demora gracias al servicio web. Es posible que desee utilizar esta opción si tiene una solicitud de servicio web que tarda un tiempo en procesarse, pero le recomendamos que solo utilice esta función durante las pruebas, ya que evitará que se guarden los datos embebidos .
5. Cuando haya terminado, haga clic en Aplicar.

Corrección de errores de TLS

A partir del 1 de septiembre de 2021, las solicitudes de servicios web con errores de seguridad de la capa de transporte (TLS) fallarán. TLS es lo que hace que las solicitudes web a través de HTTPS (a diferencia de HTTP simple) sean seguras, evitando que los datos de la solicitud sean visibles para terceros y garantizando que la solicitud se envíe al destino correcto. Ignorar los errores de TLS elimina efectivamente estos beneficios de seguridad; este cambio es un paso importante en nuestros esfuerzos continuos por mejorar la seguridad de la plataforma Qualtrics .

Para resolver cada error de TLS , debe realizar una de las siguientes acciones:

• Corrija el error TLS . Debido a la naturaleza de los errores de TLS , nuestro equipo de soporte no puede brindar orientación específica sobre cómo hacerlo, pero su administrador de red sabrá cómo solucionar el error.
• Cambie la solicitud de servicio web del elemento de flujo para que se realice a través de HTTP, no de HTTPS. Por ejemplo, podría cambiar la URL “https://example.com” a “http://example.com”. Si decide adoptar este enfoque, también debe asegurarse de que la URL HTTP no redirija a la URL HTTPS.
  Atención: Tenga en cuenta que este enfoque hará que los datos de la solicitud del servicio web se transmitan sin cifrar.

Puede verificar que su elemento de servicio web esté listo para este cambio utilizando el botón de prueba siguiente al campo URL en el elemento de flujo. La visualización de los datos sin procesar en la ventana resultante, que también se muestra a continuación, no debería mostrar ningún error.

Tipos de proyectos en los que está disponible esta función

Siempre que tenga acceso a los servicios web como parte de su licencia, puede agregar un servicio web al flujo de la encuesta de cualquier tipo de proyecto. Esto incluye lo siguiente:

• Proyectos de encuesta
• Compromiso
• 360
• Ciclo de vida
• Investigación de la experiencia de empleado ad hoc
• Pulso
• Soluciones XM
• Conjuntos
• MaxDiff