External Nodes used are used to interact with external systems.
Node publish messages to AWS SNS (Amazon Simple Notification Service).
Configuration:
In the following example, topic name depends on Device Type and there is a Message that contains deviceType field in Metadata:
1
2
3
{
deviceType: controller
}
For publishing message in controller’s topic, we will set this pattern in Topic ARN pattern:
1
arn:aws:sns:us-east-1:123456789012:${deviceType}
In runtime, pattern will be resolved to arn:aws:sns:us-east-1:123456789012:controller
Published payload - Node will publish full Message payload to the SNS. If required, Rule Chain can be configured to use chain of Transformation Nodes for sending correct Payload to the SNS.
Outbound message from this node will contain response messageId and requestId in Message metadata. Original Message payload, type and originator will not be changed.
Node publish messages to the AWS SQS (Amazon Simple Queue Service).
Configuration:
${deviceType}
.
Can be set direct Queue URL for message publishing or pattern can be used, that will be resolved to the real Queue URL using Message metadata.In the following example, Queue URL depends on Device Type and there is a Message that contains deviceType field in Metadata:
1
2
3
{
deviceType: controller
}
For publishing message in controller’s Queue, we will set this pattern in Queue URL pattern:
1
https://sqs.us-east-1.amazonaws.com/123456789012/${deviceType}
In runtime, pattern will be resolved to https://sqs.us-east-1.amazonaws.com/123456789012/controller
Published body - Node will publish full Message payload to the SQS. If required, Rule Chain can be configured to use chain of Transformation Nodes for sending correct Payload to the SQS.
Published attributes - optional list of attributes can be added for publishing message in SQS. It is a collection of
If FIFO queue is selected, then Message ID will be used as deduplication ID and Message originator as group ID.
Outbound message from this node will contain response messageId, requestId, messageBodyMd5, messageAttributesMd5 and sequenceNumber in Message metadata. Original Message payload, type and originator will not be changed.
Kafka Node sends messages to Kafka brokers. Expects messages with any message type. Will send record via Kafka producer to Kafka server.
Configuration:
${deviceType}
Published body - Node will send full Message payload to the Kafka topic. If required, Rule Chain can be configured to use chain of Transformation Nodes for sending correct Payload to the Kafka.
Outbound message from this node will contain response offset, partition and topic properties in the Message metadata. Original Message payload, type and originator will not be changed.
Note - if you want to use Confluent cloud as a kafka broker you should add next properties:
Key | Value |
---|---|
ssl.endpoint.identification.algorithm | https |
sasl.mechanism | PLAIN |
sasl.jaas.config | org.apache.kafka.common.security.plain.PlainLoginModule required username="CLUSTER_API_KEY" password="CLUSTER_API_SECRET"; |
security.protocol | SASL_SSL |
Publish incoming message payload to the topic of the configured MQTT broker with QoS AT_LEAST_ONCE.
Configuration:
${deviceType}
.Different Authentication credentials are supported for external MQTT broker:
If PEM credentials type is selected, the following configuration should be provided:
Published body - Node will send full Message payload to the MQTT topic. If required, Rule Chain can be configured to use chain of Transformation Nodes for sending correct Payload to the MQTT broker.
In case of successful message publishing, original Message will be passed to the next nodes via Success chain, otherwise Failure chain is used.
Configuration:
Different Authentication credentials are supported for Azure IoT Hub:
If Shared Access Signature credentials type is selected, the following configuration should be provided:
If PEM credentials type is selected, the following configuration should be provided:
X.509 CA-signed authentication
Published body - Node will send full Message payload to the Azure IoT Hub device. If required, Rule Chain can be configured to use chain of Transformation Nodes for sending correct Payload to the Azure IoT Hub.
In case of successful message publishing, original Message will be passed to the next nodes via Success chain, otherwise Failure chain is used.
Publish incoming message payload to the RabbitMQ.
Configuration:
${deviceType}
.${deviceType}
.Published body - Node will send full Message payload to the RabbitMQ. If required, Rule Chain can be configured to use chain of Transformation Nodes for sending correct Payload.
In case of successful message publishing, original Message will be passed to the next nodes via Success chain, otherwise Failure chain is used.
Invoke REST API calls to the external REST server.
Configuration:
${deviceType}
Endpoint URL
URL can be a static string or a pattern. Only Message metadata is used for resolving patterns. So property names that are used in the patterns must exist in the Message Metadata, otherwise raw pattern will be added into URL.
For example, if Message payload contains property deviceType with value container, then this pattern:
http://localhost/api/${deviceType}/update
will be resolved to
http://localhost/api/container/update
Headers
Collection of header name/value can be configured. Those headers will be added into Rest request. Pattern should be used for configured both header name and header value.
For example ${deviceType}
. Only Message metadata is used for resolving patterns.
So property names that are used in the pattern must exist in the Message Metadata, otherwise raw pattern will be added into header.
Request body - Node will send full Message payload to the configured REST endpoint. If required, Rule Chain can be configured to use chain of Transformation Nodes for sending correct Payload.
Outbound message from this node will contain response status, statusCode, statusReason and responce headers in the Message metadata. Outbound Message payload will be the same as response body. Original Message type and originator will not be changed.
In case of successful request, outbound message will be passed to the next nodes via Success chain, otherwise Failure chain is used.
Node sends incoming message using configured Mail Server. This Node works only with messages that where created using To Email transformation Node, please connect this Node with To Email Node using Success chain.
Configuration:
This Node can work with default Mail Server configured on System level. Please find more details about how to configure default System SMTP Settings.
If specific Mail Server is required for this node - disable Use system SMTP settings checkbox and configure Mail Server manually.
Additionally this node can create email attachments if incoming message has prepared attachments field with reference to files stored in DataBase.
In case of successful mail sending, original Message will be passed to the next nodes via Success chain, otherwise Failure chain is used.
You can see the real life example, where this node is used, in the next tutorial:
It sends notification to users,customers,tenants,single customer user,all users of single customer,all users of current tenant , all admin users of current tenant etc. or you can determine that will be sended notification to who. (target -> topic)