List the Faces in a Database

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

To list the faces in a database

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

    http://localhost:14000/action=ListFaceDatabases

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

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

    http://localhost:14000/action=ListFaces&database=faces
                                           &metadata=true
                                           &imagestatus=true

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

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

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

    • 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 face using the action BuildFace, or run training for all faces that have incomplete training using the action BuildAllFaces.
      • failed indicates that Media Server could not use the image for training. For example, if Media Server does not detect a face in an image, it cannot be used as a training image. Remove the failed image using the action RemoveFaceImages.
    • 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 NullFaceImageData. Images that have been removed and have a status of untrained cannot be trained, so OpenText recommends you remove these images with the action RemoveFaceImages.