ISystemTagObjectMapper¶
-
interface
OCP\SystemTag\
ISystemTagObjectMapper
¶ - Public interface to access and manage system-wide tags.
Implemented by: OC\SystemTag\SystemTagObjectMapper
Source: lib/public/SystemTag/ISystemTagObjectMapper.php#35
Methods¶
-
public
OCP\SystemTag\ISystemTagObjectMapper::
getTagIdsForObjects
($objIds, $objectType)¶ - Get a list of tag ids for the given object ids.This returns an array that maps object id to tag ids[1 => array(‘id1’, ‘id2’),2 => array(‘id3’, ‘id2’),3 => array(‘id5’),4 => array()]Untagged objects will have an empty array associated.
Source: Parameters: - $objIds (string | array) object ids
- $objectType (string) object type
Returns: array with object id as key and an array of tag ids as value
Since: 9.0.0
-
public
OCP\SystemTag\ISystemTagObjectMapper::
getObjectIdsForTags
($tagIds, $objectType, $limit=0, $offset="")¶ - Get a list of objects tagged with $tagIds.
Source: Parameters: - $tagIds (string | array) Tag id or array of tag ids.
- $objectType (string) object type
- $limit (int) Count of object ids you want to get
- $offset (string) The last object id you already received
Returns: string[] array of object ids or empty array if none found
Throws: \OCP\SystemTag\TagNotFoundException
if at least one of the given tags does not existThrows: \InvalidArgumentException
When a limit is specified together with multiple tag idsThrows: \OCP\SystemTag\TagNotFoundException
if at least one of the given tags does not existThrows: \InvalidArgumentException
When a limit is specified together with multiple tag idsSince: 9.0.0
-
public
OCP\SystemTag\ISystemTagObjectMapper::
assignTags
($objId, $objectType, $tagIds)¶ - Assign the given tags to the given object.If at least one of the given tag ids doesn’t exist, none of the tagswill be assigned.If the relationship already existed, fail silently.
Source: Parameters: - $objId (string) object id
- $objectType (string) object type
- $tagIds (string | array) tag id or array of tag ids to assign
Throws: \OCP\SystemTag\TagNotFoundException
if at least one of the given tags does not existSince: 9.0.0
-
public
OCP\SystemTag\ISystemTagObjectMapper::
unassignTags
($objId, $objectType, $tagIds)¶ - Unassign the given tags from the given object.If at least one of the given tag ids doesn’t exist, none of the tagswill be unassigned.If the relationship did not exist in the first place, fail silently.
Source: Parameters: - $objId (string) object id
- $objectType (string) object type
- $tagIds (string | array) tag id or array of tag ids to unassign
Throws: \OCP\SystemTag\TagNotFoundException
if at least one of the given tags does not existSince: 9.0.0
-
public
OCP\SystemTag\ISystemTagObjectMapper::
haveTag
($objIds, $objectType, $tagId, $all=true)¶ - Checks whether the given objects have the given tag.
Source: Parameters: - $objIds (string | array) object ids
- $objectType (string) object type
- $tagId (string) tag id to check
- $all (bool) true to check that ALL objects have the tag assigned,
false to check that at least ONE object has the tag.
Returns: bool true if the condition set by $all is matched, false otherwise
Throws: \OCP\SystemTag\TagNotFoundException
if the tag does not existSince: 9.0.0