Partager via

retrieveRecord

  • Article

Récupère un enregistrement de table.

Disponible pour

Applications pilotées par modèle et portails.

Syntaxe

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

Paramètres

Nom Type Obligatoire Description
entityLogicalName String Oui Nom logique de la table de l’enregistrement à récupérer. Par exemple : "compte".
ID String Oui GUID de l’enregistrement de table à extraire.
options String 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. Limiter les colonnes que vous récupérez est une pratique recommandée importante en matière de performances. Si des propriétés ne sont pas spécifiées à l’aide de $select, toutes les propriétés sont renvoyées.
  • Utilisez l’option de requête système $expand pour contrôler quelles données des tables associées sont renvoyées. Si vous incluez uniquement 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 Function Non

Fonction à appeler lorsqu’un enregistrement est récupéré. Un objet JSON avec les propriétés récupérées et les valeurs sera transmis pour identifier la fonction.
errorCallback Fonction Non Fonction à appeler lorsque l’opération échoue.

Valeur renvoyée

Type : Promesse<Entity>

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

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).