Declaring the Configuration in the Design View

Path:

In this field, you can enter a path that will be displayed as part of the URL in the browser. The first time you open the .wac file, the name of the Web App Project is automatically entered.

Note:

You can change the path at runtime in the X4 Control Center via Administration > X4 API.

In this field, you can enter the path to an graphic file (.gif, .png or .svg) or a Material Icon that will be used as the logo of the web app.

Note:

• The Material Icon must be specified with the prefix icon, e.g. icon:<MaterialIconName>.
• The graphic file must be stored in the Resources folder directly inside the Web App Project.
• The logo is always displayed with a height of 45 pixels. The graphic file used as the logo is scaled automatically.

Logo Color:

Authorization Flow:

Use this drop-down list to specify which authorization flow is used.

Available options:

Public Access:
Use this option to specify that no login should be required. Users who access the Web App without login are recognized as anonymous users. They cannot be granted any special rights.

Resource Owner Password Flow:
If a Web App uses the Resource Owner Password Flow authorization flow, a user with a temporary password cannot log in to that Web App.

Note:

• If you want to use temporary passwords, use the Authorization Code Flow authorization flow.
• The Resource Owner Password Flow authorization flow will be discontinued with the next version. For security reasons, we recommend using Authorization Code Flow.

Authorization Code Flow:
Keycloak must be configured according to the selected authorization flow.

Note:

To use the single sign-on functionality, you must use the Authorization Code Flow.

Additional information:

For more information, please visit the official Auth0® Inc. website.

• https://auth0.com/docs/authorization/flows/resource-owner-password-flow
• https://auth0.com/docs/authorization/flows/authorization-code-flow

Realm:

In this field, you can specify which realm from Keycloak will be used.

Note:

The realm must be specified if Authorization Code Flow or Resource Owner Password Flow is used and a realm other than the default is to be used.

Client ID:

In this field, you can specify which client from Keycloak will be used.

Note:

The client must be specified if Authorization Code Flow or Resource Owner Password Flow is used and a client other than the default is to be used.

Client Secret:

In this field, you can specify the client secret of the defined client, which can be read from Keycloak.

Note:

The client secret must be specified if Authorization Code Flow or Resource Owner Password Flow is used and a client secret other than the default is to be used.

Access Right:

In this field, you define define which role can access the Web App. You can enter the name of a previously defined role.

Note:

The roles are managed in the Keycloak Administration Console.

Local Only:

Use this checkbox to specify whether the project should be deployed locally only. By default, the checkbox is disabled.

Note:

If this option is enabled, the web application can be displayed in the browser only in the local system.

Active:

Use this checkbox to specify whether the project is enabled. By default, the checkbox is disabled.

Note:

If the project is not active, the web application cannot be displayed in the browser.

Enable URL Parameters:

Use this checkbox to specify whether data should be transferred to a Web App when it is called.

Note:

You can change this flag at runtime using the Web App Configuration Management adapter. 

Remove Empty Properties:

Use this checkbox to define whether empty property values are sent from the Web App to the X4 process.

Available options:

• Checkbox disabled (default): Empty property values are sent from the Web App to the X4 process.

• Checkbox enabled: Empty property values are not sent to the X4 process.

Data Format:

Use this drop-down list to specify which data format is used.

Available options:

• 1.0
• 2.0 (default)

Note:

This setting cannot be changed at runtime.

Data Protection:

In this field, you can link external pages as privacy policy.

Imprint:

In this field, you can link external pages as imprint.

Logout Redirect:

In this field, you can redirect users to the specified URL after logout. You can enter any valid URL with any valid protocol (http://, https://, etc.), e.g. https://www.softproject.de/.

Map API Key:

When using Google Maps as a map provider, the folllowing APIs must be enabled:

• Maps JS API
• Locations (for search and route calculation)
• Directions (for route calculation)

Info-banner process:

In this field, you can enter the path to the .wrf file that provides the data to generate an info banner in the Web App. The Technical Process must be located in the Services/Processes folder.

Note:

The content of the info banner is reloaded automatically every 30 minutes. To reload the info banner content manually, refresh the Projects view.

In this pane, you can add the path to files in the project. The contents from the files are inserted as meta elements in the HTML head.

Note:

The file must be located in the Resources folder.