With OpenDocument support being extended to Lumira documents, from Release 1.29 of SAP Lumira, server for BI Platform (LS4BIP), users can generate direct links (URLs) for opening Lumira documents and specific content within them.
This URL can be shared with other users, who can view and act on the document based on their existing rights or by virtue of credentials passed in the OpenDocument URL itself.
The basic syntax for an OpenDocument URL is as follows:
A user can generate an OpenDoc URL in the opened document state. Refer the below screenshots.
The first one shows the button/icon that allows generation of the OpenDocument URL. The second one shows the window that opens, containing the OpenDocument URL.
Following options are supported for Lumira content through OpenDocument URL. These are embedded as parameters in the OpenDocument Link.
Authentication parameters – Serialized sessions and Logon Tokens
These allow users to access documents without being prompted for credentials.
Note: If the user has an existing session for the browser session, he would not be prompted for credentials even if the authentication parameters are not embedded in the OpenDocument URL
Document Identification parameters
Document Id or Document Name can be passed as a parameter.
Story Name parameter
Story Name can be passed as a parameter. If this parameter exists in the URL, the user is directly taken to the specified story on opening the link.
Page Number parameter
Page Number can be passed as a parameter. If this parameter exists in the URL, the user is directly taken to the specified page of the specified story on opening the link.
Refresh parameter allows the user to define if the document should refresh on open or not.
The OpenDocument link is generated based on the current state of the document, e.g. if a user is on a particular page within a story in a document, the OpenDocument link generated in this state will automatically include the story and page parameters.