rename Private URL to Preview URL and other changes

[sekmiller]

What this PR does / why we need it: Updates the Private URL to Preview URL in Edit Dataset Popup and native api calls. The request was due to confusion over the use of Private URLs. Also hides Collection info when there is an Anonymous Preview

Which issue(s) this PR closes:

• Closes Reviewers using anonymous private URL might learn dataset author's identity from information about the Dataverse installation or collection #8184 Reviewers using anonymous private URL might learn dataset author's identity from information about the Dataverse installation or collection
  #8184

• Closes Some researchers unsure of difference between "Private URL" and "Anonymous Private URL" #8185 Some researches unsure of differences between "Private URL" and "Anonymous Private URL

• Closes Anonymous peer Review: Anonymize "breadcrumbs" and "collection" level information for this feature in HDV and install in Production #10950 Anonymous peer Review: Anonymize "breadcrumbs" and "collection" level information for this feature in HDV and install in Production

Special notes for your reviewer: the native api references to privateurl remain and have been marked as deprecated. The classes and service beans, etc. remain with the private url nomenclature.
With respect to 10950 I ran into some jsf weirdness for hiding the breadcrumbs. there may be a better way to handle it.

Suggestions on how to test this:
This is the doc I used to guide the update to the Edit Dataset Popup: https://user-images.githubusercontent.com/18374574/151025261-ed70e998-9341-4013-9e0f-3c1d4d2c83e4.jpg

I did make one change to the popup to show the resulting url on create. Julian signed off on showing the URL in the popup. He is also reviewing the UI/UX for acceptance testing.

Creation of the "general" preview url will always be available to those that have manage Dataset permission permissions via the "Preview URL" option under the Edit Dataset menu. "Anonymous Preview" is only available if the AnonymizedFieldTypeNames setting has been added to the installation. (Use curl -X PUT -d 'author, datasetContact, contributor, depositor, grantNumber, publication' http://localhost:8080/api/admin/settings/:AnonymizedFieldTypeNames to add the setting)

Verify that the newly created preview url works and indicates to the user that they are viewing an unpublished dataset. Also if the "Anonymous Preview" is used that the Anonymized metadata are displayed as "withheld". Also in the anonymous preview you should not be able to determine the Dataverse Collection that hosts the dataset. (That is, the "breadcrumbs" that indicate the Collections in the ownership tree should not be visible, nor should the header showing the immediate owner of the dataset.)

In the native api verify that previewUrl and privateUrl may be used interchangeably.(curl -H "X-Dataverse-key:35f79221-0fc4-433b-956c-cf20f7f13d87" -X POST "http://localhost:8080/api/datasets/:persistentId/privateUrl?anonymizedAccess=true&persistentId=doi:10.5072/FK2/GNJY26")

• if you have anonymizedAccess=true and AnonymizedFieldTypeNames are not set you should get an error.

Does this PR introduce a user interface change? If mockups are available, please link/include them here:
Yes. See doc above.

Is there a release notes update needed for this change?:
Included.

Additional documentation:
The app documentation has been updated for this change

[coveralls]

coverage: 22.301% (+0.4%) from 21.852%
when pulling 18db323 on 8184-preview-url-changes
into 42d00d1 on develop.

[jggautier]

Hey @sekmiller. I haven't seen what you've done but from your comments in this PR, shouldn't this PR close the GitHub issue Some researchers unsure of difference between "Private URL" and "Anonymous Private URL" #8185, instead of the GitHub issue it's set to close now, Reviewers using anonymous private URL might learn dataset author's identity from information about the Dataverse installation or collection #8184?

[sekmiller]

Hey @jggautier, the reason that I marked it with 8184 was because that is the one that was in the queue- and it has the references to changing the name to "Preview URL". 8185 has "no status", but I can add it to the "Closes" above.

[pdurbin]

I'm ready to approve this but API tests didn't run. I'm kicking of another attempt manually: https://jenkins.dataverse.org/job/IQSS-Dataverse-Develop-PR/job/PR-10961/22/

[pdurbin]

API tests are passing: https://jenkins.dataverse.org/job/IQSS-Dataverse-Develop-PR/job/PR-10961/22/testReport/

Approved.

I didn't run the code myself but it looks good.

[ofahimIQSS]

Hey @sekmiller: Found a typo: published ot if the URL

[ofahimIQSS]

@sekmiller Another observation I had during testing: "Disable General Preview URL" button isn't working as expected when I modify an existing unpublished dataset file.

I compared the 2 behaviors in Internal with the PR and Demo with previous code.

To test this, open up an existing dataset thats unpublished and go to Preview URL and click on disable general preview url button. Then from dataset page, go back to Preview URL screen. Here is where the issue lies: "Preview URL has not been created". should be displayed instead of showing a URL as it is doing now.

Also noticed that the green success disabling message wasn't displayed either:

Screen.Recording.2024-11-15.at.12.17.56.PM.mov

[ofahimIQSS]

@sekmiller Found a similar issue for Anonymous Preview. Create a new dataset and save it without publishing. Edit the dataset > Preview URL. Under Anonymous Preview, generate a URL then disable it. Disable button not working as expected.

Additionally, I noticed that the typo is still there. #10961 (comment)

Screen.Recording.2024-11-18.at.12.20.31.PM.mov

[sekmiller]

@ofahimIQSS I fixed the typo "ot". I also modified the refresh on the delete url popup so that it won't appear until the refresh completes. that should fix most of the timing issues we've seen with the delete processing

[github-actions]

📦 Pushed preview images as

ghcr.io/gdcc/dataverse:8184-preview-url-changes

ghcr.io/gdcc/configbaker:8184-preview-url-changes

🚢 See on GHCR. Use by referencing with full name as printed above, mind the registry name.

[github-actions]

📦 Pushed preview images as

ghcr.io/gdcc/dataverse:8184-preview-url-changes

ghcr.io/gdcc/configbaker:8184-preview-url-changes

🚢 See on GHCR. Use by referencing with full name as printed above, mind the registry name.