How do I get/set document tags through the automation client?

I'm having a heck of a time finding documentation on getting/setting document tags through the automation client. I found the TagServiceImpl but it wants a CoreSession not a ConcreteJavaProxy. Can someone point me in the right direction?

0 votes

5 answers



Woops, that ConcreteJavaProxy should be org.nuxeo.ecm.automation.client.jaxrs.spi.DefaultSession. The ConcreteJavaProxy is the jruby wrapper class.

Today there's no operation to tag a document. You could easily write one though, that would call the underlying TagService.

Operations available in Nuxeo 5.4.2 are listed at

0 votes

Based on I started on a class to handle the creation of the Tag and Tagging objects myself but i'm having a problem creating a document with a nil parent.

I'd prefer to use the TagService but the TagService doesn't take the session from the automations client. Is there another client I should use?


If you code through Automation Client then you don't have access to all the Nuxeo APIs, only the Automation ones. If you want to code using all the Nuxeo APIs then you have to code server-side, by writing a new service or a new Operation.

This one s a bit late :

list / search tags : select * from tags (where tag:label like '%odontolo%')

you can then retrieve the UUID of the Tag

list tagged documents : select * from Tagging where relation:target = '*UUID_OF_THE_TAG*'

Create a Tagging document (inherits from Relation) with

**relation:source** being the UUID of your document,

**relation:target** the UUID of the Tag and

**ecm:path** the label of the tag

Note that both are HiddenInNavigation, the ecm:path is also used for storing the tag label and it causes some problems when querying through the UI (advanced search queries can lead to “Illegal relative path with null node”)

1 votes

much better since 7.1 : org.nuxeo.ecm.platform.tag.operations

<extension point="operations" target="org.nuxeo.ecm.core.operation.OperationServiceComponent">
    <operation class="org.nuxeo.ecm.platform.tag.operations.TagDocument"/>
    <operation class="org.nuxeo.ecm.platform.tag.operations.UntagDocument"/>
    <operation class="org.nuxeo.ecm.platform.tag.operations.RemoveDocumentTags"/>


OK I did it in a new operation

@Operation(id=SetDocumentTag.ID, category=Constants.CAT_DOCUMENT, label=“SetDocumentTag”, description=““) public class SetDocumentTag {

public static final String ID = "SetDocumentTag";
private static final Log log = LogFactory.getLog(SetDocumentTag.class);

protected CoreSession session;

@Param(name = "label", required = true)
protected String label;

@Param(name = "username", required = true)
protected String username;

public void run(DocumentModel input) throws Exception {
    TagService service = Framework.getLocalService(TagService.class);
    String docId = input.getId();
    log.error("SetDocumentTag> docId=" + docId + " tag=" + label + " username=" + username);
    service.tag(session, docId, label, username);;



1 votes


In the last comment, maumig mention an implementation of tagging through automation client… can you give me hints on how this is done?



0 votes

in the meantime has been implemented tagging through automation client? Thanks!

0 votes