Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note
iconfalse

WIP! Restricted access.

Let's take a simple scenario where a BPMN process reads some content (text message) that is stored in the product registry and passes the message to a target variable.

Tip

Before you begin,

  • Download the product installer from here, and run the installer.
    Insert excerpt
    Installing the Product
    Installing the Product
    nopaneltrue
  • Select the relevant WSO2 Integration Studio based on your operating system and download it from here.
    The path to this folder is referred to as <EI_TOOLING> throughout this tutorial.

    Info

    Getting an error message? See the troubleshooting tips given under Installing WSO2 Integration Studio.

Let's get started! This tutorial includes the following sections:

...

  1. Create a text file named TestBPMN.texttxt with the following text content: 'Sample content stored in the registry'
  2. Create a registry resource project:
    1. Open WSO2 Integration Studio and click Miscellaneous → Create New Registry Project  in the Getting Started view as shown below.
    2. In the dialog that opens, enter a name for the registry project.
    3. Click Finish and see that the project is now listed in the project explorer.
  3. Add the TestBPMN.texttxt file to the conf directory of the product registry:
    1. Right-click the registry resource project in the left navigation panel, click New, and then click Registry Resource. This will open the New Registry Resource window.  
    2. Select the Import from file system option as shown below and click Next.
    3. Click Browse file and select the TestBPMN.texttxt file that you created.
    4. In the Registry field, select conf as the registry directory. 
    5. In the Registry path to deploy field, set repository/ as the path.
    6. In the Save Resource in field, select the existing registry resource project.
    7. Click Finish.

...

Now, let's configure the READ task to read the content from the registry resource (TestBPMN resource) and write it to a specific target.

Select the Read READ task in the diagram, go to the Properties/Main Config tab, and enter the following configurations:

ResourceOriginTargetType
conf:/repository/TestBPMN.txtREGISTRYtestingstring

Image RemovedImage Added

The descriptions of the properties are as follows:

...

Configuring the User Task

Select the User task , go and apply property values:

  1. Go to the Properties/Main config tab and enter admin in the Assignee field.
    Image Added
  2. Go to the Properties/Form tab and enter the following configurations:

Image Removed

Use the following values as Form properties:

  1. idNameTypeExpression

...

  1. RequiredReadableWriteable
    variabletestingstring${testing}

...

  1. falsetruefalse


    Image Added

Deploying the artifacts

Follow the steps below to deploy BPMN artifacts.

...

the

...

artifacts

...

...

Follow the steps below to deploy the registry artifacts.

  1. See the instructions on packaging the registry resource in Create a composite applicaition project (C-App project) to package the registry resource:
    1. Open the Getting Started  view and click  Miscellaneous → Create New Composite Application .

    2. In the  New Composite Application Project  dialog that opens, select the registry project and click Finish.
    1. In the Composite Application Project POM Editor that opens, under Dependencies, set the server role of the registry resource to Business Process Server as shown below.
  2. To create the Export a CAR file , do one of with the followingregistry artifacts:
    1. Be sure the the registry resource is selected as a dependency in th C-App project.
    2. Right-click the C-App project and select Export Composite Application Project from the pop-up menu. Alternatively, open the pom.xml file in the Composite Application Project POM Editor and click the button for creating an archive in the upper-right corner.
    3. Specify a location to save the CAR file.
      You have now exported the registry resource into a single CAR file.
  3. To deploy Deploy the CAR file in the Business Process server of WSO2 EI:
    1. Start the Business Process profile.
    2. Open the management console of the Business Process profile.
    3. Go to Main → Carbon Applications → Add and select the CAR file.

Follow the steps below to deploy BPMN artifacts.

  1. See the instructions on creating the deployable archive for the BPMN artifacts.
  2. See the instructions on deploying BPMN artifacts.

Testing the output

Follow the steps below to test the output.

  1. Log into the BPMN-explorer at https://localhost:9445/bpmn-explorer using admin for both the username and password.
  2. Click PROCESSES in the top menu, and click the Start option of the Read Task process.
    Image Added
  3. Go to MONITORING → ADVANCED FILTERING. Then select the ReadTask process as the Process Definition ID and click Search to find the running process instance.
    Image Added
  4. Select your process instance to see details. Click the Variables tab and see that the content that you stored in the registry ('Sample content stored in the registry') has been written by the user task.