Copyright © Cloud Software Group, Inc. All Rights Reserved

Managing Formflow Context

Formflows can access information that is stored in the HTTP session established when a user logs into FormBuilder Desktop. For example, formflow context is useful for retrieving the current user name for use in process logic.

To retrieve context information, the formflow process instance must be running.

Accessing Context Data

When a user logs into FormBuilder Desktop, a new HTTP session is created for that user. You can access session data in the formflow using the Get Formflow Context activity on the Formflow palette.

For details on configuring this activity, see the TIBCO BusinessWorks FormBuilder Palette Reference.

Table 10 Parameters Retrieved by the Activity Get Formflow Context

Parameter	Description
User name	Name of the user currently logged into FormBuilder Desktop
Preferred Locale	The preferred locale is based on browser settings of the user accessing the FormBuilder Desktop
Protocol	Default protocol used to transfer data between the web browser and the servlet engine. For example, HTTP
Server Name	Name of the machine hosting the servlet engine where the formflow is running
Server Port	Port number used by the servlet engine for running the formflow application
Context Path	The web application context for the referenced formflow. Specify the string value for the Web Application Context field in TIBCO Administrator when the referenced archive is deployed. The default is /Formflows.You can change this value in the following way: In TIBCO Administrator console, select: Application Management> application_name> Configuration> application_name>Application. Select Application tab, find Formflows.war>context-root,and change the current default name Formflows into the desired name.
Temp Directory	Used to store temporary files.

Information about which user is logged in can be used in formflow logic. For example, a formflow can call an automated process for validating users, and the user information can be passed as input to the Call Process activity.

Accessing Request Data

When a user clicks a link in FormBuilder Desktop to launch a formflow, data is stored in the request. The request is the URL string for launching the formflow that is sent to the FormBuilder Desktop controller component.

You can access request data in the formflow using the Get Request Attribute activity on the Formflow palette. For details on configuring this activity, see the TIBCO BusinessWorks FormBuilder Palette Reference.

The request can contain user-specified parameters. For example, in the Get Formflow URL activity, you can specify any string for a request parameter. To access this string during formflow processing, use the Get Request Attribute activity.

Copyright © Cloud Software Group, Inc. All Rights Reserved