topic Re: What is the best way to integrate or migrate users from client app? in Alfresco Forum

What is the best way to integrate or migrate users from client app?

sepgs2004 — Thu, 23 Aug 2018 02:44:48 GMT

From our application, we integrate with Alfresco for document management. There are clients of our application, who has Oracle IP/M, Documentum and other content management systems. So our application has code to integrate with other repositories as well.Now, our application has its own user managem

Re: What is the best way to integrate or migrate users from client app?

jpotts — Thu, 23 Aug 2018 15:43:29 GMT

How are you adding the comment node? Are you calling the REST API or are you calling a web script that uses the Java API to create the comment?

If it is the latter, you can just add an aspect to your content model that captures the data, then add the aspect to the comment node and set the data. In fact, you've already created two properties to capture updated by and updated date. Those could be defined in an aspect which would allow you to re-use the property definitions for both documents and comments.

Basically, when the application invokes the web script, pass along not only the comment but also the application username. The web script can then add the aspect to the comment node.

Re: What is the best way to integrate or migrate users from client app?

sepgs2004 — Fri, 24 Aug 2018 14:28:52 GMT

For now, we are invoking the existing built in webscripts, that correspond to add/delete comments, through Rest API.

When you say the "latter", do you mean we should write our own webscript with JAVA.

I will explore along the lines of having aspects for the comments.

When you say "when the application invokes the web script"... what is this web script you are talking about.

I am using the ones that are built in...

Get all the comments
GET /alfresco/s/api/node/{store_type}/{store_id}/{id}/comments?reverse={reverse?}&startIndex={startIndex?}&pageSize={pageSize?}

Add comment
POST /alfresco/s/api/node/{store_type}/{store_id}/{id}/comments

Delete comment
DELETE /alfresco/s/api/comment/node/{store_type}/{store_id}/{id}

Please give me some more tips to follow your recommendation.

Re: What is the best way to integrate or migrate users from client app?

cesarista — Mon, 27 Aug 2018 17:50:40 GMT

Hi:

Jeff mentions that if you created a custom aspect with a property called "updated by", you may add this aspect to your comment (not only to the document). Even, you can add the user in the text of the comment for having a visual reference of the application user.

Other aprox. could be for example to integrate users in Alfresco, with a custom JDBC authentication subsystem, that enables to login in Alfresco from a database table. Then, users (with contributor role) could create their own comments via webscript. Although this probably will change a lot your document structure permissions on the repo.

Regards.

--C.

Re: What is the best way to integrate or migrate users from client app?

sepgs2004 — Tue, 28 Aug 2018 15:16:59 GMT

If we go with having a custom aspect with updated_by property, you mentioned that we can add this aspect to the comment.

Can I still use the REST API (and version 5.1.0) to accomplish this (like described below)?

For the REST API that I use with version 5.1.0, to add a comment, I am using the following call.

It has a JSON argument. Are you saying we can add the aspect property into the JSON argument?

It's details are here.

<url>/api/comment/node/{store_type}/{store_id}/{id}</url>

<format default="json">argument</format>

My code looks like this. I wonder how to pass the aspect value in here in this REST API call!

JsonObject jobject = new JsonObject();
jobject.addProperty("content", commentContent);
StringEntity entity = new StringEntity(jobject.toString());
callFunction.setEntity(entity);
callFunction.setHeader("Accept", "application/json");
callFunction.setHeader("Content-type", "application/json");
response = httpClient.execute(callFunction);

Or should I use the Alfresco SDK API with features available in Alfresco 5.2 onward?

Re: What is the best way to integrate or migrate users from client app?

cesarista — Tue, 28 Aug 2018 16:27:04 GMT

Maybe with additional GET and PUT calls to /api/nodes/{nodeId} , where your nodeId is your comment id (check the notes about adding or removing aspects).

Alfresco Content Services REST API Explorer

Regards.

--C.

Re: What is the best way to integrate or migrate users from client app?

jpotts — Wed, 29 Aug 2018 21:52:03 GMT

To clarify, I meant that if you were already calling a custom web script, just modify it to add an aspect and set the property.

If you are not using a custom web script, why not write one? That way you can get this done in one REST call instead of multiple.