topic Re: Rest Api : Link a File to a Site in Alfresco Forum

Rest Api : Link a File to a Site

hilal_aslan — Fri, 23 Jun 2017 13:02:10 GMT

Hi, I m using Alfresco Community 5.2. I want to create link a file(this file is in another site) to site by using REST API. But I can not find any document about this issue. How can I create link to site for folder or any document?Thanks in advance..

Re: Rest Api : Link a File to a Site

afaust — Sat, 24 Jun 2017 14:58:27 GMT

Depending on what kind of link you want to create (symlink- or hardlink-like, or even just a peer-reference) you would have to deal with either creating/managing a node or handling associations of a node. Depending on the kind of link you may either have to know the type / property / association to use, or even create your own custom content model if nothing of the existing fits your requirement.

Unfortunately you did not really specify what the kind of link should be, e.g. what its purpose is and how it should be presented to the end-user, so my comment is rather abstract and you will probably not find any documentation on such an abstract level.

Re: Rest Api : Link a File to a Site

mehe — Mon, 26 Jun 2017 05:48:43 GMT

If you just want to create a filelink it should work with the "create node" rest endpoint (see alfresco-API-explorer, see Axels create link above)

Type should be an app:filelink and in the properties you need a cm:destination set to the targets nodeRef (with workspace://SpacesStore). I think adding ".lnk" or ".url" as Extension in the nodename will force share to show an appropriate icon.

But I never tried it myself....

Re: Rest Api : Link a File to a Site

hardik1512 — Mon, 26 Jun 2017 10:09:44 GMT

How about below webscripts?

/alfresco/s/api/node/doclink/{store_type}/{store_id}/{id}
/alfresco/s/api/site/doclink/{site}/{container}/{path}
/alfresco/s/api/site/doclink/{site}/{container}

You can find more info at webscript home.

Re: Rest Api : Link a File to a Site

afaust — Mon, 26 Jun 2017 11:21:02 GMT

You should not rely on those web scripts - they are marked with the lifecycle "internal" which means they are meant to be consumed by the Alfresco products and may change (without notice) between Alfresco versions. That is the reason that there exists a new v1 ReST API to get people off using these internal APIs.

Re: Rest Api : Link a File to a Site

hilal_aslan — Wed, 28 Jun 2017 06:07:01 GMT

I m clicking "copy to" on myfiles folder or any site folder. And after that, it is appear a button called "create link". By clicking this button, I can create link for this document to any place. But now, I want to make this process (create link) with rest api.

Re: Rest Api : Link a File to a Site

hilal_aslan — Wed, 28 Jun 2017 06:07:49 GMT

Ok but what about parameters ?

Re: Rest Api : Link a File to a Site

hilal_aslan — Fri, 30 Jun 2017 10:37:47 GMT

any help!

Re: Rest Api : Link a File to a Site

janv — Mon, 03 Jul 2017 13:41:26 GMT

Martin and Alex are correct. You should be able to use the new V1 REST API to create a node of the given node type (app:filelink) and set the property (cm:destination). We also have a basic unit test for this specific scenario.

Re: Rest Api : Link a File to a Site

hilal_aslan — Mon, 03 Jul 2017 14:08:37 GMT

Ok but what is Api URL ? my api url is "http://localhost:8080/alfresco/api/-default-/public/alfresco/versions/1/nodes/43ad4f37-7bff-491e-b636-0b3998ecae7b "

and my parameters :

{
"name": "Test file link",
"nodeType": "app:filelink",
"properties" : {
"cm:destination" : "b3ee89c4-bf02-44dc-a0e9-9ca6fdc9b97b"
}
}

but I get error "400 bad request"

{
"error": {
"errorKey": "Failed to change (specialise) node type - from {http://www.alfresco.org/model/content/1.0}folder to {http://www.alfresco.org/model/application/1.0}filelink",
"statusCode": 400,
"briefSummary": "06030125 Failed to change (specialise) node type - from {http://www.alfresco.org/model/content/1.0}folder to {http://www.alfresco.org/model/application/1.0}filelink",
"stackTrace": "For security reasons the stack trace is no longer displayed, but the property is kept for previous versions",
"descriptionURL": "https://api-explorer.alfresco.com"
}
}

Re: Rest Api : Link a File to a Site

janv — Mon, 03 Jul 2017 15:03:25 GMT

You need to "create [the symbolic] link" in a new parent folder, hence use POST .../nodes/{parentFolderNodeId}/children:

Alfresco Content Services REST API Explorer

The "cm:destination" property points to the source file. It should be noted that this is a pre-existing model as currently used by Share. Here the snippets from ...

applicationModel.xml

<type name="app:filelink">
   <title>File Link Object</title>
   <parent>cm:link</parent>
</type>

contentModel.xml

<type name="cm:link">
   <title>Link Object</title>
   <parent>cm:cmobject</parent>
   <properties>
      <property name="cm:destination">
         <title>Link Destination</title>
         <type>d:noderef</type>
         <mandatory>true</mandatory>
      </property>
   </properties>
</type>

Regards,

Jan