X4 Produktdokumentation

Views

Opening Views

No other views can be opened in the BPMN Designer perspective, all relevant views are open by default.

  • Select the desired view from the View menu in the menu bar.

projects.png


Projects

The Projects view displays a tree structure of the connected repository with various elements such as projects, folders, and files. The context menu can be opened by right-clicking on an element in the Projects view. The available options change depending on where in the tree structure the context menu is called.

The Filter text field above the project tree can be used to search for files within the connected repository. Placeholders like * or ? are not possible.

The following actions can be performed using various buttons:

  • Jump-to-repository.png Jump from active Editor to Repository Navigator: Highlight opened file in the editor within the Projects view.

  • Show-or-hide-files.png Show or hide all files: Show and hide contents of the file system. Files excluded from the project are grayed out.

x4App.png


Apps

The Apps view displays all X4 Apps that are used to bundle projects.

prop_ps.png


Properties

In the Properties view, the properties of selected process modules and of opened processes can be displayed and edited:

  • The left column displays the property name, the right column contains the corresponding values.

  • A title and a description can be stored for each process. These are displayed in the generated documentation.

  • To edit properties of an opened process, click on an empty area on the workplace.

Properties.png

The most common properties are displayed by default, however, additional settings can be made using the Properties view toolbar:

  • image-20241002-085503.png Pin to Selection: Pin displayed properties in the Properties view

  • image-20241002-085534.png Show Categories: Show properties sorted by categories

  • image-20241002-085558.png Show Advanced Properties: Show advanced properties

  • image-20241002-085726.png Restore Default Value: Restore to default value

  • image-20241002-085745.png View Menu: Open additional options

start.png


Run/Debug Console

If a process is checked for errors or simulated, debug information is displayed in the Run/Debug Console view for each executed process step. Error messages are highlighted in red, successful status messages are green.

When a process step outputs an intermediate result, it is stored in a temporary file during debugging, which you can view using the corresponding reference (e.g., file://1376054979039/). 

output16x16.png


Output

info  You can access the Output view during debugging from the Debug > Output menu or using the Output icon in the toolbar.

In the Output view, you can see the results of each debug step.


image-20241002-055930.png

If the output is larger than 1 MB, a warning is displayed. You can download the data using the Load button.
Large amounts of data can affect the performance of the X4 Designer. 

You can also perform the following actions from the toolbar:

  • image-20241002-084618.png  Find content: Find data in the Output view

  • image-20241002-084609.png  Copy all content: Copy all data from the Output view to the clipboard

  • image-20241002-084602.png Copy selected content: Copy selected data from the Output view to the clipboard

  • image-20241002-084554.png Save content: Save the data from the Output view

  • image-20241002-084547.png Format content: Format the data from the Output view

Note:

Binary data is displayed as hexadecimal data in the Output view. Images and text-based contents are shown as image or text. The output of binary data as hexadecimal data does not affect the performance of the X4 Designer.


monitor.png


Server Log1175px650


The Server Log view allows you to track the server status and especially errors in the Server Log view from within the X4 Designer.

image2024-3-7_10-8-7.png

call_hierarchy.png


Process Call Hierarchy

The Process Call Hierarchy view allows you to display all repository elements using a certain process or process component in the repository.

image2024-3-7_10-9-6.png

Right-click on the desired element in the Projects view to bring up a context menu. Process Call Hierarchy then displays a list of all repository items that contain at least one reference to the selected item.

error_log.png


Error Log

The Error Log view allows you to view errors that occurred in the X4 Designer.

X4-Designer-log.png

The following additional actions can be performed via the toolbar:

  • Export-log.png Export Log: Export error log and save it as .log file

  • Import-log.png Import Log: Import error log (.log)

  • Clear-log-viewer.png Clear Log Viewer: Clear error log 

  • Delete-log.png Delete Log: Delete error log permanently

  • Open-log.png Open Log: Open log file (.log) in X4 Designer

  • Restore-log.png Restore Log: Restore error log

  • Menu.png View Menu: Open additional options

problems_view.png


Problems

In the Problems view, all errors and warnings are listed. The filter can be used to customize the displayed list.

debug16x16E.png


Debug Sessions

The Debug Sessions view lists all active debug sessions. Double-click the desired process in the view to switch to the debug session.

Active debug sessions are marked in gray. New debug sessions connected to the server are highlighted in orange.

breakpoints.png


Breakpoints

In the Breakpoints view, all set breakpoints are listed. In the view, breakpoints can be activated, deactivated and deleted. Additionally, all breakpoints can be skipped without deleting the breakpoints.

quickwatch16x16.png


Quick Watch

In the Quick Watch view, variables, parameters, and dynamic parameters can be viewed separately with their values during debugging.

To do so, choose the corresponding entry from the drop-down list:

image2024-3-7_10-11-36.png

Selected variables are updated after each debug step.

When you select the Parameters entry, you can use the Project, Global and System checkboxes to specify which type of parameters you would like to display:

image2024-3-7_10-12-10.png

If the result of the debug step contains content greater than 1 MB, a warning is displayed and the result can be downloaded via a button.
Large amounts of data can affect the performance of the X4 Designer. 

info  The Quick Watch view can be accessed during debugging via the Debug > Quick Watch menu or via the quickwatch16x16.png Quick Watch icon in the toolbar.

outline_co.png


Outline

In the Outline view, the complete process diagram is displayed as an image. By clicking on the individual areas of the illustration, it is easy to navigate through the process, even if it is larger than the size of the Designer window.

PD_Tools.png


Base64

Base64 encode or decode strings

PD_Tools.png


Digest

Generate hash value for strings

PD_Tools.png


Regex

Apply regular expression (Regex) to a string to test the expression or to directly replace the string according to a pattern

PD_Tools.png


URLCodec

URL encode or decode strings