Fully document import by CSV

[hannahfrost]

No description provided.

[mjgiarlo]

@hannahfrost @bbranan cc: @jcoyne (just FYI)

I've tested the CSV importer and here's what I found.

First, I created a simplified version of the CSV with a single image-related object (which actually maps to the GenericWork type rather than the Image type, which confused me). You can see that in #1395

Next, I copied a smallish PNG to tmp/hyku-objects, and then ran the command: ./bin/import_from_csv foo.localhost spec/fixtures/csv/simple.csv tmp/hyku-objects

I found that I needed to make a small number of code changes to get the script to run. AccountElevator expects there to be a global logger object, so I added that to the script, and there's also some undocumented dependency between imported objects and collections. So I added a way to ignore that dependency.

Here are some shortcomings that will/may need addressing before we consider this useful in a hosted service context:

• Files are never attached to the works that are imported
• CSV import should allow a depositor (email) to be specified on the command-line. By default, the depositor is set to a system user, so you can only see it if you are an administrator.
• CSV import could allow an AdminSet ID to be specified on the command-line. It defaults to the default AdminSet.
• CSV import should accept a column for visibility
• CSV import may need to handle workflow in some way if an item is deposited into an AdminSet that isn't using the self-deposit workflow
• It is possible to import data that does not match our vocabularies, e.g., resource type
• It is possible to import data that would not pass form validation. For instance, the current CSV format does not include a field for rights statements. (This doesn't cause errors, but does create data that looks odd, and may make it difficult to edit an imported object without needing to add values for these fields.)

[atz]

This blocks #1238, and the problem is not just the documentation, but the fact that nobody (even the authors of this code) can actually run it successfully. There is no Hyku feature here, currently. There is the idea and structure where a feature might go, but nothing usable.