Élément attribute

Spécifie une colonne d’un élément entity ou link-entity à renvoyer avec une requête.

Découvrez comment sélectionner des colonnes à l’aide de FetchXml.

Exemple

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <link-entity name='contact'
      from='contactid'
      to='primarycontactid'
      link-type='inner'
      alias='contact'>
      <attribute name='fullname' />
    </link-entity>
  </entity>
</fetch>

Attributs

Nom	Obligatoire ?	Description
aggregate	Non	La fonction d’agrégation à appliquer. Découvrez comment agréger des données avec FetchXml
alias	Non	Le nom de la colonne à renvoyer. Chaque colonne doit avoir un nom unique. Vous utiliserez des alias lorsque vous récupérerez des valeurs agrégées. En savoir plus sur les alias de colonne.
dategrouping	Non	Lorsque vous regroupez des données par valeur de date et d’heure, cet attribut spécifie la partie de la date à utiliser. Consultez Options de regroupement de dates
distinct	Non	Lorsque vous utilisez la fonction d’agrégation countcolumn, cet attribut spécifie que seules les valeurs uniques de la colonne sont renvoyées. En savoir plus sur les valeurs de colonnes distinctes.
groupby	Non	Lorsque vous regroupez des données, cet attribut spécifie la colonne à utiliser pour regrouper les données. En savoir plus sur le regroupement.
name	Oui	Nom logique de la colonne.
rowaggregate	Non	Lorsque cette valeur est définie sur CountChildren, une valeur incluant le nombre total d’enregistrements enfants pour l’enregistrement est incluse dans les résultats. Découvrez comment utiliser cet attribut.
usertimezone	Non	Utilisé par les requêtes agrégées qui regroupent en fonction des colonnes de date et d’heure. Spécifie que le regroupement utilise le fuseau horaire de l’utilisateur ; sinon, UTC est utilisé. Selon le fuseau horaire, la même valeur de date et d’heure peut correspondre à des jours différents. En savoir plus sur le regroupement en fonction des parties d’une date

Éléments parents

Nom	Description
entity	Spécifie l’élément enfant d’un élément fetch, l’entité parente de la requête. Une seule entité est autorisée.
link-entity	Joint une table liée à l’élément entity ou link-entity pour renvoyer des colonnes supplémentaires avec le résultat. Également utilisé avec les éléments de filtre pour appliquer des conditions aux valeurs de colonne dans les tables associées.

Fonctions d’agrégation

Utilisez ces fonctions d’agrégation. Découvrez comment agréger des données avec FetchXml

Fonction	Valeur renvoyée
avg	La valeur moyenne des valeurs de la colonne avec des données.
count	Le nombre de lignes.
countcolumn	Le nombre de lignes avec des données dans cette colonne.
max	La valeur maximale des lignes dans cette colonne.
min	La valeur minimale des lignes dans cette colonne.
sum	La valeur totale des valeurs de la colonne avec des données.

Options de regroupement de dates

En savoir plus sur le regroupement en fonction des parties d’une date

active	Description
day	Regrouper par jour du mois
week	Regrouper par semaine de l’année
month	Regrouper par mois de l’année
quarter	Regrouper par trimestre de l’exercice
year	Regrouper par année
fiscal-period	Regrouper par période de l’exercice
fiscal-year	Regrouper par exercice

En savoir plus sur les paramètres de l’exercice

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é).