Skip to main content

Reference

 

OutSystems

PlatformRuntime API

The OutSystems Platform PlatformRuntime API provides actions to:

  • switch the database connection in runtime;
  • retrieve the GUID that uniquely identifies the current request.

To use this API, add a dependency to your application on the PlatformRuntime_API module.

Summary

Actions
Database_WriteInParallelTransaction Write a record converted to an object using other transaction besides the main transaction of the request
DatabaseConnection_SetConnectionStringForSession Switches a Database Connection from one database to another at runtime and in the current Session.
There are some conditions to which you have to pay attention to when using this action:
- If there is a single query that uses the Database Connection with the old database before this action is executed, the switch to the new database will not happen until the end of the current request. Only in a next request the database switch becomes effective.
- The Connection String must connect to a database with the same type (e.g. Oracle, SQL Server, MySQL) as the one configured in Service Center for the Database Connection.
- Your license must include the Platform Extensibility APIs feature.
Request_GetKey Provides the RequestKey that uniquely identifies the current request.
If there is no RequestKey available in the current context, an empty string is returned.
Session_GetMobileAppLoginId Gets the token that uniquely identifies the authenticated session for a Mobile Application.
This method can be used in when managing server side session stores where you need to uniquely identify a user authenticated session.
Session_GetMobileAppLoginInfo Gets User information of the authenticated user for a Mobile Application
This method is designed for interoperability scenarios where you need to embed a Responsive screen in your mobile application

 

Actions

 

Database_WriteInParallelTransaction

Write a record converted to an object using other transaction besides the main transaction of the request

Inputs

Record
Type: Object. Mandatory.
Record to write using the a parallel transaction

DatabaseConnection_SetConnectionStringForSession

Switches a Database Connection from one database to another at runtime and in the current Session.
There are some conditions to which you have to pay attention to when using this action:
- If there is a single query that uses the Database Connection with the old database before this action is executed, the switch to the new database will not happen until the end of the current request. Only in a next request the database switch becomes effective.
- The Connection String must connect to a database with the same type (e.g. Oracle, SQL Server, MySQL) as the one configured in Service Center for the Database Connection.
- Your license must include the Platform Extensibility APIs feature.

Inputs

connectionName
Type: Text. Mandatory.
Name of the Database Connection, as defined in Service Center.
connectionString
Type: Text. Mandatory.
The Connection String to be used by the Database Connection to connect to the new database.
databaseIdentifier
Type: Text.
The initial database to use (effective only for Oracle databases, indicating the schema to be initialy used)

Request_GetKey

Provides the RequestKey that uniquely identifies the current request.
If there is no RequestKey available in the current context, an empty string is returned.

Outputs

RequestKey
Type: Text.

Session_GetMobileAppLoginId

Gets the token that uniquely identifies the authenticated session for a Mobile Application.
This method can be used in when managing server side session stores where you need to uniquely identify a user authenticated session.

Outputs

loginId
Type: Text.
Returns the session identifier or NullTextIdentifier() if no user is logged in

Session_GetMobileAppLoginInfo

Gets User information of the authenticated user for a Mobile Application
This method is designed for interoperability scenarios where you need to embed a Responsive screen in your mobile application

Outputs

userId
Type: Integer.
Returns the user identifier, or NullIdentifier() (userId = 0) if user is not logged in
isPersistent
Type: Boolean.
True if the login is persistent
  • Was this article helpful?