Skip to main content
Skip table of contents

Deploying a Service

Especially in fusion teams, developers want to make a finished feature or an intermediate state of a service available to other team members for testing while they continue to work on the same service. This is easily possible in the Designer by using the test environment for developing (refer to Working with the Test Environment for details) and deploying to the test server only when necessary. You only need to deploy your service if you want to allow other team members to test new features or if you want to run regeression tests against your test server.

We recommend using container deployment as the default deloyment target starting with PAS 23.1. For further information see:

The Deployment Controls are available on the service details page (refer to chapter Managing the Service Details for further information). Click on the Service panel tab (service name) to open the details page:

deployment_properties.png

Select your deployment target the first time you deploy. Use the target switch in section Options to select your desired deployment target:

Prerequisites

  • Container deployment: Your user must be assigned the xuml_container_admin profile.

  • Integration (Bridge) deployment: Your user must be assigned the integration_user profile and he must have an integration user account created by an integration administrator.

Refer to Overview of Standard Profiles in the Administration Guide.

We recommend to enter a version number and increase the number with each deployment:

Expert Advice

By default, each newly created service gets number 0.1.0 assigned. We recommend to increase the version number before redeploying each time you have made relevant changes to the service. You can change the version number in section General of the Deployment Properties. Follow the concept of semantic versioning.

In case of deployment problems, comparing the version number and the number of the deployed version can help to find out which version of the service is running.

Now use the deployment controls to deploy the service to your chosen target:

deployment_controls_deploy.png

Button

Description

button_deploy_service.png

Use this option to deploy the service to the selected deployment target.

button_application_clickable.png

Use this option to open the application of the deployed service in a new browser tab.

If this button is greyed out, the service has not been deployed yet.

button_administration_clickable.png

Use this option to open the deployed service in the management UI of the selected deployment target:

If this button is greyed out, the service has not been deployed yet.

button_api_clickable.png

Use this option to open the test UI of the service API.

If this button is greyed out, the service has not been deployed yet.

button_log_analyzer_clickable.png

Use this option to access the service logs of the deployed xUML service in the Log Analyzer.

Refer to Analyzing Platform Logs in the Administration Guide for more information about the Log Analyzer.

If this button is greyed out, the service has not been deployed yet.

Executing the Deployed Service

The deployed service is accessible via option Open Application in the deployment controls section. The start page of the deployed service looks exactly the same as that of the test service:

application_start_page.png

The handling of the deployed service is also the same:

  • Users can create new instances and execute the process.

  • Users can access the instance overview.

The difference is: The deployed version does not change, even if the developer changes the service in the test environment.

Example: Test Service vs. Deployed Service

A developer created a simple test application, containing only a user task with an assigned test form:

The test form contains two input fields and a button:

The developer deploys this version:

deployment_controls_deploy.png

After the deployment of this version, he starts to extend the test form:

Test Service

The developer opens the test service:

example_open_preview.png

The developer starts the process to create a new instance:

The adapted form opens:

form_in_development.png

Deployed Service

The tester opens the deployed service:

example_open_app.png

The tester starts the process to create a new instance:

The deployed version of the form opens:

deployed_form.png

Guidance for Designer Documentation

Creating and running services in Designer consists of several steps, all of which are explained in detail in the documentation:

Service Development:

Service Validation and Testing:

Service Deployment:

Service / Application Execution:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.