elemento attribute

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	Obrigatório?	Description
aggregate	Não	A função de agregação 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 ao 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. Ver opções de agrupamento de datas
distinct	Não	Quando você usa a função de agregação countcolumn , esse atributo especifica que somente 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. Saiba mais 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 de 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 é truee o fuso horário do usuário é usado. Observação: 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. Somente uma entidade é permitida.
link-entity	Une uma tabela relacionada à entidade ou à entidade de 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 de agregação

Use essas funções de agregação. Saiba como agregar dados com FetchXml

Função	Valor de retorno
avg	O valor médio dos valores de 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 de coluna com dados.

Opções de agrupamento de datas

Saiba mais sobre agrupamento por partes de uma data

Value	Description
day	Agrupar por dia do mês
week	Agrupar por semana do ano
month	Agrupar por mês do ano
quarter	Agrupar por trimestre do ano fiscal
year	Agrupar por ano
fiscal-period	Agrupar por período do ano fiscal
fiscal-year	Agrupar por ano fiscal

Saiba mais sobre as configurações do ano fiscal