elemento atributo

Especifica unha columna dunha entidade ou entidade de ligazón para devolver cunha consulta.

Aprende a seleccionar columnas usando FetchXml.

Exemplo

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

Atributos

Nome	Requirido?	Descrición
aggregate	Non	A función agregada a aplicar. Aprende a agregar datos con FetchXml
alias	Non	O nome da columna a devolver. Cada columna debe ter un nome único. Usarás alias ao recuperar valores agregados. Máis información sobre os alias de columna.
dategrouping	Non	Cando agrupa datos por un valor de data, este atributo especifica a parte de data a usar. Ver opcións de agrupamento de datas
distinct	Non	Cando se usa a función agregada countcolumn , este atributo especifica que só se devolven valores únicos para a columna. Máis información sobre os distintos valores das columnas.
groupby	Non	Ao agregar datos, este atributo especifica a columna a usar para agrupar os datos. Obtén máis información sobre a agrupación.
name	Si	O nome lóxico da columna.
rowaggregate	Non	Cando este valor se establece nun CountChildren valor que inclúe o número total de rexistros fillos para o rexistro inclúese nos resultados. Aprende a usar este atributo.
usertimezone	Non	Utilízase por consultas agregadas que agrupan por columnas de data e hora. Dependendo do fuso horario, o mesmo valor de data e hora pode caer en diferentes días. Aprende a agrupar por partes dunha data Use este atributo cun false valor para forzar o agrupamento a usar o valor UTC. Cando non se establece este atributo, o valor predeterminado é true, e utilízase o fuso horario do usuario. Nota: Con QueryExpression, o agrupamento sempre usa UTC. Ao usar a clase SDK FetchXmlToQueryExpressionRequest, esta configuración pérdese. Non hai xeito de configurar isto usando QueryExpression.

Elementos pais

Nome	Descrición
Entidade	Especifica o elemento fillo para un elemento fetch, a "entidade pai" para a consulta. Só se permite unha entidade.
Entidade de ligazón	Únese a unha táboa relacionada coa entidade ou entidade de ligazón para devolver columnas adicionais co resultado. Tamén se usa con elementos de filtro para aplicar condicións aos valores das columnas en táboas relacionadas.

Funcións agregadas

Utiliza estas funcións agregadas. Aprende a agregar datos con FetchXml

Function	Valor devolto
avg	Valor medio dos valores das columnas con datos.
count	Número de filas.
countcolumn	Número de filas con datos nesa columna.
max	O valor máximo das filas desa columna.
min	O valor mínimo das filas desa columna.
sum	Valor total dos valores das columnas con datos.

Opcións de agrupamento de datas

Máis información sobre o agrupamento por partes dunha data

Valor	Descrición
day	Agrupación por días do mes
week	Grupo por semana do ano
month	Grupo por mes do ano
quarter	Agrupación por trimestre do exercicio fiscal
year	Grupo por ano
fiscal-period	Agrupación por período do exercicio fiscal
fiscal-year	Agrupación por exercicio fiscal

Máis información sobre a configuración do ano fiscal