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

Last changes to this page 2 aug 2007 by Michiel Beijen
© J.C.Murphy, J.W.Murphy 1997 arsperl@arsperl.org