BMC Remedy Connector

Select

Release Notes: BMC Remedy Connector Release Notes

Demos and Technical Reference: Anypoint Exchange

The Anypoint BMC Remedy AR System Connector is built with the BMC Remedy AR System Java API v8.1 and is compatible with BMC Remedy AR System 7.x and later. The connector exposes methods for performing CRUD operations on BMC Remedy AR System.

Read through this User Guide to understand how to set up and configure a basic flow using the connector. Read through the Technical Reference to understand how the connector operations interact with BMC Remedy AR System. You will also find demo applications here that illustrate how to use the connector operations. Release Notes are a good way to track feature additions, compatibility limitations and API version updates with each release of the connector version.

Before You Begin

This document assumes that you are familiar with Mule, the Anypoint Studio interface, Global Elements, DataSense, and batch processing in Mule. Further, it assumes you are familiar with BMC Remedy AR System.

Requirements

To use the BMC Remedy connector, you need:

BMC Remedy AR System - A BMC Remedy AR server instance v7.x or later. The connector has been tested against a BMC Remedy AR server v9.1 instance. See the Installation instructions.
BMC Remedy AR System Java API v8.1 - You can download it from here: Download.

Compatibility

Application/Service	Version
Mule Runtime	3.5.2 and higher
BMC Remedy AR API	v8.1

Application/Service

Version

Mule Runtime

3.5.2 and higher

BMC Remedy AR API

v8.1

To Install this Connector

In Anypoint Studio, click the Exchange icon in the Studio taskbar.
Click Login in Anypoint Exchange.
Search for the connector and click Install.
Follow the prompts to install the connector.

When Studio has an update, a message displays in the lower right corner, which you can click to install the update.

Configuring the BMC Remedy Global Element

To use the BMC Remedy Connector in your Mule application, configure a global BMC Remedy Connector element that can be used by all the BMC Remedy connectors in the application.

Adding the BMC Remedy Connector to a Flow

To use the BMC Remedy connector in a Mule application project:

In Anypoint Studio, click File > New > Mule Project.
Enter a name for your new project and leave the remaining options with their default values.
If you plan to use Git, select Create a .gitignore file for the project with default ignores for Studio Projects, and then click Next.
Click Finish to create the project.
Create a new Mule project in Anypoint Studio.
Drag the BMC Remedy connector onto the canvas, then select it to open the properties editor.

Configure the connector’s parameters:

Field	Description
Display Name	Enter a unique label for the connector in your application.
Connector Configuration	Select a global BMC Remedy connector element from the drop-down.
Operation	Select an operation for the connector to perform.

Field

Description

Display Name

Enter a unique label for the connector in your application.

Connector Configuration

Select a global BMC Remedy connector element from the drop-down.

Operation

Select an operation for the connector to perform.

Save your configurations.

BMC Remedy Connector Authentication

To access the data in a BMC Remedy AR System instance, you have the following possibilities in terms of authentication:

Basic authentication

All you need to do in order to use "Basic Authentication" is to provide your credentials in a global configuration, then reference the global configuration in any BMC Remedy Connector in your application. If you notice that you are getting connection timeouts or read timeouts, you can modify the Connection Timeout and Read Timeout from the General Category, to increase those values.

Required parameters for Basic authentication:
1. Username: Enter the username.
2. Password: Enter the password.
3. Server: Enter the IP of the AR server responsible for handling login requests
4. Server Port: Enter the port number on which the AR server is configured to handle the requests
5. Authentication: Enter the authentication string alias.The Authentication String Alias can be used to identify the correct authentication domain for the user.
6. Locale: Enter the locale.

To be able to use the BMC Remedy server, you need to specify the path to previously downloaded AR API library:

Required dependencies configuration:
1. Press the Add File button in "Required dependencies" section.
2. Navigate to the location of the "arapixx_buildxxx.jar" library, select it and click "Open".

Using the Connector

The BMC Remedy Connector functions within a Mule application as a secure entrance for access and updates to your organization’s information in the BMC Remedy AR System.

Your application can perform several operations that BMC Remedy AR System exposes via RPC. When building an application that connects with BMC Remedy AR System, for example, to create new application Users, you don’t have to go through the effort of custom-coding and securing a connection. Rather, you can just drop a connector into your flow, configure a few connection details, then run the app to begin transferring data.

Using the Connector in a Mavenized Mule App

After you download and install the connector, use the following steps to make the BMC Remedy connector available to inside a Mule application for use and packaging.

Add the repository information to your project’s pom.xml file:

