About Model and Environment Variables

Model variables and environment variables are an optional part of every SOAP or REST document that a client submits to a VHI Web service to invoke a Web method. Although these elements are optional, meaning that the WSDL and schema, or REST metadata, do not require them in the syntax, a given application may require them to be specified to run successfully.

VHI SOAP Web services adhere to applicable SOAP standards, including WS-Resource, WS-Security, and WS-Addressing. As there may be some applications that cannot consume these features for various reasons, these options are turned off by default. You can enable these settings on the Session Server Web Service Property page in the Administrative Console.

See a List of Web Service Specifications for a description of WS-Security, WS-Addressing, and WS-Resource.

Model Variables

By default, VHI creates three model variables whenever a model is created. Any user-defined model variables that you create also are listed. How these user-defined variables are used and their semantics are application-dependent.

Within Web services there is a method, getModelVariables, that you can use to query the current settings.

Environment Variables

VHI uses environment variables to communicate to the service how to run. For example, what server or domain to use.

When using SOAP Web services, if WS-Addressing, WS-Resource, or WS-Security are enabled in the Administrative Console, then, using the WS-Addressing, WS-Resource, and WS-Security specifications, the SessionID, Password, and Username information can be placed in the SOAP header instead.

Adding Variables

After you deploy your model to the session server, you can view and test the model to see if the Web service that is created works as expected, by clicking Test on the Deployment Successful message box to open the Web Services Explorer. In the Web Services Explorer you can add, remove and view model and environment variables.


Related Topics
Bullet About Verastream Web Services
Bullet Testing Web Services
Bullet About Stateful Web Services
Bullet About Load Balancing Web Services
Bullet Using Commands to Deploy a Model Package