Online documentation - WebsydianExpress v3.5 |
In some cases it is useful to transfer parameters to a business process at runtime in order to control the behavior of the business process.
Parameters can be transferred using either menu services or deep linking. It is not possible to transfer parameters to a business process when it is activated from a menu item in a menu bar.
The entry point to a business process is the ProcessEntryPoint function found in the WSYAPI group model.
Fields you would like to transfer as parameters should be added to the WebInput variable. The fields will be populated and can be used before you call the first page generator function in the edit point 'Call to first page generator'.
If no parameters are transferred to the business process the fields in WebInput will just be empty.
If for some reason you want to exclude a parameter from the signature protection, then the field must also be present in the variable ExcludeFromSign.
Please read the following sections for information on how parameters are transferred to fields in the WebInput variable.
Before you can add parameters to a menu service link the following you must create a business process that can process the parameters as described in Adding parameters to a business process.
Please note that all parameters transferred to the ProcessEntryPoint function will be signed, thus it will not be possible for a user to tamper with the parameters added to the menu service.
Depending on whether the menu service is inserted in the details or grid region the behavior is a little different (the grid regions is the part of the template between the grid replacement markers; if any).
In the template add parameters to a menu service using the following syntax:
/(MENU-AliasText?parameterlist)
AliasText is the name of the alias referencing the business process and parameterlist is a list of parameters separated by ampersands where each parameter has the following syntax:
For more information and examples please read Menu Services.
In the template add parameters to a menu service using the following syntax:
/(MENU-AliasText?parameterlist)
AliasText is the name of the alias referencing the business process and parameterlist is a list of parameters separated by ampersands where each parameter has the following syntax:
For more information and examples please read Menu Services.
Before you can add parameters to a menu service link the following you must create a business process that can process the parameters as described in Adding parameters to a business process.
As parameters that come from an external link is not signed, all parameter fields must be present both in the WebInput variable and in the ExcludeFromSign variable.
An URL that access the business process has the following syntax:
URL?WSLOAD=AliasText&WSCONTEXT=(Y|N)¶meterlist&WSPARMLIST=parameternamelist
name=value
An example of a deep-link URL could be:
http://mydomain/express/mysite?WSLOAD=ShowProd&WSCONTEXT=Y&ProdID=1234&WSPARMLIST=ProdID
For more information and example please look in Deep Linking.
As the parameters transferred from a deep link are not signed, it is very important that the values in the WebInput variable are validated before use.