ConsoleWebServiceController

Action, cp-store-install, supplied by the system when the user has just aquired an item from the store and is now running installer workflow for the first time.

ActionStoreRemove

Action, cp-remove-store, supplied by the system when the user is requesting to be removed from the store and there is a non zero balance on the account.

ActionStoreUpgrade

Action, cp-store-upgrade, supplied by the system when the user has just aquired an upgrade from the store and is now running installer workflow for further configuration

Method Summary
Browser	createBrowser(String userAgent) Creates a Browser object from the user agent. Some Browser methods may not work when the Browser instance is created this way.
Buffer	createBuffer() Creates and returns a new Buffer object
Data	createData() Creates and returns an empty Data object
PacketDataList	createDataList(String name, String column, String[] array) Creates a new non persistent PacketDataList and adds the array to the column
PacketDataList	createDataList(String name, String[] columns) Creates a new non persistent PacketDataList and returns it. Maximum column size is 100.
Email	createEmail(String emailName, String emailSettingsId) Creates an Email container using the specified template and specified enterprise email settings.
Email	createEmail(String name) Creates a SystemEmail container using the specified template.
FileBuffer	createFileBuffer(String type, int limit) Creates and returns a new FileBuffer object
FtpRequest	createFtpRequest() Creates real-time FTP/FTPS/SFTP request object useful for communication with an external FTP service. Requires activation key with Remote Services enabled.
String	createGUID(String prefix) Creates a Globally Unique ID, alternatively with the specified prefix. Null prefix results in a guid of max length 37. With prefix it is length(prefix)+26
JSONBuffer	createJsonBuffer() Returns a new JSON Buffer
JSONParser	createJsonParser(String jsonString) Returns a parser for the given JSON string
TextMessage	createMessage() Creates a new Message object.
String	createMobileLink(PalInfo pal, String action, Data data) Creates link for mobile application
Payload	createPayload() Creates a new Payload object.
Payload	createPayload(String json) Creates a new Payload object from the JSON encoded string. See Payload.toJson().
ServiceRequest	createServiceRequest() Creates real-time http(s) request object useful for communication with external web services. Requires activation key with Remote Services enabled.
TextEmail	createTextEmail(String emailName) Creates a text-based (body is text as opposed to XHTML) email.
TransactionPacket	createTransaction(String description) Creates a new transaction. If the description is not null, the transaction description will be set to the description, otherwise it will be set to the Pal description.
	debug(Object message) Adds a debug message.
	debugData(Data data) Debugs all the values of the given data object.
	debugList(DataList list) Debugs the name, all of the columns, and up to 100 rows of data. The output is rendered in the debug messages of Pal Builder. This method is used for development purposes and ignored in deployed pals.
	debugPayload(Payload payload) Debugs the payload. See comments on debugList and debugData
	debugs(String message, int length) Adds the debug message but splits it into length character segments. Min length is 20 and max is 150. This debugs only to the server-side debugger.
	dumpDebug() Forces an immediate flush of the debug log. This can be called once every 10 seconds.
BusinessUtil	getBusinessUtil() Returns a BusinessUtil object.
ChartTool	getChartTool() Creates and returns a chart factory object which can be used to create specific chart types.
ConsolePacket	getConsolePacket() Returns the ConsolePacket associated with this Console Pal. There exists only one ConsolePacket for each ConsolePal. All users access the same ConsolePacket. Be careful when writing workflow that modifies the ConsolePacket. Typically, setting properties on the ConsolePacket should be limited to initialization, Console System workflow, or an administrator to reduce the chance of collision.
DateUtil	getDateUtil() Returns a utility for working with dates.
EncryptionUtil	getEncryptionUtil() Returns encryption utility
Enterprise	getEnterprise() Returns the enterprise associated with the running Pal.
String	getError() Returns the error, if any.
Formatter	getFormatter() Returns a formatter.
GeoUtil	getGeoUtil(String units) Returns a utility for working with geo-coordinates. Use km for kilometers and m for miles.
Logger	getLogger() Returns the Logger for this workflow engine.
Monitor	getMonitor() Returns the workflow monitor.
RuntimePal	getPal() Returns the active Pal
RuntimePal	getPalById(String palId) Returns the Pal for the specified palId. Pals must belong to the same enterprise and group.
PalInfo	getPalInfo(String palId) The PalInfo for the specified palId.
String[]	getPlugins() Returns the names of all plugins registered in this cloud
QRUtil	getQRUtil() Returns a utility for creating and reading QR codes.
ConsoleWebServiceRequest	getRequest() Returns the Request object.
String	getResourcePath(String resource, String version) Returns the resource path for the specified resource.
WebServiceResponse	getResponse() Returns the Response object.
ShellPalManager	getShellPalManager() Returns shell pal manager for current pal. Current pal should be associated with zone and activation key with Shell Pals option enabled. Pal becomes "admin" for all shell pals created with this shell pal manager. Note that shell pal cannot manage other shell pals (shell pal cannot act as "admin" to create shell pals)
double	getTime() Returns the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC for the given server.
String	getTimeZone() Returns the timezone for this thread.
TransactionPacket	getTransaction(String txId) Returns the specified TransactionPacket.
Validator	getValidator() Returns a utility for validating user data.
String	getWorker() Returns the worker (application server) running this workflow. Useful in a multi-worker environment for analyzing performance and for troubleshooting.
String	getWorkflowName() Returns the name of the currently running workflow.
	setClean(boolean clean) Sets all dataset operations to clean/not clean. See Dataset.setClean(boolean)
	setDateFormat(String pattern) Sets the date pattern for displaying dates for this thread.
	setErrorPrefix(String errorPrefix) Appends this prefix to any workflow generated error message.
	setTimeZone(String timezone) Sets the timezone for dates created or displayed in this thread.
