promptrenderer Element

 

Content

promptrenderer Element

Description

Example

Properties

Description

The promptrenderer Element renders a user prompt that can be inserted into a page based on the Prompt Page Type.

Features:

Defines textual input fields, as well as dropdowns and lookups based on SDCs/Reference Types/SQL (see Type property).
Supports style validations similar to the maint Element.
Integrated with advancedtoolbar Element Action buttons. Values entered are passed to the Action (see Prompts Identifier property).
Returns Prompt Identifiers and entered values to the caller script.
Capability to upload a file from the client to a server location (see File Upload property).

Example

promptrenderer Element Properties

Property Name Description
Prompts Defines prompts to render:
Property Name Description
Identifier Identifier of the input prompt. Use this as a variable referenced in an Action button on the advancedtoolbar Element. Example: For an identifier "mysdcid", a hidden field called action_mysdcid is already created. Therefore, if using [mysdcid] in the Action button properties substitutes the value.
titleText displayed for each input prompt.
Type Type of data handled by the input prompt.
Type Description
String"String" data type.
Number"Number" data type.
Absolute/Relative Date"Date" data type.
RefTypeReference Type.
Dropdown from an SDCDropdown containing a list of SDCs.
Dropdown from a List of ValuesDropdown containing a list of predefined values.
Dropdown from SQLDropdown containing results of a SQL query.
Lookup from SDCLookup page containing a list of SDCs.
Lookup from SQLLookup page containing results of a SQL query.
Dropdown DefinitionDropdown that retrieves data based on an SDC definition.
Type DetailsDetails about the input prompts.
Property Name Description
SDC IdIdentifier of the SDC.
Reftype IdIdentifier of the Reference Type.
Lookup WebPageName of the Lookup page.
SQL SQL script to execute. Notes:
The number of columns in the select list should be 2.
The column aliased by refdisplayvalue is displayed in the dropdown, while the other is treated as the internal value.
[%currentuser%] and [%sdcid%] are supported substitution variables.
The [%sdcid%] is the sdcid defined in the sdcid property of the advancedtoolbar Element. Example:

select sdccolumnid, linkid refdisplayvalue from sdclink where sdcid = '[%sdcid%]'

List of ValuesSemicolon-separated list of values that are rendered as a dropdownlist.
Dropdown DefinitionDropdown that retrieves data based on an SDC definition:
Property NameDescription
SDC IdThe SDC for which data is retrieved.
Query FromValue of the From clause for the query.
Query WhereValue of the Where clause for the query.
Query Order ByValue of the Order By clause for the query.
Value ColumnActual column value.
Display ColumnColumn value displayed to users.
ValidationsValidations for the input prompt.
OnChangeJavaScript executed for an onChange event. This is typically used to fire Ajax requests that create dependent cascading inputs (such as dropdowns) during the prompt. See Using OnChange below.
File Upload File Upload component. Use the variable [uploadedfiles] in the Action button properties to access the the list of uploaded file paths.
Property Name Description
ShowYes shows the file browse dialog.
Upload LocationThis has been deprecated. Use "File Location Policy Node" and "File Location Policy Item" (below).
Rename File After Upload Yes renames the file after the upload. The file is renamed to:

[current user]_[timestamp]_[original file name]

Create User SubfolderYes creates subfolders under the Upload Location for the current user, then uploads into the subfolder.
File Location Policy NodeNode that governs the location of file uploads in the File Location Policy. The OOB configuration is Upload Custom.
File Location Policy ItemFile location item in the node above (defaults to first node).
Includes If you want to use your own JavaScript files:
Property NameDescription
IdentifierUnique identifier for this item, rendered as an ID attribute in the HTML tag.
URLURL of the JavaScript (*.js) file containing functions called in the page.