List the Objects in a Database

To list the objects that you have added to a database, and check whether training was successful, use the following procedure.

To list the objects in a database

  1. (Optional) First list the databases that have been created to store objects. Use the action ListObjectDatabases:

    http://localhost:14000/action=ListObjectDatabases

    Media Server returns a list of databases that you have created.

  2. List the objects that exist in one of the databases. Use the action ListObjects, for example:

    http://localhost:14000/action=ListObjects&database=logos
                                             &metadata=true
                                             &trainingoptions=true
                                             &imagestatus=true
    

    Media Server returns a list of objects in the specified database, and the number of training images associated with each object.

    If you set the action parameter metadata to true, Media Server returns the metadata you have added to the object.

    If you set the action parameter trainingoptions to true, Media Server returns the training options you have set for the object.

    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.