_designer_excerpts

With xUML service adapter calls, the xUML Runtime adds the following outgoing HTTP headers containing correlation information to the request:

• X-Transaction-Id or xTransactionId (in JMS context)
  This header identifies the transaction the call belongs to. You can set the transaction id manually with setTransactionID. If not set, the Runtime will generate one.
  This header will be passed through the callstack to identify all service calls that belong to a transaction.
• X-Request-Id
  This header identifies the unique request. The Runtime generates a unique number for each adapter call.
• X-Sender-Host and X-Sender-Service
  These headers contain the sender host resp. the sender service. They are set by the Runtime automatically.

Transaction id and request id will be logged to the transaction log on the adapter call (refer to Administration Guide > Contents of the Transaction Log for more details). Having this information, you can use this for error analysis or usage metrics.

The Apache Kafka documentation speaks of events that contain a message, or of records in more technical parts of the documentation. This documentation summarizes all under the term "message".

Each application offers two basic functionalities during execution: The user can start a process (and create a so-called process instance) and he can view the existing instances that have not yet been completed. These "instances in progress" are displayed in the instance list. For each BPMN model, a dedicated instance list is generated.

Use Add to add a new column.

Use Cancel to discard your changes.

Use this area to move the columns by drag and drop.

Activate this checkbox to hide this column during execution.

The input in this field is displayed as header of the column.

Technical identifier for data processing. Not visible for the end user. The input in this field is mandatory.

Use Save to save your changes.

The Transaction ID identifies a transaction. It is a unique number used to trace service calls through the call stack of multiple service calls.

• Clients calling an xUML service can provide a transaction ID in HTTP header X-Transaction-ID or xTransactionId (in JMS context).
• SOAP clients can also use the SOAP headers to provide a transaction ID.
• If an xUML service is called without providing a transaction ID, the Runtime will generate such an ID.

This ID will be passed on through the call stack of the xUML service, so that the whole transaction can be traced. This can be useful, when analyzing the log file in case of error.

The name of the selected file is displayed. If you want to select a different file, use option Change File.

The file's name is also displayed in field Name.

Change the contents of the Name field of you want to rename the backup before uploading it.

Option Confirm is only enabled after you have selected the namespace to which the file is to be uploaded.

If documentation is available, it will be opened in a new browser tab.

This allows developers to access library documentation at any time during the development process.

The content of the tree in the administration tab depends on the profile assigned to your account within Scheer PAS Administration.

Use this option if you need more or less space on the diagram pane. Click on the pane to display the start line, the second click marks the end line and defines the size of the area to be added. To add space, click from left to right to define the area. If you want to delete a horizontal space, click from right to left to define the area

Use this option if you need more or less space on the diagram pane. Click on the pane to display the start line, the second click marks the end line and defines the size of the area to be added. To add space, click from top to bottom to define the area. If you want to delete a vertical space, click from bottom to top to define the area.

You have several options to adjust the diagram pane. When you open the pane for the first time, the default view is displayed:

• The Diagram Pane is displayed in the centre at the top
  (refer to chapter Modeling BPMN for further information)
• The Execution Pane is displayed below the diagram pane
  (refer to chapter Modeling Execution for further information)
• Four Designer Panels are shown in the left sidebar
  
  • The Service Panel
  • The Controls Panel
  • The Attributes Panel
  • The Validation Panel

Activate this option to highlight all invalid elements.

Use this option to enable or disable the grid on the diagram pane. The grid supports you during modeling: If the grid is enabled, elements snap to the grid points.

This element cannot be prepopulated.

This element can be prepopulated.

• You can set a default value in the Attributes panel to be applied before displaying the form. Refer to Changing BPMN Element Attributes for more information.
• You can overwrite these defaults dynamically in the Get Data execution of a user task. How to do this is explained on Using Forms.

Confirm the security prompt in the pop-up window with Yes to delete the selected parameter from the operation.

Specify a default value for the related variable here.

You can delete a parameter in the implementation folder of the service panel using the Delete option of the context menu or the Del key.

• On Event: The model is executed when the event occurs.
• On Exit: The model is executed after completion of the task/event.
• Decision: The model is executed when the process reached the gateway.
• Get Data: The model is executed when BPMN is waiting in a user task and returns the default values for the form.

