Salesforce

Subform Controls (Magic xpa 4.x)

« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

Subform Controls (Magic xpa 4.x)

You can use the Subform control to integrate a task form into the form of another task, while maintaining the subform's task data handling and record cycle activities as independent of the parent task.

You cannot define a Control logic unit or an Event logic unit for a Subform control.

The Subform control properties are listed by categories:

Since version: Android and iOS support – 2.2a

Subform Advantages

You can park on the line of a parent task and see the details from the subtask, for a one-to-many task relation.

Magic xpa automatically refreshes the Subform data view according to the parent task only when passing parameters.

Magic xpa retains your last position in the Subform data view when you leave and reenter.

A tab cycle is provided for the Subform task.

You can jump to the called program or task by right-clicking on the control and selecting Go to Object (Ctrl+F5). Once you are done, you can return to the previous program or task by right-clicking and selecting Return to Object (Ctrl+Shift+F5).

Subform Behavior

A Subform control works only with interactive tasks, which means that the subform will not be active for the Main or Batch program.

A Subform control behaves like a child window task, but also permits event activation from a parent task and automatically relocates to the last record when the focus is returned to the subform.

The runtime engine automatically handles the navigation between the parent task and the called task displayed in the subform.

The runtime engine automatically refreshes the subform view when any of the passed arguments to the called task are changed.

The subform task is initially executed after the first Record Prefix operation of the parent task.

In Online tasks, all of the subform fields are treated as one control.

The runtime engine executes the subtask’s prefix operations and Record Prefix operations, creates the subtask data view, and executes the Record Suffix operations and subtask’s suffix operations.

When the called task has an XML table as the Main Source, it should also be declared in the current task (where the subform is declared).

Offline Tasks

  • Only Offline programs can be used in an Offline program’s subform.

  • Offline programs cannot be used in a non-Offline program’s subform.

Related Topics

Reference
Attachment 
Attachment