ARIS - SHARE YOUR IDEAS
How can we make ARIS better?
Add a new idea Subscribe
Status Open for voting
Workspace Modeling & Contribution
Created by Jörg Neves Bliesener
Created on Nov 30, 2023

RELATED IDEAS

Implement negative revision numbers beyond -1 for ADS links

The link to retrieve the document from ADS contains a positive or negative number that specifies the version to retrieve. Example:

https://my.ariscloud.com/documents/rest/v2/data/0/0/-/b9b58043-33ef-4b7f-a5e6-01afda4a8b2e?tenant=dach&revision=-1

The "&revision=xxx" part in the link allows to retrieve arbitrary document revisions. Additionally, revision number "-1" retrieves the LAST version of the document.

However, apart from "-1", no other negative revision number can be used. Support tells us that this is not implemented, which makes it complicated to retrieve prior versions of documents that change quickly and produce many versions (e.g. log files of regularly scheduled reports that are uploaded to ADS).

An intuitive approach would be to maintain the current feature that "&revision=-1" retrieves the latest version and that all other negative numbers accordingly retrieve the corresponding previous versions:

  • &revision=-1 retrieves the LAST version. This works as of SR24.

  • &revision=-2 retrieves the version before the last version ("second last version"). This currently does not work.

  • &revision=-3 retrieves the version before the second last version. This currently does not work.

To make it more clear, let's assume we have a document with 953 versions:

  • &revision=950 retrieves version 950 (this works as of SR24)

  • &revision=953 retrieves version 953, the last document version (this works as of SR24)

  • &revision=-1 also retrieves version 953, as this is the last document version (this works as of SR24)

  • &revision=-2 retrieves version 952 of the document. This currently is not implemented

  • &revision=-3 retrieves version 951 of the document. This currently is not implemented

  • ...and so on

When a new document version is added, this latest version will be numbered 954. Now the links would work as:

  • &revision=950 retrieves version 950 (this works as of SR24)

  • &revision=954 retrieves version 954, the last document version (this works as of SR24)

  • &revision=-1 also retrieves version 954, as this is the last document version (this works as of SR24)

  • &revision=-2 retrieves version 953 of the document. This currently is not implemented

  • &revision=-3 retrieves version 952 of the document. This currently is not implemented

  • ...and so on