Partager via


retrieveRecord

Récupère un enregistrement de table.

Disponible pour

Applications et portails pilotés par modèle.

Syntaxe

context.webAPI.retrieveRecord(entityLogicalName, id, options).then(successCallback, errorCallback);

Paramètres

Nom Type Obligatoire Descriptif
entityLogicalName Chaîne Oui Nom logique de la table de l’enregistrement à récupérer. Par exemple : « compte ».
pièce d'identité Chaîne Oui GUID de l’enregistrement de table à récupérer.
options Chaîne Non

Options de requête système OData, $select et $expand, pour récupérer vos données.

  • Utilisez l’option de requête système $select pour limiter les propriétés retournées en incluant une liste de noms de propriété séparés par des virgules. La limitation des colonnes que vous récupérez est une bonne pratique importante en matière de performances. Si les propriétés ne sont pas spécifiées à l’aide de $select, toutes les propriétés sont retournées.
  • Utilisez l’option de requête système $expand pour contrôler les données des tables associées retournées. Si vous incluez simplement le nom de la propriété de navigation, vous recevrez toutes les propriétés des enregistrements associés. Vous pouvez limiter les propriétés retournées pour les enregistrements associés à l’aide de l’option de requête système $select entre parenthèses après le nom de propriété de navigation. Utilisez cette procédure pour les propriétés de navigation à valeur unique et avec valeur de collection.

Vous spécifiez les options de requête à partir de ?. Vous pouvez également spécifier plusieurs options de requête système en utilisant & pour séparer les options de requête. Par exemple:

?$select=name&$expand=primarycontactid($select=contactid,fullname)
successCallback Fonction Non

Fonction à appeler lorsqu’un enregistrement est récupéré. Un objet JSON avec les propriétés et valeurs récupérées est transmis à la fonction.

errorCallback Fonction Non Fonction à appeler lorsque l’opération échoue.

Valeur de retour

Type :Entitépromise<>

API web
Référence d’API Power Apps component framework
Vue d'ensemble de Power Apps component framework