Abfragefelder, Operatoren und Makros in Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Hier finden Sie ausführliche Beschreibungen der einzelnen Felddatentypen, Abfrageoperatoren und Abfragemakros. Einige Datentypen, Operatoren und Makros sind nur für die angegebene Azure DevOps-Version gültig.

Eine kurze Übersicht über Abfragetasks, Operatoren und Makros, die für jeden Datentyp unterstützt werden, finden Sie unter Abfrageschnellübersicht. Weitere Informationen zum Erstellen von Abfragen mit hoher Leistung finden Sie unter Anleitungen zum Erstellen von Abfragen mit hoher Leistung.

Abfragefelddatentypen und -werte

Der Wert, den Sie für ein Feld angeben, muss dem Datentyp dieses Felds entsprechen. In der folgenden Tabelle sind die unterstützten Datentypen aufgeführt.

Hinweis

Für Azure Boards Clouddienst entspricht der Datentyp dem Datentyp, der für das Feld auf der Seite Prozessfelder> aufgeführt ist. Bei lokalen Bereitstellungen entspricht der Datentyp dem Attribut, das type einer FIELD Definition zugewiesen ist. Weitere Informationen finden Sie unter Arbeitselementfelder und Feldattribute.

Datentyp

Beschreibung

Boolescher Wert

Gibt ein Feld an, das einen True/False-Wert annimmt.

DateTime oder Date/Time

Ein Datumsfeld, in dem Sie eine Variable angeben können, z @Today . B. oder @Today-1oder einen Wert, z. B. 01.01.2012. Geben Sie Datumsangaben in das Datumsmuster ein, das Sie für Ihr persönliches Profil festgelegt haben. (Weitere Informationen finden Sie unter Festlegen persönlicher Einstellungen .) Abfragebeispiele finden Sie unter Abfrage nach Datum or@CurrentIteration.

Für WIQL-Abfragen können Sie das Datum auch im UTC-Muster (Coordinated Universal Time) angeben. Weitere Informationen finden Sie unter Syntax für die Arbeitselementabfragesprache (Work Item Query Language, WIQL).

Double oder Decimal

Eine reelle Zahl, z. B. 0,2 oder 3,5. Abfragebeispiele finden Sie unter Abfragen nach numerischen Feldern.

GUID

Eine Zeichenfolge, die eine eindeutige ID darstellt.

History

Benutzerdefiniert formatiertes Feld, das zur Nachverfolgung von Verlaufsinformationen verwendet wird. Dieser Datentyp wird nur verwendet, um das Feld Verlauf zu unterstützen. Dieses Feld wird automatisch für die Volltextsuche indiziert, wenn diese verfügbar ist. Weitere Informationen finden Sie unter Volltext- und Teilwortsuchen , die weiter unten in diesem Artikel beschrieben werden. Abfragebeispiele finden Sie unter Verlauf und Überwachung.

HTML

Textzeichenfolgen, die formatierte Beschreibungen unterstützen, z. B. die Felder Beschreibung oder Repro-Schritte . Diese Felder werden automatisch für die Volltextsuche indiziert, wenn diese verfügbar ist. Weitere Informationen finden Sie unter Volltext- und Teilwortsuchen , die weiter unten in diesem Artikel beschrieben werden. Informationen zum Abfragen von Rich-Text-Feldern finden Sie unter Abfragen nach Titeln, IDs und Rich-Text-Feldern.

Identität

Kurze Textzeichenfolge, die eine Benutzeridentität identifiziert.

Integer

Eine 32-Bit-Ganzzahl mit Vorzeichen, z. B. 0, 1, 2 oder 34.

PlainText - oder Textfeld (mehrzeiliges)

Textzeichenfolgen, die lange Beschreibungen unterstützen, z. B. das Feld Anwendungsstartinformationen . Diese Felder werden automatisch für die Volltextsuche indiziert, wenn diese verfügbar ist. Weitere Informationen finden Sie unter Volltext- und Teilwortsuchen , die weiter unten in diesem Artikel beschrieben werden. Informationen zum Abfragen von Nur-Text-Feldern finden Sie unter Abfragen nach Titeln, IDs und Rich-Text-Feldern.

PicklistDouble1

