Differences

This shows you the differences between two versions of the page.

--- auto_slides [2022/01/24 13:35]
yves created
+++ auto_slides [2022/11/21 12:20] (current)
yves
@@ Line 1: / Line 1: @@
-===== Links and sharing =====
+===== Linking and sharing (automation) =====
+{{:stud2_sharing.png?nolink&400|}}
-==== Open PMA.studio and auto-navigate ====
+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.
-=== To a particular slide
+Let's see how this works for PMA.vue and PMA.studio:
-=== To a particular folder
+==== 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 ====
@@ Line 13: / Line 40: @@
 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]].
-=== For a particular slide
+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 |}}
-=== For a particular folder
+We cover a lot more ground in [[https://realdata.pathomation.com/sharing-facilities-in-pma-studio/|our blog article]], if interested in this topic.

PMA.studio

User Tools

Site Tools

Differences

Page Tools