element atribut

Especifica una columna d'una entitat o entitat d'enllaç que s'ha de retornar amb una consulta.

Obteniu informació sobre com podeu seleccionar columnes mitjançant 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>

Atributs

Nom	És obligatori?	Descripció
aggregate	No	La funció agregada a aplicar. Obteniu informació sobre com agregar dades amb FetchXml
alias	No	Nom de la columna que voleu retornar. Cada columna ha de tenir un nom únic. Utilitzareu àlies quan recupereu valors agregats. Obtén més informació sobre els àlies de columna.
dategrouping	No	Quan agrupeu dades per un valor de data i hora, aquest atribut especifica la part de data que s'ha d'utilitzar. Consulta les opcions d'agrupació de dates
distinct	No	Quan utilitzeu la funció d'agregació countcolumn , aquest atribut especifica que només es retornen valors únics per a la columna. Obteniu més informació sobre els diferents valors de columna.
groupby	No	Quan agregau dades, aquest atribut especifica la columna que s'ha d'utilitzar per agrupar les dades. Obteniu més informació sobre l'agrupació.
name	Sí	El nom lògic de la columna.
rowaggregate	No	Quan aquest valor es defineix en CountChildren un valor que inclou el nombre total de registres secundaris del registre, s'inclou als resultats. Obteniu informació sobre com podeu utilitzar aquest atribut.
usertimezone	No	S'utilitza per consultes agregades que agrupen per columnes de data i hora. Depenent de la zona horària, el mateix valor de data i hora pot caure en dies diferents. Més informació sobre l'agrupació per parts d'una data Utilitzeu aquest atribut amb un false valor per forçar l'agrupació a utilitzar el valor UTC. Quan no definiu aquest atribut, el valor per defecte és true, i s'utilitza la zona horària de l'usuari. Nota: Amb QueryExpression, l'agrupació sempre utilitza UTC. Quan s'utilitza la classe FetchXmlToQueryExpressionRequest de l'SDK, es perd aquesta configuració. No hi ha manera de definir-ho amb QueryExpression.

Elements principals

Nom	Descripció
entitat	Especifica l'element fill d'un element fetch, l'entitat principal de la consulta. Només es permet una entitat.
entitat d'enllaç	Combina una taula relacionada amb l'entitat o l'entitat d'enllaç per retornar columnes addicionals amb el resultat. També s'utilitza amb elements de filtre per aplicar condicions als valors de columna en taules relacionades.

Funcions agregades

Utilitzeu aquestes funcions agregades. Obteniu informació sobre com agregar dades amb FetchXml

Function	Valor de retorn
avg	Valor mitjà dels valors de columna amb dades.
count	El nombre de files.
countcolumn	El nombre de files amb dades en aquesta columna.
max	El valor màxim de les files d'aquesta columna.
min	El valor mínim de les files d'aquesta columna.
sum	El valor total dels valors de columna amb dades.

Opcions d'agrupació de dates

Més informació sobre l'agrupació per parts d'una data

Valor	Descripció
day	Agrupar per dia del mes
week	Agrupa per setmana de l'any
month	Agrupa per mes de l'any
quarter	Agrupar per trimestres de l'exercici
year	Grup per any
fiscal-period	Agrupació per període de l'exercici
fiscal-year	Agrupació per exercici

Més informació sobre la configuració de l'exercici fiscal