Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
56 commits
Select commit Hold shift + click to select a range
2ddcc36
refactor container instance
bobbi-SMR Mar 8, 2019
d854445
refactor out digital_object_handler
bobbi-SMR Mar 11, 2019
6c71fb8
refactor subject and agent handlers
bobbi-SMR Mar 11, 2019
197a9d3
refactoring comments in linked_objects
bobbi-SMR Mar 12, 2019
3b1468e
Merge pull request #1 from tufts-digital-collections-archives/refacto…
bobbi-SMR Mar 12, 2019
abd6e24
individual publish flags
Mar 13, 2019
5f979b1
Add notes publish flag documentation
Mar 14, 2019
10a8b0c
agent roles added
Mar 19, 2019
b07fe13
Merge pull request #2 from tufts-digital-collections-archives/publish…
bobbi-SMR Mar 19, 2019
d4983f7
remove some debugging
Mar 25, 2019
988caac
add to list of new functionality
Mar 25, 2019
094b995
remove creator restriction from documentation
Mar 25, 2019
070b9f7
changed typos in spreadsheet; clarified agent documentation
Apr 5, 2019
e9f7d1e
Merge pull request #3 from tufts-digital-collections-archives/agent_r…
bobbi-SMR Apr 5, 2019
668e27e
add more agents to template, document
Apr 10, 2019
f4a3549
refactor to include unbounded numbers of agents
Apr 10, 2019
3135134
Add to feature list + links
Apr 10, 2019
a3962a9
fix numeric typo
Apr 22, 2019
eeb083d
Add more clarity to agent directions
Apr 23, 2019
2e31b79
More clarifications
Apr 23, 2019
375a475
Merge pull request #4 from tufts-digital-collections-archives/multipl…
bobbi-SMR Apr 23, 2019
2605b59
added another date block plus suppport for more
Apr 25, 2019
c36adb4
document multiple dates
Apr 29, 2019
180e19b
fix typo
Apr 29, 2019
25eb643
attempt to use handler's constant
May 10, 2019
bdc3c98
recover from committing wrong handler
May 10, 2019
b823901
Update documentation to reflect exact matching
May 10, 2019
f75da00
fix date type error message
May 20, 2019
c8f0455
add better error handling for bad date types, including documentation
May 21, 2019
61e807e
correct typo in documentation
May 21, 2019
b91ea19
Better handling of date-related controlled list values
May 22, 2019
ef814e7
expand date error information
Jun 13, 2019
2a4e213
stress necessity of changing labels when adding columns
Jun 13, 2019
d1f4203
reinstate Creation as default Date Label
Jun 19, 2019
2dae2d5
up the version number
Jun 19, 2019
0311be0
up the version number
Jun 19, 2019
07260b1
explicate end date for single date type
Jun 19, 2019
fdd14a5
Merge pull request #5 from tufts-digital-collections-archives/exact_m…
bobbi-SMR Jun 19, 2019
915e203
check for key dups, single dates with end date
Jun 21, 2019
c7486f4
added second extension and container blocks
Jun 21, 2019
98daa1b
add update wrt needing a modified initializer
Jun 21, 2019
2faf750
added second extent block
Jun 21, 2019
94b1ae1
undo mistaken block
Jun 21, 2019
ad3752c
support multiple extensions
Jun 24, 2019
0450d32
rearrange extension and container columns
Jun 25, 2019
ace46d5
support multiple container instances
Jun 25, 2019
0d7a91e
update documentation for the extents and container instances
Jun 25, 2019
010ac38
remove 'agents-as-subject' from list of don't dos
Jul 22, 2019
71ed44f
update versioning
Jul 22, 2019
ae54d71
Add contributors, tighten up language wrt to versions
Jul 25, 2019
fd83c73
Merge branch 'master' into extensions
bobbi-SMR Jul 25, 2019
455bc5b
Merge pull request #6 from tufts-digital-collections-archives/extensions
bobbi-SMR Jul 25, 2019
edbcb49
correct link to releases
Jul 25, 2019
6783c19
restore version links to full URL
Jul 25, 2019
e42a6a6
fix documentation errors
Oct 7, 2019
119edbe
Support xlink namespace in Notes
Oct 25, 2019
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 32 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,29 +5,35 @@ Also supports the inport of spreadsheets that will allow for the creation of Dig

## Current Version

