ProcessMIX User Guide
Categories

Deploy and Use

Updated on March 24, 2023
Print

In order for the project to become available for use and further integration, it is necessary to deploy it. As a result of creating a project deployment, a Java application is built and endpoints are formed for each flow.

How to deploy the project?

To deploy a project, the user should click the gray Run button with the Play symbol at the top center of the IDE. The build process of the project is initiated. The button changes its state and a green progress bar appears. Please wait for the process to finish. If there are any errors during the project build, please contact technical support.

Note:

The user can start the deployment if at least one flow has been previously created.


There is a grey Loading symbol instead of the Play symbol. This means project deploy is in progress, wait for it to be completed.

If the Run button is initially red, that means that the project can’t be deployed. You need to go to the error panel and make fixes to the project. Then try again.

If the deployment process was successful, the user sees a green button with a Pause symbol. Test Helper and Debug become available after a successful run or build of the project.

If the project was deployed, but the user made changes to the project that caused errors, the Run button turns red with an update symbol.

If the project was deployed, but the user made changes to the project, the deploy button is blue. To start deploying the project with changes, refresh the deployment by clicking the Run button.

To go to the Test Helper, the user should click on the corresponding button if it is available.

To go to the Debug, the user should click on the corresponding button, if it is available, to the left of the green button with the Pause symbol.

How to use the project?

After the successful deployment of the project, the user can get the project data in a convenient form for further use and integration.

To do this, in the top panel of the IDE, select the Project section. After that project Export.

The following export types are available:

  • Project Instance (only for on-premises installations) — a project presented in the JSON format in accordance with a predefined file structure. The exported Project Instance can be reused by the user in the ProcessMIX system via import.
  • JAR (Java Archive) — is a package file format typically used to aggregate many Java class files and associated metadata and resources into one file to distribute application software or libraries on the Java platform. Users can run a JAR file using Java 11.
  • WAR (Web Archive) — is an archive that contains all the parts of a web application: Java class files for servlets and web services, and other resources.To deploy a WAR archive, the user can use Apache Tomcat or Wildfly 14.0.1.
  • Swagger — is a project used to describe and document RESTful APIs. The Swagger specification defines a set of files required to describe such an API. As part of the ProcessMIX system, the user receives SwaggerUI, which contains requests to the API, which can be used for integration with other services.
  • WSDL — is an XML notation for describing a web service. A WSDL definition tells a client how to compose a web service request and describes the interface that the web service provider provides.
Note:

Project Instance is always available for export, and Swagger or WSDL is available only after project deployment.

To get the project in a certain view for use, the user needs to click on the required view.