Variables created in section Local are only available for use within the current execution.

Variables created in section Persisted are usable in all executions of the BPMN model.

The variable is added to the execution pane.

Add an action script operation to the class.

Add an activity operation to the class.

Add an interface to the class.

Add a mapping operation to the class.

Add an operation to the class. The implementation is to be defined later.

Add an operation to the class.

Add a sub-class to the class.

Copy the class to paste it elsewhere to the API or Implementation folder.

Cut the class to paste it elsewhere to the API or Implementation folder.

Delete the class.

An operation adds behavior to a class or interface. The behavior describes how to process the data given by the parameters. In the context of the Designer, you can implement operations as mapping, action script or activity.

Paste the class elsewhere to the API or Implementation folder. Available if Copy or Cut option have been used before.

Change the name of the class.

A class is an aggregation of properties and operations that describes a complex data type from which objects can be created.

All elements inside the Implementation folder need to be created within packages. Add a new package via the quick action or the context menu.

A package is like a directory for the file system. It is used to group executable data model elements. Packages can have any depth of nesting: To structure your work, you can create packages within packages.
Also, packages define a sort of namespace to the contained elements. The name of the package is part of the element path, e.g. Package1.Class is different from Package2.Class.

Properties are data fields that describe the structure of the class.

Undo the previous action you performed in...

• ... one of the Designer editors (except mapping editor).
• ... the Implementation folder of the service panel.

Redo your previous action (after undo).

hint_naming_conventions

PASDOC-1658 - Getting issue details... STATUS

Apply the same naming conventions to all your models. This makes reading a model much easier. Refer to Naming Conventions and Containment Tree Organization in the Builder User Guide for an overview on practice-approved naming conventions.

In contrast to a class, an interface has no properties nor implementations. Interfaces are used to define common operations of multiple classes, and then derive from that interface.
Operations of interfaces do not have an implementation but only define the signature (parameters and types).

Operations can have parameters that define the input and output objects. Operation parameters can be of simple type (Base Types) or of complex type (class or interface).

Activate this option (Yes) to enable the possibility to export your service as an Angular project for further pro-code development. You can find the export option in the additional menu of the controls panel.
If the option is enabled, an Angular project will be created for all forms and for the instance table. Deactivate (No) the checkbox to disable the export. If the Angular build is disabled, it also will not build the Angular project on deployment.

Default is Yes.

Activate this option (Yes) to enable automatic compilation with each change in the respective model.

Deactivate (No) the checkbox to disable the automatic compilation. If you chose this option, you can trigger the compilation manually via Start validation in the controls panel. The corresponding service is also compiled during a deployment, an export of the repository or similar actions, even if automatic compilation is disabled.

Default is Yes.

Activities are modeled in activity diagrams. Refer to Modeling Activities for more information on how to create an activity diagram.

Control flows that are starting from a decision node need to have a guard expression. A guard expression is an expression that evaluates to true or false, and specifies which control flow branch to follow from the decision node on.

One of the guard expressions must be else to define the branch to follow when none of the guard expressions are true.

If a decision node branches the control flow into multiple branches, order defines the order in which the guard expressions (see Guard above) should be evaluated. This is necessary in case multiple guard expressions evaluate to true.

The else  expression does not need to have an order.

An API is the entrance port of your service. It can be used to communicate with the service from the outside. There are different kinds of APIs (e.g. REST API, SOAP API, ...) that describe different communication standards.

http_headers_adapter

With xUML service adapter calls, the xUML Runtime adds the following outgoing HTTP headers containing correlation information to the request:

• X-Transaction-Id or xTransactionId (in JMS context)
  This header identifies the transaction the call belongs to. You can set the transaction id manually with setTransactionID. If not set, the Runtime will generate one.
  This header will be passed through the callstack to identify all service calls that belong to a transaction.
• X-Request-Id
  This header identifies the unique request. The Runtime generates a unique number for each adapter call.
• X-Sender-Host and X-Sender-Service
  These headers contain the sender host resp. the sender service. They are set by the Runtime automatically.

Transaction id and request id will be logged to the transaction log on the adapter call. Having this information, you can use this for error analysis or usage metrics.

http_headers

xUML services read the following incoming HTTP headers containing correlation information:

