[Arsperl-devel] ARSperl/html/manual ars_CreateImage.html, NONE, 1.1 ars_DeleteImage.html, NONE, 1.1

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/arsperl/ARSperl/html/manual
In directory sfp-cvsdas-4.v30.ch3.sourceforge.com:/tmp/cvs-serv15696/html/manual

Modified Files:
	ars_MergeEntry.html toc.html 
Added Files:
	ars_CreateImage.html ars_DeleteImage.html ars_GetImage.html 
	ars_GetListImage.html ars_SetImage.html 
Log Message:
arsystem 7.6.3 port

--- NEW FILE: ars_SetImage.html ---
<HTML>
<HEAD>
<TITLE>ARSperl Manual - ars_SetImage</TITLE>
</HEAD>
<BODY BGCOLOR="#FF0000">

   <H1>TO DO</H1>

</BODY>
</HTML>

--- NEW FILE: ars_GetImage.html ---
<HTML>
<HEAD>
<TITLE>ARSperl Manual - ars_GetImage</TITLE>
</HEAD>
<BODY BGCOLOR="#FF0000">

   <H1>TO DO</H1>

</BODY>
</HTML>

Index: ars_MergeEntry.html
===================================================================
RCS file: /cvsroot/arsperl/ARSperl/html/manual/ars_MergeEntry.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -d -r1.7 -r1.8
*** ars_MergeEntry.html	30 Mar 2003 03:18:03 -0000	1.7
--- ars_MergeEntry.html	1 Sep 2010 17:18:29 -0000	1.8
***************
*** 1,148 ****
! <HTML>
! <HEAD>
! <TITLE>ARSperl Manual - ars_MergeEntry</TITLE>
! </HEAD>
! <BODY BGCOLOR="#FFFFFF">
! 
!    <H2><CODE>ars_MergeEntry(ctrl, schema, mergeType, ...)</CODE></H2>
! 
! 	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.
! 
! 
! <P>
! There are three conditions to detect after ars_MergeEntry(...).  
! 
! <ol>
! <li> A non-null value returned means that a new entry was created.
! 
! <li> A null value returned, plus $ars_errstr empty, means that an existing
!    entry was replaced.
! 
! <li> A null value returned, plus $ars_errstr non-empty, means there was some
!    error.
! </oL>
! 
! Here's some sample code that demonstrates how to evaluate the outcome of
! 	this function:
! <PRE>
! foreach $RPTID (sort keys %RPTEntryList) {
!         undef @Report;
!         ( @Report = ars_GetEntry($ctrl1, $ISS_RPT_SCHEMA, $RPTID) )
!                 || arsdie("GetEntry $RPTID");
!         if ( $ret = ars_MergeEntry($ctrl2, $ISS_RPT_SCHEMA,
!                                    3075, @Report) ) {
!                 print "$RPTID -&gt; new $ret\n";
!         } else {
!                 arsdie("MergeEntry $RPTID $ret") if $ars_errstr;
!                 print "$RPTID replaced\n";
!         }
! }
! </PRE>
! 
! Note the value "3075" for mergeType.  That translates to<P>
! <PRE>
!            2048: skip field pattern checking
!            1024: allow NULL in required fields
!          +    3: delete existing entry and create new in its place
!          -------
!            3075
! </PRE>
! <P>
! 
!       <DL>
!          <DT><B>On success</B><DD>
! 		If a NEW entry was created: returns the entry-id of the merged entry.<BR>
! 		If an EXISTING entry was over-written: returns "" and <code>$ars_errstr</code> will be "" (or, more correctly, <code>%ARS::ars_errhash</code> will not contain any FATAL or ERROR messages - but might contains WARNINGs or NOTICEs). <BR>
! 		Note that this is how the C API behaves - this isn't something
! 		that is unique to ARSperl. <BR>
!                 <a href="#example">See examples below.</a>
!          <DT><B>On failure</B><DD>
!                 Returns "" (an empty string) and sets <code>$ars_errstr</code>
!       </DL>
! 
!       <P><a name="example">Example:</a><P>
! 
!       <PRE>
! 	# note that "4" means "overwrite existing"
! 	$a = ars_MergeEntry($ctrl, "HD:HelpDesk", 4, 
! 		   1 , "00000000012345",
! 		   2 , "FOOBAR");
! 	if(($a eq "") && ($ars_errstr eq "")) {
! 		print "entry successfully over-written\n";
! 	} 
! 	else {
! 		print "failed to merge - $ars_errstr\n";
! 	}
!       </PRE>
! 
! 	<hr width="10%">
! 
!       <PRE>
! 
! 	# note that "2" means "create a new entry"
! 	$a = ars_MergeEntry($ctrl, "HD:HelpDesk", 2, 
! 		            2 , "FOOBAR");
! 	if(($a ne "") && ($ars_errstr eq "")) {
! 		print "entry successfully created - $a\n";
! 	} 
! 	else {
! 		print "failed to merge - $ars_errstr\n";
! 	}
!       </PRE>
! 
!       <P>Notes<P>
! 	<B>Note</B>: If you try to merge a diary field (to alter existing
! 	diary entries) you need to pass the <I>encoded</I> diary to this
! 	routine. See <A HREF="ars_EncodeDiary.html">ars_EncodeDiary</A>.
! 	<P>
! 	<code>mergeType</code> defines how the merge will happen if special
! 	field (ie. Entry-Id) already exists:
! 	<P>
! 	<TABLE BORDER=1>
! 	<TR>
! 		<TH>Code</TH><TH>Meaning</TH>
! 	</TR>
! 	<TR>
! 		<TD>1</TD><TD>Generate an error</TD>
! 	</TR>
! 	<TR>
! 		<TD>2</TD><TD>Create a new entry with the new entry id</TD>
! 	</TR>
! 	<TR>
! 		<TD>3</TD><TD>Delete the existing entry and create a new on in its place</TD>
! 	</TR>
! 	<TR>
! 		<TD>4</TD><TD>Update fields specified in the fieldlist in existing entry</TD>
! 	</TR>
! 	<TR>
! 		<TD>1024+num above</TD><TD>Allow NULL in required fields (not applicable for Submitter,
! 		Status or Short-Description)</TD>
! 	</TR>
! 	<TR>
! 		<TD>2048+num above</TD><TD>Skip field pattern checking</TD>
! 	</TR>	
! 	</TABLE>
! 	<P>
! 	Refer to the Remedy Programmers Manual for further details.
! 		      <P>
!         <a href="OO/form.html#merge">The Object Oriented ARSperl layer
! 			  tries to be a little easier to use.</a>
! <P>
! <I>ars_MergeEntry was introduced in version 1.46 of ARSperl</I>
! 
! <P>
! <HR WIDTH="30%">
! <P>
! <A HREF="toc.html"><IMG ALT="&lt;--" SRC="arrow.gif" ALIGN=CENTER> Table of Contents </A>
! <p>
! <address>
! Last changes to this page 29-Mar-2003 by jcmurphy<BR>
! &#169; J.C.Murphy, J.W.Murphy 1997 ar...@ar...
! </address>
! </BODY>
! </HTML>
--- 1,151 ----
! <HTML>
! <HEAD>
! <TITLE>ARSperl Manual - ars_MergeEntry</TITLE>
! </HEAD>
! <BODY BGCOLOR="#FFFFFF">
! 
!    <H2><CODE>ars_MergeEntry(ctrl, schema, mergeType, ...)</CODE></H2>
! 
! 	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.
! 
! 
! <P>
! There are three conditions to detect after ars_MergeEntry(...).  
! 
! <ol>
! <li> A non-null value returned means that a new entry was created.
! 
! <li> A null value returned, plus $ars_errstr empty, means that an existing
!    entry was replaced.
! 
! <li> A null value returned, plus $ars_errstr non-empty, means there was some
!    error.
! </oL>
! 
! Here's some sample code that demonstrates how to evaluate the outcome of
! 	this function:
! <PRE>
! foreach $RPTID (sort keys %RPTEntryList) {
!         undef @Report;
!         ( @Report = ars_GetEntry($ctrl1, $ISS_RPT_SCHEMA, $RPTID) )
!                 || arsdie("GetEntry $RPTID");
!         if ( $ret = ars_MergeEntry($ctrl2, $ISS_RPT_SCHEMA,
!                                    3075, @Report) ) {
!                 print "$RPTID -&gt; new $ret\n";
!         } else {
!                 arsdie("MergeEntry $RPTID $ret") if $ars_errstr;
!                 print "$RPTID replaced\n";
!         }
! }
! </PRE>
! 
! Note the value "3075" for mergeType.  That translates to<P>
! <PRE>
!            2048: skip field pattern checking
!            1024: allow NULL in required fields
!          +    3: delete existing entry and create new in its place
!          -------
!            3075
! </PRE>
! <P>
! 
!       <DL>
!          <DT><B>On success</B><DD>
! 		If a NEW entry was created: returns the entry-id of the merged entry.<BR>
! 		If an EXISTING entry was over-written: returns "" and <code>$ars_errstr</code> will be "" (or, more correctly, <code>%ARS::ars_errhash</code> will not contain any FATAL or ERROR messages - but might contains WARNINGs or NOTICEs). <BR>
! 		Note that this is how the C API behaves - this isn't something
! 		that is unique to ARSperl. <BR>
!                 <a href="#example">See examples below.</a>
!          <DT><B>On failure</B><DD>
!                 Returns "" (an empty string) and sets <code>$ars_errstr</code>
!       </DL>
! 
!       <P><a name="example">Example:</a><P>
! 
!       <PRE>
! 	# note that "4" means "overwrite existing"
! 	$a = ars_MergeEntry($ctrl, "HD:HelpDesk", 4, 
! 		   1 , "00000000012345",
! 		   2 , "FOOBAR");
! 	if(($a eq "") && ($ars_errstr eq "")) {
! 		print "entry successfully over-written\n";
! 	} 
! 	else {
! 		print "failed to merge - $ars_errstr\n";
! 	}
!       </PRE>
! 
! 	<hr width="10%">
! 
!       <PRE>
! 
! 	# note that "2" means "create a new entry"
! 	$a = ars_MergeEntry($ctrl, "HD:HelpDesk", 2, 
! 		            2 , "FOOBAR");
! 	if(($a ne "") && ($ars_errstr eq "")) {
! 		print "entry successfully created - $a\n";
! 	} 
! 	else {
! 		print "failed to merge - $ars_errstr\n";
! 	}
!       </PRE>
! 
!       <P>Notes<P>
! 	<B>Note</B>: If you try to merge a diary field (to alter existing
! 	diary entries) you need to pass the <I>encoded</I> diary to this
! 	routine. See <A HREF="ars_EncodeDiary.html">ars_EncodeDiary</A>.
! 	<P>
! 	<code>mergeType</code> defines how the merge will happen if special
! 	field (ie. Entry-Id) already exists:
! 	<P>
! 	<TABLE BORDER=1>
! 	<TR>
! 		<TH>Code</TH><TH>Meaning</TH>
! 	</TR>
! 	<TR>
! 		<TD>1</TD><TD>Generate an error</TD>
! 	</TR>
! 	<TR>
! 		<TD>2</TD><TD>Create a new entry with a new entry id</TD>
! 	</TR>
! 	<TR>
! 		<TD>3</TD><TD>Delete the existing entry and create a new on in its place</TD>
! 	</TR>
! 	<TR>
! 		<TD>4</TD><TD>Update fields specified in the fieldlist in existing entry</TD>
! 	</TR>
! 	<TR>
! 		<TD>5</TD><TD>Generate a new entry id for all entries</TD>
! 	</TR>
! 	<TR>
! 		<TD>1024+num above</TD><TD>Allow NULL in required fields (not applicable for Submitter,
! 		Status or Short-Description)</TD>
! 	</TR>
! 	<TR>
! 		<TD>2048+num above</TD><TD>Skip field pattern checking</TD>
! 	</TR>	
! 	</TABLE>
! 	<P>
! 	Refer to the Remedy Programmers Manual for further details.
! 		      <P>
!         <a href="OO/form.html#merge">The Object Oriented ARSperl layer
! 			  tries to be a little easier to use.</a>
! <P>
! <I>ars_MergeEntry was introduced in version 1.46 of ARSperl</I>
! 
! <P>
! <HR WIDTH="30%">
! <P>
! <A HREF="toc.html"><IMG ALT="&lt;--" SRC="arrow.gif" ALIGN=CENTER> Table of Contents </A>
! <p>
! <address>
! Last changes to this page 20-Aug-2010 by tstapff<BR>
! &#169; J.C.Murphy, J.W.Murphy, T.Stapff 1997-2010 ar...@ar...
! </address>
! </BODY>
! </HTML>

