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 remplitAUser
avec 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é. |