RockefellerArchiveCenter / dimes

Front-end user interface for the online archival discovery at the Rockefeller Archive Center
MIT License
0 stars 1 forks source link

Printing #733

Open ctgraham opened 3 months ago

ctgraham commented 3 months ago

Is your feature request related to a problem? Please describe.

Archives staff report wanting to be able to facilitate patrons printing a finding aid.

Describe the solution you'd like

Provide a printing link which triggers request broker to pull a PDF of the resource via API.

Describe alternatives you've considered

The browser's built in print function could be enhanced, but would be a lot of extra work, and would not be as rich as the ASpace pdf function.

Additional context

tagging: @rzhang152

helrond commented 3 months ago

We should do some testing to check the performance of this ArchivesSpace endpoint, particularly for large resources.

In terms of integration, DIMES currently does not talk directly to ArchivesSpace (and it can't do that over JS without exposing credentials) so we'd have to go through the Request Broker. Based on my comment above, it may be wise to consider pre-generating PDFs and having them available at a URL somewhere.

ctgraham commented 3 months ago

Perhaps if we pre-generate the PDFs, this could be essentially another IIIF delivery?

helrond commented 3 months ago

I like that idea!

Side note - we will probably not use this because in many cases our collections are huge and are comprised of many AS resource records, so there's not an easy way for us to generate a PDF.

rzhang152 commented 3 months ago

With regard to the performance concern, might be possible to add logic option selection (max# of collections or specific types ...) for limitation when generating a pdf, especially from a large resource?

helrond commented 3 months ago

I don't believe ArchivesSpace knows how long a PDF will take to generate via that endpoint, so we'd have to figure out some way to measure it. My understanding is that it's not just based on the number of archival objects in the resource tree, but also the structure of the tree. More complex/deeply nested trees take longer to export.

For my money, the simplest and most performant option is to pre-generate PDFs and have them waiting to be downloaded.

rzhang152 commented 3 months ago

Agree. Pre-generating here is a better option thinking about the factor of the structure complexity.