Session Transactions

Session Transactions are used to log an analyst in and out of the ASM full application.

Limited Support/End of Life Capabilities

The Classic API has been replaced by the Alemba RestFul API. While we will continue to support the Classic API for clients that are still using it, no further development will be done.

If you need to request a hotfix or support for these features, please contact Alemba Support

The ASM web service also gives the option of providing the login details to each transaction instead of calling the LogIn and LogOut transactions. If the web service transactions are called in this way, the analyst is logged in, the transaction executed after which the analyst is logged out.

The ASM web service allows multiple concurrent sessions for one analyst. This means that an analyst can be logged in to the main application and also be calling an API transaction at the same time without automatically logging out of the original main application session. This will only take up one concurrent license.

LogIn Transaction

The LogIn transaction logs the analyst into the system specified and generates a session ID for their session. This session ID can then be passed to each transaction called through the API web service.

The LogIn transaction follows the same license checks as the main application. If an analyst is already logged on to ASM, an API session will not log them out of that session.

Input Parameters: LoginRequest

Argument

Type

Mandatory

Default

Description

sLoginUserID

String

Yes

N/A

Analyst’s Login ID

sLoginPassword

String

Yes

N/A

Analyst’s Password

sDatabase

String

Yes

N/A

Name of the ASM System for logging in.

Return Values: LoginResponse

Argument

Type

Description

sID

String

Session ID returned. Will be “” if login failed

sMessage

String

Error/Warning Message returned from the API transaction.

Ret

APIReturn

Error/Warning Number returned from the API transaction.

LogOut Transaction

The LogOut transaction logs a selected analyst out of ASM.

As soon as the analyst is logged out of the system, their Session ID becomes invalid. A warning will be returned if an invalid session ID or no session ID is passed to the transaction.

Input Parameters: LogOutRequest

Argument

Type

Mandatory

Default

Description

sID

String

Yes

N/A

Analyst’s current Session ID

Return Values: LogOutResponse

Argument

Type

Description

sMessage

String

Error/Warning Message returned from the API Transaction

Ret

APIReturn

Error/Warning Message returned from the API Transaction

Copyright 2023 Alemba, ASM EOS 10.4