Benutzerdefiniertes Feld, das definiert ist, um eine Auswahlliste von Dezimalwerten zu enthalten.

picklistInteger1

Benutzerdefiniertes Feld, das definiert ist, um eine Auswahlliste von Ganzzahlwerten zu enthalten.

picklistString1

Benutzerdefiniertes Feld, das definiert ist, um eine Auswahlliste von Kurztextzeichenfolgenwerten (maximal 255 Zeichen) zu enthalten.

Zeichenfolge oder Textfeld (einzeilig)

Eine kurze Textzeichenfolge, die bis zu 255 Unicode-Zeichen enthalten kann. Zeichenfolgentextfelder werden häufig verwendet, um Auswahllisten oder Dropdownmenüs zu unterstützen.

TreePath

Eine Branchstruktur, z. B. ein Bereichspfad oder ein Iterationspfad. Wählen Sie ein Element aus einer Liste gültiger Werte aus. Suchen Sie Arbeitselemente, die gleich, nicht gleich, unter oder nicht unter einer Strukturstruktur sind, oder verwenden Sie die Operatoren In oder Not In, um mehrere Werte anzugeben. Sie definieren die Struktur für ein Projekt – Bereichspfade und Iterationspfade – und wählen dann die Struktur aus, die Sie einem Team zuordnen möchten.

Weitere Informationen zum Erstellen von Abfragen finden Sie unter Abfrage nach Bereich oder Iterationspfad oder Abfrage nach Datum oder aktueller Iteration.

Hinweis

  1. Die Datentypen picklist... werden nur benutzerdefinierten Feldern zugewiesen, die für einen geerbten Prozess definiert sind. Das Geerbte Prozessmodell wird nur für Azure DevOps Services und Azure DevOps Server 2019 unterstützt.

Datums- und Uhrzeitmuster

Das Datums- und Uhrzeitmuster, das Sie für DateTime-Felder eingeben, sollte mit dem übereinstimmen, das Sie in Ihrem Profil auswählen. Informationen zum Anzeigen oder Ändern Ihrer Auswahl finden Sie unter Festlegen von Benutzereinstellungen, Uhrzeit und Gebietsschema.

Seite

Seite

Abfrageoperatoren

Sie können die Abfrageoperatoren in der folgenden Tabelle verwenden, um anzugeben, welche Beziehung zwischen den einzelnen Werten in einer Klausel und dem entsprechenden Wert in einem Arbeitselement bestehen muss. Informationen zum Datentyp, der Arbeitselementfeldern zugewiesen ist, finden Sie unter Arbeitselementfeldreferenz.

Weitere Informationen zum Hinzufügen von Klauseln und zur Verwendung der And/Oder-Operatoren finden Sie unter Definieren einer Abfrage, und/oder eines logischen Ausdrucks.

Abfrageoperator

Gibt Arbeitselemente zurück, wenn der Wert in dem Arbeitselement den angegebenen Kriterien entspricht.

Anwendbare Datentypen

=

Entspricht dem Wert in der Klausel.

Number – einschließlich Double, GUID, Integer – und String, DateTime und TreePath

<>

Stimmt nicht mit dem Wert in der -Klausel überein.

Number, String, DateTime und TreePath

>

Ist größer als der Wert in der Klausel.

Number, String und DateTime

<

Ist kleiner als der Wert in der Klausel.

Number, String und DateTime

>=

Ist größer als oder gleich dem Wert in der Klausel.

Number, String und DateTime

<=

Ist kleiner als oder gleich dem Wert in der Klausel.

Number, String und DateTime

=[Feld]

Entspricht dem Wert im angegebenen Feld.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.

<>[Feld]

Stimmt nicht mit dem Wert überein, der im angegebenen Feld enthalten ist.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.

>[Feld]

Ist größer als der Wert im angegebenen Feld.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.

<[Feld]

Ist kleiner als der Wert im angegebenen Feld.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.

>=[Feld]

Ist größer als oder gleich dem Wert im angegebenen Feld.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.

<=[Feld]

Ist kleiner oder gleich dem Wert im angegebenen Feld.

Name eines Felds mit dem gleichen Datentyp wie das angegebene Feld.

Contains

