ExpandNew Action Parameters

Learn about the ExpandNew Action Parameters.

In addition to the parameters listed under Expand Action Parameters, the ExpandNew action (mode=New) supports the following input arguments:

infoAreaId

The info area where the record is created.

This parameter is mandatory for ExpandNew actions.

link/linkId/link2/linkId2

link: Record to which the new record is linked (Record or Linked).

linkId: ID of the link used for link. This parameter is only relevant if multiple links between two info areas exist in the data model (example - multiple FI-links in KM). For further details, see Link IDs.

Use link2 and linkId2 to specify a second link record.

Default=-1.

linkRelationName

The name of a relation used to determine the link record, example - $Parent. For further details, see Link Names in JavaScript.

copyUid

Defines the record from which data is copied to the new record (Record or Linked). copySourceFields and copyTargetFields specify which field values are actually copied and where to.

Example in UPDATE_DEFAULT: creating follow-up activities (ExpandNew action in step CreateFollowUpContact->UpdatePredecessorContact of process NewFollowUpAppointment).

Note: If copySourceFields and copyTargetFields are specified but copyUid is not specified, the data is taken from the record specified in link.

copySourceFields/copyTargetFields

Comma-separated lists of fields whose values are copied to the details view of the new record. copySourceFields contains the fields from the source record (copyUid), copyTargetFields contains the target fields.

Syntax

copySourceFields: A comma-separated list of fields (<field name or number>) referring to the info area specified in copyUid) or the syntax <infoAreaId>.<fieldId> (example - FI.City) to copy fields from a parent info area.

copyTargetFields: A comma-separated list of fields that receive the values from copySourceFields.

Examples

copySourceFields = City

Copies the value of the City field if copyUid refers to a related company record.

copySourceFields = FI.City

Copies the value of the City field from FI no matter whether copyUid (or link) refer to a related company record.

Creating a new person (KP) in a company (FI):

copySourceFields = !Country

copyTargetFields = FreeC1

This copies the text value of the Country catalog into the new person's FreeC1 field.

Note: When using field IDs: To copy the text of a catalog value, add a "t" in front of the field ID (example - FI.t5).
Note: When using XML names: To copy the text of a catalog value, add a "!" in front of the field name (example - FI.!Country).
Note: To copy a catalog value from one catalog field to another catalog field (that uses the same catalog), enter just the field name or ID (example - FI.Country)
Note: Copying a catalog value to a different catalog is not supported.

autoSave

If set to true the record is automatically saved after the Expand view has been created.

Note: The match-up is not executed if this option is enabled.
Note: You have to define default values for any mandatory fields, otherwise the record cannot be saved.

Default: false

onCancel

Use the onCancel parameter to control a New page's behavior when the user cancels the creation of a new record (by clicking Cancel or pressing the ESC key).

Defining onCancel = $back (default) results in the following behavior:

  • If createNewPopup = true is defined for the ExpandNew action, the popup closes. For further details, see  createNewPopup.
  • If createNewTab = true is defined for the action, the tab is closed.
  • If neither createNewPopup nor createNewTab is set to true, the last page of the current tab is loaded again.

You can use this parameter for ExpandNew pages in Tree views as well.