--- NEW FILE: ars_DeleteImage.html ---
<HTML>
<HEAD>
<TITLE>ARSperl Manual - ars_DeleteImage</TITLE>
</HEAD>
<BODY BGCOLOR="#FF0000">

   <H1>TO DO</H1>

</BODY>
</HTML>

--- NEW FILE: ars_CreateImage.html ---
<HTML>
<HEAD>
<TITLE>ARSperl Manual - ars_CreateImage</TITLE>
</HEAD>
<BODY BGCOLOR="#FF0000">

   <H1>TO DO</H1>

</BODY>
</HTML>

--- NEW FILE: ars_GetListImage.html ---
<HTML>
<HEAD>
<TITLE>ARSperl Manual - ars_GetListImage</TITLE>
</HEAD>
<BODY BGCOLOR="#FF0000">

   <H1>TO DO</H1>

</BODY>
</HTML>

Index: toc.html
===================================================================
RCS file: /cvsroot/arsperl/ARSperl/html/manual/toc.html,v
retrieving revision 1.29
retrieving revision 1.30
diff -C2 -d -r1.29 -r1.30
*** toc.html	31 Mar 2009 12:16:11 -0000	1.29
--- toc.html	1 Sep 2010 17:18:29 -0000	1.30
***************
*** 1,537 ****
! <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
!     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
! <html xmlns="http://www.w3.org/1999/xhtml">
!   <head>
!     <title>
!       ARSperl Manual
!     </title>
!     <style type="text/css">
! /*<![CDATA[*/
!     body {
[...1063 lines suppressed...]
!           </li>
!           <li>
!             <a href="ds_shv.html">Status History Value</a>
!           </li>
!           <li>
!             <a href="ds_verifyuser_hash.html">Verify User Structure</a>
!           </li>
!           <li>
!             <a href="ds_getvui_hash.html">VUI Attributes Structure</a>
!           </li>
!         </ul>
!       </dd>
!     </dl>
!     <address>
!       <a href="../index.html">ARSPerl</a><br />
!       Last changes to this page 31st March 2009 by mic...@gm...<br />
!       © J.C.Murphy, J.W.Murphy 1997 <i>ar...@ar...</i>
!     </address>
!   </body>
! </html>

[Arsperl-devel] ARSperl/html/manual ars_CreateImage.html, NONE, 1.1 ars_DeleteImage.html, NONE, 1.1

[Arsperl-devel] ARSperl/html/manual ars_CreateImage.html, NONE, 1.1 ars_DeleteImage.html, NONE, 1.1 ars_GetImage.html, NONE, 1.1 ars_GetListImage.html, NONE, 1.1 ars_SetImage.html, NONE, 1.1 ars_MergeEntry.html, 1.7, 1.8 toc.html, 1.29, 1.30