Media Server 24.1

# ListObjects

Returns a list of objects in a specified database. The action can also return information about the images, training options, and metadata associated with each object.

Type: synchronous

Parameter | Description | Required
--- | --- | ---
`database` | The name of the database that contains the objects. | Yes
`identifier` | A comma-separated list of identifiers to specify the objects to list. If you do not set this parameter, Media Server lists all of the objects in the specified database. | No
`imagestatus` | A Boolean value (default false) that specifies whether to return the label and training status of each image associated with each object. | No
`maxresults` | The maximum number of objects to return. | No
`metadata` | A Boolean value (default false) that specifies whether to return the metadata associated with each object. | No
`start` | The starting point for the list when you set the `maxresults` parameter. For example, to start listing objects from the tenth object in the database, set `start=10`. The entries in the database are indexed from 1. | No
`trainingoptions` | A Boolean value (default false) that specifies whether to return the training options set for each object. | No

## Example

The following example lists up to 10 objects contained in the `CompanyLogos` database:

    /action=ListObjects&database=CompanyLogos
                       &imagestatus=TRUE
                       &metadata=TRUE
                       &trainingoptions=TRUE
                       &start=1
                       &maxresults=10

## Response

The response always includes the following information for each object:

- `identifier` - The identifier for the object.
- `numimages` - The number of training images associated with the object.
- `numtrained` - The number of images associated with the object that have been trained (the number that are used for object recognition).
- `numfailed` - The number of images associated with the object where training failed.
- `numuntrained` - The number of images associated with the object that have not yet been trained.

If you set the action parameter `imagestatus` to `true`, Media Server returns the status of each training image associated with each object.

- The `status` element indicates the status of training:

  - `trained` indicates that training was successful.
  - `untrained` indicates that training has not been attempted. Run training for the object using the action BuildObject, or run training for all objects that have incomplete training using the action BuildAllObjects.
  - `failed` indicates that Media Server could not use the image for training. Remove the failed image using the action RemoveObjectImages.
- The `hasimagedata` element indicates whether the training image is stored in the database. If the value of this element is `false`, the image has been removed from the database by the action NullObjectImageData. Images that have been removed and have a status of `untrained` cannot be trained, so OpenText recommends you remove these images with the action RemoveObjectImages.

    <autnresponse>
      <action>LISTOBJECTS</action>
      <response>SUCCESS</response>
      <responsedata>
        <entry>
          <identifier>HP</identifier>
          <numimages>3</numimages>
          <numtrained>1</numtrained>
          <numfailed>1</numfailed>
          <numuntrained>1</numuntrained>
          <images>
            <image>
              <label>image1</label>
              <status>trained</status>
              <hasimagedata>true</hasimagedata>
            </image>
            <image>
              <label>image2</label>
              <status>untrained</status>
              <hasimagedata>true</hasimagedata>
            </image>
            <image>
              <label>image3</label>
              <status>failed</status>
              <hasimagedata>true</hasimagedata>
            </image>
          </images>
          <trainingoptions>
            <trainingoption>
              <key>usecolor</key>
              <value>false</value>
            </trainingoption>
          </trainingoptions>
          <metadata>
            <item>
              <key>CompanyName</key>
              <value>Hewlett Packard</value>
            </item>
          </metadata>
        </entry>
      </responsedata>
    </autnresponse>

Copyright 2023 Open Text
Version 24.1 | Last updated December 2023

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.1

Topic Title: ListObjects