Share via


Buscar datos usando búsquedas de entidades en Unified Service Desk

Las búsquedas de entidades son definiciones FetchXML que consultan los servicios web de Microsoft Dataverse para devolver datos. También puede usar parámetros de sustitución dentro de las consultas FetchXML en una búsqueda de entidades. Las búsquedas de entidades pueden usarse en reglas de navegación de ventanas como origen para tener acceso a los datos que no se muestran en el formulario, y como destino para buscar los datos mediante una llamada de servicio web a Dataverse y, a continuación, rellenar los datos de contexto de Unified Service Desk para poder usarlos en parámetros de sustitución. También puede usar búsquedas de entidades en la acción DoSearch para que el control hospedado Administrador global busque los datos.

Defina una búsqueda de entidades en el área Búsquedas de entidades (Configuración>Unified Service Desk>Búsquedas de entidades) en Dataverse. Para definir una búsqueda de entidades deberá especificar tres cosas: un nombre, la entidad a la que se aplica la búsqueda y la consulta FetchXML que representa la consulta para recuperar datos del servidor.

La siguiente consulte FetchXML devuelve los detalles de nombre y dirección de una cuenta basada en un identificador de cliente disponible desde un caso:

<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">  
  <entity name="account">  
    <attribute name="name" />  
    <attribute name="emailaddress1" />  
    <attribute name="telephone1" />     
    <attribute name="address1_line1" />  
    <attribute name="address1_city" />  
    <attribute name="address1_stateorprovince" />  
    <attribute name="address1_postalcode" />  
   <attribute name="address1_country" />  
   <attribute name="msdyusd_facebook"/>  
   <attribute name="msdyusd_twitter"/>  
    <order attribute="name" descending="false" />  
    <filter type="and">  
      <condition attribute="accountid" operator="eq" value="{[[incident.customerid.Id]x]}" />  
    </filter>  
  </entity>  
</fetch>  

Este es el aspecto que tiene la definición de búsqueda de entidades:

Ejemplo de definición de búsqueda de entidad.

Importante

Cuando se definen consultas FetchXML en una búsqueda de entidades, solo debe devolver los campos requeridos para el propósito. Esto minimiza el impacto en la red limitando el tamaño de la solicitud y los datos que se devuelven, optimizando así el uso de recursos.

Los programadores también pueden reutilizar una definición de búsqueda de la entidad existente en el código para buscar registros en Dataverse. Más información: Reutilizar la definición de búsqueda de entidad en el código personalizado

Consulte también

Reutilizar la definición de búsqueda de entidad en el código personalizado
Utilizar reglas de navegación de ventanas en Unified Service Desk
Llamadas a la acción
Aprenda a configurar Unified Service Desk
Tutorial: uso del adaptador de escucha genérico para enrutamiento de eventos de CTI