• X-Transaction-Id or xTransactionId (in JMS context)
  This header identifies the transaction the call belongs to. You can set the transaction id manually with setTransactionID.
  This header will be passed through the callstack to identify all service calls that belong to a transaction.
• X-Request-Id 
  This header should identify the unique request.
• X-Sender-Host and X-Sender-Service
  These headers should contain the sender host resp. the sender service.

These headers will be all logged to the transaction log. Having this information, you can use this for error analysis or usage metrics.

Header information as a map. The map contains arrays of header value strings whereas the header name is the key of the map.

• Header names are lowercase and treated case insensitive.
• Multiple headers with the same name are treated as arrays.

Refer to HTTP Header Support for more information on the standard xUML HTTP headers.

Specifies the maximum size of the request in KB (1 KB = 1024 Bytes). This can be used to prevent DoS or similar attacks. When the payload of the service exceeds the given maximum, incoming request are rejected.

Specifies the maximum size of the request header in KB (1 KB = 1024 Bytes). This can be used to prevent DoS or similar attacks. When the header payload of the service exceeds the given maximum, incoming request are rejected.

Ports are elements of the UML modeling standard. A port defines an entrance point to the service and connects the API to an interface or class.

Drag the element you want to create from the toolbar and drop it on the diagram pane.

Another way to create a bpmn element is to click on the element in the toolbar, switch to the editor and click again.

To cancel the operation, press the Esc key.

In the Process folder you can create your BPMN models. One service can contain several BPMN models.

To create a model, hover over the Process folder to display the quick start icons and click Add Model.

To add an unused library to the project, click Add library .

The new BPMN model is also displayed in the service panel and you can use option Open model to open it.

When you create a new model, it opens automatically in a new tab and you can directly start modeling.

Enter a name for the BPMN model in the pop-up window Create New Model. Click Save.

Background Color

If you want to select a background color, activate the checkbox and click on the color placeholder that will appear.

Then use the color picker to select a new color or enter the hexadecimal code of the desired color:

Click here to insert or change the Name of the related element. Generated elements (like e.g. message) cannot be renamed.

Enter a name for the form in the pop-up window Create New Form. Click Save.

The new form is also displayed in the service panel and you can use option Open model to open it.

When you create a new form, it opens automatically in a new tab and you can directly start designing.

To define the timer settings, click to open the timer editor. For detailed explanations see How to Use the Scheduler/Timer.

To set the duration of the timer, the event should be trigged by a persisted property of type integer or datetime. You have two options to set the timeout in the attributes panel:

• Integer: Define the number of seconds the event has to wait.
• Datetime: Define the absolute datetime when the event should fire.

Use option Documentation to display the documentation of a library.

You can find it in the Manage Libraries dialog...

... as well as in the service panel when you hover over a library.

If you want to add your own libraries to a service, hover over the Libraries folder in the service panel and use option Manage Libraries .

The added library is now displayed in the service panel and you can use it during modeling.

The dialog Manage Libraries opens.

All libraries that have been uploaded to the current namespace are shown in this dialog:

• Currently unused libraries are displayed on the left side of the window.
• The libraries that are already used in this service are shown on the right side.

Expand the drop-down lists to display the details of each library such as versions and dependencies.

The library is now displayed in the column Used Libraries.

If you have finished, click Save to persist your changes.

Select the process start you want to trigger from the drop-down menu.

The instance list shows all running instances that have not yet been processed to the last service step.

A progress view is displayed...

• ... if an open process instance is in a state where no forms have to be filled.
• ... if the instance is in a state that your role is not allowed to see.

You can wait until the process reaches the next form (or the process end) or switch back to the overview and proceed with another instance.

Use option Refresh to update the instance list.

If the process is role-based, role labels are displayed - one for each role assigned to your user. Click a label to view only the instances allowed for that role.

For detailed information about role usage in apps, refer to chapter Role-based Authorization Concept.

Select the process for which you want to create a new instance by clicking the corresponding option.

On top of the explorer tree you can find a search box. Select the part of the explorer tree (namespace, folder or service) you want to search, and enter a search term.

Alternatively, you can also add libraries via the context menu.

Alternatively, you can open the context menu of a Process folder and select the option Add Model.

