Difference between revisions of "Post Selection JavaScript"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 3: Line 3:
:''Compare to [[Form Scripting]] and [[Field Scripting]]''
:''Compare to [[Form Scripting]] and [[Field Scripting]]''


=== Editing Lookup Scripts ===
=== Working with Post Selection Scripts ===
Follow these steps to add or change scripting for a Lookup field:
Follow these steps to add or change scripting for a Lookup field:


Line 11: Line 11:
# Click the '''Save''' button.
# Click the '''Save''' button.


===Writing Lookup Scripts===
===Post Selection Variables===


In the JavaScript code, the following variables are available:  
In the JavaScript code, the following variables are available:  
Line 19: Line 19:
:* <tt>name</tt>: The label of the selected record
:* <tt>name</tt>: The label of the selected record


This example displays the label of the selected record.
===Examples===
:{|
 
<pre>
====Displays the Label of the Selected Record====
alert("You have selected record: " + name);</pre>
This example uses the <tt>name</tt> variable to display the label of the record, has configured in the [[Record Identifiers]].
|}
 
:<syntaxhighlight lang="javascript" enclose="div">
alert("You have selected record: " + name);
</syntaxhighlight>
 
====Copy a Field from Another Record====
This code accesses the record targeted by a Lookup, retrieves a field value, and places it into the current form. Here, the current record is an OrderItem. When the user selects the Order the item is part of, this code retrieves the Order number and stores it in the current record.
 
:<syntaxhighlight lang="javascript" enclose="div">
var order = _sdForm.order.order_num;  // Get value from Order record
setTextFieldValue(_sdForm, "order_number", order);  // Set it in current record
</syntaxhighlight>


===Learn More===
===Learn More===

Revision as of 23:00, 21 May 2014

Lookup fields have the additional ability for validations using JavaScript.

Compare to Form Scripting and Field Scripting

Working with Post Selection Scripts

Follow these steps to add or change scripting for a Lookup field:

  1. Click GearIcon.png > Customization > Objects > {object} > Fields
  2. Click the name of the Lookup field.
  3. Enter or change the code in Post Selection JavaScript.
  4. Click the Save button.

Post Selection Variables

In the JavaScript code, the following variables are available:

  • objectId The identifier for the Object
  • id: The identifier of the selected record
  • name: The label of the selected record

Examples

Displays the Label of the Selected Record

This example uses the name variable to display the label of the record, has configured in the Record Identifiers.

<syntaxhighlight lang="javascript" enclose="div">

alert("You have selected record: " + name); </syntaxhighlight>

Copy a Field from Another Record

This code accesses the record targeted by a Lookup, retrieves a field value, and places it into the current form. Here, the current record is an OrderItem. When the user selects the Order the item is part of, this code retrieves the Order number and stores it in the current record.

<syntaxhighlight lang="javascript" enclose="div">

var order = _sdForm.order.order_num; // Get value from Order record setTextFieldValue(_sdForm, "order_number", order); // Set it in current record </syntaxhighlight>

Learn More