Share via


Buscar datos usando búsquedas de entidades en Servicios unificados

 

Publicado: noviembre de 2016

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Las búsquedas de entidades son definiciones FetchXML que consultan los servicios web de Microsoft Dynamics 365 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 Dynamics 365 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 > Servicios unificados > Búsquedas de entidades) en Dynamics 365. 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 Dynamics 365.Más información:Reutilizar la definición de búsqueda de entidad en el código personalizado

Ver también

Reutilizar la definición de búsqueda de entidad en el código personalizado
Utilizar reglas de navegación de ventanas en Servicios unificados
Llamadas a la acción
Aprenda a usar Servicios unificados
Tutorial: Uso del adaptador de escucha genérico para enrutamiento de eventos de CTI

Unified Service Desk 2.0

© 2017 Microsoft. Todos los derechos reservados. Copyright