Skip to main content

Creating a New DPU in UnifiedViews

Abstract

Creating a New DPU in UnifiedViews

This section contains a guide on how to create a DPU in UnifiedViews.

If you are not familiar with basic concepts of UnifiedViews (DPU, data unit, etc.), you find thebasic concepts of UnifiedViews in a separate section with respect to DPU development.

For general installation notes, refer to the installation guide.

Quick Start Using the DPU Archetype Template

Note

Before you start, make sure that the development environment is prepared as we described it in Development Environment Setup.

UnifiedViews provides a Maven Archetype that generates a skeleton for a new DPU for you.

You can access it in two ways:

  • From within your IDE, using the wizard. Click New ProjectMavenCreate from archetype

  • Use the interactive command line.

You have first to make sure that the SWC repository is configured correctly.

The Maven Archetype is either available at the remote UnifiedViews repository under the following coordinates:

  • groupId: eu.unifiedviews

  • artifactId: uv-dpu-template-base

  • version: matching the latest release of PoolParty, or your targeted release

Alternatively, you may also checkout and install the UnifiedViews - Plugin-devEnv repository, master branch on your computer to have all needed artifacts in your local repository.

Using the Command Line

If you are using IntelliJ as IDE, you can use IntelliJ's built-in terminal.

$ mvn archetype:generate -DarchetypeGroupId=eu.unifiedviews -DarchetypeArtifactId=uv-dpu-template-base -DarchetypeVersion=8.0.0 -Ddpu_name=my-dpu -Ddpu_type=Extractor -Ppoolparty-profile

Replace the values for dpu_name and dpu_type. For more information, go to basic concepts of UnifiedViews for supported DPU types, default is 'Transformer'.

The output should be similar to the following:

[INFO] Generating project in Interactive mode
...
Define value for property 'groupId': eu.unifiedviews.plugins
Define value for property 'artifactId': my-dpu-project
[INFO] Using property: version = 1.0.0-SNAPSHOT
Define value for property 'package' eu.unifiedviews.plugins: : 
[INFO] Using property: author = SWC
[INFO] Using property: dpu_name = my-dpu
[INFO] Using property: dpu_type = Extractor
[INFO] Using property: unifiedviews_api_version = 8.0.0
Confirm properties configuration:
groupId: eu.unifiedviews.plugins
artifactId: my-dpu-project
version: 1.0.0-SNAPSHOT
package: eu.unifiedviews.plugins
author: SWC
dpu_name: my-dpu
dpu_type: Extractor
unifiedviews_api_version: 8.0.0
 Y: : 
[INFO] ----------------------------------------------------------------------------
[INFO] Using following parameters for creating project from Archetype: uv-dpu-template-base:8.0.0
[INFO] ----------------------------------------------------------------------------
[INFO] Parameter: groupId, Value: eu.unifiedviews.plugins
[INFO] Parameter: artifactId, Value: my-dpu-project
[INFO] Parameter: version, Value: 1.0.0-SNAPSHOT
[INFO] Parameter: package, Value: eu.unifiedviews.plugins
[INFO] Parameter: packageInPathFormat, Value: eu/unifiedviews/plugins
[INFO] Parameter: dpu_name, Value: my-dpu
[INFO] Parameter: unifiedviews_api_version, Value: 8.0.0
[INFO] Parameter: dpu_type, Value: Extractor
[INFO] Parameter: author, Value: SWC
[INFO] Project created from Archetype in dir: /home/user/Develop/my-dpu-project
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

Note

You will be asked for missing artifactId or groupId, but not for dpu_name and dpu_type, make sure to specify them on the command line.