elemento de atributo

Especifica uma coluna de uma entidade ou entidade de link a ser retornada com uma consulta.

Saiba como selecionar colunas usando FetchXml.

Example

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

Attributes

Nome	Necessário?	Description
aggregate	Não	A função agregada a ser aplicada. Saiba como agregar dados com FetchXml
alias	Não	O nome da coluna a ser retornada. Cada coluna deve ter um nome exclusivo. Você usará aliases quando recuperar valores agregados. Saiba mais sobre aliases de coluna.
dategrouping	Não	Quando você agrupa dados por um valor datetime, esse atributo especifica a parte de data a ser usada. Consulte Opções de agrupamento de datas
distinct	Não	Quando você usa a função de agregação countcolumn , esse atributo especifica que apenas valores exclusivos para a coluna são retornados. Saiba mais sobre valores de coluna distintos.
groupby	Não	Quando você agrega dados, esse atributo especifica a coluna a ser usada para agrupar os dados. Obtenha mais informações sobre agrupamento.
name	Yes	O nome lógico da coluna.
rowaggregate	Não	Quando esse valor é definido como CountChildren um valor que inclui o número total de registros filho para o registro é incluído nos resultados. Saiba como usar esse atributo.
usertimezone	Não	Usado por consultas agregadas que agrupam por colunas datetime. Dependendo do fuso horário, o mesmo valor datetime pode cair em dias diferentes. Saiba mais sobre o agrupamento por partes de uma data Use esse atributo com um false valor para forçar o agrupamento a usar o valor UTC. Quando você não define esse atributo, o valor padrão é true, e o fuso horário do usuário é usado. Nota: Com QueryExpression, o agrupamento sempre usa UTC. Ao usar a classe SDK FetchXmlToQueryExpressionRequest, essa configuração é perdida. Não há como definir isso usando QueryExpression.

Elementos pai

Nome	Description
entidade	Especifica o elemento filho para um elemento fetch, a 'entidade pai' para a consulta. Só é permitida uma entidade.
link-entidade	Junta-se a uma tabela relacionada à entidade ou entidade-link para retornar colunas adicionais com o resultado. Também usado com elementos de filtro para aplicar condições em valores de coluna em tabelas relacionadas.

Funções agregadas

Use essas funções agregadas. Saiba como agregar dados com FetchXml

Função	Valor de retorno
avg	O valor médio dos valores da coluna com dados.
count	O número de linhas.
countcolumn	O número de linhas com dados nessa coluna.
max	O valor máximo das linhas nessa coluna.
min	O valor mínimo das linhas nessa coluna.
sum	O valor total dos valores da coluna com dados.

Opções de agrupamento de datas

Saiba mais sobre o agrupamento por partes de uma data

Valor	Description
day	Grupo por dia do mês
week	Grupo por semana do ano
month	Grupo por mês do ano
quarter	Grupo por trimestre do ano fiscal
year	Grupo por ano
fiscal-period	Grupo por período do exercício
fiscal-year	Grupo por ano fiscal

Saiba mais sobre as configurações do ano fiscal