Plug-in (Function & Smart Service)Free

Content Tools

by Appian Corporation

Description

These functions extend Appian content and offer document/folder search, directory listing, and the ability to get/set the searchable attribute of a folder.

Functions are designed for and only work on Appian content, not the local filesystem. All search functions assume the root folder and all subfolders are searchable. Search functions will not return results contained within non-searchable objects.

All functions use the serviceContext of the user account executing the expression at runtime.

Features

Data Types
contentSecurityRoleMap: CDT that backs the returnContentRoleMap function

Smart Services

  • Copy Document (Change Extension)
  • Delete Document Version
  • Delete Folder Contents
  • Delete Files Created Before
  • Delete Multiple Documents
  • Remove Member From Folder Security
  • Inherit Security From Parent for Folder
  • Inherit Security from Parent for Document
  • Remove Member From KC Security
  • Delete Rule/Constant Versions
  • Set Folder Security
  • Create Document Version
  • Create expression rule
  • Update expression rule expression
  • Update expression rule parameters

Functions

  • getfoldersrequiringchangesapproval
  • getsubfoldersfromfolder
  • getdocumentsfromfolder
  • getdocumentinternalidsfromfolder
  • getfilesolderthandate: Get files older than a particular date
  • getfileslargerthansize: Get files larger than a particular size
  • finddocumentsbyname
  • getconstantorruleuuidbyname
  • findcontentbyattribute
  • getcontentdetailsbyuuid
  • getcontentdetailsbyinternalname
  • getcontentobjectdetailsbyid
  • getcontentobjectswithnumofversions: function to find rules or constants with a given number of versions. Useful to find out objects that can increase memory usage in the collaboration engine. See https://forum.appian.com/suite/help/16.3/kb/kb-1226.html
  • getcontentobjectrevisionhistorydetails: Retrieves the revision history of a content object formatted as "[version id, date created, date updated, size, author]"
  • getconstantsfromfolder
  • getconstantsbyname
  • setfoldersearchability
  • getfoldersearchability
  • getdownloadersfromgroup
  • returncontentrolemap
  • getprocessmodeldetailsbyuuid
  • getrulereferencebyname
  • generateuuid

Release notes

The plugin's name-checking rules were relaxed to allow square brackets [] and dots . in constant and rule names

Version history (29)

1.11.4

This update streamlines our maintenance process, ensuring that specialized environments remain compatible with general releases without requiring manual patches.

1.11.3

Updated the filter and return logic for function "getContentObjectsWithNumOfVersions".

1.11.2

Updated name validations for constants and expression rules as per Appian standards.

1.11.1

Fixed issue with Delete Multiple Documents Smart Service where it skipped certain documents that were generated from other smart services (e.g. Word Doc From Template)

1.11.0

Replace deprecated content APIs with modernized file management APIs. See the 23.2 Release notes here https://docs.appian.com/suite/help/23.2/Appian_Release_Notes.html#modernized-file-management-apis

1.10.0

Added a new smart service: Delete Multiple Documents

1.9.2

Bug fix: Copy the latest version of a document when using the Copy Document smart service

1.9.1

Bug fixe: Reintroducing parameter to generateuuid that was unintentionally removed in 1.9.0

1.9.0

Adding function to update expression rule parameters

1.8.1

Bug Fixes:

Adding parameter to generateuuid so that it can be used in loops

1.8.0

New function: generateuuid

1.7.3

Fixing recursive search with FindContentByAttribute, FindDocumentsByName, and FindFoldersByName

1.7.2

Content API Optimization:

  • Replace usages of searchIdsByRoot and queryIdsByRoot
  • Uses getChildrenIds instead by modifying the ContentFilter
  • Other small performance / memory optimizations included

1.7.1

Fix for the previously uploaded 1.7.1 version, which was missing a bundle file related with the newly added changes.

1.7.1

Added a new function for getting a constant by its name - GetConstantValueByName Added new validations for rule name and constant name length in GetConstantValueByName and GetRuleReferenceByName.

1.6.0

Adding two new smart services:

  • Create Expression Rule
  • Update Expression Rule

Updating function

  • findcontentbyattribute now supports searching for rules and rule folders

1.5.0

