Chat now with support
Chat mit Support

Identity Manager 9.2 - API-Entwicklungshandbuch

Entity-Methoden

Entity-Methoden arbeiten mit kleinen Teilen des Objektmodells, um Daten aus der Datenbank zu lesen beziehungsweise in diese zu schreiben. Wenn Sie eine Entity-Methode erstellen müssen Sie nur Tabellen- und Spaltennamen sowie gegebenenfalls eine Filterbedingung (WHERE-Klausel) angeben. Die interne Abarbeitung wird durch den API Server übernommen. Das Schema der Eingabe- und Ausgabedaten ist ebenfalls fest vorgegeben.

Beispiele zur Definition von Entity-Methoden finden Sie im SDK unter Sdk01_Basics\01-BasicQueryMethod.cs.

Detaillierte Informationen zum Thema

Hinweise

  • Deklarieren Sie in der URL von Entity-Methoden, die Operationen vom Typ Update oder Create unterstützen, keine Pfad-Parameter.

Ergebnisse einschränken

HINWEIS: Entity-basierte Methoden arbeiten standardmäßig mit einer Limitierung, um unabsichtliches Laden extrem großer Datenmengen zu vermeiden.

Mithilfe der folgenden Abfrage-Parameter können Sie die Anzahl der zurückgegebenen Datensätze begrenzen, um mehrere Datensätze in aufeinanderfolgenden Antworten zu erhalten:

Abfrage-Parameter Standardwert Beschreibung
PageSize 20

Legen Sie fest, wie viele Datensätze in der Antwort maximal enthalten sein dürfen.

Wenn Sie nur die Gesamtanzahl ermitteln, aber keine einzelnen Datensätze erhalten möchten, verwenden Sie den Wert -1.

StartIndex 0

Legen Sie fest, ab welchem Datensatz die Ergebnisse in der Antwort zurückgegeben werden.

Dieser Parameter ist nullbasiert (das erste Element wird mit dem Wert 0 angesprochen).

Beispiel

Die folgende Anfrage gibt 50 Identitäten zurück und beginnt dabei bei der 101. Identität:

https://<Host-Name>/ApiServer/portal/person?PageSize=50&StartIndex=100

Sortierung

Mithilfe des Abfrage-Parameters OrderBy können Sie die Ergebnisse einer zurückgegebenen Antwort sortieren. Mit diesem Parameter können Sie nach den Spaltennamen der zugrundeliegenden Datenbanktabelle sortieren.

Beispiele

Die folgende Anfrage gibt Identitäten aufsteigend sortiert nach Vorname zurück:

https://<Host-Name>/ApiServer/portal/person?OrderBy=FirstName

Die folgende Anfrage gibt Identitäten absteigend sortiert nach Vorname zurück:
https://<Host-Name>/ApiServer/portal/person?OrderBy=FirstName%20DESC

Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen