This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
auto_slides [2022/01/24 13:44] yves |
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|}} | ||
+ | |||
+ | 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 ==== | ==== Auto-navigate ==== | ||
Line 16: | Line 23: | ||
=== To a particular slide === | === 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 === | === 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 ==== | ==== Automate the share dialog ==== | ||
Line 30: | Line 46: | ||
=== For a particular slide === | === 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 | When | ||
* PMA.studio runs at ''https://server/pma.studio'', and | * PMA.studio runs at ''https://server/pma.studio'', and | ||
* Your content resides on PMA.core ''https://server/pma.core'', 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'' | * Your slide is called ''slides/case/my-scan.svs'' | ||
- | Then your direct link to that slide becomes | + | You can create a sharing link to your slide via the call |
- | ''https://server/pma.studio/?serverUrl=https%3A%2F%2Fserver%2Fpma.core%2F&path=slides%2Fcase%2Fmy-scan.svs'' | + | ''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 === | === 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. |