Enthält eine exakte oder teilweise Übereinstimmung der Textzeichenfolge innerhalb des Felds, das Sie für das Filtern ausgewählt haben.

String

Enthält keine

Enthält keine exakte oder teilweise Übereinstimmung der Textzeichenfolge in dem Feld, das Sie zum Filtern ausgewählt haben.

String

Enthält Wörter

Enthält die genaue Textzeichenfolge oder Wörter innerhalb des Felds, das Sie für das Filtern ausgewählt haben. Sie können auch Teile von Wörtern oder Ausdrücken eingeben, die das Platzhalterzeichen * enthalten. Die Textzeichenfolge ist auf 100 Zeichen beschränkt. Einschränkungen finden Sie unter Volltextsuche nach Server- und Sortierungsanforderungen.

Langtextfelder, die für die Volltextsuche indiziert sind, die allen PlainText - und HTML-Feldern entsprechen, sowie den Feldern Verlauf und Titel .

Enthält keine Wörter

Enthält nicht die exakten Textzeichenfolgen oder Wörter in dem Feld, das Sie zum Filtern ausgewählt haben. Die Textzeichenfolge ist auf 100 Zeichen beschränkt.

Verwenden Sie diesen Operator in Kombination mit einer Klausel mit dem Contains Words-Operator , um bestimmte Schlüsselwörter einzu- und auszuschließen.

Textfelder, die für die Volltextsuche indiziert sind.

In

Entspricht einem beliebigen Wert in einer durch Trennzeichen getrennten Liste. Beispielsweise können Sie nach Arbeitselementen mit der ID 100, 101 und 102 suchen, indem Sie die entsprechenden Werte im Feld für die ID eingeben. Trennen Sie mehrere Werte mit dem Listentrennzeichen, das den regionalen Einstellungen entspricht, die für den Clientcomputer festgelegt wurden. Sie können z. B. ein Komma (,) verwenden.

Number, String, DateTime, TreePath

Ist leer

Listet Arbeitselemente auf, die ein leeres HTML-Feld enthalten. Sie geben mit diesem Operator keinen Wert an. Dieser Operator wird für Azure Boards (Clouddienst), Azure DevOps Server 2019 und höhere Versionen unterstützt.

HTML

Ist nicht leer

Listet Arbeitselemente auf, die Inhalte im HTML-Feld enthalten. Sie geben mit diesem Operator keinen Wert an. Dieser Operator wird für Azure Boards (Clouddienst), Azure DevOps Server 2019 und höhere Versionen unterstützt.

HTML

Not In

Entspricht keinem Wert in einem durch Trennzeichen getrennten Satz. Sie können Arbeitselemente, deren Status nicht Aufgelöst, Abgeschlossen oder Geschlossen ist, aus Abfrageergebnissen ausschließen, wenn Sie diese Werte für das Feld Zustand angeben. Trennen Sie mehrere Werte mit dem Listentrennzeichen, das den regionalen Einstellungen entspricht, die für den Clientcomputer festgelegt wurden. Sie können z. B. ein Komma (,) verwenden.

Der Not In-Operator ist ab Azure Boards und TFS 2018.2 und höheren Versionen verfügbar.

Number, String, DateTime, TreePath

In Gruppe

Entspricht einem Wert, der ein Member der Gruppe in der Klausel ist. Gruppen entsprechen dem Namen eines Teams, einer Sicherheitsgruppe oder einer Arbeitsnachverfolgungskategorie. Beispielsweise können Sie eine Abfrage erstellen, um alle Arbeitselemente zu suchen, die Mitgliedern der Gruppe „Contributors“ oder einem Team zugewiesen wurden. Teamgruppen werden erstellt, wenn ein Team angelegt wird. Der Name der Teamgruppen folgt dem Muster [Teamprojektname]\Teamname.

Beispielabfragen finden Sie unter Abfragen nach Zuweisung oder Workflowänderungen.

Zeichenfolge , die mit dem Namen eines teams, einer Sicherheitsgruppe oder einer Kategorie übereinstimmt, die im System definiert ist.

Hinweis

