To demo server, add external tool for Open OnDemand

[pdurbin]

We want to add a dataset-level tool that says "Explore in OpenOnDemand" to https://demo.dataverse.org

The manifest will be a variation of the one at https://iqss.github.io/ondemand-loop/development_guide/dataverse_integration/#registering-the-external-tool . I'm putting a version below that I think we'll use, but I'll confirm with @abujeda.

Here's a direct link to the interstitial page that users will see (from the toolUrl): https://hmdc.github.io/fasrc-ondemand-loop/dv_external_tools/demo_landing.html

The reason we have an interstitial page is that installation of Open OnDemand we're integrating with is only for Harvard affiliates. And they have to have a FASRC account be be connected to the FASRC VPN. See also the following issue.

• Features - Dataverse External Tool Proxy page for demo.dataverse.org should be different from the one for Harvard Dataverse. ondemand-loop#334

curl --location 'http://localhost:8080/api/admin/externalTools' \
--header 'Content-Type: application/json' \
--data '{
  "displayName": "Explore in Open OnDemand",
  "description": "Download dataset files into Open OnDemand and publish back to Dataverse",
  "toolName": "ondemand_loop_dataset_tool",
  "scope": "dataset",
  "types": ["explore"],
  "toolUrl": "https://hmdc.github.io/fasrc-ondemand-loop/dv_external_tools/demo_landing.html",
  "httpMethod": "GET",
  "toolParameters": {
    "queryParameters": [
      {"dataverse_url": "{siteUrl}"},
      {"dataset_id": "{datasetPid}"},
      {"version": "{datasetVersion}"},
      {"locale": "{localeCode}"},
      {"env_cannon_prod": "{localeCode}"}
    ]
  }
}'

[abujeda]

We are tracking the deployment as well in our repo.
Added here only for reference: IQSS/ondemand-loop#335

[abujeda]

The queryParameters is missing one value:
{"env_cannon_prod": "{localeCode}"},

This is a trick required to know what environment Dataverse wants to connect to.
We need this trick to avoid having different proxy pages to link to different environments.

[abujeda]

Thanks for deploying @pdurbin
I am closing our issue to track the deployment in Demo
IQSS/ondemand-loop#335

[pdurbin]

Sure! Please see also the announcement here: https://groups.google.com/g/dataverse-community/c/_vX899PJDY4/m/rSITNjNcAwAJ

I'll move this to "merged", I guess, so I can ask the Dataverse team if they want a PR for the manifest above. (We discuss "merged" at standup.)

[abujeda]

The post is great!! 🚀