Skip to content

Latest commit

 

History

History
48 lines (33 loc) · 2.93 KB

README.md

File metadata and controls

48 lines (33 loc) · 2.93 KB

Islandora Workbench

A command-line tool that allows creation, updating, and deletion of Islandora content from CSV data. Islandora Workbench is an alternative to using Drupal's built-in Migrate tools for ingesting Islandora content from CSV files. Unlike the Migrate tools, Islandora Workbench can be run anywhere - it does not need to run on the Islandora server. The Migrate tools, however, are much more flexible than Islandora Workbench, and can be extended using plugins in ways that Workbench cannot.

Note that this tool is not related in any way to the Drupal contrib module called Workbench.

Features

  • Allows creation of Islandora nodes and media, updating of nodes, and deletion of nodes and media from CSV files
  • Allows creation of paged/compound content
  • Can run from anywhere - it communicates with Drupal via HTTP interfaces
  • Provides robust data validation functionality
  • Supports a variety of Drupal entity field types (text, integer, term reference, typed relation, geolocation)
  • Can provide a CSV file template based on Drupal content type
  • Can use a Google Sheet or an Excel file instead of a local CSV file as input
  • Allows assignment of Drupal vocabulary terms using term IDs, term names, or term URIs
  • Allows creation of new taxonomy terms from CSV field data, including complex and hierarchical terms
  • Allows the assignment of URL aliases
  • Allows creation of URL redirects
  • Allows adding alt text to images
  • Supports transmission fixity auditing for media files
  • Cross platform (written in Python, tested on Linux, Mac, and Windows)
  • Well tested
  • Well documented
  • Provides both sensible default configuration values and rich configuration options for power users
  • Run from within a Docker container.

Documentation

Complete documentation is available.

Contributing to Workbench

Metadata, files, and Drupal configurations are, in the real world, extremly complex and varied. Testing Islandora Workbench in the wild is best way to help make it better for everyone. If you encouter a difficulty, an unexpected behavior, or Workbench crashes on you, reach out on the #islandoraworkbench Slack channel or open an issue in this Github repo.

If you have a suggestion for improving the documentation, please open an issue on this repository's queue and tag your issue "documentation".

If you want to contribute code (bug fixes, optimizations, new features, etc.), consult the developer's guide.

Using Workbench and reporting problems is the best way you can help make it better!

Current maintainer

Mark Jordan

License

License: MIT