findObject

The xpertrule.findObject method returns the internal Viabl Platform Object from a from it's given Object Name or Id. If an Object is not found then null is returned.

Finding the Object by it's Object Name can therefore be used to write generic JavaScript code that can access/process any number of Viabl Platform Objects:

 var Obj = xpertrule.findObject(name);

Finding the Object by it's Object ID is used when other Viabl Platform functions return the Object ID (e.g xpertrule.lineOfReasoning):

 var Obj = xpertrule.findObject(id);

findObject can be "expensive" in terms of computer processing time therefore if the same referenced object is accessed many times in your code then it is preferable to store the Object in a local variable Object.

for example:

var gradeObj = xpertrule.findObject("Grade");
if (gradeObj !== null)
  gradeObj.val("Director");

It is best practice to always check that the Object has been found (i.e. not null) before accessing it.