retrieveRecord (Referencia de API JavaScript) para Marco de integración de canal de Dynamics 365 1.0

Recupera un registro de entidad.

Sintaxis

Microsoft.CIFramework.retrieveRecord(entityLogicalName, id, options).then(successCallback, errorCallback);

Parámetros

Name	Type	Obligatorio	Descripción
entityLogicalName	Cadena	Sí	El nombre lógico de la entidad del registro que desea recuperar. Por ejemplo: "cuenta".
id.	Cadena	Sí	GUID del registro de entidad que desea recuperar.
opciones	Cadena	No	Opciones de consulta del sistema OData, $select y $expand, para recuperar los datos. Use la opción de consulta del sistema $select para limitar las propiedades devueltas incluyendo una lista separada por comas de nombres de propiedad. Esta es una práctica recomendada importante de rendimiento. Si las propiedades no se especifican con $select, se devolverán todas las propiedades. Use la opción de consulta del sistema $expand para controlar qué datos de entidades relacionadas se devuelven. Si incluye solo el nombre de la propiedad de navegación, recibirá todas las propiedades de registros relacionados. Puede limitar las propiedades devueltas para registros relacionados con la opción de la consulta del sistema $select entre paréntesis después del nombre de propiedad de navegación. Use esta opción para las propiedades de navegación de un solo valor y valoradas como colección. Especifique las opciones de consulta comenzando con ?. Puede especificar también varias opciones de consulta usando & para separar las opciones de consulta. Por ejemplo: ?$select=name&$expand=primarycontactid($select=contactid,fullname)
successCallback	Función	No	Una función para llamar cuando se recupera un registro.
errorCallback	Función	No	Una función para llamar cuando la operación tiene error.

Valor de retorno

En caso de resultar correcto, devuelve una promesa que contiene una cadena con los atributos recuperados y sus valores.

Ejemplos

Este código de ejemplo recupera el nombre y el número de teléfono de un registro de contacto con ID = a8a19cdd-88df-e311-b8e5-6c3be5a8b200.

// retrieve contact record
var id = "b44d31ac-5fd1-e811-8158-000d3af97055";
var entityLogicalName = "contact";
Microsoft.CIFramework.retrieveRecord(entityLogicalName, id, "?$select=fullname,telephone1").then(
    function success(result) {
      res=JSON.parse(result);
        console.log(`Retrieved values: Full Name: ${res.fullname}, Telephone Number: ${res.telephone1}`);
        // perform operations on record retrieval
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);