Attributelement

Artikel
08/05/2024

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

Teilen über