Sie können den Operator In Group nur mit Feldern verwenden, die den Datentyp String oder das Feld Arbeitselementtyp verwenden. Sie können auch Gruppen verwenden, die in Azure Active Directory (Azure AD) definiert sind, wenn Ihr Azure Boards Konto von Azure AD unterstützt wird, oder Active Directory, wenn Ihre lokale Serverinstanz von Active Directory unterstützt wird.

Informationen zu Kategoriegruppen finden Sie unter Verwenden von Kategorien zum Gruppieren von Arbeitselementtypen.

Nicht in Gruppe

Stimmt nicht mit einem Wert überein, der ein Mitglied der Gruppe in der -Klausel ist.

Zeichenfolge , die dem Namen einer Benutzergruppe in Team Foundation Server oder einer für ein Projekt definierten Kategoriegruppe entspricht.

Hinweis

Sie können den Not In Group-Operator nur mit Feldern verwenden, die den Datentyp String oder das Feld Arbeitselementtyp verwenden. Sie können auch Gruppen verwenden, die in Azure AD definiert sind, wenn Ihr Azure Boards Konto von Azure AD unterstützt wird, oder Active Directory, wenn Ihre lokale Serverinstanz von Active Directory unterstützt wird.

Nicht unter

Stimmt nicht mit dem Wert in der -Klausel überein und ist nicht unter dem Knoten in der -Klausel enthalten.

TreePath

Unter

Entspricht dem Wert in der Klausel oder ist unter dem Knoten in der Klausel enthalten.

TreePath

War schon einmal

Entspricht dem Wert in der Klausel an einem vorherigen Punkt.

String , DateTime

Tipp

Es ist möglich, eine Abfrage mithilfe der WIQL-Syntax zu kontruieren, die einen Operator wie Was Ever für andere Datentypfelder als die aufgeführten verwendet. Beispielsweise können Sie Was Ever innerhalb einer Klausel mithilfe des Iterationspfads verwenden. Ein Beispiel finden Sie unter Abfrage nach Datum oder aktueller Iteration, Auflisten von Arbeitselementen, die aus einem Sprint verschoben wurden.

Abfragen von Makros oder Variablen

Sie können die in der folgenden Tabelle beschriebenen Makros verwenden, um Ihre Abfragen basierend auf bestimmten Feldern zu filtern.

Hinweis

Die folgenden Makros werden nur vom Webportal unterstützt: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity und @TeamAreas. Abfragen, die diese Makros enthalten, funktionieren nicht, wenn sie in Visual Studio/Team Explorer, Microsoft Excel oder Microsoft Project geöffnet werden.


Makro

Beschreibung


[Beliebige]

Verwenden Sie mit den Feldern Arbeitselementtyp oder Zustand , um alle Arbeitselementtypen oder alle Zustände zu durchsuchen. Beispielsweise Work Item Type=[Any] werden keine Filter basierend auf dem Arbeitselementtyp platziert.


@CurrentIteration

Verwenden Sie mit dem Feld Iterationspfad , um automatisch nach Arbeitselementen zu filtern, die dem aktuellen Sprint basierend auf dem aktuellen Teamfokus oder Kontext zugewiesen sind. Spezifische Beispiele finden Sie unter Abfrage nach Datum oder aktueller Iteration.
Das @CurrentIteration Makros funktioniert nur, wenn es über das Webportal ausgeführt wird. Sie können das Makro nicht verwenden, wenn Sie Testsammlungen und Testfälle kopieren oder klonen, Warnungen definieren oder REST-APIs verwenden.


@CurrentIteration +/- n

Verwenden Sie mit dem Feld Iterationspfad , um den Satz von Arbeitselementen zu filtern, die dem aktuellen Sprint +/- n Sprints basierend auf dem aktuellen Teamfokus oder Kontext zugewiesen sind. Spezifische Beispiele finden Sie unter Abfrage nach Datum oder aktueller Iteration.
Das Makro @CurrentIteration +/- n wird für Azure Boards, Azure DevOps Server 2019 und höher und nur bei Ausführung über das Webportal unterstützt.


@Follows

Verwenden Sie das Feld ID und den Operator In , um alle Arbeitselemente aufzulisten, denen Sie im Projekt folgen. Weitere Informationen zum Feature "Folgen" finden Sie unter Folgen eines Arbeitselements oder Pull Requests. Sie können dieselbe Liste auf der Seite Arbeitselemente unter Folgende Pivotansicht anzeigen.
Das @Follows Makros wird nur unterstützt, wenn es über das Webportal ausgeführt wird.