String	toString() Returns a description of this object.

Method Detail

Browser createBrowser(String userAgent)

Creates a Browser object from the user agent. Some Browser methods may not work when the Browser instance is created this way.

Parameters:

String userAgent Required parameter.

Returns: Browser

Since: 04-21-2020

top

Buffer createBuffer()

Creates and returns a new Buffer object

Returns: Buffer

Since: 07-11-2008

top

Data createData()

Creates and returns an empty Data object

Returns: Data

Since: 08-21-2007

top

PacketDataList createDataList(String name, String column, String[] array)

Creates a new non persistent PacketDataList and adds the array to the column

Parameters:

String name Required parameter.
String column Required parameter.
String[] array Required parameter.

Returns: PacketDataList

Since: 06-10-2016

top

PacketDataList createDataList(String name, String[] columns)

Creates a new non persistent PacketDataList and returns it. Maximum column size is 100.

Parameters:

String name
String[] columns

Returns: PacketDataList

Since: 10-07-2010

top

Email createEmail(String emailName, String emailSettingsId)

Creates an Email container using the specified template and specified enterprise email settings.

Parameters:

String emailName - email template name. Required parameter.
String emailSettingsId - if of enterprise email settings. Required parameter.

Returns: Email

Since: 06-04-2011

top

Email createEmail(String name)

Creates a SystemEmail container using the specified template.

Parameters:

String name

Returns: Email

Since: 06-04-2011

top

FileBuffer createFileBuffer(String type, int limit)

Creates and returns a new FileBuffer object

Parameters:

String type Required parameter. Allowed values: zip, jar, ods, odt, xlsx, docx.
int limit - Max size limit in KB, cannot exceed Max Export size of activation key. Required parameter.

Returns: FileBuffer

Since: 08-27-2013

top

FtpRequest createFtpRequest()

Creates real-time FTP/FTPS/SFTP request object useful for communication with an external FTP service. Requires activation key with Remote Services enabled.

Returns: FtpRequest

Since: 05-25-2011

top

String createGUID(String prefix)

Creates a Globally Unique ID, alternatively with the specified prefix. Null prefix results in a guid of max length 37. With prefix it is length(prefix)+26

Parameters:

String prefix

Returns: String

Since: 05-21-2009

top

JSONBuffer createJsonBuffer()

Returns a new JSON Buffer

Returns: JSONBuffer

Since: 04-29-2022

top

JSONParser createJsonParser(String jsonString)

Returns a parser for the given JSON string

Parameters:

String jsonString Required parameter.

Returns: JSONParser

Since: 01-29-2016

top

TextMessage createMessage()

Creates a new Message object.

Returns: TextMessage

Since: 04-27-2009

top

String createMobileLink(PalInfo pal, String action, Data data)

Creates link for mobile application

Parameters:

PalInfo pal - Pal to create link to. Required parameter.
String action - action defined in mobile configuration. Required parameter.
Data data - optional data to pass to action.

Returns: String

Since: 06-24-2011

top

Payload createPayload()

Creates a new Payload object.

Returns: Payload

Since: 10-07-2010

top

Payload createPayload(String json)

Creates a new Payload object from the JSON encoded string. See Payload.toJson().

Parameters:

String json Required parameter.

Returns: Payload

Since: 05-16-2011

top

ServiceRequest createServiceRequest()

Creates real-time http(s) request object useful for communication with external web services. Requires activation key with Remote Services enabled.

Returns: ServiceRequest

Since: 11-05-2010

top

TextEmail createTextEmail(String emailName)

Creates a text-based (body is text as opposed to XHTML) email.

Parameters:

String emailName

Returns: TextEmail

Since: 05-27-2009

top

TransactionPacket createTransaction(String description)

Creates a new transaction. If the description is not null, the transaction description will be set to the description, otherwise it will be set to the Pal description.

Parameters:

String description Maximum allowed size of parameter: 128

Returns: TransactionPacket

Since: 02-07-2011

top

debug(Object message)

Adds a debug message.

Parameters:

Object message - Any object.

Since: 06-17-2024

top

debugData(Data data)

Debugs all the values of the given data object.

Parameters:

Data data

Since: 06-04-2019

top

