Configuración del atributo de búsqueda de servicios web

Este artículo contiene los siguientes temas:

Como administrador, se puede configurar el atributo de búsqueda de servicios web. Se puede configurar el atributo para recuperar la información desde un sistema externo y mostrarla en el ticket. Por ejemplo, se pueden rellenar los campos del ticket con la información de hardware como, por ejemplo, la fecha de compra y los datos de la garantía que se almacenan en una herramienta de CMDB.

Requisitos previos

Antes de configurar el atributo de búsqueda de servicios web, asegúrese de que se hayan completado las siguientes tareas de los requisitos previos:

Activación de la invocación del servicio web
Seleccione el tipo de ticket al que se asocia el atributo de búsqueda de servicios web.

Consideraciones

Se configuran dos operaciones de servicios web:
- Una que devuelve varios registros. Podemos llamarla la operación del servicio web de lista. Asigne la operación del servicio web de lista con el campo del servicio web de lista en el atributo. Configure esta operación del servicio web para aceptar uno de los parámetros de entrada como cadena de búsqueda. Los parámetros se asignan más tarde a la búsqueda de servicios web.
- Una que devuelve un solo registro. Podemos llamarla operación del servicio web de detalles. Asigne la operación del servicio web de detalles con el campo del servicio web de detalles. Los parámetros de entrada para esta llamada del servicio web pueden asignarse a uno o más campos que se rellenan en el servicio web de lista.
Configure las operaciones del servicio web de lista y del servicio web de detalles, que estén relacionadas entre sí.
Nota: Para obtener más información sobre cómo configurar credenciales del servicio web y operaciones del servicio web, consulte Configuración de servicios web salientes.
La operación del servicio web de lista recupera los registros que se basan en la cadena de búsqueda que se proporciona en la búsqueda.
Si la operación del servicio web de detalles devuelve varios campos, se muestra solo el primer registro del resultado.
Cuando se configura la asignación de entrada para los servicios web, se pueden asignar hasta diez Campos de entidad. Los campos de muestra proporcionan información adicional como referencia, pero no se guardan en el ticket. Los campos de muestra aparecen en el campo personalizado de la búsqueda de servicios web.
Cuando se asigna un atributo de tipo DateTime, los valores solo aparecerán aparecen en el ticket con fines de referencia. Los valores no se guardan en el ticket.
Se puede configurar el atributo de búsqueda de servicio web solo para las llamadas a servicios web SOAP y no para llamadas a servicios web RESTful.
Se pueden introducir hasta 4000 caracteres como cadena de búsqueda en el campo de búsqueda de un ticket.
La cadena de búsqueda que se introduce en la búsqueda no se conserva en el ticket. Cuando se selecciona un registro de los resultados de la búsqueda, la información relacionada aparece en los campos asignados del ticket.
Los campos asignados del ticket pueden mostrar hasta 4000 caracteres de los valores que se devuelven desde la búsqueda del servicio web.

Configuración del atributo de búsqueda de servicios web

Se puede configurar el tipo de atributo Búsqueda de servicios web tal y como se hace con cualquier otro atributo.

Para obtener más información sobre la creación de atributos, consulte Creación y gestión de atributos.

Configuración de campos personalizados con el atributo de búsqueda de servicios web

Se puede asociar el atributo Búsqueda de servicios web a una plantilla de campos personalizados y se puede visualizar en un ticket. Cuando se busca en el campo personalizado de un ticket, la información recuperada desde los servicios web se muestra en una ventana emergente. Se pueden configurar los dos campos siguientes para el campo personalizado de la búsqueda de servicios web:

Lista de servicios web: el servicio ayuda a recuperar los registros y a que se muestren en una cuadrícula en la ventana emergente. Se puede rellenar el ticket con los campos asignados desde la Lista de servicios web.
Detalles del servicio web (opcional): el servicio ayuda a recuperar información de todos los registros recuperados por la Lista de servicios web. El ticket no se rellena con la información que se recupera en Detalles del servicio web.

Nota: solo se muestran en el campo personalizado los primeros 25 registros que se recuperan desde el sistema externo.

Para obtener más información sobre la creación de plantillas de campos personalizados, consulte Creación y gestión de las plantillas de campos personalizados.

Asignación de campos personalizados con los servicios web

Después de haber creado los campos personalizados, asígnelos a ambos servicios web. Se puede seguir este ejemplo para asignar los campos personalizados.

Si la respuesta del servicio web es como se muestra en este ejemplo:

Code Block

<result>
       <record>
              <attribute1>value</attribute1>
              <attribute2>value</attribute2>
              <attribute3>value</attribute3>
              <attribute4>value</attribute4>
       </record>
       …
       …
       <record>
       …
       …
       </record>
</result>

Entonces las asignaciones de campos tanto para los campos de muestra como para los campos del ticket de ambos servicios web señalan a los atributos obligatorios.

Campo de muestra 1: /result/record/attribute1
Campo personalizado/del ticket: /result/record/attribute3
Consulte las notaciones de XPath estándar para obtener más detalles.

Nota: Para pasar la cadena de búsqueda a la Lista de servicios web, asigne el atributo de búsqueda de servicios web al parámetro de servicio web necesario.

Prácticas recomendables para configurar los atributos de búsqueda de servicios web

Para validar la operación del servicio web que se crea para una lista de servicios web, utilice un ticket ficticio. Cuando se utiliza un ticket para validar la operación del servicio web, el ticket se actualiza con la información asignada. No utilice un ticket válido para este fin.
Agregue los campos de ticket personalizados y asignados bajo un encabezado de la sección individual. Los usuarios pueden detectar fácilmente los valores asignados del servicio web cuando aparecen en una sección individual.