Partager via

É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. 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

Utilisez cet attribut avec une valeur false pour forcer le regroupement à utiliser la valeur UTC. Lorsque vous ne définissez pas cet attribut, la valeur par défaut est true et le fuseau horaire de l’utilisateur est utilisé.

Remarque : avec QueryExpression, le regroupement utilise toujours UTC. Lors de l’utilisation de la classe FetchXmlToQueryExpressionRequest du Kit de développement logiciel (SDK), ce paramètre est perdu. Il n’est pas possible de définir ce paramètre à l’aide de QueryExpression.

É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

Function 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

Valeur 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

  • Last updated on