Digitalia ARTS MUNI Technical Documentation

Pictura documentation

Contact email: digitalia@phil.muni.cz

Updated: 30 Oct 2026

Prepared by Illyria Brejchová

Introduction

Basic information about the Pictura platform is available on the database website in the About section.

The user manual for adding and managing data in Pictura can be found here.

Technical Implementation

Pictura is realised using Islandora Open-Source Digital Asset Management and is part of the Digitalia MUNI ARTS infrastructure. It's basic technical documentation can be found in a separate document.

Individual records are stored as Drupal Nodes and grouped by type into Content Types. URIs of the individual objects: https://www.pictura.phil.muni.cz/en/node/[id] and taxonomy terms: https://pictura.phil.muni.cz/en/taxonomy/term/[id].

GitHub repository for configuration files

GitHub repository for platform-specific modifications to the Digitalia theme

Database Structure

An overview of the content of Pictura can be found in the Help section. The data structure of Pictura is based on the domain standard of VRA core 4.0 and the description of resources follows the Cataloging Cultural Objects guidelines.

Metadata

Pictura stores metadata in records that have fields. Each Field has a Drupal type. Some field types are complex and contain subfields.

Label Machine name Field type
Access rights field_access_rights List (text)
Art & Architecture Thesaurus field_aat Entity referenceReference type: Taxonomy termVocabulary: Art & Architecture Thesaurus
Component of field_component_of Entity referenceReference type: ContentContent type: Record
Contributors field_contributors Entity referenceReference type: Digitalia muni custom entityDigitalia muni custom entity type: Agent
Creators field_creators Entity referenceReference type: Digitalia muni custom entityDigitalia muni custom entity type: Agent
Creators and contributors note field_agents_note Double Field
Cultural context field_cultural_context Entity referenceReference type: Taxonomy termVocabulary: Art & Architecture Thesaurus
Dates field_dates Pictura Date
Dates note field_dates_note Double Field
Depicts work field_depicts Entity referenceReference type: ContentContent type: Record
Descriptions field_descriptions Description
Digitalia MUNI collection field_dm_collection List (text)
Embargo end date field_embargo_end_date Date
Handle field_handle Text (plain)
Holding institution field_holder Entity referenceReference type: Taxonomy termVocabulary: Agent
Iconclass field_iconclass Entity referenceReference type: Taxonomy termVocabulary: Iconclass
Inscription field_inscription Inscription
Inventory number field_inventory_number Text (plain)
Keywords field_keywords Entity referenceReference type: Taxonomy termVocabulary: Keywords
License field_license Entity referenceReference type: Taxonomy termVocabulary: Licenses
Location field_location Digitalia Geolocation
Materials field_materials Entity referenceReference type: Taxonomy termVocabulary: Art & Architecture Thesaurus
Materials and techniques note field_materials_techniques_note Double Field
Measurements field_measurement Entity reference revisionsReference type: Digitalia muni custom entityDigitalia muni custom entity type: Measurement
Part of collection field_member_of Entity referenceReference type: ContentContent type: Record
Record type field_model Entity referenceReference type: Taxonomy termVocabulary: Islandora Models
Relation field_relation Relation
Rights holder field_rights_holder Text (plain)
Rights note field_rights Text (formatted, long)
Rights status type field_rights_status_type List (text)
State edition field_state_edition State Edition
Storage field_storage Entity referenceReference type: Taxonomy termVocabulary: Storage
Style period field_style_period Entity referenceReference type: Taxonomy termVocabulary: Art & Architecture Thesaurus
Subgroup field_dm_subgroup Entity referenceReference type: GroupGroup type: Subcommunity
Techniques field_techniques Entity referenceReference type: Taxonomy termVocabulary: Art & Architecture Thesaurus
Titles field_titles Structured title
Top-level collection field_dm_group Entity referenceReference type: GroupGroup type: Community
Work type field_work_type Entity referenceReference type: Taxonomy termVocabulary: Art & Architecture Thesaurus

Taxonomy vocabularies

Taxonomy Note TID
Agent Pictura authority base for people and collective bodies agent
Art & Architecture Thesaurus https://www.getty.edu/research/tools/vocabularies/aat/ aat
Attribution specifies the relation between the record and agent e.g. school of, after, copy, workshop attribution
Iconclass https://iconclass.org/en/ iconclass
Islandora Media Use Original file, service file, etc. islandora_media_use
Islandora Models Record type - collection, work or image islandora_models
Licenses Creative Commons and a few custom licenses

Pictura specific complex fields subfields

The code defining the field types can be found here: https://github.com/ArtsFacultyMU/digitalia-module-digitalia_custom_field_types Two types, Agent and Measurement, are instead realised using a custom entity type called Digitalia MUNI Custom Entity.

