OutSystems Developer Cloud (ODC) is a cloud-native app development platform that provides a modular, scalable environment in which you develop and deploy your apps. With ODC you can build and deploy enterprise-grade, mission-critical apps in weeks. You can build web apps, web portals, mobile apps, and business workflows faster than with traditional development tools. You can then deploy your apps in a scalable, secure, and high-performance environment.
This connector has two parts:
- A custom code extension : RabbitMQClient_ExternalLogic
- A library that uses the underlying custom code extension: RabbitMQ Client (Black Belt Edition)
The connector provides the following functionality (as of now):
- PurgeQueue
- Receive
- Send
There is also a operational support API to discover the unique build number for this connector so that any bugs discovered can be reported against this unique build number. The API is
- GetBuildInfo
To use this component correctly, you should have a working and running RabbitMQ instance. You should also ensure that you have:
- Valid credentials to the RabbitMQ instance
- A working virtual host setup
- A working exchange setup
- A working queue setup (remember to bind the queue to the exchange with a valid routing key)
You can install the connector through ODC Forge.
You should install both the custom code extension as well as the RabbitMQ Client (Black Belt Edition) library.
Firstly, add the RabbitMQ Client (Black Belt Edition) library to your application as shown below.
Depending whether you want to use all the APIs, you can selectively add the needed APIs (or removed unused ones automatically later).
The RabbitMQ Client (Black Belt Edition) library requires a few settings to be configured in ODC portal for your application which is using the library:
| S/No. | Name of setting | Remarks |
|---|---|---|
| 1. | RABBITMQ_HOST | The hostname / IP address of the rabbit MQ server |
| 2. | RABBITMQ_PASS | The password to connect to the rabbit MQ server |
| 3. | RABBITMQ_PORT | The port number to connect to the rabbit MQ server (default value: 5672) |
| 4. | RABBITMQ_USER | The username to connect to the rabbit MQ server |
| 5. | RABBITMQ_VHOST | The virtual host to connect to |
To send a message, you will need to supply the right configuration values. The screenshot below gives an example. Not all values are mandatory as you can see. It is recommended to have a client action (in the demo application, it is set up in GetMQConfigInfo client action) that supplies standard values across the application and override values when applicable.
NOTE: For the queue type, you should use the supplied Entities.QueueType.
To receive a message, you will need to supply the right configuration values. The screenshot below gives an example. Not all values are mandatory as you can see. In this case, the placeholder value for isExclusive is not needed and hence not supplied.
This library is capable to integrate with ODC private gateway. This allows your ODC application to send/receive messages to a RabbitMQ server instance that is on-premise.
An example of an outsystems cloud connector string is
./outsystemscc --header "token:<REPLACE WITH YOUR TOKEN SUPPLIED BY ODC ADMIN>" <REPLACE WITH YOUR SECURE GATEWAY URL SUPPLIED BY ODC ADMIN> R:<ODC PORT TO COMMUNICATE>:<HOSTNAME OR IP OF RABBITMQ SERVER>:<PORT OF RABBITMQ SERVER>
example (with confidential information replaced):
./outsystemscc --header "token:_my_secret_token_" https://some-value.outsystems.app/some-other-values-here R:5001:172.20.80.129:5672
It is important to supply the same port number (5001) for what you have supplied in outsystemcc and set it to the RABBITMQ_PORT in ODC portal. The RABBITMQ_HOST value must be secure-gateway (all in small caps).
- Only text messages are allowed. If you need to send binary data, you might want to encode it as base64 before sending
- The maximum payload sent/receive is 5.5 MB
Kindly submit your bug report here and do indicate the build number of the library which you are using too.
You can reach out to me via email at paul.ho@outsystems.com