===== Linking and sharing (automation) =====

{{:stud2_sharing.png?nolink&400|}}

Sharing content is arguably [[https://realdata.pathomation.com/sharing-facilities-in-pma-studio/|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:

==== Auto-navigate ====

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
  * Have access to PMA.studio
  * Have access to the PMA.core tile server on the slide/folder resides
  * Have access to the slide/folder that you're referring them to


=== To a particular slide ===

When 
  * PMA.studio runs at ''https://server/pma.studio'', and 
  * Your content resides on PMA.core ''https://server/pma.core'', and
  * Your slide is called ''slides/case/my-scan.svs''

Then your direct link to that slide becomes

''https://server/pma.studio/?serverUrl=https%3A%2F%2Fserver%2Fpma.core%2F&path=slides%2Fcase%2Fmy-scan.svs''

=== To a particular folder ===

You can't do this yet. But don't despair; this is on our feature list for a future version of PMA.studio

==== Automate the share dialog ====

The content here only describes the syntax to automate share link creation. For a discussion and comprehensive user story, see [[https://realdata.pathomation.com/sharing-facilities-in-pma-studio/|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 [[https://realdata.pathomation.com/sharing-facilities-in-pma-studio/|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.

{{ ::stud2_sharing_folder.png?direct&400 |}}

We cover a lot more ground in [[https://realdata.pathomation.com/sharing-facilities-in-pma-studio/|our blog article]], if interested in this topic.