UC Modify a Scheduled Recording

Motivation

In case of updates (e.g. start, duration or device have changed), an update of the scheduled recording is necessary.

Description

Currently updates are only supported for chunks (and their commands) and recurrences, not for booking definitions or bookings. This should currently be sufficient for all supported use cases.

Modify Chunk

Follow these steps to modify/update chunks:

Obtain newest version of chunk from API

Use GET /vidicontrol/schedulercore/SchedulerCore/BookingService/v1/Chunks/JMQZ?content=Commands

The ?content=Commands query parameter is mandatory in this use case.

Example Response:

CODE

{
  "id": "VCR-JMQZ",
  "commandList": [
    {
      "id": "VCR-n50J",
      "capabilityId": "VCR-wl",
      "poolId": null,
      "deviceId": "VCR-0B",
      "executionTime": "2023-05-02T18:59:58Z",
      "duration": 2,
      "index": 0,
      "executionState": "Pending",
      "handling": "WaitForResult",
      "content": "{\"action\":\"Switch\",\"input\":{}}",
      "commandType": "CapabilityRouter",
      "inPortId": "VCR-Jr",
      "outPortId": "VCR-xd",
      "routingList": []
    },
    {
      "id": "VCR-Pp3Q",
      "capabilityId": "VCR-0B",
      "poolId": "VCR-wl",
      "deviceId": "VCR-AN",
      "executionTime": "2023-05-02T19:00:00Z",
      "duration": 3600,
      "index": 1,
      "executionState": "Pending",
      "handling": "WaitForResult",
      "content": "{\"action\":\"Record\",\"input\":{\"targetPath\":null,\"profileName\":null}}",
      "commandType": "CapabilityRecorder",
      "inPortId": "VCR-Jr",
      "outPortId": null,
      "routingList": []
    }
  ],
  "vcItemId": "ITEM-VX-8233",
  "metadata": null,
  "start": "2023-05-02T18:59:58Z",
  "end": "2023-05-02T20:00:00Z",
  "executionState": "Pending",
  "title": "Recording Test",
  "clipId": null,
  "parentInfo": {
    "bookingId": "VCR-99Q4",
    "bookingDefinitionId": "VCR-n6QN",
    "bookingDefinitionType": "Single"
  }
}

Change values in the response

As an example, the recording should be extended for one hour the title should be changed from “Test Recording” to “KPTN News”. The modified object is then:

CODE

{
  "id": "VCR-JMQZ",
  "commandList": [
    {
      "id": "VCR-n50J",
      "capabilityId": "VCR-wl",
      "poolId": null,
      "deviceId": "VCR-0B",
      "executionTime": "2023-05-02T20:59:58Z",
      "duration": 2,
      "index": 0,
      "executionState": "Pending",
      "handling": "WaitForResult",
      "content": "{\"action\":\"Switch\",\"input\":{}}",
      "commandType": "CapabilityRouter",
      "inPortId": "VCR-Jr",
      "outPortId": "VCR-xd",
      "routingList": []
    },
    {
      "id": "VCR-Pp3Q",
      "capabilityId": "VCR-0B",
      "poolId": "VCR-wl",
      "deviceId": "VCR-AN",
      "executionTime": "2023-05-02T21:00:00Z",
      "duration": 3600,
      "index": 1,
      "executionState": "Pending",
      "handling": "WaitForResult",
      "content": "{\"action\":\"Record\",\"input\":{\"targetPath\":null,\"profileName\":null}}",
      "commandType": "CapabilityRecorder",
      "inPortId": "VCR-Jr",
      "outPortId": null,
      "routingList": []
    }
  ],
  "vcItemId": "ITEM-VX-8233",
  "metadata": null,
  "start": "2023-05-02T20:59:58Z",
  "end": "2023-05-02T21:00:00Z",
  "executionState": "Pending",
  "title": "KPTN News",
  "clipId": null,
  "parentInfo": {
    "bookingId": "VCR-99Q4",
    "bookingDefinitionId": "VCR-n6QN",
    "bookingDefinitionType": "Single"
  }
}

Send it back to the API via PUT /vidicontrol/schedulercore/SchedulerCore/BookingService/v1/Chunks/