Fiorano Preferences are available under Window > Preferences > Fiorano

The common preferences like security for Enterprise Server connections and JMX connections can be provided here.


Figure 1: Fiorano preferences

Security Options

Remember login password: If this option is enabled, the password for any user logged out of Enterprise Server (in Online Event Process Development) and any Administrative or JMX Server (in Connection Management) is saved for the future login. The password is also saved in case the connected server goes down or when the studio is restarted.

By default this option is disabled and the password fields are set to blank. Hence, while logging into an Enterprise Server for the first time or in future, whenever the password field is emptied, a dialog box prompts to enter the password wherein this preference can be set as well.

JMX Connections

By enabling the preferences under this section

  • Show expert operations
  • Show hidden operations
  • Show hidden Attributes

As the names suggest, users can view the expert operations, hidden operations and hidden attributes respectively for the JMX connection.

Various sections in Fiorano Preferences are explained in the following sections.

ESB Connection Preferences

Enterprise Server configurations can be defined here. List of Enterprise Servers can be added and the server details such as IP address, port and security credentials can be provided. Configuration of these servers is used in Offline Event Process Development perspective for actions (export Event Process to server, import Event Process from server etc.) that require server connection.


Figure 2: Enterprise Server Configurations

Restore Defaults button is used to restore the preferences to default values.

Mapper

Fiorano Mapper preferences are listed under this section.


Figure 3: Mapper Preferences

Limit Tree depth

This option is used to hide and hence reduce the size of the input/output tree or schema structure thereby reducing the load to the system.

Limit Tree Depth in Mapper

While loading a structure to the input or output trees in Mapper, the whole structure is parsed in a single go and the tree is loaded with the entire structure. This can cause mapper to load slowly and can also cause memory issues while dealing with large/complicated structures.

Selecting a value from the Maximum Tree Depth option under Limit Tree depth in Mapper configures the depth till which nodes are loaded and displayed automatically.


Figure 4: Option to limit tree depth in Mapper

Icon
  • All the nodes which have mappings defined will be loaded automatically irrespective of the maximum level chosen.
  • Nodes from deeper levels can be seen by expanding parent nodes.

Limit Output Port Schema Tree Depth

Refer the Limit scheme tree depth on port subsection under the Orchestration section below.

Test Classpath

Mapper allows users to test the mappings defined using the Test option (Refer section Testing the Transformation). If the mappings use Custom java functions, the user has to add them to the classpath before testing the transformation. This table provides the user an option to add/remove entries from the test classpath.

Icon

A few entries are added to the classpath by default viz., external libraries for Saxon and Xalan, DB look-up functions and jars added in %FIORANO_HOME%/runtimedata/eMapper/jars folder.

Orchestration

Orchestration preferences are grouped into General options, Workflow options, Service options and CPS options.

General Options

General Options contain preferences for Error Port and Routes Color and Route Shape. The preference chosen here will be applied in orchestration editor.


Figure 5: Orchestration Preferences

Limit scheme tree depth on port

While loading a structure of output port schema, the whole structure is parsed in a single go and the tree is loaded with the entire structure. This can slow down the loading of microservice and can also cause memory issues while dealing with large/complicated structures. While dealing with lengthy schemas, the option similar to Limit Tree Depth in Mapper may be used as below.

Maximum Tree Depth option present at Orchestration > General Options > Limit Tree Depth limits the depth of the Output Port schema structure that is loaded and displayed automatically.


Figure 6: Option to limit tree depth in Output Port Schema

Route Style

Changing the route style from Automatic to "Manhattan" gives a more organized look for the routes connecting the microservices. This interface is helpful for applications involving numerous microservices.


Figure 7: Option to choose the Manhattan route style


Figure 8: Route style before and after for the ComposieBC Demo EP under Samples

Icon

Applications that are already open needs to be closed and reopened for the change in appearance to take effect.

Orchestration Editor

