AgileApps Support Wiki

Difference between revisions of "Custom Form Actions"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
 
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''[[File:GearIcon.png]] > Objects > {object} > Custom Form Actions
'''[[File:GearIcon.png]] > Objects > {object} > Custom Form Actions


Custom actions are displayed as buttons the user can click when displaying data records.
Custom actions are displayed in '''Actions''' list in the sidebar, when the user is viewing a record.
__TOC__
__TOC__
==About Actions==
==About Actions==
An Action can execute any of the following:
An Action can invoke either:  
* A [[Pages|page]] which is a standard JSP (JavaServer Page) page with custom user interface elements or an independent tab
:* A [[Pages|page]] which is a standard JSP (JavaServer Page) page with custom user interface elements or an independent tab
* JavaScript that uses [[AJAX and REST]] to interact with the platform
:* [[JavaScript]] that uses [[AJAX and REST]] to interact with the platform
 
The action can run on a single record, on multiple records (via [[More Actions]]), or both.
 
===Single Record Actions===
For a single-record action, the user visits the record and then invokes one of the action button(s) in the heading bar. (The buttons they see depend on the actions that have been implemented and the user's permissions.)
:[[File:RecordActions-Single.png]]
 
===Multiple Record Actions===
For  multiple-record actions, the user selects records in a [[View]], and then uses the [[More Actions]] dropdown to invoke the desired action.
:[[File:RecordActions-Multiple.png]]
 
===Learn More===
:* [[Manage Related Information]]


==Working with Actions==
==Working with Actions==
Line 44: Line 31:


===Action Information section===
===Action Information section===
#Provide basic information:
:;Name:Unique name for the action
#;Name:Unique name for the action
::Use alphanumeric characters and underscores
#:Use alphanumeric characters and underscores
:;Title:Field display label
#;Title:Field display label
:;Type:Select the type of action:
#;Type:Select the type of action:
::* Invoke Page
#:* Invoke Page
:::* Select the page from the list
#:* Execute JavaScript (single-record action only)
::* Execute JavaScript (single-record action only)
#If ''Invoke Page'' was selected, select it from the list
:'''Invocation Point:'''
#Select the invocation point:
::* '''Single Record:''' The action works on a single record  
#* '''Single Record:''' The action works on a single record  
<!--
#* '''Group Action:''' The action works on a group of records selected in a [[View]]
::* '''Group Action:''' The action works on a group of records selected in a [[View]]
#* '''Both:''' The action works on both single records and groups of records
::* '''Both:''' The action works on both single records and groups of records
#:: ''Note:'' The Group Action and Both options are not present if the action type is Execute JavaScript.
::: ''Note:'' The Group Action and Both options are not present if the action type is Execute JavaScript.
#Optionally, unclick the ''Enabled'' checkbox to disable the action
-->
#Optionally, click the [[#About Requires Record Selection during Group Operation|Requires Record Selection during Group Operation]] checkbox (this option appears only when ''Group Action'' is selected as the invocation point)
:'''Enabled -''' Uncheck this box to disable the action.
# If ''Execute JavaScript'' was selected, enter the [[JavaScript]]
<!--:[[#About Requires Record Selection during Group Operation|Requires Record Selection during Group Operation]] checkbox
#:'''Tip:''' Use the [[Template Variable Tool]] to get available [[#Template Variables|Template Variables]]
::This option appears only when ''Group Action'' is selected as the invocation point)
-->
: '''JavaScript'''
:: This section appears if ''Execute JavaScript'' was selected. Use it to enter the [[JavaScript]].
{{Note|To run the JavaScript in the LongJump UI and the legacy AgileApps UI, enter the script in the Legacy UI Script tab. To run the JavaScript in the New AgileApps UI, enter the script in the New UI Script tab.}}
:: Use the [[Template Variable Tool]] that appears under it to get available [[Template Variables]]
<!--


===Packaging Options Section===
===Packaging Options Section===
Choose whether or not allow an installer to disable the action.
Choose whether or not allow an installer to disable the action.


===Available Roles section===
-->
===Available to Roles section===
Select the user [[Roles]] which can execute the action. The action button appears only for users in those roles.
Select the user [[Roles]] which can execute the action. The action button appears only for users in those roles.
 
<!--
====Considerations====
====Considerations====
 
:*If [[Template Variable]]s are used in the JavaScript code:
:*If [[#Template Variable|Template Variable]]s are used in the JavaScript code:
::*The Template Variable '''''will not''''' be replaced if the Action is invoked from a Group Action.
::*The Template Variable '''''will not''''' be replaced if the Action is invoked from a Group Action.
::*The Template Variable '''''will''''' be replaced if the Action is invoked from a Single Record
::*The Template Variable '''''will''''' be replaced if the Action is invoked from a Single Record
Line 78: Line 71:
:*If checked, the Group Action requires that a record is selected in order to execute the action
:*If checked, the Group Action requires that a record is selected in order to execute the action
:*If not checked, the Group Action can execute when no records are selected
:*If not checked, the Group Action can execute when no records are selected
 
-->
==Using Template Variables==
{{:Template Variables for Actions and Components}}
<noinclude>
<noinclude>


[[Category:Object Aspects]]
[[Category:Object Aspects]]
</noinclude>
</noinclude>

Latest revision as of 06:35, 28 August 2018

GearIcon.png > Objects > {object} > Custom Form Actions

Custom actions are displayed in Actions list in the sidebar, when the user is viewing a record.

About Actions

An Action can invoke either:

  • A page which is a standard JSP (JavaServer Page) page with custom user interface elements or an independent tab
  • JavaScript that uses AJAX and REST to interact with the platform

Working with Actions

Add an Action

To add an action:

  1. Click the Add Action button
  2. Fill in the Action settings
  3. Click [Save]

Edit an Action

To edit an action:

  1. Click the title of the action
  2. Click the [Edit] button
  3. Modify the Action settings.
  4. Click [Save]

Delete an Action

To delete an action:

  1. Click the title of the action
  2. Click the [Delete] button

Action Settings

Action Information section

Name
Unique name for the action
Use alphanumeric characters and underscores
Title
Field display label
Type
Select the type of action:
  • Invoke Page
  • Select the page from the list
  • Execute JavaScript (single-record action only)
Invocation Point:
  • Single Record: The action works on a single record
Enabled - Uncheck this box to disable the action.
JavaScript
This section appears if Execute JavaScript was selected. Use it to enter the JavaScript.

Notepad.png

Note: To run the JavaScript in the LongJump UI and the legacy AgileApps UI, enter the script in the Legacy UI Script tab. To run the JavaScript in the New AgileApps UI, enter the script in the New UI Script tab.

Use the Template Variable Tool that appears under it to get available Template Variables

Available to Roles section

Select the user Roles which can execute the action. The action button appears only for users in those roles.

Retrieved from "https://agileappscloud.info/aawiki-src/index.php?title=Custom_Form_Actions&oldid=4757"