Method Call Builder

Method Call Builder

In this topic ...

Quick Tips
Specifying Inputs
Related Topics ...

Passing Arguments to Actions

The Method Call builder allows you to construct a call to a method and also to define inputs to the method, if any inputs exist.
The Method Call builder creates a call to a specific method, with choices for where each argument input should come from. Once configured, the Method Call builder creates a new Action List, which calls an action with any required input arguments defined.
This builder is particularly useful when you develop your own builders and need a method argument to be supplied as an external input.

Quick Tips

Use the Method Call builder to wrap calls to methods that take arguments -- We can use a method call to "wrap" a call to a method that takes arguments so that we can call that method from another builder that just allows you to specify a method name, such as Action List.

Specifying Inputs

The Method Call builder takes the inputs described in the table below. For help on inputs common to many or all builders such as those in the Properties and HTML Attributes input groups, see "Using the Builder Call Editor."

Input name Description
Name Enter a name for this builder call. The designer tool displays this name in the builder call list.
Method to call Use the Action Chooser to select one of the methods in the model to call.
Public Enable this check box to make this method call available to other (linked) models.
Arguments Specify the values for any arguments (only arguments defined by the specified action are displayed). We can use the Reference Chooser to select the value from an element in the model or we can enter a text string manually.
Overwriting
Rename Existing This input is useful in cases where you want to change the behavior of code that was placed in the WebApp by a high-level builder or by an Imported Model.
For example, you might want to do this if you have a Domino View & Form builder in your model, and you want to use a different class for one of the LJO's that Builder adds to the WebApp. The Domino View and Form Builder does not provide an "LJO Class Name" input. But, we can place a new LJO Builder in the model and give it the same name as that assigned by the Domino View and From Builder, thus replacing the existing LJO and specifying new class.

Enable - When checked, this input will cause the Builder to replace an existing WebApp object with a new object. The Builder will locate the existing WebApp object (variable, LJO, etc.), rename it, and then create a replacement object.

This input is available on the following low-level Builders that create WebApp objects: Action List, Imported Page, Linked Java Object, Linked Model, Method, Method Call, Page, Variable and Schema.

Input name	Description
Name	Enter a name for this builder call. The designer tool displays this name in the builder call list.
Method to call	Use the Action Chooser to select one of the methods in the model to call.
Public	Enable this check box to make this method call available to other (linked) models.
Arguments	Specify the values for any arguments (only arguments defined by the specified action are displayed). We can use the Reference Chooser to select the value from an element in the model or we can enter a text string manually.
Overwriting
Rename Existing	This input is useful in cases where you want to change the behavior of code that was placed in the WebApp by a high-level builder or by an Imported Model. For example, you might want to do this if you have a Domino View & Form builder in your model, and you want to use a different class for one of the LJO's that Builder adds to the WebApp. The Domino View and Form Builder does not provide an "LJO Class Name" input. But, we can place a new LJO Builder in the model and give it the same name as that assigned by the Domino View and From Builder, thus replacing the existing LJO and specifying new class. Enable - When checked, this input will cause the Builder to replace an existing WebApp object with a new object. The Builder will locate the existing WebApp object (variable, LJO, etc.), rename it, and then create a replacement object. This input is available on the following low-level Builders that create WebApp objects: Action List, Imported Page, Linked Java Object, Linked Model, Method, Method Call, Page, Variable and Schema.