ARSperl Manual - ars_decodeStatusHistory

## `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