Please see Summary of Listserv Discussions (Sep-Dec 2015)Suggested Questions
Status | Topic | Question | Answer or Link | Relevant sub group |
---|---|---|---|---|
Ready? | General | Where can I find and/or submit user-created scripts/plugins? |
...
Link to Plugins and Scripts? | Committers | |||
Ready? | General | Where can I find a list of institutions who are live with ArchivesSpace? | Christine's answer: "Institutions with links on the Members list webpage (http://archivesspace.org/members) have live implementations or implementation blogs that they have indicated they're ready to share with the wider public. You'll likely hear from others on this listserv that are far along in their implementations, but haven't yet shared a link, or are live with the ArchivesSpace staff interface, but do not use the public interface. (A number of institutions, particularly those who used Archvists' Toolkit, have separate finding aid delivery systems/mechanisms and export or plan to export finding aids produced in ArchivesSpace to these other systems.)" | |
Need assistance | General | How can ArchivesSpace be integrated with other applications? | Integration | |
Out of Scope | General | Where does ArchivesSpace fit into the archival workflow? |
...
| ||||
Out of Scope (?) | General | Can I edit the ArchivesSpace wiki? | Christine's message on requesting JIRA accounts: "Since it's come up a few times recently, I just wanted to mention that any staff member of an ArchivesSpace member institution is welcome to request a JIRA/wiki accounts by emailing me directly. Our JIRA and wiki instances are public, but the account will allow you to watch and comment on issues and make updates to some wiki pages. We do ask that certain activities, like voting on issues when we call for votes, happen through the institutional representative to maintain equity across our member institutions. If you have any questions, or any difficulties accessing an existing account, please just let me know." christine.dibella at lyrasis.org | |
Ready / TechDocs | System | What ports do different ArchivesSpace components run on? | See the Technical Documentation: http://archivesspace.github.io/archivesspace/user/getting-started/#Start-ArchivesSpace
| |
Ready / TechDocs | System | How do I backup ArchivesSpace? |
...
See the Technical Documentation: http://archivesspace.github.io/archivesspace/user/backup-and-recovery/ | ||||
Out of Scope (?) Not answerable? (Or address it by saying that it varies widely by institution, and maybe give a few examples) | System | How big does a production MySQL database tend to be? | Some ballparks from the listserv, but this is going to vary considerably based on the institution. | |
Ready / Candidate for labs/community repo? | System | What authentication methods can be used with ArchivesSpace? |
| Commiters, Candidate for Labs/Community Repo |
Ready (or needs vetting?) | System | How do |
...
I install ArchivesSpace on a Windows/MySQL server? | Good step by step instructions provided by user The technical documentation (http://archivesspace.github.io/archivesspace/user/running-archivesspace-as-a-windows-service/) plus the provided instructions are good resources. The listserv instructions go into a great deal of detail about installing prereqs (Java, MySQL) that are not in the tech docs and could be considered out of scope. | |
Out of Scope (User) | Functionality |
...
What defines a repository? | Inspired by this discussion (subjects and agents are shared across repositories, as well as user defined labels possibly) "As I understand it, Accessions, Resources and Digital Objects are repository-specific, while Subjects and Agents (and maybe the other modules like Locations, Events, Collection Management and Classifications) exist across repositories." (Ben Goldman's answer on the listserv.) | |||
Out of Scope (User) | Functionality | What is the difference between an archival object and an instance? | Based on discussion here of a user suggestion to change redundant requirements for designating container types that causes users to have to enter the same information in multiple areas. In archival object and archival instance, in this case. | |
Out of Scope (User) | Functionality | What is the role of the digital object module in an institution's archival workflow? | Good listserv answer - I think we should ask Maureen Callahan for her permission to use her outline of how they do it at Yale in the FAQ. | |
Out of Scope (User) | Functionality | What is the role of digital object components? | Brad's answer: "Digital object components are for modeling and structuring complex digital objects, that is, digital objects in which rendering of the intellectual content requires two or more digital files." | |
API | How do I use cURL to interact with the API? | The API section of the github docs has lots of good examples using curl | ||
API | How do I use the API to manipulate data for public display? | |||
API | How do I run an advanced search using the API? | Also see the API documentation for /search | ||
Out of scope (Too specific?) | API | How can I batch associate digital objects with archival objects? | Examples in thread |
...
Out of scope (User?) | Customization | How do I set default values for accession and resource records? | Good writeup by Brad | |
Out of scope (User?) | Customization | How do I set permissions per repository/group? | Discussion here | |
Need assistance, is there any official documentation for setting up subdomains? (If not, I can write up some instructions for doing this in Apache --Rachel) | Customization | How do I customize the ArchivesSpace |
...
public and staff interface URLs? | Default Setup By default, ArchivesSpace is set up to access the public application on port 8081 and the staff application on port 8080. E.g.,
Subdomains You can opt to run each application on separate subdomains. E.g.,
This document describes a simple approach for those wishing to deviate from the recommended practice of running each user-facing ArchivesSpace application on its own subdomain, and instead serve each application under a prefix. E.g.,
| |||
Out of Scope User Documentation? | Customization | How do I set a default repository? | Asked here, no answer (I feel like I used to see this question a lot) | |
Out of Scope User Documentation | Customization | Can I restrict the visibility of agent contact information based on staff permission level? (user oriented?) | Asked here, no answer | |
Ready | Customization | How do I set up Google Analytics to work with ArchivesSpace? |
...
| ||
Ready | Customization | Can I run ArchivesSpace using the default database? |
...
No, the embedded database is only suitable for demonstration purposes. When you are ready to starting using ArchivesSpace with real users and data, you should switch to using MySQL. MySQL offers significantly better performance when multiple people are using the system, and will ensure that your data is kept safe. |
...
For more information, see Running ArchivesSpace against MySQL. | ||||
Customization | How do I change the look and feel of ArchivesSpace (e.g., adding my institution's logo)? | Some examples in the github doc's Customizing and Theming section, including how to change the logo | ||
Seems more user, than tech | Customization | How do I add user defined fields? |
...
The user docs has a page on User Defined fields | ||||
Out of scope (not needed) | Customization | config.rb overview | There are comments in the file itself, which is included in the github tech docs | |
Customization | How can I change tooltips? | Brief answer | ||
Candidate for labs/community repo? | Importing/exporting | How do I customize exports? | The blog post references a GitHub repo that's example of to customize the EAD exporter. Would be nice if the how to add as a plugin info from the blog post was in the repo's readme. | Candidate for labs/community repo? |
Out of Scope | Importing/exporting | How do I import Word EAD files? | Tool developed by UVA (not public though) The application mentioned in the post is at https://github.com/uvalib/transmog Not sure how AS-specific it is, but certainly is a fellow traveler. | Integrations? Labs/community? (Pretty instituion-specific) |
User Documentation | Importing/exporting | How do I import CSV accession records? | Asked on listserv, no answer. Covered by user documentation: https://docs.archivesspace.org/Default.htm#ImportCSV.htm | |
Candidate for labs/community repo? | Importing/exporting | How do I batch create digital objects? | The user documentation covers importing Digital Objects via CSV and using RDE templates. The script referenced on the listserv provides an example of using the API to batch create digital objects and linking them as an instance of an existing archival object. | Candidate for labs/community repo? |
Out of Scope User Documentation | Importing/exporting | How do I convert MARC records to EAD for importing into ArchivesSpace? | AS (and the user documentation) already covers importing MARCXML, so I wonder if this is worth including? | Possible candidate for labs/comnunity repo if relevant |
Importing/exporting | Can I customize the PDF output? | Some pointers on a newer thread. Answer would basically be a pointer to the stylesheet used to generate the PDF. | Candidate for labs/community repo by creating an example modification? | |
Out of Scope | Importing/exporting | How do I map EAD to MODS? | Stylesheet provided on listserv Original question was about mapping EAD to MODs for ingesting AS data into Islandora. | Integrations? |
Out of Scope | Importing/exporting | Why do container IDs change on every export? | Couldn't find follow-ups to this, which suggests that this isn't a problem or a question asked frequently. Also wondering if 1.5 makes this less of an issue. | |
Out of Scope | Importing/exporting | How do I set EAD elements to always be published (unless they have an internal audience) when importing EAD files? | The listserv response, plus the same resources on the customizing export question contain examples (the Yale code says "exporter" there's a converter example there too: https://github.com/archivesspace/yale-ead-exporter/blob/master/backend/model/yale_ead_converter.rb) | Candidate for labs/community repo? |
Out of Scope | Importing/exporting | Can I include the public interface URL for a record in its exported EAD? | Potentially the same set of examples of ead converter plugins could provide a starting point, depending on whether or not the public UI URL is derivable from the resource data. | Public interface group? |
Importing/exporting | Why am I getting an "invalid byte sequence" error when importing a CSV file? | May be caused by importing a CSV that was created through MS Excel, use Google Sheets instead (listserv discussion) Seems more like a general why does Excel generate crappy CSV question. Not esp unique to AS. | ||
Out of Scope | Importing/exporting | How can I make the EAD XML output prettier? | Suggestions in listserv thread Seems more like a general how to format XML question. Not esp unique to AS. | |
Migration | Why do I have duplicate records after migrating? | Need to rebuild index | ||
User Documentation | Reports | How do I enable Jasper reports? | Specific instructions for enabling Jasper reports are in the User Docs: https://docs.archivesspace.org/Default.htm#ReportsEnabling.htm. Those a note about needing to enable fonts, which is important and not in the listserv answer. If there's not a problem doing so, these could be added to the tech docs at http://archivesspace.github.io/archivesspace/user/configuring-archivesspace/ by just adding a comment or two to the right spot in the config file. | |
User Documentation | Reports | How can I edit the SQL for a Jasper report? | The User Docs contain detailed instructions with points to external Jasper docs. We should see if this information needs to remain in the closed User Docs or if some of it could be repurposed for technical FAQs: http://docs.archivesspace.org/Default.htm#ReportsCustomizing.htm http://docs.archivesspace.org/Default.htm#ReportsAdding.htm Otherwise, maybe something as simple as: Jasper reports can be modified by modifying the files in /reports that correspond to a given report. For more on Jasper reports, see http://community.jaspersoft.com/documentation/tibco-jaspersoft-studio-user-guide/v60/concepts-jasperreports. | |
Either the developers or the whole TAC? | Upgrading | General question about where to find/discuss functionality changes after upgrade? | Based on long discussion here It seems that the release notes might need to be more substantial about functionality / general changes. | |
Upgrading | Can I skip versions when upgrading? | Yes, based on the FAQ section here: https://github.com/archivesspace/archivesspace/blob/master/UPGRADING_1.5.0.md it appears that existing ASpace instances can be upgraded and skip versions. However, new ASpace users who want to use the migration tool need to go to an earlier version first and then upgrade. | ||
Ready | Indexing | When should I reset the index? |
| |
Ready | Indexing | How do I reset the index? |
...
Delete the following directories and restart ArchivesSpace:
data/solr_index is the actual index, so if you delete that nothing will be searchable until the index is rebuilt. data/indexer_state is how the indexer keeps track of what it has and hasn’t indexed. Deleting that will effectively make the indexer believe nothing is indexed and force it to be rebuilt. | ||||
Ready | Indexing | Why is the Solr indexer constantly rebuilding the index/running in a loop? | Chris's answer (when a record has a circular parent/child relationship) | |
Need assistance | Bugs | Current top bugs? |
...
Bug Wranglers | |||
Paraphrased from 2015 listserv, check answer for accuracy | Bugs | How do I report a bug? | You can submit possible bugs by using the "Send Feedback" button at the bottom of your ArchivesSpace instance (or the one at sandbox.archivesspace.org). When you submit a ticket, please indicate:
|
...
Include screenshots or logs whenever possible. | Bug Wranglers | |||
Are we sure we want to include? It's the only error message we had and it doesn't seem to have been heavily discussed. | Error Messages | What does the "translation missing: en.enumerations" error mean? | Listserv question |