Compartir a través de


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 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 la agrupación a utilizar el valor UTC. Cuando no se configura este atributo, el valor predeterminado es true y se utiliza la zona horaria del usuario.

Nota: Con QueryExpression, la agrupación siempre utiliza UTC. Al utilizar la clase FetchXmlToQueryExpressionRequest del SDK , esta configuración se pierde. No hay forma de configurar esto usando QueryExpression .

Elementos primarios

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

Función 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

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).