@Me

Verwenden Sie mit einem Identitäts- oder Benutzerkontofeld, um automatisch nach Elementen zu suchen, die Ihrem Benutzer- oder Kontonamen zugeordnet sind. Sie können beispielsweise Arbeitselemente finden, die Sie mit der -Klausel Created By=@Megeöffnet haben. Weitere Beispiele finden Sie unter Abfragen nach Zuweisung, Workflow oder Kanban-Boardänderungen.


@MyRecentActivity1

Verwenden Sie mit dem Feld ID und dem Operator In , um Arbeitselemente aufzulisten, die Sie innerhalb der letzten 30 Tage im Projekt angezeigt oder aktualisiert haben. Sie können dieselbe Liste auf der Seite Arbeitselemente, Pivotansicht "Meine Aktivität " anzeigen.


@Project

Verwenden Sie das Feld Teamprojekt , um nach Arbeitselementen in anderen Projekten zu filtern. Beispielsweise finden Sie alle Arbeitselemente im aktuell ausgewählten Projekt mit der -Klausel Team Project=@Project. Das System filtert standardmäßig automatisch basierend auf dem aktuellen Projekt. Weitere Informationen finden Sie unter Definieren einer Abfrage, Projektübergreifende Abfrage.


@RecentMentions1

Verwenden Sie mit dem Feld ID und dem Operator In , um Arbeitselemente aufzulisten, in denen Sie im Abschnitt Diskussion erwähnt wurden. Sie können dieselbe Liste auf der Seite Arbeitselemente in der Pivotansicht Erwähnt anzeigen.


@RecentProjectActivity1

Verwenden Sie mit dem Feld ID und dem Operator In , um Arbeitselemente aufzulisten, die kürzlich aktualisiert wurden. Die Anzahl der aufgeführten Arbeitselemente hängt von der Aktivität der Arbeitsnachverfolgung des Projekts ab. Bei hoch aktiven Projekten listet das Makro Arbeitselemente auf, die innerhalb der letzten 30 Tage im Projekt aktualisiert wurden. Bei weniger aktiven Projekten kann diese Liste jedoch Arbeitselemente enthalten, die älter als 30 Tage sind. Sie können ähnliche Listen auf der Seite Arbeitselemente, Zuletzt erstellt, Zuletzt aktualisiert und Zuletzt abgeschlossene Pivotansichten anzeigen. Die Anzahl der zurückgegebenen Arbeitselemente ist auf 5000 begrenzt.


@StartOfDay2

Verwenden Sie mit einem DateTime Feld, um nach Arbeitselementen zu filtern, die sich auf das aktuelle Datum oder einen Plus-/Minus-Offset beziehen. Beispielsweise finden Sie alle Elemente, die in der letzten Woche mit der -Klausel Closed Date>=@StartOfDay-7geschlossen wurden. Weitere Beispiele finden Sie unter Abfrage nach Datum oder aktueller Iteration.


@StartOfMonth2

Verwenden Sie mit einem DateTime Feld, um nach Arbeitselementen zu filtern, die sich auf den aktuellen Monat oder auf einen Plus-/Minus-Offset beziehen. Beispielsweise können Sie alle Elemente finden, die in den letzten drei Monaten mit der -Klausel Created Date>=@StartOfMonth-3erstellt wurden. Weitere Beispiele finden Sie unter Abfrage nach Datum oder aktueller Iteration.


@StartOfWeek2

Verwenden Sie mit einem DateTime Feld, um nach Arbeitselementen zu filtern, die sich auf die aktuelle Woche beziehen oder nach einem Plus/Minus-Offset. Sie können beispielsweise alle Elemente finden, die in den letzten zwei Wochen mit der -Klausel Changed Date>=@StartOfWeek-2geändert wurden. Weitere Beispiele finden Sie unter Abfrage nach Datum oder aktueller Iteration.


@StartOfYear2

