Progress.BPM.UserSession class

This class allows you to connect to an SBM Server and access the server’s functionality. An ABL application creates ABL BPM objects that represent objects that reside on the SBM server, and it is through these ABL objects that a developer interacts with the server. Many of these objects can be created through UserSession methods (Progress.BPM.Process, which you can create only by calling StartProcess(  ) on a UserSession object, is an example), and some can be created through methods on classes that you get from UserSession. The lifetime of an ABL object in an OpenEdge program is limited by the lifetime of the UserSession object with which it is associated.

The following constructor establishes a connection (through a URL) to an SBM Server:

Constructor

 

 

PUBLIC UserSession( INPUT connection-parms AS CHARACTER )

connection-parms

A character string containing a URL with the connection parameters that identify the SBM Server.

The URL must be in the following format:

 

Syntax 

-URL SBMServerDC://{ip-address | host-name}[:port-number ]

ip-address

The IP address of the SBM Server.

host-name

The host name of the SBM Server.

port-number

The number of the port that the SBM Server listens on. If no optional port-number is specified, the Savvion default value of 18793 is used.

 

Super Class

Progress.Lang.Object class

Interfaces

This class does not implement interfaces.

Public
Properties

Connected property

SessionId property

–

Public
Methods

 

Connect( ) method	Disconnect( ) method
GetAssignedTasks( ) method	GetAvailableTasks( ) method
GetDataSlotTemplates( ) method	GetProcessTemplateNames( ) method
GetTask( ) method	StartProcess( ) method

Public
Events

This class does not have any public events.

Notes

When the Disconnect( ) method is called on a UserSession object, all of the objects created directly or indirectly from that UserSession object become invalid. A flag on the Disconnect ( ) method identifies whether the user session is deleted on the SBM Server.

All BPM classes are a snapshot of the execution of a process on the SBM Server. It is important to consider this when working with BPM classes.

Note that executing DELETE OBJECT on a UserSession object causes the Disconnect( ) method to run, which will delete any local objects. It will have no effect on the active session in the SBM Server.