This is an old revision of the document!
Sharing content is arguably one of the most important applications of digital pathology, if not for the Web in general.
Automation sharing functionality in your workflows can significantly increase your productivity.
Let's see how this works for PMA.vue and PMA.studio:
In some instances, you want to point people to PMA.studio, log in, and navigate directly to a particular slide or folder.
This use is mostly suited when everybody in your organization has access to PMA.studio, and you want people to use their own credentials.
In order for this to work, people must
When
https://server/pma.studio, and https://server/pma.core, andslides/case/my-scan.svsThen your direct link to that slide becomes
When
https://server/pma.studio, and https://server/pma.core, andslides/case/
Then your direct link to that slide becomes
https://server/pma.studio/?serverUrl=https%3A%2F%2Fserver%2Fpma.core%2F&path=slides%2Fcase%2
==== Automate the share dialog ====
The content here only describes the syntax to automate share link creation. For a discussion and comprehensive user story, see our blog article on the subject.
Note that when creating share links in this manner, users that receive the link will
* not have access to all PMA.studio features (only the specific slide(s) that you refer to)
* impersonate the account used to create the link with in the first place (probably your own)
* log access to the shared content under the impersonated credentials
=== For a particular slide ===
When all you may want to do is show a button in your own user interface that pops up a viewport to the content that you want to launch, you can create sharing links on via the PMA.studio back-end API.
When
* PMA.studio runs at https://server/pma.studio, and
* Your content resides on PMA.core https://server/pma.core, and
* You have credentials to the above PMA.core via usr / pwd, and
* Your slide is called slides/case/my-scan.svs
You can create a sharing link to your slide via the call
https://server/pma.studio/api/Share/CreateLinkForSlide?userName=usr&password=pwd&serverUrl=https%3A%2F%2Fserver%2Fpma.core%2F&pathOrUid=slides%2Fcase%2Fmy-scan.svs
The URL creates and returns the share link to be passed along other forms of communication.
We cover a lot more ground in our blog article, if interested in this topic.
=== For a particular folder ===
Sometimes it's more useful to share an entire folder instead of individual slides. The content from a folder can e.g. constitute a single patient case.
When
* PMA.studio runs at https://server/pma.studio, and
* Your content resides on PMA.core https://server/pma.core, and
* You have credentials to the above PMA.core via usr / pwd, and
* Your folder is called slides/my-case
You can create a sharing link to your folder via the call
https://server/pma.studio/api/Share/CreateLinkForFolder?userName=usr&password=pwd&serverUrl=https%3A%2F%2Fserver%2Fpma.core%2F&path=slides%2Fmy-case''As with creating links to individual slides, this URL creates and returns the share link to be passed along other forms of communication.
We cover a lot more ground in our blog article, if interested in this topic.