Installing and Configuring Mule Concur Connector
Thanh Nguyen
Installing
• You can install the connector in Anypoint Studio using the instructions in Installing a Connector from Anypoint Exchange
Configuring
1. Start Anypoint Studio and create a new Mule project: Navigate to File > New > Mule Project
2. Type a project name and click Next. Accept default values on the next screen of the wizard and click Finish.
3. In the Package Manager that appears at left by default in Studio, double-click on your application’s project name to open it, and click the application’s XML file in src/main/app/yourMuleAppProjectName.xml.
Configuring
4. Select the Global Elements tab.5. Click on the Create button, search for Concur and add a
Concur connector configuration.6. Set the Concur Connector parameters in the global
element for easy reference by your application later:– Username and password (the same ones you used to login
to the developer sandbox)– Api URL - typically https://www.concursolutions.com for the
Developer Sandbox– Consumer Key - the value of "Key" when registering the
Partner application
Configuring
Upgrading from an Older Version
1. Click the popup and check for available updates. 2. Click the Connector version checkbox and click Next
and follow the instructions provided by the user interface.
3. Restart Studio when prompted. 4. After restarting, when creating a flow and using the
Object Store Connector, if you have several versions of the connector installed, you may be asked which version you would like to use. Choose the version you would like to use
Using the Connector
• With the Concur connector you can create and extract data with most of the Concur APIs
• The operations offered are based on what is available in the Concur Developer Sandbox
Example Use Case
• Getting a "list of lists" and retrieving "quickexpenses“
• You may jump ahead and paste the code for the flows into the XML Editor in Studio after the Concur connector has been downloaded and a global element referencing your Concur instance credentials has been created
Example Use Case
Retrieve a List of Lists
1. Add a new Flow element by dragging it from the palette and give a name to the flow, such as getlists.
2. Drag an HTTP Listener into your flow from the palette.3. Double-click the HTTP Listener and click the green plus
sign next to the Connector Configuration dropdown and set the Host to localhost, and the Port to 8081.
4. Click OK to close the properties window, then enter getlists as the value in the "Path" field in this HTTP listener’s "Basic Settings" section.
Retrieve a List of Lists
5. Add a Concur connector to the new flow and select the Get list of lists operation, after selecting the Connector Configuration you desire.
6. Finally, add an Object to JSON transformer to the flow.
7. For reference you may check the particular "getlists" flow within the example XML code further down
Execute the flow and check the outcome
1. Right-click on the project in the Package Explorer, and click Run As > Mule Application.
2. Check that the application has started by monitoring the Studio console.
3. Open browser and go to http://localhost:8081/getlists
4. You should receive a JSON response
Namespace and Schema
5. Hit the stop button to halt the server running the application
Create a Quick Expense
1. Add a new Flow element by dragging it from the palette and name it "getquickexpenses".
2. Add an HTTP Listener to your flow by dragging it from the palette.
3. Use the configuration from the first demo, or if you did not create that flow, click the green plus sign next to Connector Configuration for the HTTP endpoint and enter localhost as the Host and 8081 for the Port
Create a Quick Expense
4. Click OK to close the properties window, then enter getquickexpenses as the value in the "Path" field in this HTTP listener’s "Basic Settings" section.
Namespace and Schema
5. Add the Concur connector to the new flow, referencing a global element from the Connector Confiuration and set an Operation to perform and any other properties you require.
6. Finally, add an Object to JSON transformer link in the previous example.
Execute the flow and check the outcome
1. Right-click on the project in the Package Explorer > Run As > Mule Application
2. Check the console to see when the application starts.
3. Open the browser and go to http://localhost:8081/getquickexpenses
Execute the flow and check the outcome
4. You should receive a JSON response like this:
5. Hit the stop button to halt the server running the application.
Example Use Case Code
Question and answer