The GetObjectIdByParam method

The GetObjectIdByParam method allows receiving of object ID at which some parameter is equal to the specified value. The first found object ID is receiving if there are several such objects. The null is receiving if such objects are not found

Syntax of method invocation:

function GetObjectIdByParam (obj_type : String, obj_param : String, param_value : String)

Method arguments:

1. obj_type – required argument. Specifies type of system object, ID of which is required to get.
2. obj_param - required argument. Specifies the name of parameter in database on value of which the object is to be found.
3. param_value – required argument. Specifies the required value of object parameter.

Example. Find cameras from which black-and-white image is receiving and set the Color parameter equals to 1 for them.

if (Event.SourceType == "MACRO" && Event.SourceId== "1" && Event.Action == "RUN")
 
{
  var id = GetObjectIdByParam("CAM","color","0"); //receiving the first object ID
  while (id){ //while exist the Camera objects from which black-and-white image is receiving
     SetObjectParam ("CAM", id, "color", "1"); //change the Color parameter for found object
     id = GetObjectIdByParam("CAM","color","0"); //receiving the next object ID
  }
}