This feature is available from iCM 10.1.0.102
Description
This function restores a hidden event to its previous position, based upon its timestamp (the numbered position may not be the same if other events in the sequence have been shown/hidden). It works with active and sealed histories.
Unhiding an event also writes a hidden "metadata event" which includes the ID of the event, the type of action (ie "unhide") and the optional reason. Metadata events are returned when history queries are made in audit mode.
For an overview, see Hiding and Replacing Events.
Parameters
| Field | Type | Required | Notes |
|---|---|---|---|
| eventid | positive integer | Yes | The event id to unhide - from log/replaceEvent's response, or a gethistory event's eventId |
| id | string (UUID) | One of id / labels | The ID of the history the event belongs to. Mutually exclusive with labela-labele |
| labela ... labele | simple value | " | The labels to identify the history |
| reason | string | No | Free text, stored in the metadata event. Omit entirely for no reason field at all. |
Returns
If the operation was successful then the "result" structure will contain the following.
| Property | Description |
|---|---|
| historyid | The unique ID of the history |
| eventid | The ID of the event |
| eventpos | The position of the event in the history |
| metadataeventid | The ID of the corresponding metadata event |
Example
{
"method": "unhideevent",
"params": {
"labela": "HideEventTest",
"labelb": "1234-1234-1234-1234",
"eventid": 1042,
"reason": "restored in error"
}
}
"result": {
"historyid": "3f1c9a2e-...-9a6a6a2b6d10",
"eventid": 1042,
"eventpos": 2,
"metadataeventid": 1046
}
