Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Provide a unique name and description.

  • Determine whether you will implement the integration in Java or Groovy.  Groovy has the advantage that the script is loaded dynamically and does not require a FlexDeploy server recycle when you make changes.

  • Define properties for the new change management system. Properties are configuration values used by FlexDeploy to connect to the new system and parameterize its usage. 

  • Define Ticket Fields as necessary, which are used to create Ticket or Incidents automatically from FlexDeploy.

  • Develop either a Java class or Groovy script to perform the integration. Groovy is recommended in most cases, unless there is a Java SDK that will be used to assist in the development.

The examples below demonstrate a custom integration for Zendesk using both Java and Groovy.

...

  • In order to compile your java class, you will need FlexDeployAPI.jar on classpath.

  • Implement all the methods described in the table in the API Implementation section.

  • For any failure connecting to the system or if any issues with the data, then you can throw exception. For example throw new ApiException("Invalid credentials.", "");

  • Once you are ready with unit testing, you can prepare Jar file for your credential store java class and other utility classes. This jar file can be placed on server classpath now.

    • For Tomcat, put this jar file in in a new folder which is next to the apache-tomcat-flexdeploy/libext folderflexdeploy-tomcat folder name apiext. This location is a change from versions before 8.0.

    • If you are using any third-party libraries from your Java implementation, then those jar files will also need to be added to same libext apiext folder. Keep in mind that this can cause issues with server functioning, so be prepared to remove your additional library files.

  • To pickup changes to your API, the FlexDeploy server must be restarted.

...