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 */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
procedure function |
protected | REST.Backend.EMSServices.pas REST.Backend.EMSServices.hpp |
REST.Backend.EMSServices | TEMSLoginAPI |
Description
Se connecte au serveur EMS et obtient des données d'authentification que vous pourrez utiliser dans des requêtes ultérieures.
Vous devez spécifier dans (AUserName) le nom d'utilisateur de l'utilisateur qui se connecte, et le mot de passe de cet utilisateur dans (APassword).
Pour gérer les informations reçues, vous devez fournir l'un des éléments suivants :
- Une instance de TBackendEntityValue (
AUser) et un tableau JSON (AJSON). LoginUser remplitAUseravec les données reçues et ajoute l'objet JSON reçu àAJSON. - Une procédure de type TFindObjectProc (
AProc). LoginUser appelle votre procédure et fournit les données d'authentification reçues sous forme d'objet JSON.
Exceptions
| Exception | Message | Description |
|---|---|---|
|
MasterSecret requis |
Le type d'authentification a la valeur TAuthentication.MasterSecret, et la propriété MasterSecret des informations de connexion du service backend EMS sous-jacent est une chaîne vide. | |
|
Token de session attendu |
La réponse du serveur EMS ne contient pas de token de session. La réponse du serveur EMS doit être un objet JSON de données de connexion qui contient une paire clé-valeur avec la valeur de TJSONNames.SessionToken comme clé. | |
|
Token de session requis |
Le type d'authentification a la valeur TAuthentication.Session, et vous ne vous êtes pas connecté. |