Alternatively, you can open the context menu of a Forms folder and select the option Add Form.

The Include checkbox corresponds to the element attribute Include in Library Export: Activate the checkbox for all elements that you want to include in your library.

Trigger Events: Use the attribute Trigger Events in the Attributes Panel to define which button of a form associated to the element triggers the default process flow of a BPMN process. This attribute is only available for boundary events.

• Refer to Working with the BPMN Editor for further information regarding editing of BPMN elements using the different context menus on the diagram pane.
• Refer to Styling BPMN Elements for further information regarding styling possibilities for BPMN elements, for example how to change the background color, the font style and size etc.

None. The content of this element is ignored during execution.

Enables a field-acurate layout customization.

A valid CSS class.

The attribute is used to activate Angular directives, that are created as development kit (devkit) library to expand the default functionality.

• empty attribute
• attribute with value (e.g. color="red")
• multiple entries separated by space (e.g. color="red" multiline max="5")

A commentary field for the developer. The content is invisible to users and its sole purpose is internal documentation.

Refer to  Modeling Forms for further information regarding editing of form elements using the context menu.

Field name shown in the form.

The element must be filled or used if the checkbox is activated.

Element may remain empty (default).

Element must be filled.

Technical identifier for data processing and not visible for the end user.

Alphanumercial characters and underscore.

This field is write-protected. When you use the option, Read-only is added to the bottom right of the element:

User can enter values (default).

User cannot enter values.

Displays the type of the form element in read-only mode.

In this field, you can enter text. Content added to attribute Text is shown in the element. If the user does not change the content of the field during form execution, the content of Text will be saved to the database.

The attribute is used to adjust the position of a form element in context to a bigger neighboring element.

Example: The Radio Button Group Color is much bigger than the Button Next, but the button should be shown at the bottom of the form. Therefore, the button's attribute Vertical Alignment is set to Bottom.

Supported Form Elements

Align the element in the middle of the element cell.

Align the element on top of the element cell (default).

The content of this attribute is displayed in the element when attribute Text has not been filled. The placeholder is a sample value, it is not saved to the database. When a user overwrites the placeholder, it disappears and the user's input is saved to attribute Text.

The validation panel is available in all editors, and shows xUML Compiler messages ( and ) no matter where they occur. Use the information given in the validation panel to check the mentioned elements of your service model.

The Designer supports you during modeling by validating the service, displaying messages for invalid implementations, and giving you advice on how to fix these errors.

The Designer provides all necessary base types in a Bridge Base standard library. This library is available in all services and cannot be removed. It contains the following xUML base types:

• Any
• Blob
• Boolean
• DateTime
• Float
• Integer
• String

Most of these base types are only able to hold one single piece of information, like text in a string, true or false in a boolean, or binary data in a blob.

If you want to associate several bits of information, you have to define a complex type that combines a number of independent base types and possibly other complex types. Such complex types are modeled as classes. To use your own types, you can

• define your own data structures in the Implementation folder
• provide them via a library.

Libraries are code repositories that are useful to organize your development project into re-usable pieces that can be used in multiple services. They contain predefined classes, interfaces, operations and parameters you can use during modeling by simple drag & drop.
Libraries are developed with the Builder. The Designer comes with a standard library which already provides all necessary Base Types and base type operations.

Enter a name for the service in the pop-up window Create New Service. Click Save.

The new folder is created and displayed in the tree.

• You cannot import newer versions to a system having an older version installed.
• There are no migrations if importing Designer content from versions prior to Designer 21.1.3 (2.0.165). This may result in the imported service not working.
  In the future, importing data from a version older than 21.1.3 will be disabled.

To open a service, click on the service name in the explorer tree.

1. The Service tab will open.
2. The service details will be displayed on the right side of the tree.

The new service is created and displayed in the tree.

By exporting and importing, you can transfer Designer contents between PAS installations. These installations may have divergent versions.

A Service contains one executable micro service. Services are created in the Explorer tree. The necessary settings for your service such as the service properties, the BPMN model,  the data model, used libraries and forms are managed within the service. You need to open a service to access its contents via the Service panel, refer to Service Panel for details.

Enter a name for the folder in the pop-up window Create New Folder.

Click Save.

You are now able to paste the URL, for example to an email.

The action is confirmed by a toast message.