Field type Subfield Field type Note
Structured title title string
title_type string list of allowed values
language string list of allowed values
id string title ID
id_type string
source string
source_id string
note string
Digitalia Geolocation type string list of allowed values
place string
url uri To GeoNames
country string
adm1 - adm5 string
lat string latitude
long string longitude
note string
Description description string
language string list of allowed values
source string
source_id string
note string
Inscription text string
language string
cs_translation string
en_translation string
position string
author string
author_vocab string
author_id string
source string
source_id string
note string
Relation name string
type string list of allowed values
link uri
source string
source_id string
note string
Pictura Date date string
language string
earliest_year integer
latest_year integer
date_type string list of allowed values
translations string
source_id string
source string
note string
State Edition name string
description string
type string list of allowed values
num integer
count integer
source string
source_id string
note string
Agent field_agent Taxonomy term Entity reference vocabulary: Agent
field_attribution Taxonomy term Entity reference vocabulary: Attribution
field_extent Taxonomy term Entity reference vocabulary: Art & Architecture Thesaurus
field_is_uncertain Boolean
field_role Taxonomy term Entity reference vocabulary: Art & Architecture Thesaurus
field_source Text (formatted, long)
field_source_id Text (plain)
Measurement field_format_size Taxonomy term Entity reference vocabulary: Art & Architecture Thesaurus
field_is_uncertain Boolean
field_measurement_extent Taxonomy term Entity reference vocabulary: Art & Architecture Thesaurus
field_measurement_qualifier Taxonomy term Entity reference vocabulary: Art & Architecture Thesaurus
field_measurement_type List (text)
field_measurement_unit List (text)
field_measurement_value Number (decimal)
field_remarks Text (plain, long)
field_scale_type Taxonomy term Entity reference vocabulary: Art & Architecture Thesaurus
field_shape Taxonomy term Entity reference vocabulary: Art & Architecture Thesaurus
field_source Text (formatted, long)
field_source_id Text (plain)

Exporting data

REST API

All nodes and terms can be accessed via REST export (GET). The data is labeled with machine names the semantics of which was described in the chapter on metadata. A number of formats are available - json, xml.

For nodes:

https://pictura.phil.muni.cz/node/export

Parameter Description Example
nid Node ID https://pictura.phil.muni.cz/en/node/export?_format=json&nid=6
format xml or json https://pictura.phil.muni.cz/node/export?_format=xml

For taxonomy terms:

Parameter Description Example
tid Term ID https://pictura.phil.muni.cz/en/taxonomy/term/export?_format=json&tid=1226
name String contained in the name of the term https://pictura.phil.muni.cz/en/taxonomy/term/export?_format=json&name=photograph
vid Terms from vocabulary with given ID https://pictura.phil.muni.cz/en/taxonomy/term/export?_format=json&vid=aat
page API results are paged every 50 results starting with 0. Increment page parameter to get next page. https://pictura.phil.muni.cz/en/taxonomy/term/export?_format=json&page=1
format xml or json https://pictura.phil.muni.cz/taxonomy/term/export?_format=xml

For Digitalia MUNI custom entities:

https://pictura.phil.muni.cz/entity/export

Parameter Description Example
id Entity ID https://pictura.phil.muni.cz/en/entity/export?_format=json&id=6
format xml or json https://pictura.phil.muni.cz/entity/export?_format=json

Dublin Core OAI-PMH

OAI-PMH is the main way in which data from Pictura is contributed to aggregating platforms, such as LINDAT/CLARIAH-CZ.

Endpoint: https://pictura.phil.muni.cz/oai/request

Example use: https://pictura.phil.muni.cz/oai/request?verb=ListRecords&metadataPrefix=oai_dc

The mapping is realized using the Metatag module and tokens, the available Drupal tokens have been expanded by the Digitalia Token module

Dublin Core Element Pictura record field
title [node:title]
creator [node:field_creators:entity:name]
contributor [node:field_contributors:entity:name]
subject [node:field_techniques]^[node:field_iconclass]^[node:field_aat]^[node:field_cultural_context]^[node:field_keywords]^[node:field_style_period]
description [node:field_descriptions:0:description]^[node:field_descriptions:1:description]
publisher Pictura, Digitalia MUNI ARTS, Faculty of Arts, Masaryk University
date [node:field_dates:0:date]
type [node:field_model:entity:name]^[node:field_work_type]
format [node:field_materials]^[digitalia_muni:media_mime_types]
language en^cs
identifier https://hdl.handle.net/11222/[node:field_handle]
relation [digitalia_muni:media_urls]^[node:field_depicts]^[node:field_component_of]^[node:field_member_of]^[node:field_relation:0:source_id]
rights [node:field_rights_status_type]^[node:field_license]
coverage [node:field_location:0:place]

VRA Core OAI-PMH

In preparation.

Indexing and searching

Basic information about browsing and searching options can be found in the Help section of the database website.

The index for full text search on the platform contains the pages of all content types.

Roles

Content editor - can create and edit data

Curator - manages the data across top-level collections

Administrator - manages the technical configuration of the system

The users and content on Pictura can be part of groups, these typically correspond to top-level collections (Communities) but can also be used for managing access to subsets of content (subcommunities).

Community Role Scope
Member A member of the community. Can read restricted content
Community Curator A user that can manage all content that
Community Contributor A user that can add new records to the community