REST.Backend.EMSServices.TEMSLoginAPI.LoginUser
Delphi
procedure LoginUser(const AUserName, APassword: string; AProc: TFindObjectProc); overload;
procedure LoginUser(const AUserName, APassword: string; out AUser: TBackendEntityValue; const AJSON: TJSONArray); overload;
C++
void __fastcall LoginUser(const System::UnicodeString AUserName, const System::UnicodeString APassword, Rest::Backend::Servicetypes::_di_TFindObjectProc AProc)/* overload */;
void __fastcall LoginUser(const System::UnicodeString AUserName, const System::UnicodeString APassword, /* out */ Rest::Backend::Metatypes::TBackendEntityValue &AUser, System::Json::TJSONArray* const AJSON)/* overload */;
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
protected | REST.Backend.EMSServices.pas REST.Backend.EMSServices.hpp |
REST.Backend.EMSServices | TEMSLoginAPI |
Beschreibung
Führt die Anmeldung bei EMS-Server durch und ruft die Authentifizierungsdaten ab, die Sie in weiteren Anforderungen verwenden können.
Sie müssen den Benutzernamen des Benutzers, der sich anmeldet (AUserName
), und das Passwort dieses Benutzernamens (APassword
) angeben.
Stellen Sie für die weitere Behandlung der empfangenen Informationen entweder die folgende Instanz oder die folgende Prozedur bereit:
- Eine Instanz von TBackendEntityValue (
AUser
) und ein JSON-Array (AJSON
). LoginUser fülltAUser
mit den empfangenen Daten und hängt das empfangene JSON-Objekt anAJSON
an. - Eine Prozedur mit dem Typ TFindObjectProc (
AProc
). LoginUser ruft Ihre Prozedur auf und stellt die empfangenen Authentifizierungsdaten als JSON-Objekt bereit.
Exceptions
Exception | Meldung | Beschreibung |
---|---|---|
MasterSecret erforderlich |
Der Authentifizierungstyp ist TAuthentication.MasterSecret, und die Eigenschaft MasterSecret der Verbindungsinformationen des zugrunde liegenden EMS-Backend-Dienstes ist ein leerer String. | |
Sitzungs-Token erwartet |
Die Antwort vom EMS-Server enthält kein Sitzungs-Token. Die Antwort vom EMS-Server muss ein JSON-Objekt der Anmeldedaten sein, das ein Schlüssel/Wertepaar mit dem Wert von TJSONNames.SessionToken als Schlüssel enthält. | |
Sitzungs-Token erforderlich |
Der Authentifizierungstyp ist TAuthentication.Session, und Sie haben sich nicht angemeldet. |