Freigeben über


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 Nr. 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 zur Verwendung des UTC-Werts zu erzwingen. Wenn Sie dieses Attribut nicht festlegen, ist der Standardwert true und die Zeitzone des Benutzers wird verwendet.

Hinweis: Bei QueryExpression erfolgt die Gruppierung immer in UTC. Bei Verwendung der SDK-Klasse FetchXmlToQueryExpressionRequest 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

Funktion 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

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).