NGOValidateUserForSession

This call is used to validate a user for the particular session. It takes CabinetName, UserDBId and Password for validation and returns UserIndex and UserName for that user session.

Input Parameter description	View sample InputXml
Output Parameter description	View sample OutputXml
Errors and Warnings

Input Parameters description

Name	Parent Tag	Description	Valid Values	Default Values
Option	Root	Unique option for the call.	NGOValidateUserForSession	N/A
CabinetName	Root	Name of the Cabinet to which User wants to connect.		N/A
UserDBId	Root	UserDBId for the user session		N/A
Password	Root	Password of the user		N/A

Output Parameters description

Name	Parent Tag	Description
Option	Root	NGOValidateUserForSession
Status	Root	Status of the call. If it is 0, then the call is successful.
UserIndex	Root	User Index of the logged-in user.
UserName	Root	User Name of the logged-in user.
Super	Root	Whether the user is supervisor or not.
Cabinet	Root	Information between the Cabinet tags is the Properties of the Cabinet.
CabinetName	Cabinet	Name of the Cabinet.
CabinetType	Cabinet	Type of the Cabinet.
Security Level	Cabinet	Level of security for the Cabinet.
VersionFlag	Cabinet	It is a flag that indicates whether AutoVersioning is allowed or not.
ImageVolumeIndex	Cabinet	It indicates the VolumeId of the Cabinet to which the User has connected.
CreationDateTime	Cabinet	Date and Time at which the Cabinet was created.
FTSDatabasePath	Cabinet	The path where the FTS data will be stored.
CabinetLockFlag	Cabinet	Flag that specifies whether the Cabinet is locked or not.
LoginUserIndex	Cabinet	Unique Index of the User, connected to the Cabinet.
Privileges	Cabinet	A seven-bit string specifying the Privileges of the User logged in the system.
LockByUser	Cabinet	Name of the User by whom the Cabinet is locked.
Folders	Root	Information between the Folders tag is the list of folders at root level. Each Folder has its own Properties that are returned with it. Following Folders are returned in this call. Root Folder, Inbox Folder of Supervisor, Sent Item Folder of Supervisor and Trash Folder of the Supervisor.
Folder	Folders	It contains information about folder.
FolderIndex	Folder	It indicates the unique Index of the folder.
ParentFolderIndex	Folder	Index of the Parent Folder.
NoOfSubFolders	Folder	It indicates the number of subfolders of a folder.
NoOfDocuments	Folder	It indicates the number of documents in the folders.
Owner	Folder	It indicates the Owner of the folder.
OwnerIndex	Folder	It indicates the Index of the Owner of the folder.
CreationDateTime	Folder	It indicates the CreationDateTime of the folder.
RevisedDateTime	Folder	Date and time when the folder was last revised.
AccessDateTime	Folder	Date and time when the object was last accessed.
DeletedDateTime	Folder	Date and time when the object was deleted.
DataDefIndex	Folder	Index of the Data Class associated with the Folder.
ImageVolumeIndex	Folder	Image Volume Index associated with the Folder.
Comment	Folder	Comment associated with the Folder
ACL	Folder	Reserved.
AccessType	Folder	Specifies the scope of accessing the object.
FolderName	Folder	Name of the folder.
Location	Folder	It specifies the location where the object is present.
ExpiryDateTime	Folder	Date and time when the object will expire.
FolderLock	Folder	Flag that specifies whether the folder is locked.
FinalizedFlag	Folder	Flag that specifies whether the object is finalized.
ACLMoreFlag	Folder	Reserved.
LoginUserRights	Folder	Rights of the logged in User on the object.
FinalizedDateTime	Folder	Date and time when the object was finalized.
VersionFlag	Folder	Flag to indicate whether Versioning is allowed or not.
FolderType	Folder	It specifies the type of the Folder.
Services	Root	Information between the Services tag is the list of services that are registered on this Cabinet. For e.g. Image, FTS. Each service is returned within <Service> and </Service>.
Service	Services	It contains information for a particular Service.
ServiceIndex	Service	Index of the service registered on a Cabinet.
ServiceType	Service	Type of the Service registered on the Cabinet for erg Image or FTS.
HostName	Service	Name of the machine from where service is registered.
DBName	Service	It specifies the JTS information used by the service. Its format is A#B#C#D. Where A – DSN used by the service for connecting with database. B – IP Address where JTS is running C – Port at which JTS is running. D – Cabinet Name E.g. panremote#192.168.5.138#1000#SAMPLECAB
Comment	Service	Comment associated with the Service.

Errors returned from call

Code	Message	Comments
-50146	Invalid session.	The specified UserDBId is incorrect.
-50127	Invalid Password.	Either the input password is null or is incorrect.
-50006	User account has expired.	The specified user’s account has expired.
-50010	User not alive.	The specified user is not alive.
-50125	Cabinet has been locked for Administrative purposes.	The cabinet has been locked by some user for Administrative purposes.
-50110	Insufficient rights to connect to the Cabinet.	User has insufficient rights on the cabinet.