Document how to replace a media

[mjordan]

In Islandora 7.x we have the ability to replace a datastream:

In Islandora 8, you must "Remove" the file and replace it with another:

This should be documented at https://islandora-claw.github.io/CLAW/user-documentation/datastreams/.

Related issue: #1035.

[dannylamb]

You should link out to https://islandora-claw.github.io/CLAW/technical-documentation/rest-create/#files-and-media as well to point out that there's ways to do this headlessly.

[mjordan]

PR merged.

[rosiel]

I don't know if this is in scope. But does this process still leave the original file and its metadata floating around in Fedora? @dannylamb

[mjordan]

Reopening this, since the text added by the above PR does not appear in https://islandora.github.io/documentation/user-documentation/media/ (maybe it was removed subsequently?), so that documentation still does not explain how to replace a media or file.

@rosiel to answer your question ^^, if I replace the file as described in the PR at https://github.com/Islandora/documentation/pull/1221/files, the file and its metadata remain in Fedora.

Also, if I delete the media at http://localhost:8000/media/X/delete, the binary and its metadata persist in Fedora. I've just verified this by adding a media, visiting it Fedora, then deleting the media, and revisiting it and its metadata in Fedora. Still there.

The only way I've found of verifiably deleting a file and its metadata is to run the "Delete media and file(s) action" in the general media list (http://localhost:8000/admin/content/media). Revisiting the file and its metadata in Fedora returns 404s.

This is all very confusing. I'd love to see a way to:

1. replace a file, along with the option to completely purge the one you think you're deleting or to create a new version of the file and accompanying metadata (i.e., keep the old file too by not make it the current revision)
2. delete (i.e. completely nuke from "Islandora") a file and its accompanying media and metadata

I wonder how we can wire up the code in the "Delete media and file(s) action" so that the user doesn't have to go to http://localhost:8000/admin/content/media to actually delete a file and its media but instead can do it closer to the node the file is associated with.

[mjordan]

Thinking about some UI options for this. These options are not "closer to the node the file is associated with" but they are closer to the existing UI for managing the specific media.

if I replace the file as described in the PR at https://github.com/Islandora/documentation/pull/1221/files, the file and its metadata remain in Fedora.

We could allow the user to choose whether the file and its metadata remain in Fedora (current behavior) or do not (expected behavior):

if I delete the media at http://localhost:8000/media/X/delete, the binary and its metadata persist in Fedora.

We could allow the user to choose whether the media remains in Fedora (current behavior) or does not (expected behavior):

Also, these options should only be present if Fedora is being used.

[rosiel]

Thank you for validating that, @mjordan ! Would it be appropriate to document the current actual behaviour in the documentation? I would like to make a PR.

[mjordan]

Sounds good to me, until we can come to a landing on how to implement the desired behavior. @manez any thoughts on the docs?

[mjordan]

@rosiel 's improvements to the doc have been merged, but should I close this issue and open a new one for the UI mods described above?

[rosiel]

Sounds good, as this is a "document" ticket.

I like your suggestions, by the way.

[mjordan]

Thanks! Will close this one and open a new one.