Media Server 24.3

# GetLatestRecord

DEPRECATED: The `GetLatestRecord` action is deprecated in Media Server 12.5.0 and later. OpenText recommends that you use the actions KeepLatestRecords and GetLatestRecords instead.

This action is still available for existing implementations, but it might be incompatible with new functionality. The action might be removed in future.

Retrieves the latest record that has been added to a track, or the latest records for all tracks.

NOTE: Media Server only generates records in tracks that are used. For example, if you run face detection but do not use the face detection data track as the input for another task, Media Server does not generate records in that track.

NOTE: This action only returns records from requests that have a status of `processing`. Media Server does not return records from requests that have a status of `finished`. You can use this action to confirm that Media Server is processing video correctly. You should not use this action to retrieve results from Media Server. If you need to retrieve results through ACI, Media Server provides an ACI response output engine.

Type: synchronous

Parameter | Description | Required
--- | --- | ---
`Compress` | A Boolean value (default `true`) that specifies whether the action returns image data in compressed JPEG format, rather than PNG format. | No
`Token` | The asynchronous action token, returned by the `process` action, that specifies the processing request to return records from. If you do not set this parameter, Media Server returns records for all processing requests. | No
`Tracks` | A comma-separated list of tracks to return the latest records from. If you do not set this parameter, Media Server returns the latest record from each output track. To return the latest records from all tracks, set this parameter to an asterisk (`*`). | No

## Example

    /action=GetLatestRecord
                  &Token=...
                  &Tracks=Keyframe.Result,OCR.Result

## Response

A sample response appears below.

    <autnresponse>
      <action>GETLATESTRECORD</action>
      <response>SUCCESS</response>
      <responsedata>
        <result>
          <session token="...">
            <track name="Keyframe.Result" inUse="true">
              <KeyFrameData>
                <id>392a3c2b-013f-440e-93e6-b3efb5088810</id>
              </KeyFrameData>
            </track>
            <track name="OCR.Result" inUse="true">
              <OCRResult>
                <id>4e999dbf-b142-4624-a2e2-47ce5ccdf85a</id>
                <text>...</text>
                <region>
                  <left>119</left>
                  <top>501</top>
                  <width>426</width>
                  <height>24</height>
                </region>
                <confidence>97</confidence>
              </OCRResult>
            </track>
          </session>
        </result>
      </responsedata>
    </autnresponse>

If a track is not used, the `inUse` attribute has a value of `false`, and Media Server does not return any records for that track:

    <track name="Keyframe.Result" inUse="false" />

Copyright 2024 Open Text
Version 24.3 | Last updated June 2024

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL Media Server 24.3

Topic Title: GetLatestRecord