The Metadata and Relations category enables you to manage metadata associated with Oracle Beehive artifacts and entities.

A category is a hierarchical structure of designations that may be applied to entities, including all of the artifacts stored in a workspace. Categories always exist at the enterprise scope. Refer to "Managing Categories" for more information.

Programming Tips

Limiting Number of Entities Returned by /labl Resource

A label may be applied to many entities. When you perform a GET on the label resource, the BDK returns a representation that includes the IDs of all the entities to which the label has been applied.

If a label has been applied to a large number of artifacts, you may limit the number of entities returned by the /labl resource. Use the resource /comb/v1/d/labl/list/entities/{id}, where {id} is the ID of the label. When you POST to this resource to retrieve the entities to which the specified label has been applied, pass a predicateAndSortListParameters object. In this object, you may control which IDs are returned, including the count limit.

Detecting if Shared Tag Has Been Set by User

If an object has been tagged by a shared tag, which is represented by the label resource, the label will appear in the object's attachedMarkers member. To determine if the object has been tagged by the current logged-in user or another user, retrieve the label. The label contains an entities member, which is a list of all objects that have been tagged by this label.

• If the object in question appears in the label's entities member, then the object has been tagged by the current logged-in user.
• If the object does not appear in the label's entities member, then the object has been tagged by a user other than the logged-in user.