UtilityFree

Automated Import Manager (AIM) Client

by Appian Corporation

Description

This utility automates the process of inspecting the application, executing DDL scripts, updating CDTs, republishing the appropriate datastores, and importing the application.

With the Automated Import Manager Client, users can automatically deploy applications and package contents (either applications from Appian OR packages generated from the Automated Versioning Manager) to any environment. This utility provides the scripts that support triggering deployments from an external CI tool or deploy from the command line

For more information, please see visit: https://community.appian.com/w/the-appian-playbook/198/deployment-automation

Features

Automated Import Manager:

  • Inspect Application: This tool will automatically mimic the "Inspect" functionality that exists within Appian
  • Validating Application Content: In addition to inspecting the application, the tool will ensure all CDT dependents are included to avoid objects pointing to older versions. (This feature is only available on Appian 7.9 and above)
  • Execute DDL Scripts: DDL scripts can be uploaded and automatically executed. NOTE: For Microsoft SQL Server, only Transact-SQL statements are valid.
  • Execute Migrations with Flyway: Flyway is a tool used for managing database migrations. It makes it easier to track SQL script versions and not re-execute SQL scripts that have already been run. If a Flyway directory is provided, the Automated Import Manager will automatically execute migrations against the corresponding datasource. Learn more about Flyway here.
  • Update CDTs: Users are no longer required to delete CDTs before updating them, this tool will perform this step automatically
  • Import Application and admin console configuration: Automatically import an application with an optional customization file
  • Republish Datastores: After application import, datastores will be automatically published or republished
  • Add Patches: Automatically add patch contents to a specified existing application

Note: This utility does not support Java version 9.0.

Release notes

Upgraded the plugin to make it compatible with Appian version 25.1 and above. Also added the old version of the utility as a supplemental file for users below 25.1 version.

Version history (18)

2.6.0

Replaced metaparadigm json rpc with appian json rpc to make the plugin compatible with Appian 25.1+ versions.

2.5.33

Upgraded Commons-IO Library for security fix

2.5.31

The previous submission had only the JAR, just updated the client deploy application and uploading as a package.

2.5.31

Upgraded Commons Compress Library for security fix.

2.5.27

Updates to Slf4j library

2.5.26

Updates to Zip4j library

2.5.25

Version Name Change

2.5.24

Security Updates

2.5.21

Security Updates

2.5.19

Simplification of the listing.

2.5.18

Security Updates

2.5.17

-Fixed bug introduced in v2.5.16 where deleting documents after a successful import was not working

2.5.16

-Fixed an issue where ZIP and SQL files were not being deleted from a failed import in the Temporary Documents folder -Allowing ADM to work for packages with Application Configurations, a feature added in 21.4

2.5.15

Security Updates

2.5.14

Fixed an issue where patches.xml was added to packages starting in 21.2, thus the ADM's definition of a "cross-app patch" needed to be updated to account for this change.

v2.5.13

Bug Fixes:

  • Fixed an issue where setting "appianObjectsRepoPath" prevented a package that included a patches.xml file from being processed successfully

2.5.5

Inspecting the application, executing DDL scripts, updating CDTs, republishing the appropriate datastores, and importing the application.

For a full list of the release notes, refer to the tool documentation available at: https://community.appian.com/w/the-appian-playbook/198/deployment-automation

2.5.4

nspecting the application, executing DDL scripts, updating CDTs, republishing the appropriate datastores, and importing the application.

----------------------------------------------------------

For a full list of the release notes, refer to the tool documentation available at: https://community.appian.com/w/the-appian-playbook/198/deployment-automation

Latest Release Notes:

v2.5.4

  • Enhancements
  • Improved descriptions of errors encountered during deployments
  • Bug Fixes
  • Fixed "Connection Refused" bug when running on a Jenkins server
  • Fixed "buildSingleApp" AVM bug when specifying an appianObjectsRepoPath
  • Fixed rare "hanging" bug in AIM Client

v2.5.3

  • Enhancements
  • Created a reset command for Remote Automated Deployment Manager
  • Bug Fixes
  • Version and Import Metrics Logger Initialized correctly to fix null pointer exception

v2.5.2

  • Enhancements
  • Folder listener to auto trigger ‚ÄúAdd Contents‚Äù action
  • Field validation for import and versioning manager properties files
  • Usage metrics collection to better understand tool use
  • Updated error log messages
  • Bug Fixes
  • ADM UI: Handle apostrophes in app name
  • ZIP type validation for Automated Import Manager

v2.5.1

  • Enhancements
  • New BuildMultipleApps action
  • Check version of tools with -v or -version flags
  • Bug Fixes
  • Fixed ADM SQL errors with non-null statements and forward slash as delimiters

v2.5.0

  • Enhancements
  • Added Flyway DB version control tool to command line and AIM GUI
  • Allow import of DDL scripts or Flyway scripts without an application zip or patch zip
  • Added Folder Listener script that will run addContents automatically when a file is dropped into a folder
  • Bug Fixes
  • Added buildAllApps to list of approved actions
  • Set inspect_only properly in AIM
  • Fixed bug where repo would be cloned into a folder with an incorrect name
  • Passed in correct authentication token for buildAllApps and buildSingleApp