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
).
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.
FI.t5
).FI.!Country
).FI.Country
)autoSave
If set to true
the record is automatically saved after the Expand view
has been created.
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 theExpandNew
action, the popup closes. For further details, see createNewPopup. - If
createNewTab = true
is defined for the action, the tab is closed. - If neither
createNewPopup
norcreateNewTab
is set totrue
, the last page of the current tab is loaded again.
You can use this parameter for ExpandNew pages in Tree views as well.