Enable the Background for Orchestration Editor option to turn the default white background of the orchestration editor to one with a grid watermark view.


Figure 9: Option to enable the Grid Watermark background


Figure 10: Editor style before and after for the ComposieBC Demo EP under Samples

Icon

Applications that are already open needs to be closed and reopened for the change in appearance to take effect.

Logging Preferences

Logs that appear in the Error Log and Console (refer to the respective sections in the Offline Event Process Development views section) panels can be configured to either display in the respective panels or save in a file.

File Logger

Logs will be saved in a file instead of getting displayed in the Error Log / Console panel.

PropertyDescription
Log LevelLogs can be restricted to either  Info, Warning or Error.
Directory

The location where the log file gets saved, which is %FioranoHome%\runtimedata\eStudio\workspace\.repositories\logs.

File SizeSize of each log file. After reaching the size limit, it gets saved to the next file if more than 1 has been specified in the number of files (next property).
# of filesThe number of log files to be generated in which lags can be saved. When all the files are exhausted with log data, it starts overwriting from the first log file.
Time Stamp FormatPrefixes timestamp to the log message. The default format is dd/MM/yyyy HH:mm:ss


Figure 11: Logger Type configuration properties

Icon

If this Logger Type is selected, then logs no more appear in the Error Log and Console panels but get directly saved in the files generated as per configuration.


Figure 12: Info and Error logs saved in the log file with the timestamp format as specified

Console Logger

Log level can be restricted to Info, Warning or Error, and a time stamp can be appended to the logs.

If this logger type is selected, logs won't be saved to a file, but will just be displayed in the Error Log and Console panels.


Figure 13: Information logs displayed in the Console panel with the timestamp format as specified

Icon

The two screenshots above are taken between 18:20 and 18:42, where the Logger Type property has been Changed from "ConsoleLogger" to "FileLogger" from the time 18:21 till 18:41 and then switched back. Changes can be noticed from the timestamp in the logs.

Workflow Options

Workflow options contain Workflow color information. Workflow Item color and Workflow End color used in Document tracking can be configured here.


Figure 14: Workflow options

Service Options

Default configurations for Service Instances can be provided here. These default configurations are set on a service instance when a new service instance is created.

Default JVM Configurations

JVM configurations like classpath, System properties, memory options etc. can be defined. These options are used while launching the component in Separate Process launch mode.

These are the default configurations that are applicable to all the newly created service instances. Service Instances can also overwrite the default configurations set on them by making modifications in properties view.


Figure 15: Service options

Configurations defined here are set on the Service Instance in Runtime Arguments section of the properties view. For example if the user wants to change the heap memory settings, he can provide the values for memory tuning properties.


Figure 16: Memory tuning options

After defining these configurations, the default values are set when a service instance is drag-and-dropped in Orchestration editor and can be seen in Runtime Arguments section.


Figure 17: Runtime Arguments

These properties are set on the JVM on which the service instance will be launched.

Connection Factory Preferences

Configurations used by service instances while creating Connection factories can be defined here. The connection factories are created internally by using default configuration. To overwrite the defaults, user can set the properties here.


Figure 18: Connection Factory Settings

The properties defined here are available in Execution section in service instances Properties view.

CPS Options

These options are used by external CPS launch components where the CPS is launched as a separate JVM process. The following components CPS is launched in separate process JVM: SapR3, XMLSplitter, SapR3Monitor, Aggregator, CBR, Join, CompositeBC, JMSIn:5.0, JMSOut:5.0 and JMSRequestor:5.0.

Apart from these prebuilt components, custom components CPS will also be launched in a separate process JVM.


Figure 19: CPS launch options

Orchestration Online

This section contains configurations for online Event Process orchestration.


Figure 20: Online Orchestration preferences

General Options

Lock running service instances: This option prevents the service instances from being moved or dragged when an Event Process is running.

Application Options

