Is is possible to extract a document stored in ADS from "outside" ARIS? I mean, if you know the url of the stored document. How?
Thanks in advance
Mercedes
1
136
6
by Runé Becker
Posted on Thu, 01/26/2023 - 15:44
Dear Mercedes,
The URL of an ADS link can't be used from outside ARIS because the calling user or application needs to authenticate against with an user account.
But you can use ARIS RESTful API where we offer a variety of APIs, such as ARIS Document Storage API. It allows you to extract files stored inside ARIS Server from an external application.
Actually, 3 out of 4 licenses for ARIS API are included in your standard ARIS client licenses. See the ARIS Functional Product Matrix on page 16. Only ARIS API System Access (YCSSA/YDSSA) are separately licensed as that license is meant for programmatically extracting data from ARIS, such as another app.
You can try out to get a valid token from your ARIS Server via /apidocs/swagger-ui/index.html?url=/umc/apidocs/swagger.json. Enter tenant name, user name and password. If successful, the HTML response code is 200.
1. Try out the ARIS UMC API function to request a token
2. Fill out your login data and execute the ARIS UMC API function
3. ARIS UMC API provided a valid token via HTML response code 200. With a valid token you can execute other API functions.
Well, you can share the document URL. Following the URL the user needs to authenticate to ARIS in the browser and then will get the document. The URL is also stable as long as you don't migrate to another server address.
That is not exactly "outside" ARIS. If you use Sharepoint as backend for ARIS document storage you might be able to access the documents through other Sharepoint mechanisms. But as long as ARIS hosts the documents it's the ARIS Server that will hand the document to you and possibly check your access privileges to the document.
That last parameter "revision" selects a specific revision of the document. If you set this parameter to -1, the link will always point to the latest revision of the document - regardless of any approval state.
