Attributelement

Gibt eine Spalte aus einer Entität oder Link-Entität an, sodass sie einer Abfrage zurückgegeben wird.

Erfahren Sie, wie man Spalten mithilfe von FetchXml auswählt.

Beispiel

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

Attribute

Name des Dataflows	Erforderlich?	Eigenschaft
aggregate	Nein	Die anzuwendende Aggregatfunktion. Erfahren Sie, wie Sie Daten mit FetchXml aggregieren
alias	Nein	Der Name der zurückzugebenden Spalte. Jede Spalte muss einen eindeutigen Namen besitzen. Sie verwenden Aliase, wenn Sie Aggregatwerte abrufen. Weitere Informationen zu Spaltenaliase.
dategrouping	Nein	Wenn Sie Daten nach einem Datum/Uhrzeit-Wert gruppieren, gibt dieses Attribut den zu verwendenden Datumsteil an. Siehe Datumsgruppierungsoptionen
distinct	Nein	Wenn Sie die Funktion „countcolumn aggregieren“ verwenden, gibt dieses Attribut an, dass nur eindeutige Werte für die Spalte zurückgegeben werden. Weitere Informationen zu eindeutigen Spaltenwerten.
groupby	Nein	Wenn Sie Daten aggregieren, gibt dieses Attribut die Spalte an, die zum Gruppieren der Daten verwendet werden soll. Weitere Informationen zur Gruppierung.
name	Ja	Der logische Name der Spalte.
rowaggregate	Nein	Wenn der Wert auf CountChildren festgelegt ist, wird ein Wert ist, der die Gesamtanzahl von untergeordneten Datensätzen für den Datensatz enthält, in den Ergebnissen enthalten. Erfahren Sie, wie Sie dieses Attribut verwenden.
usertimezone	Nein	Wird von Aggregatabfragen verwendet, die nach Datum/Uhrzeit-Spalten gruppieren. Abhängig von der Zeitzone kann derselbe Datum/Uhrzeit-Wert in verschiedene Tage fallen. Erfahren Sie mehr über das Gruppieren nach Teilen eines Datums Verwenden Sie dieses Attribut mit einem false Wert, um die Gruppierung zu zwingen, den UTC-Wert zu verwenden. Wenn Sie dieses Attribut nicht festlegen, wird der Standardwert true verwendet, und es wird die Zeitzone des Benutzers verwendet. Hinweis: Bei QueryExpression verwendet die Gruppierung immer UTC. Bei Verwendung der SDK FetchXmlToQueryExpressionRequest-Klasse geht diese Einstellung verloren. Es gibt keine Möglichkeit, dies mit QueryExpression festzulegen.

Übergeordnete Elemente

Name des Dataflows	Eigenschaft
Entität	Gibt das untergeordnete Element für ein Fetch-Element an, die „übergeordnete Entität“ für die Abfrage. Es ist nur eine Entität zulässig.
link-entity	Verbindet eine Tabelle, die sich auf die Entität oder Link-Entität bezieht, um zusätzliche Spalten mit dem Ergebnis zurückzugeben. Wird auch mit Filter-Elementen verwendet, um Bedingungen auf Spaltenwerte in verwandten Tabellen anzuwenden.

Aggregatfunktionen

Verwenden Sie diese Aggregatfunktionen. Erfahren Sie, wie Sie Daten mit FetchXml aggregieren

Function	Zurückgegebener Wert
avg	Der Durchschnittswert der Spaltenwerte mit Daten.
count	Die Anzahl der Zeilen.
countcolumn	Die Anzahl der Zeilen mit Daten in dieser Spalte.
max	Der Maximalwert der Zeilen in dieser Spalte.
min	Der Minimalwert der Zeilen in dieser Spalte.
sum	Der Gesamtwert der Spaltenwerte mit Daten.

Datumsgruppierungsoptionen

Erfahren Sie mehr über das Gruppieren nach Teilen eines Datums

Wert	Eigenschaft
day	Nach Monatstag gruppieren
week	Nach Jahreswoche gruppieren
month	Nach Jahresmonat gruppieren
quarter	Nach Quartal des Geschäftsjahres gruppieren
year	Nach Jahr gruppieren
fiscal-period	Nach Zeitraum des Geschäftsjahres gruppieren
fiscal-year	Nach Geschäftsjahr gruppieren

Weitere Informationen zu Geschäftsjahreseinstellungen