X4 Produktdokumentation

Views

The X4 BPMS offers different views. Some of the available views are only available in certain perspectives.

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.

image-20260312-131333.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:

  • image-20260312-131355.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.

image-20260312-131433.png


Apps

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

image-20260312-131814.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-20260312-131848.png Pin to Selection: Pin displayed properties in the Properties view

  • image-20260312-131917.png Show Categories: Display properties by category

  • image-20260312-131938.png Show Advanced Properties: Show advanced properties

  • image-20260312-131958.png Restore Default Value: Reset to default values

  • image-20260312-132017.png View Menu: Open additional options

image-20260312-134334.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/).

image-20260312-134427.png


Output

You can access the Output view during debugging via the Debug > Output menu or via the image-20260312-134510.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-20260312-134537.png Find content: Find data in the Output view

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

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

  • image-20260312-134637.png Save content: Save data from the Output view

  • image-20260312-134659.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.

image-20260312-134716.png



Web App Preview

The Web App Preview view opens automatically when you open the Web App perspective. In the Web App Preview view, you can find a live preview of the opened Detail component.

image-20260312-134728.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
image-20260312-134803.png



Process Call Hierarchy

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

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.

image-20260312-134839.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:

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

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

  • image-20260312-134951.png Clear Log Viewer: Clean the error log

  • image-20260312-135011.png Delete Log: Delete the error log irrevocably

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

  • image-20260312-135243.png Restore Log: Restore the error log

  • image-20260312-135313.png View Menu: Open additional options

image-20260312-135328.png



Problems

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

image-20260312-135344.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.

image-20260312-135358.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.

image-20260312-135411.png



Quick Watch

You can access the Quick Watch view during debugging via the Debug > Quick Watch menu or by clicking the Unknown AttachmentQuick 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.

image-20260312-135516.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.

image-20260312-135531.png


Base64

Encode or decode Base64 strings

image-20260312-135547.png


Digest

Create a hash value for strings

image-20260312-135600.png


Regex

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

image-20260312-135613.png


URLCodec

Encode or decode URL strings


More information: