Preferences of an xUML Service
All users may view preferences of an xUML service. Expand the tree below a node instance in the Node Instances section of the navigation on the left. Then, navigate to an xUML service entry below the sub-navigation item xUML Services. The tab xUML Service is initially displayed.
In the Preferences section of the information/working area, the following preferences can be modified:
Option | Desciption |
---|---|
Tracing and Mockups Enabled | Switching tracing and mockups on / off. All xUML services are compiled with tracing and mockups enabled. This option allows you to turn off the tracing, so that no trace information is returned by the Bridge when a service is called. To change this preference, you have to stop the service - it cannot be changed on a running service. Runtime 2017.8 If you change the flag during runtime, you will get an error "Failed to update the running xUML service". In the service log you will see the following:
Using an older Runtime, you cannot change this preferences on the fly either, but you will not get an error. |
Dump Context on Error | Switching error dump on / off. Each time an xUML service throws an exception, actual call stack and data is logged in a trace file. This trace information can be viewed with the Analyzer (function Import Trace from File) or with the Interactive Debugger (function Load Dump File). |
Bridge Server Log Level | Related to the xUML service standard log.The Bridge process running the selected xUML service logs activities like starting and stopping xUML services, loading add-ons, etc. according to the log levels listed in a table on Bridge Server Log Levels of an xUML Service. Users, who have MODELER access rights, may only change the log level, if they themselves or a member of the same group deployed the xUML service. The logged information is described in detail on xUML Service Standard Log. |
Transaction Log Level | Related to the xUML service transaction log.The Bridge process running the selected xUML service logs data usable for performance measurements or statistical evaluations. The transaction log levels are described on Transaction Log Levels of an xUML Service. Users, who have MODELER access rights, may only change the log level, if they themselves or a member of the same group deployed the xUML service. The logged information is described in detail on xUML Service Transaction Log. |
Transaction Log Rotation Interval | Related to the xUML service transaction log. The transaction log rotation interval configures the segmentation of the transaction log: one logfile per day or one logfile per hour (default is daily). Users, who have MODELER access rights, may only change the log level, if they themselves or a member of the same group deployed the xUML service. |
Automatic Startup | Select this option, if you want the service to startup automatically, whenever the Bridge is started. Only users who are member of a group, to which the role ADMIN has been assigned, are allowed to change this option. This option can be globally disabled by the Disable Automatic Service Startup option on the node instance preferences. When updating the BRIDGE, all deployed services (xUML, Node.js, and Java services) will be kept. However, the automatic startup option will be ignored on the very first start-up after the update. |
Automatic Restart | Whenever the service crashes, it will restart immediately. Nevertheless, in the navigation the icon next to the xUML service name will indicate the abnormal termination. |
Owner | The group id of the user who has deployed the service. Only users who are member of a group, to which the role ADMIN has been assigned, are allowed to modify the owner of the service. |
Timer Enabled | Switching timers on / off. |
Scheduler Enabled | Switching schedulers on / off. |
Users with USER access rights may not change any of these preferences.
The preferences can be changed on the fly, while the xUML service is still running. Sole exception: Tracing and Mockups Enabled.
Click Apply to save your modifications. All future incidents will be handled according to the new settings.
Preferences of REST Services
Concerning REST services, the Bridge displays additional preferences:
Figure: REST Preferences
This section is only visible for REST services.
In section Rest Ports, you find a list of all REST service components and their port types. You can do the following here:
- Click the port type (e.g. SupportAPI in the figure above) to access the REST service documentation page.
For more information on REST documentation refer to REST Interface Documentation. - Click the Test link to access the same documentation page with additional test capabilities.
For more information on testing REST services, refer to and Testing REST Services.
When updating the BRIDGE, all deployed services (xUML, Node.js, and Java services) will be kept. However, the automatic startup option will be ignored on the very first start-up after the update.