Help with Sample 'Purchase Order' form

Question

HI Guys,
Have been playing around with the supplied sample file 'Purchase Order'
At the bottom of the form is a Part No., Description and Cost field that populate from a PartNoScript routine.
Have been trying to copy this routine into my own form as its nearly the same.
Question is  - There is a line 2/3rds down
  -  function getDesc(partNumber, descField, itemPrice)
Where is the partName, DescField, ItemPrice store or located. I've looked in all the scripts, looked at the form fields and cannot find what these three relate too.
I'm assume it must be the field name somehow but just cant seem to find them.
Any help much appreciated.
Dave
( With each passing day my knowlage grows stronger - One day I'll take over the world. !! )
var partNo = new Array(" ",
                                                     "580463116",
    "25906311C",
                                                     "25129637J",
                                                     "771128",
                                                     "11198262A",
                                                     "57251",
                                                     "25906312A",
                                                     "51615223D",
                                                     "51615224D",
                                                     "516154CAC");
  // Array of part descriptions.
var partDesc = new Array(null,
                                                            "Electric Fuel Pump",
                                                            "Air Flow Meter",
                                                            "Air Intake Sleeve",
                                                            "Fuel Filter",
                                                            "Fuel Injector Seal Set",
                                                            "Oxygen Sensor",
                                                            "Wiring Harness Upgrade",
                                                            "Brake Caliper left",
                                                            "Brake Caliper right",
                                                            "Brake Master Cylinder right");
// Array of part prices.
var partPrice = new Array(null,
                                                              149.95,
                                                              145.95,
                                                              98.95,
                                                              10.95,
                                                              5.95,
                                                              69.95,
                                                              109.95,
                                                              59.95,
                                                              59.95,
                                                              49.95);
// Populate the part number Drop-down List.
function populatePartNo(dropdownField)
      var i;
      for (i=0; i < partNo.length; i++)
         dropdownField.addItem(partNo[i]);
// Populate the description and unit price fields.
function getDesc(partNumber, descField, itemPrice)   -------------Where are these items/fields, defined or located. ?
   var i;
   for (i = 0; i < partNo.length; i++)                    // Go through the entire list of part numbers to find the one that is currently selected.
      if (partNo[i] == partNumber)                              // When we find the part number currently selected.
        descField.rawValue = partDesc[i];          // Put the description in the description field
              itemPrice.rawValue = partPrice[i];          // and put the unit price in the unit price field.
              break;                                                                                // No need to go further if there is a match.

Answer 1

Hi Dave,
Just to recap:
There is script in the change event of the dropdown that calls the getDesc() function:
// Populate the description and the unit price when we change the part number.
partNoScript.getDesc(xfa.event.newText, txtDescription, numUnitPrice);
This passes three parameters into the function:
xfa.event.newText is the new item in the list that the user has just selected.
txtDescription is the name of the Description object in the same Row that the user has selected from the dropdown.
numUnitPrice is the name of the Unit Price object in the same Row that the user has selected from the dropdown.
So the function is going to be receiving three pieces of information: the new value of the dropdown; the object deference for Description; and the object reference for Unit Price.
Now if we look at the first line of the function:
function getDesc(partNumber, descField, itemPrice)
You can see that the function assigns the incoming parameters to new variables: partNumber; descField; and itemPrice. These variables only live within the function.
For the purpose of the script in the function:
partNumber = the value of the txtPartNum dropdown.
descField = the object reference for the txtDesciption object in the Row that called the function.
itemPrice = the object reference for the numUnitPrice object in the Row that called the function.
Passing the value of the dropdown into the function is fairly straightforward (txtPartNum/partNumber). The clever bit is passing the object reference for the other objects in the Row into the function (eg txtDescription/descField).
The script in the function includes a loop, which looks at the array. If the selected part number is in the array, then it sets the value of the txtDescription object in the same Row, by referencing the descField variable:
descField.rawValue = partDesc[i];
Does that make sense?
In relation to the dropdowns:
You can access the scripts in the Script Editor (5), including enter event, exit event, etc.
You can access most of the dropdown properties in the various palettes (6).
Hope that helps,
Niall