Skip to content

MARC21 import (tool_import_marc21)

See also: Tools user guide · Developer reference

Load a MARC21 binary file (.mrc) exported from a library catalogue into a Dédalo section, mapping its fields and subfields to components.

This needs an administrator to configure the field map first

A cataloguer drops the file and runs the import, but the mapping from MARC fields to Dédalo components lives in the tool's configuration. Setting that map up is an administrator task — see Before you can use it below and the developer reference.

What it's for

MARC21 is the standard interchange format for library catalogues. If your institution already holds bibliographic records in an ILS (Koha, Sierra, Symphony, Aleph…), you can export them as MARC21 and load them into Dédalo instead of re-keying every record.

Concrete scenario: a museum library has thousands of monograph records in its ILS. It exports them to catalogo.mrc and opens the import tool on its Publications section. The tool reads each MARC record, uses a chosen control field (for example 907 $a) as the stable identifier to decide update-versus-create, then walks the configured field map — title from 245, ISBN from 020, imprint from 260/264, and so on — writing each value into the matching component.

When to use it

  • You have a one-shot or recurring bulk load of bibliographic data already available as MARC21.
  • The target section has a MARC field map configured for it.

When NOT to use it:

  • To load Dédalo's own dedalo_raw exports back, use CSV import.
  • For a Zotero bibliography (CSL JSON), use Zotero import.
  • For an arbitrary RDF/OWL graph, use RDF import.

Before you can use it

The import is driven by a field map the tool reads from its configuration, not by anything you set at import time. The map is a flat list of rules — each rule names a MARC field (and optional subfield) and the target component tipo. One rule names the field used as the record identifier.

The tool ships with a reference map for Publications. To change it, an administrator copies it into the Tools configuration of tool_import_marc21 and edits it there; that copy then replaces the shipped map. A rule with a key the import does not know, or a malformed rule, stops the import with a message naming the rule — fix it in the Tools configuration. The developer reference documents every rule key.

Where to find it

The tool attaches to sections and surfaces on Publications-style sections once your profile is authorised for it and the section carries the tool in its configuration. It opens in its own window.

Using it, step by step

  1. Export the MARC21 file from your ILS as a .mrc binary.
  2. Open the tool on the target section.
  3. Drop or select the .mrc file onto the drop zone.
  4. Fill the Values form if the configuration renders one — those values are written into every imported record, and replace a mapped value of the same field.
  5. Click IMPORT. The tool parses each record, applies the field map, and creates or updates records. Because the run can be long, the request is given an extended timeout — wait for it to finish.
  6. Read the result message, which reports created, updated and failed counts.

Tips and gotchas

Choose a stable identifier field

The rule that names the identifier field (for example 907 $a) is what lets a re-import update the same records instead of duplicating them. Point it at a control field your ILS keeps stable across exports.

Values that cannot be mapped are listed, not guessed

A year that is not in the field, or a language or material code the map does not know, is not written. The result lists it per record so you can correct the record or extend the map.

Verify a sample before a large load

Run a small file first and inspect the created records. A large ILS export is easier to correct while it is a handful of records than after thousands are written.