Get Default link for a Node

Sometimes you may have a Livelink Object ID (the value of dataid from dtree) and you need to create a link to that object. Generally you can find most of the components that you need in the request object, such as the complete URL, but the actual Request Handler for that type of Livelink Object is a little more complex. You can follow the function calls used in the Browse pages, but sometimes you do not have enough information, for example when within a function where these objects are not available.

This article looks at an alternative method to get a link to that Livelink Object. For this we will use the Livelink URL that is used by the Notifications system (<Livelink URL>?func=notify.config).

function String getDefaultURL (DAPINode inNode)
    // Load the Notification Configuration information
    Dynamic config=$LLAgent.Utils.ConfigLoad( prgCtx.USession().fDbConnect.fConnection, 100 )
 
    // Convert the Node into a WebNode
    Object webNode=$WebNode.WebNodes.GetItem(inNode.pSubType)
 
    // Get the Open action of the WebNode
    Object open=webNode.Cmd("open")
 
    // String to store the return value
    String nodeURL
 
    // if the Object in question is not a Document then use this link format
    if (inNode.pSubType <> $TypeDocument)
        nodeURL=Str.Format("%1?%2",config.URL,Str.Format(open.fQueryString,inNode.pID))
 
    // For Documents point at the General Properties page
    else
        nodeURL=Str.Format("%1?func=ll&objid=%2&objaction=properties",config.URL,inNode.pID)
    end
end

In response to a question on the Knowledge Center, another approach for creating the nodeURL was provided by Kyle Swidrovich. This approach would replace the if .. then clause in the function with the following :

nodeURL = Str.Format( "%1/open/%2", config.URL, inNode.pID)

Having tested this approach, the only difference I've found is that the original code takes you to the browse page for Folders, Projects, Compound Documents etc and the Properties page for Documents, whereas the new one just calls the open action for that Object. Thus if a Document is a Word document it would be viewed - or you would see the Document Overview page depending on your configuration - and a ZIP file would be downloaded rather than showing the Properties dialog for the Object, in some cases this may be what you want.