Verwenden Sie mit einem DateTime Feld, um nach Arbeitselementen zu filtern, die sich auf das aktuelle Jahr beziehen, oder nach einem Plus/Minus-Offset. Beispielsweise finden Sie alle Features, für die ein Zieldatum innerhalb des aktuellen Jahres geplant ist, mit der -Klausel Target Date>=@StartOfYear. Weitere Beispiele finden Sie unter Abfrage nach Datum oder aktueller Iteration.


@TeamAreas

Verwenden Sie nur mit dem Feld Bereichspfad , um nach Arbeitselementen zu filtern, deren Bereichspfad einem bestimmten Team zugeordnet ist. Erfordert, dass Sie den = Operator verwenden. Beispielsweise finden Sie alle Elemente, die den Bereichspfaden zugewiesen sind, die dem Webteam mit der -Klausel Area Path=@TeamAreas [Fabrikam Fiber]\Webzugewiesen sind. Weitere Beispiele finden Sie unter Abfragen nach Bereich oder Iterationspfad.
Das @TeamAreas-Makro wird für Azure DevOps Server 2019 und höhere Versionen und nur bei Ausführung über das Webportal unterstützt.


@Today

Verwenden Sie mit einem DateTime Feld, um nach Arbeitselementen zu filtern, die sich auf das aktuelle Datum oder ein früheres Datum beziehen. Sie können das makro @Today auch ändern, indem Sie Tage subtrahieren. Sie können beispielsweise alle Elemente finden, die in der letzten Woche mit der -Klausel Created Date>=Today-7erstellt wurden. Weitere Beispiele finden Sie unter Abfrage nach Datum oder aktueller Iteration.


Hinweis

  1. Die makros @MyRecentActivity, @RecentMentions und @RecentProjectActivity werden für TFS 2018.2 und höhere Versionen unterstützt.
  2. Die makros @StartOfDay, @StartOfWeek, @StartOfMonth und @StartOfYear werden für Azure DevOps Server 2019 Update 1 und höhere Versionen unterstützt.

Volltext- und partielle Wortsuchen

Geben Sie Contains oder Does Contain an , um nach exakten oder teilweisen Übereinstimmungen eines Worts oder Ausdrucks zu suchen. Diese Operatoren filtern Elemente basierend auf dem Volltextsuchindex, der für Langtextfelder erstellt wird. Geben Sie Enthält Wörter oder Keine Wörter an, um nach einem genauen Ausdruck zu suchen oder das Feldhalterzeichen zu verwenden. * Bei Verwendung dieser Operatoren wird der Index für die Volltextsuche verwendet. Sie können das Platzhalterzeichen nur am Ende eines partiellen Worts oder Ausdrucks verwenden.

Beispiele finden Sie unter Beispielabfragen für Arbeitselemente und Abfrage für Arbeitselemente mithilfe des Felds Verlauf.

Hinweis

Nicht alle Bereitstellungen unterstützen Volltextsuchen. Beispielsweise unterstützen SQL Express und SQL Azure, die den Clouddienst unterstützen, keine Volltextsuche. In diesen Fällen werden nur die Operatoren Contains und Does not Contain angezeigt.

Azure DevOps Server und Team Foundation Server indizieren automatisch alle Langtextfelder mit dem Datentyp PlainText und HTML sowie dem Feld Titel für die Volltextsuche. Index und Operatoren sind nur verfügbar, wenn die SQL Server, die Team Foundation Server unterstützt, die Volltextsuche unterstützt.

Bei Volltextsuchen ist eine SQL-Sortierung erforderlich, die einer Sprache entspricht, in der eine Worttrennung bei SQL Server registriert ist. Wenn die Sortierungseinstellungen für die Projektsammlungsdatenbank, die für Ihre Team Foundation Server-Instanz verwendet werden, nicht einer unterstützten Sprache entsprechen, entsprechen Ihre Suchergebnisse möglicherweise nicht Ihren Erwartungen. In diesen Fällen können Sie versuchen, die Contains- oder Nicht enthalten-Operatoren zu verwenden.

Weitere Informationen finden Sie unter Volltextsuchabfragen und Sortierungseinstellungen.

REST-API

Informationen zur programmgesteuerten Interaktion mit Abfragen finden Sie unter einer der folgenden REST-API-Ressourcen: