Élément attribute

Article
08/05/2024

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`	No	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 SDK FetchXmlToQueryExpressionRequest, ce paramètre est perdu. Il n’y a aucun moyen de définir cela à 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

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

Partager via