Added a smart service for creating a new version of a document

1.4.0

Added a function for getting a rule (interface, expression, integration, or decision) by its name

1.3.1

Removed use of deprecated APIs. Due to this, REMOVED these services and functions:

  • Unexpire Document service
  • Approve Pending Changes service
  • getPendingDocuments function

These components have been deprecated for over 2 years and we are removing them from this plugin. If you use these, which should be exceedingly rare, do not upgrade your plugin.

1.3.0

1.3.0 - Added Set Folder Security smart service

1.2.2 - Converted code base to Gradle

1.2.1 - Lowered the safeguard from 10 to 3 for the Keep Versions parameter of the Delete Rule/Constant Versions Smart Service

1.2.0 - added plugin to copy document (to change extension), removed some deprecated apis, and mavenized plugin code base

1.1.4: Added a new smart service called Delete Version/Rule versions. Allows for deleting of old versions of rules and constants and helps maintain the environment clean. This is needed especially for long running dev sites where there are hundreds of rule versions created through the maintenance cycle. The deleter allows for keeping a minimum number of versions and maximum age of version to keep. Used by the Environment Cleanup application.

1.2.2

1.2.2 - Converted code base to Gradle

1.2.1 - Lowered the safeguard from 10 to 3 for the Keep Versions parameter of the Delete Rule/Constant Versions Smart Service

1.2.0 - added plugin to copy document (to change extension), removed some deprecated apis, and mavenized plugin code base

1.1.4: Added a new smart service called Delete Version/Rule versions. Allows for deleting of old versions of rules and constants and helps maintain the environment clean. This is needed especially for long running dev sites where there are hundreds of rule versions created through the maintenance cycle. The deleter allows for keeping a minimum number of versions and maximum age of version to keep. Used by the Environment Cleanup application.

1.2.0

1.2.0 - added plugin to copy document (to change extension), removed some deprecated apis, and mavenized plugin code base

1.1.4: Added a new smart service called Delete Version/Rule versions. Allows for deleting of old versions of rules and constants and helps maintain the environment clean. This is needed especially for long running dev sites where there are hundreds of rule versions created through the maintenance cycle. The deleter allows for keeping a minimum number of versions and maximum age of version to keep. Used by the Environment Cleanup application.

1.1.4

UPDATED April 22, 20202: Added a new smart service called Delete Version/Rule versions. Allows for deleting of old versions of rules and constants and helps maintain the environment clean. This is needed especially for long running dev sites where there are hundreds of rule versions created through the maintenance cycle. The deleter allows for keeping a minimum number of versions and maximum age of version to keep. Used by the Environment Cleanup application.

1.1.3

UPDATED 10.29.2019: Added a new smart service called "Approve Pending Documents and Folders" under "Document Management" which allows you to approve documents and folders which are in the pending state due to previously being created or deleted from a folder which was marked as Approval Required. Use this smart service after using the "Remove Approval Required" smart service if there are documents and folders that you have created but cannot download or see in the design environment. Also adds a function "getPendingDocumentsAndFolders" which can reveal if a knowledge center contains documents or folders in this state.

1.1.3

UPDATED 10.29.2019: Added a new smart service called "Approve Pending Documents and Folders" under "Document Management" which allows you to approve documents and folders which are in the pending state due to previously being created or deleted from a folder which was marked as Approval Required. Use this smart service after using the "Remove Approval Required" smart service if there are documents and folders that you have created but cannot download or see in the design environment. Also adds a function "getPendingDocumentsAndFolders" which can reveal if a knowledge center contains documents or folders in this state.

1.0.2

added getconstantvaluebyname and getconstantvaluebyuuid functions

1.0.1

This update is to resolve properties issue

1.0.0

This plugin will replace both:

Custom Content Functions Content Details by UUID

As part of this effort: https://agile.appian.com/browse/CEX-4785

The goal will be to deprecate the other two plugins once this is approved.

1.0.0

This plugin will replace both:

Custom Content Functions Content Details by UUID

As part of this effort: https://agile.appian.com/browse/CEX-4785

The goal will be to deprecate the other two plugins once this is approved.

Resources

  • Content Tools Documentation.pdf

    Deployment Instructions

    Download