Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WBRIDGE and version 7.2.0

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.

Image Modified

In the Preferences section of the information/working area, the following preferences can be modified:

Automatic Restart
OptionDesciption
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.

Noteinfo
iconfalse

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:

[2017-10-13 17:14:11 +0200][0000000000][Error][Internal][BELM][47][Fail to handle the change "AddOns/SOAP/Service/base.tab"]

Using an older Runtime, you cannot change this preferences on the fly either, but you will not get an error.

Dump Context on ErrorSwitching 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 E2E Analyzer (function Import Trace from File) or with the E2E Interactive Debugger (function Load Dump File).
Bridge Server Log LevelRelated 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 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 LevelRelated 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 IntervalRelated 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
Multiexcerpt-include
MultiExcerptNameautomatic_startup
PageWithExcerptINTERNAL:_bridge_excerpts

Select this option, if you want the service to startup automatically, whenever the E2E 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.

Note
iconfalse

This option can be globally disabled by the Disable Automatic Service Startup option on the node instance preferences.

Multiexcerpt-include
MultiExcerptNameautomatic_restart
Whenever the service crashes, it will restart immediately. Nevertheless, in the navigation the icon Image Removed next to the xUML service name will indicate the abnormal termination.
PageWithExcerptINTERNAL:_bridge_excerpts
Owner
Multiexcerpt-include
MultiExcerptNameowner
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.
PageWithExcerptINTERNAL:_bridge_excerpts
Timer EnabledSwitching timers on / off.
Scheduler EnabledSwitching schedulers on / off.

Users with USER access rights may not change any of these preferences.

Notetip
iconfalse

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.

Noteiconfalse

Updating or reinstalling the Bridge (by keeping the deployed xUML service) will reset the automatic startup and owner preferences. The automatic startup option will be deselected, and the owner will be reset to user id admin.

Preferences of REST Services

Concerning REST services, the E2E Bridge displays additional preferences:

Figure: REST Preferences

Noteinfo
iconfalse

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.

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameservice_startup_after_update
PageWithExcerptINTERNAL:_bridge_excerpts