Export & Deep Links

In this section you can make settings for so-called deep links, IIIF and the OAI/PMH interface or upload XSLT files for exports.

Use system object ID (instead of UUID)

If enabled the URL of the detail view uses the system object ID instead of the UUID.

If enabled, deep links can be used to access records in the system. The deep link releases are technically solved via the API interface /api/objects.

Please note: you have to assign permissions to the system user "Deep Link" so the links are working. Users also need the system right "Deep Links" to access the links in the detail view.

Access by ID

Allows direct access by the object ID. Example: https://<your-fylr-url>/api/v1/objects/id/<id>.

Caution: Because these object IDs are continually assigned, it can be a security risk to enable this option. A user who is made aware of a deep link can guess further deep links. For all deep links, however, the system user "Deep Link" must have access to the records for them to work.

Access by Column

Allows access by specific values in object type columns (they have to be unique). Example: https://<your-fylr-url>/api/v1/objects/column/<object-type>/<name-of-unique-column>/<value>.

Embed Linked Records

Decide wether you want to embed linked records in the xml that can be accessed via a deep link or not. Linked records are for example persons, locations, keywords. If you want to include not only the standard text and the id of those linked records but all the data from these object types (like name and contact information of the photographer), you need to choose an option that's not "No records".

OPTIONDESCRIPTION

All

The data of the linked records of all object types will be included in the xml file that can be accessed via a deep link.

Records not included in the main search

Only data of the linked records of object types that are not shown in the main search will be included in the xml file that can be accessed via a deep link.

Records not included in the main search, unless reverse

Only data of the linked records of object types that are not shown in the main search, unless they are reverse records, will be included in the xml file that can be accessed via a deep link.

No records

The data of the linked records will never be embedded.

Depth of Linked Records (1-9)

Define how many levels of linked records should be embedded. Choose "1" if you for example want to embed all the fields from the object type "Photographer" that is linked to your images (like name, contact information, etc.). If the photographer record itself links to another object type (i.e. locations) and you want this data in the xml of the image record, choose a depth of "2".

IIIF REQUIRED STATEMENT

When IIIF is used, FYLR supports the Presentation API 3.0. The manifest is assembled automatically depending on the mask requested. See https://iiif.io/api/presentation/3.0/#requiredstatement for details. You should use the required statement for copyright information and general information about your database.

Label

The label of the required statement.

Value

The text for the required statement, this is formatted as Markdown with Table, Strikethrough, Linkify and TaskList enabled.

XSL Transformations

When exporting records as xml, a default FYLR structure is used. If you want to export data in a specific xml format, you can use XSLT. You can define multiple transformations that can be accessed in the xml export settings.

Please note: FYLR currently only support XSLT 1.0.

XSLT File

Upload a valid XSLT file.

Name

Technical name.

In the Deep-Link interface, this XSLT can be applied by using format/xslt/<xslt-name>.

In the OAI/PMH interface, this is used as a metadata format (metadataFormat=<name>).

Display Name

The display name will be shown in the export settings.

Description

Description of the format (optional).

Allow this XSLT to be used in the Deep Link interface.

Use for OAI/PMH

Allow this XSLT to be used in the OAI/PMH interface.

Please note: since the OAI/PMH standard requires XML, make sure that the XSLT produces valid XML. Otherwise an internal parsing error can occur in the OAI/PMH plugin.

Schema (only OAI/PMH)

XML Schema. Used for the namespace (xmlns) of the exported records.

Namespace (only OAI/PMH)

XML Namespace. Used as the namespace of the exported records.

OAI/PMH

The Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) is a protocol developed for harvesting metadata descriptions of records in an archive so that services can be built using metadata from many archives. An implementation of OAI-PMH must support representing metadata in Dublin Core, but may also support additional representations.

Enable OAI/PMH to let others harvest your data that's stored in FYLR.

More information about the standard can be found here: http://www.openarchives.org/.

Repository Name

Name of the OAI/PMH repository.

This information will be provided by the Identify verb as repositoryName

Namespace

Freely definable OAI Identifier Namespace.

Records can be requested using oai:<namespace>:<uuid> in the URL.

Maximum Number of Records for ListRecords

Limit the number of records per page for the verb ListRecords.

Embed Linked Records

As for the XML export, linked records are not loaded and embedded in the XML Document:

  • If the option "All" is selected, all linked records are loaded and embedded during the export.

  • If "Not included in main search" option is selected, all linked records that are not included in the main search are loaded.

  • If "None" is selected, no linked records are loaded, but only the standard is exported.

Depth of Linked Records (1-9)

When linked records are loaded and merged, this depth defines how many levels of linked records are loaded (1 - 9). See above.

TAG-SETS

Tag filters can be used to specify more sets for OAI/PMH. Each tag filter specifies a set. If a tag filter set is requested, all records are returned where the tag filter matches.

Tag filter sets have the prefix tagfilter:, for example <setSpec>tagfilter:sample_tagfilter</setSpec> for all records that match the tag filter sample_tagfilter.

To get a list of all available sets, use the verb listSets (see http://www.openarchives.org/OAI/openarchivesprotocol.html#ListSets).

Set Name

Technical name of the set.

Tag Filter

Definition of the tag filter.

Administrator Email

This information will be provided by the Identify verb as adminEmail.

Last updated