Condividi tramite


elemento attribute

Specifica una colonna da un'entità o un'entità di collegamento da restituire con una query.

Informazioni su come selezionare le colonne 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 Obbligatorio? Description
aggregate NO Funzione di aggregazione da applicare. Informazioni su come aggregare i dati con FetchXml
alias NO Nome della colonna da restituire. Ogni colonna deve avere un nome univoco. Gli alias verranno usati quando si recuperano valori di aggregazione. Altre informazioni sugli alias di colonna.
dategrouping NO Quando si raggruppano i dati in base a un valore datetime, questo attributo specifica la parte data da usare. Vedere Opzioni di raggruppamento di date
distinct NO Quando si usa la funzione di aggregazione countcolumn , questo attributo specifica che vengono restituiti solo valori univoci per la colonna. Altre informazioni sui valori di colonna distinti.
groupby NO Quando si aggregano dati, questo attributo specifica la colonna da usare per raggruppare i dati. Ulteriori informazioni sul raggruppamento.
name Yes Nome logico della colonna.
rowaggregate NO Quando questo valore è impostato su CountChildren un valore che include il numero totale di record figlio per il record viene incluso nei risultati. Informazioni su come usare questo attributo.
usertimezone NO Usato dalle query di aggregazione raggruppate in base alle colonne datetime. A seconda del fuso orario, lo stesso valore datetime può rientrare in giorni diversi. Informazioni sul raggruppamento per parti di una data

Usare questo attributo con un false valore per forzare il raggruppamento per usare il valore UTC. Quando non si imposta questo attributo, il valore predefinito è truee viene usato il fuso orario dell'utente.

Nota: con QueryExpression, il raggruppamento usa sempre utc. Quando si usa la classe SDK FetchXmlToQueryExpressionRequest, questa impostazione viene persa. Non è possibile impostare questa impostazione usando QueryExpression.

Elementi padre

Nome Description
entità Specifica l'elemento figlio per un elemento di recupero, ovvero l'entità padre per la query. È consentita una sola entità.
link-entity Aggiunge una tabella correlata all'entità o all'entitàdi collegamento per restituire colonne aggiuntive con il risultato. Usato anche con gli elementi filtro per applicare condizioni sui valori di colonna nelle tabelle correlate.

Funzioni di aggregazione

Usare queste funzioni di aggregazione. Informazioni su come aggregare i dati con FetchXml

Funzione Valore restituito
avg Valore medio dei valori di colonna con i dati.
count Numero di righe.
countcolumn Numero di righe con dati in tale colonna.
max Valore massimo delle righe in tale colonna.
min Valore minimo delle righe in tale colonna.
sum Valore totale dei valori della colonna con i dati.

Opzioni di raggruppamento data

Altre informazioni sul raggruppamento per parti di una data

Value Description
day Raggruppa per giorno del mese
week Raggruppa per settimana dell'anno
month Raggruppa per mese dell'anno
quarter Raggruppa per trimestre dell'anno fiscale
year Raggruppa per anno
fiscal-period Raggruppare per periodo dell'anno fiscale
fiscal-year Raggruppa per anno fiscale

Altre informazioni sulle impostazioni dell'anno fiscale