Skip to content

Template repository to create Camunda Platform 8 Inbound Connectors using Connector SDK

License

Notifications You must be signed in to change notification settings

camunda/connector-template-inbound

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A template for new C8 inbound Connectors.

To use this template update the following resources to match the name of your connector:

...and delete this hint.

Read more about creating Connectors

Check out the Connectors SDK

Inbound Connector Template

Camunda Inbound Connector Template

Build

You can package the Connector by running the following command:

mvn clean package

This will create the following artifacts:

  • A thin JAR without dependencies.
  • An uber JAR containing all dependencies, potentially shaded to avoid classpath conflicts. This will not include the SDK artifacts since those are in scope provided and will be brought along by the respective Connector Runtime executing the Connector.

Shading dependencies

You can use the maven-shade-plugin defined in the Maven configuration to relocate common dependencies that are used in other Connectors and the Connector Runtime. This helps to avoid classpath conflicts when the Connector is executed.

Use the relocations configuration in the Maven Shade plugin to define the dependencies that should be shaded. The Maven Shade documentation provides more details on relocations.

API

Connector Properties

This Connector can be configured with the following properties:

Name Description Example Can be a secret
sender Value of the sender field of the messages generated by MockSubscription Alice Yes
messagesPerMinute How many messages per minute should MockSubscription produce (1-10) 3 No

Output

This Connector produces the following output:

{
  "event": {
    "sender": ".....",
    "message": ".....",
    "code": 999
  }
}

Test locally

Run unit tests

mvn clean verify

Test with local runtime

Use the Camunda Connector Runtime to run your function as a local Java application.

In your IDE you can also simply navigate to the LocalContainerRuntime class in test scope and run it via your IDE. If necessary, you can adjust application.properties in test scope.

Element Template

The element templates can be found in the element-templates/inbound-template-connector.json file.

About

Template repository to create Camunda Platform 8 Inbound Connectors using Connector SDK

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages