WORK IN PROGRESS

Create the Project

Create a source code repository for a new connector. We strongly prefer if you use Github to maintain connector source code, but any reasonable way will do. E.g. connectors maintained under the Polygon project are maintained in the Evolveum area on Github. The naming convention that we use is connector-targetsystem.

Choose a license. We recommend to use Apache 2.0 license. But any reasonable license will do.

Choose a maven group ID and artifact ID.

Use our Maven archetype to create an empty project structure.

git clone https://github.com/Evolveum/polygon.git
cd polygon/basic-connector-archetype
mvn clean install
cd your-project-folder
mvn archetype:generate -DarchetypeGroupId=com.evolveum.polygon -DarchetypeArtifactId=basic-connector-archetype -DarchetypeVersion=1.0-SNAPSHOT -DgroupId=your.group.id -DartifactId=your-artifact-id

If the archetype creates a new folder inside your repository then simply move the generated files where you need them.

Add the generated files under source control:

git add pom.xml src

Now you can import the project into your IDE and start the development.