Error in custom connected system plugin deployment.

Hello appian developers:

I am developing a connected system type plugin and although the plugin has been validated by Appian, when I proceed to deploy it to Appian Cloud, this deployment fails with the following error:


2025-08-07 06:57:09,799 [http-nio-8080-exec-21839] ERROR com.appiancorp.plugins.LoggingPluginEventListener - Failed to enable Plug-in 'Instagram Connected System' (InstagramConnectedSystem) version 1.1.0: 'There was a problem loading the module descriptor: com.appiancorp.connectedsystems.templateframework.osgi.ConnectedSystemTemplateModule.<br/>com.nttdata.appian.plugins.SocialConnectedSystem.InstagramConnectedSystemTemplate is not of type com.appian.connectedsystems.templateframework.sdk.ConnectedSystemTemplate'
2025-08-07 06:57:09,800 [http-nio-8080-exec-21839] ERROR com.appiancorp.plugins.DeployUploadedPluginReaction - Failed to deploy plugin file socialConnectedSystem.jar
java.lang.IllegalStateException: Plugin was deployed but not successfully enabled
at com.appiancorp.plugins.DeployPluginService.lambda$installPlugin$2(DeployPluginService.java:134)

It seems to be a problem in the class that defines the Connected system, but I'm not sure if it means that the class must be of the type indicated in the error com.appian.connectedsystems.templateframework.sdk.ConnectedSystemTemplate, which doesn't match the examples provided by appian in its documentation, which indicates the use of the com.appian.connectedsystems.simplified.sdk.SimpleConnectedSystemTemplate class, or that the type indicated in the error is not correctly implemented by the plugin. The connected system I am developing extends the com.appian.connectedsystems.simplified.sdk.oauth.SimpleOAuthConnectedSystemTemplate class which in turn extends the aforementioned com.appian.connectedsystems.simplified.sdk.SimpleConnectedSystemTemplate class which seems to be correct according to the appian documentation.

Thank you.

  Discussion posts and replies are publicly visible

Parents Reply Children
  • Hello, I am getting the jar file with build jar and it is ok, but the source files are not included and when I try to submit the new jar I am getting this error 

    Plug-in JAR
    Validation Error(s):
    - JAR must include source code
    Please update and re-upload a valid plug-in file
    but I am trying to include inside the gradle.build file this line "from sourceSets.main.allSource" I am getting the error: trying to copy appian-plugin.xml again (the message is not exact this, but in summary mean this), I ahve tried with different options but always same problem, could you please, help me with this.
    Actually the appian-plugin.xml file is inside src/main/resources and my java classes are inside src/main/java
    Thank you.
  • I have upgraded the gradle version to 9 and included in my gradle.build file this: 

    jar {
    duplicatesStrategy = DuplicatesStrategy.FAIL
    into('META-INF/lib') {
    from(configurations.runtimeClasspath)
    }

    // Include compiled classes and resources
    from sourceSets.main.output

    // Include the java files inside the jar
    from(sourceSets.main.allSource.srcDirs) {
    include '**/*.java'
    // Optional: where to include the sources files inside the jar
    into 'sources'
    }

    manifest {
    attributes("Spring-Context": "*;publish-context:=false")
    }
    }

    now I have inside the jar in the sources folder the java sources files.
  • +1
    Certified Lead Developer
    in reply to andresm576836

    Yes, that's correct. Requires source code in plugin JARs for security review/validation. Putting sources in a separate 'sources' folder within the JAR avoids duplication conflicts with appian-plugin.xml.