Subworkflow - Create Items in SCF IZ

At a glance

· Status: Active
· Environment / Tags: SCF Workflow
· Applies consortium-wide?: No, specific to Shared Collections Facility Institution Zone
· Runs on: SCF Production Alma IZ
· Trigger: Runs only when called by another workflow
· Primary outcome: Creates or locates an SCF IZ bib/holding, then creates an item in that holding.
· Who receives results: Returns a success or error result to the calling workflow.

Why this exists

This subworkflow supports shared print / SCF item creation by moving item data from a calling workflow into the SCF Alma institution zone. It helps ensure that an item can be represented in SCF with the correct bib, holding, location, provenance, and barcode pattern.

What it does

• Receives item, bib, institution, location, and linking data (Network Id) from another workflow.
• Preserves the incoming barcode for later error reporting
• Searches SCF Alma for a matching bib record.
  • If a matching bib exists, retrieves the first bib and checks its holdings.
  • If no matching bib exists and the record is NZ-linked, creates an SCF IZ bib from the NZ record.
  • If no matching bib exists and the record is not NZ-linked, creates a new SCF IZ bib using the provided bib record, adding a local 035 field for the owning institution and MMS ID.
• Checks whether a holding already exists in SCF for the target SCF location.
  • If no matching holding exists, creates a suppressed SCF holding.
• Builds a new item request body by clearing local-only fields, appending X to the barcode, setting provenance to the owning institution code, and setting library/location to SCF values.
• Creates the item in Alma and returns either successfully imported or an error message.

Where it runs

· Alma IZ(s): SCF Production Alma IZ
· Systems touched: Alma APIs
· Credentials referenced: SCF Production - Alma APIs - Read & Write
· Reports / queries used: None

How it works

Logic overview

1. Search for the bib in the SCF IZ
2. If a matching SCF bib is found: the workflow retrieves that bib, checks for an SCF holding at the requested location, creates a holding if needed, then creates the item.
3. If no matching SCF bib is found but the source is NZ-linked: the workflow creates an SCF IZ bib from the NZ MMS ID, then creates the holding and item.
4. If no matching SCF bib is found and the source is not NZ-linked: the workflow creates a new SCF IZ bib from the supplied bib record, adds a local 035 field, then creates the holding and item.
5. If an Alma create step fails: the workflow returns an error result with the barcode, error type, and error message.
6. If item creation succeeds: the workflow returns the barcode and successfully imported.

Artifacts produced: No files or reports. The output is structured JSON returned to the calling workflow.