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