topic Re: How to add a dynamic facet via nuxeo-java-client? in Nuxeo Forum

How to add a dynamic facet via nuxeo-java-client?

Daniel_Viero — Wed, 31 May 2017 17:10:49 GMT

Hi there.

I'm trying to create a document with an optional (dynamic) Facet, but it's not working. I'm using java-client 1.0 with Nuxeo 7.10 HF-24. My code is as follows:

Document doc = new Document(name, "MyType");
doc.set("dc:title", "Doc Title");
doc.setFacets(Arrays.asList("MyFacet"));
doc.set("myfacet:attr1", "xpto");
doc = nuxeo.repository().createDocumentByPath(parentPath, doc);

The document is created, but the facet and its attributes are not there. How to accomplish that using Nuxeo Java Client? I don't want that Facet to be mandatory in MyType, since it is not applicable for all document instances.

Thanks in advance. Daniel Viero.

Re: How to add a dynamic facet via nuxeo-java-client?

pibou_Bouvret — Wed, 31 May 2017 17:29:28 GMT

Isn't the nuxeo-java-client compatible only with Nuxeo LTS 2016 and upwards ?

Re: How to add a dynamic facet via nuxeo-java-client?

Daniel_Viero — Wed, 31 May 2017 17:38:46 GMT

nuxeo-java-client 1.x is compatible with LTS 2015.

Re: How to add a dynamic facet via nuxeo-java-client?

Kevin_Leturc — Thu, 01 Jun 2017 16:27:46 GMT

Hi Daniel,

There's no way to add dynamically a facet on a document through REST in 7.10.

The method Document#setFacets is misleading and should only be used for internal client usage, like specific marshallers.

You can easily create your own operation to do that, you can also copy AddFacet operation and deploy it to your Nuxeo Server.

Regards

Re: How to add a dynamic facet via nuxeo-java-client?

Daniel_Viero — Thu, 01 Jun 2017 19:45:20 GMT

Thanks for the confirmation, Kevin. We've already copied the AddFacet operation, but I really expected the full document creation to be available as an atomic operation in the client API. If I have to do 3 or 4 call to fully create one document, and something fails in the last step (a dynamic facet's attribute validation, for instance), I will have to run undo/compensation operations manually, unless I do server-side programming. It doesn't sound OK for me, since my applications are just clients. I hope Nuxeo client API evolve. Thanks anyway.

Re: How to add a dynamic facet via nuxeo-java-client?

Kevin_Leturc — Thu, 01 Jun 2017 21:26:19 GMT

You can also use automation chain to perform this operation atomically.

For example the following chain creates a document, adds a facet and updates properties.

<component> <extension target="org.nuxeo.ecm.core.operation.OperationServiceComponent" point="chains"> <chain id="create-doc-attach-facet"> <param type="string" name="docType" /> <param type="string" name="name" /> <param type="properties" name="properties" /> <param type="string" name="facet" />  <operation id="Document.Create"> <param type="string" name="type">expr:ChainParameters['docType']</param> <param type="string" name="name">expr:ChainParameters['name']</param> </operation>  <operation id="Document.AddFacet"> <param type="string" name="facet">expr:ChainParameters['facet']</param> </operation> <operation id="Document.Update"> <param type="properties" name="properties">expr:ChainParameters['properties']</param> </operation> </chain> </extension> </component>

And then you use it with nuxeo java client:

public void itCanAnswer() { Document doc = nuxeoClient.automation("create-doc-attach-facet") .param("docType", "File") .param("name", "file-test") .param("properties", Collections.singletonMap("dc:description", "description for test")) .param("facet", "NotFulltextIndexable") .input(new DocRef(("/"))) .execute(); assertNotNull(doc); assertTrue(doc.getFacets().contains("NotFulltextIndexable")); assertEquals("description for test", doc.getPropertyValue("dc:description")); }

If something went wrong during the chain execution, the transaction is rollback.

Re: How to add a dynamic facet via nuxeo-java-client?

Daniel_Viero — Fri, 02 Jun 2017 18:52:39 GMT

That looks great! I was trying to avoid server-side development, but this is a pretty generic solution. I suggest it to be incorporated as a native operation in Nuxeo, since it looks like a basic functionality to me. Thank you very much.