Launch Services when application is synchronized: If this option is enabled, in a running Event Process, service instances in stopped state will be started if the user clicks the Synchronize button in an Event process.

Service Options

The color of the Service Instance label name at different execution status can be configured from here, that is, when a Service Instance is running, stopped and so on.

By default when a Service Instance is dragged and dropped the instance name color is Black. The states and corresponding Service instance label name colors are explained below.

  • Handle Created State: This color is shown when the service instance handle is created. This happens before the component is launched completely.
  • Handle Bound to Peer state: This color is when the service instance is running.
  • Handle Bound to no peer state: This color is shown when the peer server on which the component is running is stopped.
  • Handle unbound state: This color is shown when the component in a running Event Process is stopped.

Peer Options

These are the colors applied to service instance border to reflect the status of the peer server on which the service instance is configured to launch.

  • Unknown State: The peer server configured is unknown. i.e. the peer server configured is not running and is not present in peer repository node under Enterprise Server node.
  • Dead State: The peer server configured is not running but it is present in peer repository node under Enterprise Server node.
  • Live State: The peer server configured is present in Peer repository and is running.
  • Show Peer Server availability notifications: Whenever a peer server connects to the Enterprise Server or disconnects from Enterprise network, a notification dialog appears.

Enterprise Server Options

This option is applicable to the Enterprise Server prior to login or relogin into the eStudio.


Figure 21: Enterprise server options

Hide the confirmation dialog when switching between Enterprise Servers: If this option is enabled, when the user is working on multiple servers, the user is no longer prompted with a confirmation dialog to switch the active server and an incative server will be automatically made active whenever the user wants to perform any action (Open Event Process, delete Event Process, CRC, Launch, Import, Export, and so on) on that Enterprise Server.

Time (minutes) for relogin attempt upon HA failover: An Active Server connection failure triggers the enterprise server node connected to that server to reconnect to the backup server or the same server whichever becomes active within the time interval (in minutes) specified here. In case the server(s) takes too long to switch their state(s), a message is logged on the console and the attempt to relogin to studio is failed. It is advisable to increase the time in this case approximately to the time taken by any of the servers to become active.


Figure 22: Peer server notification

Key Board Short Cut Preferences

Before using Key Board shortcuts Fiorano scheme has to be set in Preferences (Window > Preferences > General > Keys).


Figure 23: Key-binding preferences

The default Key Board shortcuts for various actions are listed below.

  • Help F1
  • Rename F2
  • Undo Ctrl + Z
  • Redo Ctrl + Y
  • Add Event Process CTRL + I
  • Open Event Process CTRL + O
  • Import Event Process CTRL + ALT + I E
  • Import Event Process (nStudio) CTRL + ALT + I N
  • Import Service (from Local Disk) CTRL + ALT + I L
  • Import Service (from Server) CTRL + ALT + I S
  • Export Event Process CTRL + ALT + X E


Insert
1. Service Instance CTRL + ALT + A S
2. Event Process CTRL + ALT + A E
3. Remote Service Instance CTRL + ALT + A R

CRC ALT + Shift + C
Run Application ALT + Shift + R
Synchronize ALT + Shift + S
Stop Application ALT + Shift + K

View
1.View Debugger CTRL + ALT + V D
2.View Properties CTRL + ALT + V P
3.Logs CTRL + ALT + V L
4.View Error ports CTRL + ALT + V E
5.View Route Names CTRL + ALT + V R

Clear Logs ALT + C
Export Logs ALT + X
Toggle Lock Mode ALT + Z
Schema repository CTRL+Shift+S
Create Service component CTRL+Shift+N

The option to edit keyboard shortcuts is also available under General > Keys section in the preferences dialog. The list of Fiorano Orchestration commands can be viewed by entering Orchestration in the filter box provided above the available keys. The shortcut for any of the action/command can be changed by editing the Binding text field available below the keys table section.

Adaptavist ThemeBuilder EngineAtlassian Confluence