This page provides details on how to create a new version of a connected system plug-in. See the versioning core concept page for more context about what to consider when versioning.
If you are going to make a major version change to your connected system template, integration template, or client API template, do the following:
GoogleDriveSampleConnectedSystemTemplate.java
GoogleDriveSampleConnectedSystemTemplate2.java
@TemplateId(name = "GoogleDriveSampleConnectedSystemTemplate", majorVersion = 2)
GoogleDriveSendFileIntegrationTemplate.java
GoogleDriveSendFileIntegrationTemplate2.java
Modify new class files to have your updated logic. Leave the original version unchanged and make your (incompatible) updates to the new version only.
appian-plugin.xml
version field to indicate a major change has been made.
1.1.3
–> 2.0.0
appian-plugin.xml
to add references to new connected system, integration, or client API templates you created. Ensure each template has a unique key.
1
2
3
4
5
6
<connected-system-template key="GoogleDriveSampleConnectedSystem" name="GoogleDriveSampleConnectedSystem" class="com.mycorp.googledrive.templates.GoogleDriveSampleConnectedSystemTemplate">
<integration-template key="GoogleDriveSendFileIntegrationTemplate" name="GoogleDriveSendFileIntegrationTemplate" class="com.mycorp.googledrive.templates.GoogleDriveSendFileIntegrationTemplate" />
</connected-system-template>
<connected-system-template key="GoogleDriveSampleConnectedSystem2" name="GoogleDriveSampleConnectedSystem" class="com.mycorp.googledrive.templates.GoogleDriveSampleConnectedSystemTemplate2">
<integration-template key="GoogleDriveSendFileIntegrationTemplate2" name="GoogleDriveSendFileIntegrationTemplate" class="com.mycorp.googledrive.templates.GoogleDriveSendFileIntegrationTemplate2" />
</connected-system-template>
Connected system templates do not directly support minor or patch versions.
We recommend that you indicate the logical minor and patch versions through the appian-plugin.xml
instead. Backwards-compatible feature additions to a connected system should cause a minor version bump (for example, 1.1.3
–> 1.2.0
) for the Plug-in Bundle, and bugfixes should cause a patch version bump (for example, 1.1.3
–> 1.1.4
) for the Plug-in Bundle.
Don't create a copy of the connected system tag or contents. Make your (compatible) updates to the existing connected system.
Release a New Version