debugList(DataList list)

Debugs the name, all of the columns, and up to 100 rows of data. The output is rendered in the debug messages of Pal Builder. This method is used for development purposes and ignored in deployed pals.

Parameters:

DataList list

Since: 06-21-2019

top

debugPayload(Payload payload)

Debugs the payload. See comments on debugList and debugData

Parameters:

Payload payload

Since: 04-15-2021

top

debugs(String message, int length)

Adds the debug message but splits it into length character segments. Min length is 20 and max is 150. This debugs only to the server-side debugger.

Parameters:

String message
int length Required parameter. Maximum allowed size of parameter: 150

Since: 07-27-2021

top

dumpDebug()

Forces an immediate flush of the debug log. This can be called once every 10 seconds.

Since: 12-10-2018

top

BusinessUtil getBusinessUtil()

Returns a BusinessUtil object.

Returns: BusinessUtil

Since: 07-15-2009

top

ChartTool getChartTool()

Creates and returns a chart factory object which can be used to create specific chart types.

Returns: ChartTool

Since: 03-01-2018

top

ConsolePacket getConsolePacket()

Returns the ConsolePacket associated with this Console Pal. There exists only one ConsolePacket for each ConsolePal. All users access the same ConsolePacket. Be careful when writing workflow that modifies the ConsolePacket. Typically, setting properties on the ConsolePacket should be limited to initialization, Console System workflow, or an administrator to reduce the chance of collision.

Returns: ConsolePacket

Since: 07-09-2009

top

DateUtil getDateUtil()

Returns a utility for working with dates.

Returns: DateUtil

Since: 07-29-2008

top

EncryptionUtil getEncryptionUtil()

Returns encryption utility

Returns: EncryptionUtil

Since: 11-30-2016

top

Enterprise getEnterprise()

Returns the enterprise associated with the running Pal.

Returns: Enterprise

Since: 02-17-2011

top

String getError()

Returns the error, if any.

Returns: String

Since: 07-11-2008

top

Formatter getFormatter()

Returns a formatter.

Returns: Formatter

Since: 07-31-2008

top

GeoUtil getGeoUtil(String units)

Returns a utility for working with geo-coordinates. Use km for kilometers and m for miles.

Parameters:

String units Required parameter. Allowed values: km, m.

Returns: GeoUtil

Since: 08-27-2019

top

Logger getLogger()

Returns the Logger for this workflow engine.

Returns: Logger

Since: 10-19-2020

top

Monitor getMonitor()

Returns the workflow monitor.

Returns: Monitor

Since: 01-04-2010

top

RuntimePal getPal()

Returns the active Pal

Returns: RuntimePal

Since: 04-28-2010

top

RuntimePal getPalById(String palId)

Returns the Pal for the specified palId. Pals must belong to the same enterprise and group.

Parameters:

String palId

Returns: RuntimePal

Since: 04-28-2010

top

PalInfo getPalInfo(String palId)

The PalInfo for the specified palId.

Parameters:

String palId

Returns: PalInfo

Since: 10-27-2009

top

String[] getPlugins()

Returns the names of all plugins registered in this cloud

Returns: String[]

Since: 11-28-2022

top

QRUtil getQRUtil()

Returns a utility for creating and reading QR codes.

Returns: QRUtil

Since: 01-26-2017

top

ConsoleWebServiceRequest getRequest()

Returns the Request object.

Returns: ConsoleWebServiceRequest

Since: 07-09-2009

top

String getResourcePath(String resource, String version)

Returns the resource path for the specified resource.

Parameters:

String resource Required parameter.
String version

Returns: String

Since: 12-08-2015

top

WebServiceResponse getResponse()

Returns the Response object.

Returns: WebServiceResponse

Since: 07-09-2009

top

ShellPalManager getShellPalManager()

Returns shell pal manager for current pal. Current pal should be associated with zone and activation key with Shell Pals option enabled. Pal becomes "admin" for all shell pals created with this shell pal manager. Note that shell pal cannot manage other shell pals (shell pal cannot act as "admin" to create shell pals)

Returns: ShellPalManager

Since: 04-04-2011

top

double getTime()

Returns the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC for the given server.

Returns: double

Since: 10-07-2021

top

String getTimeZone()

Returns the timezone for this thread.

Returns: String

Since: 03-14-2022

top

TransactionPacket getTransaction(String txId)

Returns the specified TransactionPacket.

Parameters:

String txId Required parameter.

Returns: TransactionPacket

Since: 02-07-2011

top

Validator getValidator()

Returns a utility for validating user data.

Returns: Validator

Since: 07-11-2008

top

String getWorker()

Returns the worker (application server) running this workflow. Useful in a multi-worker environment for analyzing performance and for troubleshooting.

Returns: String

Since: 07-05-2021

top

String getWorkflowName()

Returns the name of the currently running workflow.

Returns: String

Since: 11-13-2009

top

setClean(boolean clean)

Sets all dataset operations to clean/not clean. See Dataset.setClean(boolean)

Parameters: