Introduction

Event connectors can trigger process flows by listening for events that are published to message queues/topics by a message broker (e.g. RabbitMQ).

When an event connector is added to Patchworks, you provide connection details for your message broker and then decide which queues/topics to associate with the connector. An event connector can have multiple queues/topics, and the same queue/topic can be used in multiple event connectors.

Once an event connector is defined, it becomes available for use in process flow trigger shapes.

Pages in this section

• Accessing your event connectors

• Adding a new event connector

• Updating an existing event connector

• Removing an existing event connector

• Message queues/topics

Related information

• Trigger shape (event connector)

Introduction

Existing message queues/topics can be removed at any time. Before doing this, please consider the Need to know points detailed below.

Need to know

• When a queue/topic is removed from an event connector, it is detached from any process flow trigger shapes where it has been selected for that specific event connector (broker).

• There's no effect on any other event connectors or process flow trigger shapes which are using the same queue.

The steps

To remove an existing queue/topic for an event connector, follow the steps below.

Step 1 Access your existing event connectors.

Step 2 Click the name of the event connector that you want to update - for example:

Step 3 Select the queues/topics option at the top of the page:

Step 4 Click the name of the queue that you want to remove:

Step 5 Click the 'trash' icon at the top of the page:

Introduction

Renaming existing queues/topics from event connectors and reflecting those changes in your message broker is not currently supported.

Similarly, renaming existing queues/topics in your message broker and reflecting those changes in existing event connectors is not currently supported.

What to do if a queue/topic name changes

If an existing queue/topic name changes, you should:

1. Remove the queue from any Patchworks event connectors (this also removes the queue from any process flow trigger shapes).

2. Make the required change directly in your message broker (e.g. RabbitMQ).

3. Add the 'new' (i.e. updated) queue to required Patchworks event connectors.

4. Apply the 'new' (i.e. updated) queue to required process flow trigger shapes.

Introduction

All of your installed connectors can be viewed/updated from the manage connectors page - for example:

On this page, you can see all installed event connectors. From here you can:

• Add a new event connector

• Update an existing event connector

• Remove an existing event connector

Navigating to your event connectors page

To navigate to the my connectors page, select process flows > event connectors from the left-hand navigation menu.

Introduction

When or an event connector, you have the option to add new message queues/topics.

Need to know

• When you add a new queue/topic to an event connector, it is also added to your message broker.

• You can add as many queues/topics as you want for an event connector - they will all be available for selection when this event connector is chosen as the broker in a process flow .

The steps

To add a new message queue/topic, follow the steps below.

Step 1 Access the queues/topics page for your event connector:

Step 2 Enter a name for the queue/topic, then click the create button - for example:

Step 3 The new queue/topic is added for the event connector (and is also added to your message broker):

Introduction

When adding a new event connector, you step through a series of wizard-type pages to add general settings, authentication credentials, and required queues/topics.

Need to know

• New event connectors are available for selection as brokers in process flow trigger shapes as soon as they are saved successfully.

• Event connector triggers only become active when the process flow is deployed and enabled.

• ALL messages published to selected queues/topics are passed through to the process flow.

The steps

Step 1 Log into the Patchworks dashboard, then select process flows > event connectors from the left-hand navigation menu.

Step 2 Click the add new event connector button:

Step 3 You're prompted to enter general settings for this connector:

Use the table below as a guide:

Step 4 Click the create button.

Step 5 Enter your authentication credentials for the message broker - in this case, username and password:

Step 6 Click the update button.

Step 7 Now you can select or add which message queue/topic to associate with this event connector:

Any existing queues are listed for selection, or you can add new queues/topics.

Step 8 Having added all required queues/topics, the event connector is ready to use in process flows.

Related information

• Trigger shape (event connector)

Introduction

Existing event connectors can be removed at any time. Before doing this, please consider the points detailed below.

Need to know

• When an event connector is removed, it means that it's no longer available for use as a trigger in process flows - there's no effect on any associated queues/topics within your message broker.

• If you remove an event connector that has been configured as a trigger in process flows, it is detached from those trigger shapes, automatically.

The steps

To remove an existing event connector, follow the steps below.

Step 1 Access your .

Step 2 Click the name of the event connector that you want to remove - for example:

Step 3 Click the 'trash' icon at the top of the general settings page:

Step 4 When prompted, confirm this action.

Introduction

Message queues/topics are associated with event connectors. An event connector can have multiple queues/topics, and the same queue/topic can be used in multiple event connectors.

Pages in this section

• Adding a new message queue/topic

• Renaming a message queue/topic

• Removing message queue/topic

Introduction

Event connectors can be updated at any time - you can change general settings, authentication and associated queues/topics.

The steps

To update an existing event connector, follow the steps below.

Step 1 Access your existing event connectors.

Step 2 Click the name of the event connector that you want to update - for example:

Step 3 You can now access/update general settings, authentication, and queues/topics for this event connector:

Step 4 Click the update button once all required changes have been made.