elemento de atributo

Artigo
08/05/2024

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

Compartir por