13. Sync OHMS Studio Records with Aviary Resources
An OHMS Studio record and an Aviary resource in the same organization can be linked as a synced pair. Once they are linked, the interview’s metadata, index, transcript, and media can be passed between the two in either direction. Archivists can catalog and index an interview in OHMS Studio, publish it as an Aviary resource, continue refining the transcript in the Aviary transcript editor, and send those corrections back to the OHMS record so the OHMS XML export and the OHMS Viewer stay current.
This page covers how to create a synced Aviary resource from an OHMS Studio record, how to update a synced pair in each direction, and what each sync changes.
13.1. How the sync works
Each OHMS Studio record can be linked to one Aviary resource, and each Aviary resource can be linked to one OHMS Studio record. The link is created the first time an OHMS Studio record is used to create an Aviary resource, and Aviary keeps a record of the link and the date of the last sync.
A synced pair always belongs to a single organization. Aviary creates or updates the resource in the organization that owns the OHMS Studio record, even when the person running the sync is a member of more than one organization.
There are two sync directions:
Each sync updates the existing linked record or resource in place. A sync never creates a second Aviary resource or a duplicate OHMS Studio record for the same interview.
13.2. Before you begin
13.3. Create an Aviary resource from an OHMS Studio record
[Verify: exact button and window labels against the current UI, and add screenshots for steps 3 to 7.]
What the first sync creates
What changes in the OHMS Studio record
After the media is imported, Aviary updates the OHMS Studio record so that it points to the new Aviary media file:
The OHMS Viewer then plays the interview from Aviary.
13.4. Identify a synced pair
In OHMS Studio, a synced record shows Resource record synced and the date of the last sync in place of the Create Aviary Resource & Upload Media button, along with two buttons:
In Aviary, a synced resource shows OHMS Studio record synced and the date of the last sync below the Resource Metadata section, along with two buttons:
13.5. Update an Aviary resource from OHMS Studio
Use this direction when the OHMS Studio record has changed, for example after revising the index or descriptive metadata in OHMS Studio.
The update brings the linked resource’s metadata, index, transcript, and media in line with the OHMS Studio record. It updates the existing resource rather than deleting and recreating it. If the media has not changed, Aviary does not download or import it again. If the media has changed, Aviary imports the new media once and does not leave a duplicate copy on the resource.
[Verify: whether Update Resource lets the user choose which parts to update (description, index, transcript, media), and whether it replaces or merges each part.]
13.6. Update an OHMS Studio record from Aviary
Use this direction when transcript work has continued in Aviary, for example correcting text, adjusting timecodes, adding speaker names, aligning the transcript with Gentle, or adding annotations. Without this update, the OHMS Studio record, its OHMS XML export, and the OHMS Viewer continue to show the earlier transcript.
The update writes the resource’s current data back into the linked OHMS Studio record and replaces the record’s transcript with the current Aviary transcript, including its text, timecodes, and speaker names. This works for VTT transcripts and Gentle-aligned transcripts. Standard transcript annotations and carry over to the OHMS Studio record, including NER entity types, geolocation, and Wikidata links.
After the update, preview the record in the Preview Viewer to confirm the transcript, and export the OHMS XML if the interview is published in an external OHMS Viewer.
If the resource is not linked to an OHMS Studio record, the Update OHMS button is not displayed. If any part of the update fails, Aviary displays an error and leaves the OHMS Studio record unchanged.
Choose one place to edit each transcript. Update OHMS replaces the OHMS Studio transcript with the Aviary transcript, and Update Resource sends the OHMS Studio transcript to Aviary. Edits made to the transcript in both places between syncs are not merged: the most recent update in either direction determines the transcript. Decide whether transcript editing happens in OHMS Studio or in Aviary, and sync after each round of edits. [Verify: overwrite behavior when the transcript was edited on both sides since the last sync.]
13.7. Link an existing OHMS Studio record to an existing Aviary resource
If an interview already exists as both an OHMS Studio record and an Aviary resource, for example after a migration, the two can be linked as a synced pair without creating a new resource. Linking does not change the content of either one; after the link is in place, use Update Resource or Update OHMS to send changes in the direction you choose. Contact Aviary support to link existing records and resources. [Verify: whether this remains a support request for all organizations.]
13.8. Troubleshooting
If a sync fails for another reason, contact Aviary support and include the OHMS Studio record ID and the Aviary resource ID.