<repositories>
    <repository>
        <id>mule-ee-releases</id>
        <name>MuleEE Releases Repository</name>
        <url>https://repository-master.mulesoft.org/nexus/content/repositories/releases-ee/</url>
    </repository>
</repositories>

Add the module as a dependency to your project using the release version:

<dependency>
    <groupId>org.mule.modules</groupId>
        <artifactId>remedy-connector</artifactId>
    <version>x.x.x</version>
</dependency>

Replace x.x.x with the version that corresponds to the connector you are using.

To obtain the most up-to-date pom.xml file information, access the connector in Anypoint Exchange and click Dependency Snippets.

Adding Connector to the Packaging Process

That way the final zip file which contains your flows and Java code also contains this module and its dependencies. Add a special inclusion to the configuration of the Mule Maven plugin for this module as follows:

<plugin>
    <groupId>org.mule.tools</groupId>
    <artifactId>maven-mule-plugin</artifactId>
    <extensions>true</extensions>
    <configuration>
        <excludeMuleDependencies>false</excludeMuleDependencies>
        <inclusions>
            <inclusion>
                <groupId>org.mule.modules</groupId>
                <artifactId>remedy-connector</artifactId>
            </inclusion>
        </inclusions>
    </configuration>
</plugin>

Common Operations

The following are the common use cases for the BMC Remedy connector:

Create single - Use this operation for creating a single new object on the Remedy AR server.
Create - Use this operation for creating one or more new objects on the Remedy AR server.
Get single - Use this operation for retrieving one existing object on the Remedy AR server by specifying the object’s Id.
Get - Use this operation for retrieving a list of existing objects on the Remedy AR server by providing a list of Ids.
Update single - Use this operation for updating one existing object on the Remedy AR server.
Update - Use this operation for updating multiple existing objects on the Remedy AR server.
Upsert single - Use this operation to create an object if the object does not already exist, or update an existing object on the Remedy AR server.
Upsert - Use this operation to create one or more objects if the objects do not already exist, or update one or more existing objects on the Remedy AR server.
Query - Use this operation for executing queries on the Remedy AR server.

Example Use Case - Creating a User

Create a new Mule Project by clicking on File > New > Mule Project. In the new project dialog box, the only thing you are required to enter is the name of the project. Click on Finish.

Now let’s create the flow. Navigate through the project’s structure and double-click on src/main/app/project-name.xml and include the elements seen in the above image.

Let’s start configuring each element. Double-click on the HTTP element.
Set the Path field to "/createUser".
Double-click on the first Transform Message element.
The data mappings should look like this:

.
Double-click on Remedy connector.
Click on the plus sign next to the Connector Configuration dropdown.
The global element properties pop-up prompts you for information required for basic authentication. For more info see the Installing and Configuring section.
In the Connection section enter the username and password credentials used to access the BMC Remedy AR System instance or reference them using the "placeholders" you may have set in a properties file.
Click OK to return to the Remedy tab.
From the Operation dropdown in the Basic Settings section choose Create.
From the Remedy Form Type dropdown in the General section choose <Object Type to Create>
1. For this example create an object of type User. Your connector’s configuration should be complete.
Double-click on the Logger component.
In the "Message" field enter the text "Entry created:"#[payload].
Double-click on the second Transform Message element.
Inside the Transform Message component, you should see this:
Run the application in Anypoint Studio (Right-click on the project name > Run As > Mule Application).
In order to trigger creation of the user, you will need to execute a HTTP POST request having the payload in the following format:
```
ParameterMap{
  [Username=[<username>]]
}
```
Monitor the Studio console for the "Entry created:" message and ensure the new object was created.

For other entities you can use a similar flow but you have to change the "Remedy Form Type" in the "Remedy" to the name of the form corresponding to the object type you are going to create, and re-map fields on the Transform Message component as needed.

Example Use Case XML - Creating a User

