omeka-s

Omeka S REST API integration and spreadsheet mapping community node for n8n

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.6
Author: IFP India Automation Team

Documentation

n8n-nodes-omeka-s

An n8n community node for integrating with the Omeka S REST API — map spreadsheet columns to Omeka S Resource Template properties, generate structured Excel review sheets, and ingest or update items in bulk.

Installation

Via n8n UI (Community Nodes)

  1. Open n8n and go to Settings → Community Nodes.
  2. Click Install.
  3. Enter n8n-nodes-omeka-s.
  4. Acknowledge the community node notice and click Install.

Via CLI (Self-Hosted / Docker)

mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm install n8n-nodes-omeka-s

Restart n8n after installation so the node is loaded.

Credentials

Configure the Omeka S API credential with:

  • API Root URL: Base URL of your Omeka S REST API (for example, https://your-site.org/api or http://localhost/omeka-s/api).
  • Key Identity: Your Omeka S API key identity (Admin → Users → API Keys).
  • Key Credential: Your Omeka S API key credential secret.
  • Allow Unauthorized SSL Certificates: Enable only for local or self-signed HTTPS development servers.

Supported Operations

Resource: Resource Template

  • Map Spreadsheet Headers to Properties (for Review Table)
    • Fetches the selected Omeka S Resource Template schema dynamically.
    • Accepts Manual Property Mappings (Omeka S Property + Value Expression / Column), matching spreadsheet column headers with case- and whitespace-insensitive fallback.
    • Generates an Omeka_S_Review.xlsx workbook (Review Sheet tab) containing:
      • Status (dropdown validation for Request for review, Review, Updated, Publish with conditional row coloring), Comments, and Remark.
      • Mapped property columns formatted as Label [prefix:term] (for example, Title of the Inscription [dcterms:title]).
      • Locked header row with sheet protection (password: omekas) while keeping data cells editable.

Resource: Ingest to Omeka-S

  • Create Item from Mapped Spreadsheet Table (Ingestion)

    • Optionally skips rows whose Status is not Publish / Published / Approved (Only Import Publish Status Rows).
    • Maps Label [prefix:term] columns back to Omeka S JSON-LD property payloads using the selected Resource Template (including customvocab data types where configured).
    • Supports optional Class (o:resource_class) and Item Set (o:item_set) assignment.
    • Supports Smart Upsert: updates an existing item when Omeka_Item_ID is present, or when Enable Unique Identifier Property matches an existing item in Omeka S.
    • Optionally attaches tracking fields (Omeka_Item_ID, Approval_Status, _payloadSent, _omekaResponse) to output items.
  • Delete Item(s)

    • Deletes Omeka S items by Item ID (supports expression mapping such as ={{ $json.Omeka_Item_ID }}).

Development

npm install
npm run clean
npm run build

License

MIT

Discussion