ars_decodeStatusHistory($field_value)
	Use this to decode the field value of the status history 
	field. It will decode it into an array of hash references.
	Each array element will correspond to the enumeration value
	of the status field. Each hash reference will contain a
	USER and TIME hash key. These correspond to the user and time
	that the status field was last in a particular enumerated 
	state. You can use 
        ars_GetField() to map from labels (open,
	held, closed, etc) to enumerations (0, 1, 2, etc).
The Status History field (field ID 15) is a core field. That means it is present on all Regular forms,
even if Status History logging ist disabled (in ARS 7.1.0 or higher).
      
         - On success
- 
		Returns an array of hash references.
         
- On failure
- 
                Returns undef.
      
Example:
      
	%entry = ars_GetEntry($ctrl, $form, $entry, 15)
	@status_hist_values = ars_decodeStatusHistory($entry{15});
	# print the status history for the first status (0)
	print $status_hist_values[0]->{USER}."\n";
	print localtime($status_hist_values[0]->{TIME})."\n";	
For a more detailed example, refer to the ars_decodeStatusHistory.pl file in the examples directory.
ars_decodeStatusHistory was introduced in version 1.52 of ARSperl. 
 Table of Contents
 Table of Contents 
Last changes to this page 2 aug 2007 by Michiel Beijen
© J.C.Murphy, J.W.Murphy 1997 arsperl@arsperl.org