X4 Produktdokumentation

Views

Opening views

No further views can be opened in the BPMN Designer perspective, as all relevant views are opened 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. You can access the context menu by right-clicking an element. Depending on where you are in the tree structure, the options in the context menu change.

Use the Filter text field above the project tree to search for files within the connected repository. Placeholders such as * or ? are not possible.

You can perform the following actions using the toolbar of the Projects view:

  • Jump-to-repository.png Jump from Active Editor to Repository Navigator: Select the file opened in the editor in the Projects view

  • Show-or-hide-files.png Show or hide all files: Show and hide the 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, you can view and edit the properties of selected process components and open processes.

  • The properties are in the left column, and the corresponding values are in the right column.

  • A title and a description can be stored for each process. This information is displayed in the generated documentation.

  • To edit the properties of an open process, click an empty area on the drawing surface.

Properties.png

By default, the most common properties are displayed. However, you can make additional settings using the toolbar of the Properties view:

  • image-20250313-141258.png Pin to Selection: Pin displayed properties in the Properties view

  • image-20250313-141314.png Show Categories: Display properties by category

  • image-20250313-141327.png Show Advanced Properties: Show advanced properties

  • image-20250313-141345.png Restore Default Value: Reset to default values

  • image-20250313-141400.png View Menu: Open additional options

start.png


Run/Debug Console

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

If a process step returns an intermediate result, it is stored in a temporary file during debugging, which you can view via the corresponding reference (for example, file://1376054979039/).

output16x16.png


Output

info You can access the Output view during debugging via the Debug > Output menu or via the output16x16.png Output icon in the toolbar.

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

image-20241002-055823.png

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

You can execute the following actions using the context menu:

  • image-20250313-141620.png Find content: Find data in the Output view

  • image-20250313-141639.png Copy all content: Copy all data in the Output view to the clipboard

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

  • image-20250313-141704.png Save content: Save data from the Output view

  • image-20250313-141714.png Format content: Format data from the Output view

Note:

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

monitor.png


Server Log

In the Server Log view, you can track the server status and, in particular, errors in the server log from the X4 Designer.

image2024-3-7_8-39-8.png

call_hierarchy.png


Process Call Hierarchy

In the Process Call Hierarchy view, you can display which repository elements use a process or process component in the repository.

image2024-3-7_8-43-16.png

If you right-click an element in the Projects view, a context menu is displayed. With Process Call Hierarchy, a list of all repository elements that contain at least one reference to the selected element is displayed.

error_log.png


Error Log

In the Error Log view, you can view errors that have occurred in the X4 Designer.

X4-Designer-log.png

You can execute the following actions using the context menu:

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

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

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

  • Delete-log.png Delete Log: Delete the error log irrevocably

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

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

  • Menu.png View Menu: Open additional options

problems_view.png

Problems

All errors and warnings are listed in the Problems view. You can customize the list of problems using the filter icon.

debug16x16E.png


Debug Sessions

All active debug sessions are listed in the Debug Sessions view. Double-click a process in the Debug Sessions view to switch to the associated debug session.

Active debug sessions are grayed out. New debug sessions associated with the server are highlighted in orange.

breakpoints.png


Breakpoints

All set breakpoints are listed in the Breakpoints view. You can enable, disable, and delete breakpoints. You can also skip all breakpoints without deleting the breakpoints.

quickwatch16x16.png


Quick Watch

info You can access the Quick Watch view during debugging via the Debug > Quick Watch menu or by clicking the quickwatch16x16.png Quick Watch icon in the toolbar.

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

To do this, select the appropriate entry from the drop-down list:

image2022-12-21_12-27-35.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 parameters you want to display:

image2022-12-21_12-31-5.png

If the result contains content larger than 1 MB, a warning is displayed and you can download the result by clicking a button.
Large amounts of data can negatively impact the performance of the X4 Designer.

outline_co.png

Outline

The complete process diagram is displayed as an illustration in the Outline view. You can click on individual areas in the image to easily navigate the process, even if the image is larger than the designer window.

PD_Tools.png

Base64

Encode or decode Base64 strings

PD_Tools.png

Digest

Create a hash value for strings

PD_Tools.png

Regex

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

PD_Tools.png

URLCodec

Encode or decode URL strings