For versions of ArchivesSpace **before** v2.2.2: [v1.7.8](https://github.com/harvard-library/aspace-import-excel/releases/tag/v1.7.8)
For versions of ArchivesSpace **before** v2.2.2: [v1.7.8](https://github.com/tufts-digital-collections-archives/aspace-import-excel/releases/tag/v1.7.8)

NOTE: This version does *not* support the creation of Digital Objects to be associated with already-created Archival Objects.
**NOTE**: v1.7.8 does *not* support the creation of Digital Objects to be associated with already-created Archival Objects.

For ArchivesSpace **v2.2.2 and higher**: [v2.1.19](https://github.com/harvard-library/aspace-import-excel/releases/tag/v2.1.19)
For ArchivesSpace **v2.2.2 and higher**: [v3.0.2](https://github.com/tufts-digital-collections-archives/aspace-import-excel/releases/tag/v3.0.2)


## Development

The initial version supports interactive selection of an archival object (or resource) as the starting point of the bulk upload.
This plugin supports interactive selection of an archival object (or resource) as the starting point of the bulk upload.

Version 3.0 incorporates new functionality for uploading archival objects (described in the [user documentation](user_documentation/archival_objects_instructions.md)), which supports the use of an [expansion](templates/extended_aspace_import_excel_template.xlsx) to the [original](templates/aspace_import_excel_template.xlsx) Excel template. Version 3.0 is, however, backward compatible, so that users whose workflow is satisfied with the original template can continue to use it.

### Bulk upload/creation of Archival Objects

The Excel template will be found in the templates/ folder as [**aspace_import_excel_template.xlsx**](/templates/aspace_import_excel_template.xlsx).
The Excel templates will be found in the templates/ folder as
* *New in V3.0*: [**extended_aspace_import_excel_template**](templates/extended_aspace_import_excel_template.xlsx)

* [**aspace_import_excel_template.xlsx**](templates/aspace_import_excel_template.xlsx).

The intention is not to completely reproduce a Finding Aid as presented in an EAD XML, or to allow for every permutation of Archival Object creation within ArchivesSpace. We are aiming for the "80% rule"; that is, at least 80% of the work that would be done interactively can be replaced by an excel spreadsheet; additional refinements to individual archival objects (such as addition of agents-as-subjects, assignment of locations to top-level containers, etc.) would take place interactively.
The intention is not to completely reproduce a Finding Aid as presented in an EAD XML, or to allow for every permutation of Archival Object creation within ArchivesSpace. We are aiming for the "80% rule"; that is, at least 80% of the work that would be done interactively can be replaced by an excel spreadsheet; additional refinements to individual archival objects (such as assignment of locations to top-level containers) would take place interactively.

See the [user documentation](user_documentation/USER_DOCUMENTATION.md) for more information.

### Bulk upload/creation of Digital Objects associated with already-created Archival Objects

**This functionality is turned on by default** See the <a href="#installation">Installation</a> instructions for turning it off.

The Excel template will be found in the templates/ folder as [**aspace_import_excel_DO_template.xlsx**](/templates/aspace_import_excel_DO_template.xlsx).
The Excel template will be found in the templates/ folder as [**aspace_import_excel_DO_template.xlsx**](templates/aspace_import_excel_DO_template.xlsx).

As with the original development, we are not completely reproducing all the functionality of ArchivesSpace: only one Digital Object, which can have either or both of one:
+ File with an *Xlink Actuate Attribute* of **onLoad** and an *Xlink Show Attribute* of **embed**
Expand All @@ -54,9 +60,11 @@ to
```bash
AppConfig[:hide_do_load] = true
```
3. **IF** you are running ArchivesSpace on Windows:
3. **IF** you are running, on Windows, a version of ArchivesSpace that is *lower* than version **2.6.0**:

There currently is a problem with Bundler versioning. Until a new version of ArchivesSpace is released that contains a fix to the *initialize-plugin.bat* script, copy
There was a problem with Bundler versioning.

Copy
```
archivesspace\aspace-import-excel\extras\modified_initialize-plugin.bat
```
Expand All @@ -65,15 +73,23 @@ to
archivesspace\scripts
```

**UPDATE**: You no longer need to use this modified .bat script **if** you are running ArchivesSpace 2.6.0 or higher.


4. Run the initializer script:
* for Linux, that's
```bash
scripts/initialize-plugin.sh aspace-import-excel
```
* for Windows, that's
* for Windows, running an ArchivesSpace version **lower than 2.6.0** ,that's
```
scripts\modified_initialize-plugin.bat aspace-import-excel
```
Otherwise, for Windows running ArchivesSpace version **2.6.0** and higher:
```
scripts\initialize-plugin.bat aspace-import-excel
```


5. In the **common/config/config.rb** file, add 'aspace-import-excel' to the `AppConfig[:plugins]` array.
6. Stop and restart ArchivesSpace
Expand All @@ -96,8 +112,10 @@ User documentation is [available](user_documentation/USER_DOCUMENTATION.md)

## Contributors

* Bobbi Fox: https://github.com/bobbi-SMR (maintainer)
* Robin Wendler: https://github.com/rwendler
* Julie Wetherill: https://github.com/juliewetherill
* h/t to Chintan Desai: https://github.com/cdesai-qi for catching inconsistencies
* Bobbi Fox: [@bobbi-SMR](https://github.com/bobbi-SMR) (maintainer)
* Robin Wendler: [@rwendler](https://github.com/rwendler)
* Julie Wetherill: [@juliewetherill](https://github.com/juliewetherill)
* Adrienne Pruitt: [@adriennepruitt2](https://github.com/adriennepruitt2)
* Dave Mayo: [@pobocks](https://github.com/pobocks)
* h/t to Chintan Desai: [@cdesai-qi](https://github.com/cdesai-qi) for catching inconsistencies

2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
v2.1.17
v3.0.2
Loading