Skip to end of metadata
Go to start of metadata

Introduction

This page contains detailed instructions for creating an implementation project based on PlusWorkflow 3.1.

The PlusWorkflow system as of version 3.1 is built using the tool Maven. It is recommended to familiarize yourself with this tool using the documentation and courses available on the web.

Requirements

Environment prepared according to the instructions on the page:

Creating a Maven project in the Eclipse environment

The first step is to create a new Maven project. To do this, call the File -> New -> Project menu:

In the newly opened window, select "Create a simple project..." and move to the next page by clicking Next.

Now you need to give the appropriate attributes to the project.

The exact rules for assigning values to individual attributes are described in the procedure for creating a project.TODO:LINK

Click the Finish button to finish creating the project.

Configuration of pom.xml file

The created project should have the following structure:

The pom.xml file contains the basic attributes of the project (name, version) and the definition of the required dependencies. The only required dependency is com.suncode:plusworkflow-web:war:

<dependency>
	<groupId>com.suncode</groupId>
	<artifactId>plusworkflow-web</artifactId>
	<type>war</type>
</dependency>

Communication with the PlusWorkflow system must be done by using the Java API. For this, you need to define the appropriate dependency, which allows you to use API classes in your project:

<dependency>
	<groupId>com.suncode</groupId>
	<artifactId>plusworkflow-api</artifactId>
</dependency>


Finally, the basic pom.xml file of the project looks as follows:

pom.xml
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<groupId>com.suncode</groupId>
		<artifactId>plusworkflow</artifactId>
		<version>3.1.4</version>
	</parent>
	<groupId>com.suncode.client</groupId>
	<artifactId>plusworkflow-rgol</artifactId>
	<version>3.1.DEV-SNAPSHOT</version>
	<packaging>war</packaging>
	<name>Swedwood Goleniow</name>
	<dependencies>
		
		<!-- System PlusWorkflow -->
		<dependency>
			<groupId>com.suncode</groupId>
			<artifactId>plusworkflow-web</artifactId>
			<type>war</type>
		</dependency>

		<!-- PlusWorkflow API -->
		<dependency>
			<groupId>com.suncode</groupId>
			<artifactId>plusworkflow-api</artifactId>
		</dependency>

	</dependencies>
</project>

Adding a project to a server

Add the project to the Tomcat server - go to the Servers tab, then right-click on the server and select Add and Remove.

Move the new project to the right side, then click Finish.

In the Project Explorer tab, right-click on the project. From the pop-up menu, select Maven -> Update project....


In the new window, select Force Update of Snapshots/Releases then click OK.

Starting the project

To start the project on the Servers tab, select the server and click Start or Debug.

FAQ

1. Eclipse does not see the DBManagement class:

All project dependencies are defined in the pom.xml file. You need to find out which module the class you are interested in comes from and declare the corresponding dependency. In the case of the DBManagement class, this is:

<dependency>
	<groupId>com.suncode</groupId>
	<artifactId>plusworkflow-old-core</artifactId>
</dependency>
2. Eclipse can't see classes with CUF:

All project dependencies are defined in the pom.xml file. It is necessary to find out which module the class of interest comes from and declare the corresponding dependency. In the case of c CUF classes, this is:

<dependency>
	<groupId>com.suncode</groupId>
	<artifactId>cuf-core</artifactId>
</dependency>

 Using classes outside the com.suncode:plusworkflow-api module is not recommended. All methods required by the implementation should be available as part of the public PlusWorkflow API or external modules (e.g. CUF). If a particular functionality is missing, create a corresponding ticket in JIRA.



  • No labels

2 Comments

  1. W pom.xml w ustawieniach parent z powodu braku w  Nexusie wersji 3.14 powinna być wersja 3.2:

     

     <parent>

        <groupId>com.suncode</groupId>

        <artifactId>plusworkflow</artifactId>

        <version>3.2-SNAPSHOT</version>

      </parent>

  2. To jest wersja rozwojowa dla progamistów, dla wdrożeniowców powinna być najwnowsza wydana.