updateClosedSituation
A MoogDb v2 method that updates the description and custom info of a closed Situation during the grace period. The grace period is when a Situation is closed and in the active database, before it is archived to the historic database. If a custom info field already exists, this method replaces the previous value; if a custom info field does not exist, this method adds it.
The updateClosedSituation method returns an error if the Situation is open, or if it is closed and has been archived to the historic database.
Back to MoogDb V2 API Method Reference.
Request arguments
Method updateClosedSituation takes the following request arguments:
Name | Type | Required | Description |
|---|---|---|---|
| Number | Yes | ID of the closed Situation that you want to update. |
description | String | No | New description of the Situation. |
custom_info | JSON Object | No | A JSON object containing the custom info values that you want to update. If the key already exists, the method replaces the existing value. If the key does not exist, the method adds it. |
Response
Method updateClosedSituation returns the following response:
API update behavior
The behavior of this method depends on whether the relevant alert or Situation is open, closed and still in the active database, or closed and archived to the historic database. This method updates or returns information about the alert or Situation as follows:
See API Update Behavior for more information on Situation statuses.
Examples
The following examples demonstrate typical use of method updateClosedSituation:
Request example
Example request to update the description and custom info for Situation ID 333:
function updateClosedSituation1()
{
var obtainSit=moogdb.getSituation(333);
var customInfo={"key1":"value1"};
obtainSit.set("description", "updateClosedSituation1_description_updated");
obtainSit.set("custom_info", customInfo);
var result=moogdb.updateClosedSituation(obtainSit);
logger.warning("system updates Situation which is in grace period, result should return true");
logger.warning("result = "+ result);
}