<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:tracking="http://www.mulesoft.org/schema/mule/ee/tracking" xmlns:dw="http://www.mulesoft.org/schema/mule/ee/dw" xmlns:remedy="http://www.mulesoft.org/schema/mule/remedy" xmlns:http="http://www.mulesoft.org/schema/mule/http" xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:spring="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-current.xsd
http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/remedy http://www.mulesoft.org/schema/mule/remedy/current/mule-remedy.xsd
http://www.mulesoft.org/schema/mule/ee/dw http://www.mulesoft.org/schema/mule/ee/dw/current/dw.xsd
http://www.mulesoft.org/schema/mule/ee/tracking http://www.mulesoft.org/schema/mule/ee/tracking/current/mule-tracking-ee.xsd">
    <http:listener-config name="HTTP_Listener_Configuration" host="0.0.0.0" port="8081" doc:name="HTTP Listener Configuration"/>
    <remedy:config name="Remedy__Configuration" username="${config.username}" password="${config.password}" server="${config.server}" serverPort="${config.serverPort}" doc:name="Remedy: Configuration"/>
    <flow name="crud_app_template">
        <http:listener config-ref="HTTP_Listener_Configuration" path="/" doc:name="HTTP"/>
        <parse-template location="form.html" doc:name="Parse Template"/>
        <set-property propertyName="content-type" value="text/html" encoding="US-ASCII" mimeType="text/html" doc:name="Property"/>
    </flow>
    <flow name="create_userFlow">
        <http:listener config-ref="HTTP_Listener_Configuration" path="/createUser" doc:name="HTTP"/>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
        <dw:transform-message doc:name="Transform JSON to User">
            <dw:input-payload doc:sample="sample_data\json.json"/>
            <dw:set-payload><![CDATA[%dw 1.0
%output application/java
---
[{
	"2": "Submitter1",
	"7": "Current",
	"8": "Short description1",
	"Login Name": payload.Username
}]]]></dw:set-payload>
        </dw:transform-message>
        <remedy:create-single config-ref="Remedy__Configuration" type="User" doc:name="Remedy">

        </remedy:create-single>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
        <dw:transform-message doc:name="Transform Create Result to JSON">
            <dw:set-payload><![CDATA[%dw 1.0
%output application/json
---
payload]]></dw:set-payload>
        </dw:transform-message>
    </flow>
    <flow name="get_userFlow">
        <http:listener config-ref="HTTP_Listener_Configuration" path="/getUser" doc:name="HTTP"/>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
        <dw:transform-message doc:name="Transform JSON to String">
            <dw:set-payload><![CDATA[%dw 1.0
%output application/java
---
payload.entry-id]]></dw:set-payload>
        </dw:transform-message>
        <remedy:get-single config-ref="Remedy__Configuration" type="User" doc:name="Remedy"/>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
        <dw:transform-message doc:name="Transform Get Result to JSON">
            <dw:set-payload><![CDATA[%dw 1.0
%output application/json
---
payload]]></dw:set-payload>
        </dw:transform-message>
    </flow>
    <flow name="update_userFlow">
        <http:listener config-ref="HTTP_Listener_Configuration" path="/updateUser" doc:name="HTTP"/>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
        <dw:transform-message doc:name="Transform JSON to User">
            <dw:set-payload><![CDATA[%dw 1.0
%output application/java
---
{
	"2": "Submitter1",
	"7": "Current",
	"8": "Short description1",
	"Login Name": payload.Username,
	"Request ID": payload.Id
}]]></dw:set-payload>
        </dw:transform-message>
        <remedy:update-single config-ref="Remedy__Configuration" type="User" doc:name="Remedy"/>
        <dw:transform-message doc:name="Transform Update Result to JSON">
            <dw:set-payload><![CDATA[%dw 1.0
%output application/json
---
payload]]></dw:set-payload>
        </dw:transform-message>
    </flow>
    <flow name="upsert_userFlow">
        <http:listener config-ref="HTTP_Listener_Configuration" path="/upsertUser" doc:name="HTTP"/>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
        <dw:transform-message doc:name="Transform JSON to User">
            <dw:set-payload><![CDATA[%dw 1.0
%output application/java
---
{
	"2": "Submitter1",
	"7": "Current",
	"8": "Short description1",
	"Login Name": payload.Username,
	("Request ID": payload.Id) when payload.Id != ""
}]]></dw:set-payload>
        </dw:transform-message>
        <remedy:upsert-single config-ref="Remedy__Configuration" type="User" doc:name="Remedy"/>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
    </flow>
    <flow name="query_userFlow">
        <http:listener config-ref="HTTP_Listener_Configuration" path="/queryUser" doc:name="HTTP"/>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
        <dw:transform-message doc:name="Transform JSON to String">
            <dw:set-payload><![CDATA[%dw 1.0
%output application/java
---
payload.Query]]></dw:set-payload>
        </dw:transform-message>
        <remedy:query config-ref="Remedy__Configuration" type="User" doc:name="Remedy"/>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
        <dw:transform-message doc:name="Transform Query Result to JSON">
            <dw:set-payload><![CDATA[%dw 1.0
%output application/json
---
payload]]></dw:set-payload>
        </dw:transform-message>
    </flow>
</mule>