elemento de atributo

Especifica una columna de una entidad o entidad de vínculo para regresar con una consulta.

Aprenda a seleccionar columnas mediante FetchXml.

Ejemplo

<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

Nombre	¿Obligatorio?	Descripción
aggregate	No	La función agregada a aplicar. Aprenda a agregar datos con FetchXml
alias	No	El nombre de la columna a devolver. Cada columna debe tener un nombre único. Utilizará alias cuando recupere valores agregados. Más información sobre alias de columnas.
dategrouping	No	Cuando agrupa datos por un valor de fecha y hora, este atributo especifica la parte de fecha que se utilizará. Consulte Opciones de agrupación de fechas
distinct	No	Cuando utiliza la función agregada countcolumn, este atributo especifica que solo se devuelven valores únicos para la columna. Más información sobre valores de columna distintos.
groupby	No	Cuando agrega datos, este atributo especifica la columna que se utilizará para agrupar los datos. Obtener más información acerca de la agrupación.
name	Sí	El nombre lógico de la columna.
rowaggregate	No	Cuando este valor se establece en CountChildren un valor que incluye el número total de registros secundarios para el registro se incluye en los resultados. Aprenda a usar este atributo.
usertimezone	No	Utilizado por consultas agregadas que agrupan por columnas de fecha y hora. Dependiendo de la zona horaria, el mismo valor de fecha y hora puede caer en días diferentes. Más información sobre cómo agrupar por partes de una fecha Utilice este atributo con un valor false para forzar a la agrupación a utilizar el valor UTC. Cuando no se establece este atributo, el valor predeterminado es true y se utiliza la zona horaria del usuario. Nota: con QueryExpression, la agrupación siempre usa UTC. Cuando se usa la clase FetchXmlToQueryExpressionRequest del SDK, esta configuración se pierde. No hay forma de establecer esto usando QueryExpression.

Elementos primarios

Nombre	Descripción
entidad	Especifica el elemento secundario de un elemento de fetch, el 'elemento principal' de la consulta. Solo se permite una entidad.
link-entity	Une una tabla relacionada con la entidad o vínculo-entidad para devolver columnas adicionales con el resultado. También se utiliza con elementos filtro para aplicar condiciones en valores de columna en tablas relacionadas.

Funciones de agregado

Utilice estas funciones de agregación. Aprenda a agregar datos con FetchXml

Function	Valor de retorno
avg	El valor promedio de los valores de la columna con datos.
count	Número de filas.
countcolumn	El número de filas con datos en esa columna.
max	El valor máximo de las filas de esa columna.
min	El valor mínimo de las filas de esa columna.
sum	El valor total de los valores de la columna con datos.

Opciones de agrupación de fechas

Más información sobre cómo agrupar por partes de una fecha

valor	Descripción
day	Agrupar por el día del mes
week	Agrupar por la semana del año
month	Agrupar por el mes del año
quarter	Agrupar por el trimestre del año fiscal
year	Agrupar por el año
fiscal-period	Agrupar por el período del año fiscal
fiscal-year	Agrupar por el año fiscal

Más información acerca de la configuración del año fiscal