Red Hat Training

A Red Hat training course is available for Red Hat Process Automation Manager

Integrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 7.0

Red Hat Customer Content Services

Abstract

This document describes how to integrate Red Hat JBoss Developer Studio with Red Hat Process Automation Manager.

Preface

As a developer, you can integrate Red Hat JBoss Developer Studio with Red Hat Process Automation Manager to write complex applications and leverage code auto-completion.

Chapter 1. Installing Red Hat JBoss Developer Studio

Red Hat JBoss Developer Studio is the JBoss integrated development environment (IDE) based on Eclipse. It integrates tooling and runtime components by combining Eclipse, Eclipse Tooling, and Red Hat JBoss Enterprise Application Platform. Red Hat JBoss Developer Studio provides plug-ins with tools and interfaces for Red Hat Process Automation Manager.

Procedure

  1. Download Red Hat JBoss Developer Studio:

    1. Log in to the Red Hat Customer Portal.
    2. Click DOWNLOADS at the top of the page.
    3. On the Product Downloads page that opens, navigate to the JBOSS DEVELOPMENT AND MANAGEMENT section, and click Red Hat JBoss Developer Studio.
    4. On the Software Downloads page, download Red Hat JBoss Developer Studio 11.3.0 Stand-alone Installer (devstudio-11.3.0.GA-installer-standalone.jar).
  2. In a terminal window, navigate to the directory where you downloaded the installer JAR file and enter the following command:

    java -jar devstudio-11.3.0.GA-installer-standalone.jar
  3. Follow the instructions in the installer to complete the installation.

For more information, see the Red Hat JBoss Developer Studio Installation Guide.

Important

Because of an issue in the way multi-byte rule names are handled, you must ensure that the instance of Red Hat JBoss Developer Studio is started with the file encoding set to UTF-8. You can do this by editing the $JBDS_HOME/studio/devstudio.ini file and adding the following property: "-Dfile.encoding=UTF-8".

Chapter 2. Installing Red Hat JBoss Developer Studio plug-ins

The Red Hat JBoss Developer Studio plug-ins for Red Hat Process Automation Manager are based on the community version of the plug-ins. For this reason, the Red Hat Process Automation Manager plug-in is called the Drools plug-in.

Procedure

  1. Download the Red Hat Process Automation Manager plug-ins for Red Hat JBoss Developer Studio:

    1. Log in to the Red Hat Customer Portal.
    2. Click DOWNLOADS at the top of the page.
    3. On the Product Downloads page that opens, navigate to the JBOSS DEVELOPMENT AND MANAGEMENT section, and click Red Hat JBoss Developer Studio.
    4. On the Software Downloads page, download Red Hat JBoss Developer Studio Integration Stack 11.3.0 Update Site Zip (devstudio-integration-stack-11.3.0.GA-updatesite.zip).
  2. Start Red Hat JBoss Developer Studio by selecting Red Hat JBoss Developer Studio from the Start menu.
  3. Click HelpInstall New Software.
  4. Click Add to display the Add Repository box.
  5. Enter a name in the Name field, for example, devstudio-11.3.0.GA.
  6. Click Archive, select the devstudio-11.3.0.GA-updatesite-core.zip file, and click OK.
  7. In the Install window, select JBoss Business Process and Rule Development from the list, click Next, and then click Next again.
  8. Read the license agreement, accept it, and click Finish.
  9. Restart Red Hat JBoss Developer Studio after the installation process finishes.

Chapter 3. Configuring the Red Hat Process Automation Manager server

You can configure Red Hat JBoss Developer Studio to run the Red Hat Process Automation Manager server.

Prerequisites

  • Red Hat JBoss Developer Studio is installed with the Red Hat Process Automation Manager plug-ins.
  • Red Hat Process Automation Manager is installed in a Red Hat JBoss EAP 7.1 server instance.

Procedure

  1. Start Red Hat JBoss Developer Studio.
  2. Click WindowShow ViewOther and select ServerServers to add the server view.
  3. Right-click the Servers panel and select NewServer to open the server menu.
  4. Click Red Hat JBoss MiddlewareJBoss Enterprise Application Platform 7.1 and click Next to define the server.
  5. Click Next on the Create a new Server Adapter page.
  6. To set the home directory on the JBoss Runtime page, click the Browse button and navigate to the Red Hat JBoss EAP directory where Red Hat Process Automation Manager is installed.
  7. Enter a name for the server in the Name field, ensure that the configuration file is set, and click Finish.

Chapter 4. Importing projects from a Git repository into Red Hat JBoss Developer Studio

You can configure Red Hat JBoss Developer Studio to connect to a central Git asset repository. The repository stores rules, models, functions, and processes. You can either clone a remote Git repository or import a local Git repository.

4.1. Cloning a remote Git repository

You can clone a git repository to use with Red Hat JBoss Developer Studio.

Prerequisites

  • Red Hat JBoss Developer Studio is installed with the Red Hat Process Automation Manager plug-ins.
  • You have access permission for the remote Git repository that you want to clone.

Procedure

  1. In Red Hat JBoss Developer Studio, select the server from the Server tab and click the start icon to start the server.
  2. Enter the following command in a terminal to start the secure shell server, if it is not running already.

    /sbin/service sshd start
    Note

    This command is specific to Linux and Apple Macintosh. On these platforms, if sshd has already been started, this command fails. If this happens, you may safely ignore this step.

  3. In Red Hat JBoss Developer Studio , select FileImport…​ and navigate to the Git folder.
  4. Open the Git folder, select Projects from Git, and click Next.
  5. Select the repository source as Clone URI and click Next.
  6. Enter the details of the Git repository and click Next.
  7. Select the branch you want to import and click Next.
  8. To define the local storage for this project, enter or select a non-empty directory, make any configuration changes, and click Next.
  9. Import the project as a general project in the following window and click Next.
  10. Name the project and click Finish.

4.2. Importing a local Git repository

You can import a local git repository to use with Red Hat JBoss Developer Studio.

Prerequisite

Red Hat JBoss Developer Studio is installed.

Procedure

  1. In Red Hat JBoss Developer Studio, select the server from the Server tab and click the start icon to start the server.
  2. Select FileImport and navigate to the Git folder. Open the Git folder to select Projects from Git and click Next.
  3. Select the repository source as Existing local repository and click Next.
  4. Select the repository that is to be configured from the list of available repositories and click Next.
  5. In the window that opens, select Import as general project and click Next.
  6. Name the project and click Finish.

Chapter 5. Next Steps

Appendix A. Versioning information

Documentation last updated on: Monday, October 1, 2018.

Legal Notice

Copyright © 2019 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.