ARSperl Manual - ars_MergeEntry

## `ars_MergeEntry(ctrl, schema, mergeType, ...)`

Merge an entry into the schema. This routine allows you to arbitrarily alter fields (diary, entry-id, etc) that would otherwise be difficult or impossible to alter. All it requires is permissions to write to the particular field that you wish to alter. The ellipses represent alternating fieldId/fieldValue pairs.

On success
  Returns the entry-id of the merged entry.
On failure
  Returns "" (an empty string).

Example:

    	$a = ars_MergeEntry($ctrl, "HD:HelpDesk", 4,
    		   2 , "FOOBAR");
    	die "$ars_errstr" if($a eq "");

Note: If you try to merge a diary field (to alter existing diary entries) you need to pass the encoded diary to this routine. See ars_EncodeDiary.

`mergeType` defines how the merge will happen if special field (ie. Entry-Id) already exists:

Code | Meaning
--- | ---
1 | Generate an error
2 | Create a new entry with the new entry id
3 | Delete the existing entry and create a new on in its place
4 | Update fields specified in the fieldlist in existing entry
1024+num above | Allow NULL in required fields (not applicable for Submitter, Status or Short-Description)
2048+num above | Skip field pattern checking

Refer to the Remedy Programmers Manual for further details (page 6-122 in the Remedy 3 manual)

ars_MergeEntry was introduced in version 1.46 of ARSperl

Table of Contents