Abfrage-Parameter werden der URL über ein Frage- oder das &-Zeichen angehangen.
Dem ersten Abfrage-Parameter muss ein Fragezeichen vorangestellt werden. Dabei muss folgendes Format verwendet werden:
?Parametername=Parameterwert (beispielsweise ?orderBy=LastName)
Den nachfolgenden Abfrage-Parametern muss ein & vorangestellt werden. Dabei muss folgendes Format verwendet werden:
&Parametername=Parameterwert (beispielsweise ?sortOrder=ascending)
HINWEIS: Unbekannte Abfrage-Parameter werden vom Server mit dem Fehlercode 400 abgelehnt. Das betrifft auch Abfrage-Parameter mit einer fehlerhaften Groß-/Kleinschreibung.
Beispiel
https://<Host-Name>/AppServer/portal/person?orderBy=LastName
Der Status der Sitzung wird in einem Cookie gespeichert. Dieses Cookie enthält ein verschlüsseltes Sicherheitstoken, mit dem die Anmeldung am API Server auch wiederhergestellt werden kann, wenn der API Server zwischenzeitlich neu gestartet wird. Das Sicherheitstoken wird mit dem bei der Installation ausgewählten Zertifikat kryptographisch signiert.
HINWEIS: Startet ein am API Server angemeldeter Benutzer den verwendeten Browser neu, werden das Cookie und die darin enthaltenen Sitzungsinformationen zurückgesetzt.
Detaillierte Informationen zum Thema
Mithilfe der API-Methode imx/sessions/<Name des API-Projektes> können Sie den Status der Sitzung abfragen. In der Antwort erhalten Sie folgende Informationen:
In den Webanwendungen hat jede Sitzung zwei sprachspezifische Eigenschaften: Anzeigesprache und Formatierungssprache.
Anzeigesprache
Über die Anzeigesprache wird festgelegt, in welcher Sprache die Texte der Webanwendung angezeigt werden.
Formatierungssprache
Die Formatierungssprache legt das Format für die Ein- und Ausgabe von nicht-textuellen Daten fest (beispielsweise Zahlen und Datumswerte).
Ermittlung der Sprache
Zur Ermittlung der Anzeigesprache wird für jede API-Anfrage folgende Prioritätenliste abgearbeitet, bis zum ersten Schritt, der eine einsetzbare Sprache liefert:
-
Sprache zur Person.UID_DialogCulture der angemeldeten Identität
-
Sprache zur Sprachpräferenz des Clients: erster Wert des HTTP-Headers Accept-Language
-
Fallback: Thread.CurrentUICulture des Threads der Webanwendung
-
Fallback: en-US
Die Formatierungssprache wird folgendermaßen ermittelt:
-
Sprache zur Person.UID_DialogCultureFormat der angemeldeten Identität
-
Sprache zur Sprachpräferenz des Clients: erster Wert des HTTP-Headers Accept-Language
-
Fallback: Thread.CurrentCulture des Threads der Webanwendung
-
Fallback: ermittelte Anzeigesprache
Anmerkungen
Im API Server übernimmt das CulturePlugIn die Zuordnung der korrekten Sprachen für jede Anfrage. Die Sprachen werden an der Klasse LanguageManager gesetzt und gelten dann sowohl für den aktuellen Thread als auch für asynchron aufgerufene Aufgaben.
Die Auswertung der Daten der angemeldeten Identität wird vom Plugin QER.CompositionApi.Person.SetSessionCulture umgesetzt.
