installApplications


Purpose

Installs a set applications enumerated on the list.

The onListChanged handler is called once, immediately after this call, and it returns a new, extended list of applications. The initial state for each new application is installing. The installation process then follows for each application separately and can be tracked by onApplicationChanged listener.

Calling this method triggers an application ID validation mechanism, which verifies if the ID consists of the following characters only:

  • A-Z / a-z, 0-9, .,-_%#+

If the ID contains any illegal characters, the validation mechanism throws the "The 'id' parameter contains some illegal characters" exception.

Signature

installApplications( array, username, password, allowDefferedCaching )

Returns

This method does not return anything.

Parameter

Name Description Type Use
array An array of Application objects. object required
username Overrides the identifier parameter set by the AccountManager. string optional
password Overrides the username parameter set by the AccountManager. string optional
allowDefferedCaching When set to "true", caching is postponed until the startApplication method is called. If not set, an error is logged and the application progresses to the "failed" state. boolean required

Related topics

Public API reference
ApplicationManager
Legal notice | Copyright © 2018 and Confidential to Pegasystems Inc. All rights reserved
Pega Community | Feedback
Advanced...