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.

mergeTypes: see ARS Programmer's Guide for explanation and listing of mergeTypes. ars_MergeEntry was introduced in version 1.46 of ARSperl


<-- Table of Contents

Last changes to this page 21st July 1997 by jcmurphy@smurfland.cit.buffalo.edu
© J.C.Murphy, J.W.Murphy 1997 arsperl@smurfland.cit.buffalo.edu