Field types
Object
Field type object. What is stored is a reference to another object: the literature record in which a
work is documented, the group a sheet belongs to, the original of a copy. The target remains a record of
its own with its own fields, often in another project, such as a literature project. Data entry from the
cataloguer’s side is described under Object .

Parameters
| Parameter (in the form) | Key | Values | If omitted | Effect |
|---|---|---|---|---|
| Target project | target_project_id | Project ID | the project in which the field is edited | The object is chosen from this project |
| Title field in the target project | label_field | Field name | none | Its value appears next to the target’s inventory number and is searched in the selection, for example the title |
| Citation style | citation_style, citation_locale | Style and language | the instance’s style | Style of this field’s short and full citation, see Formatting |
| Field points to a link | link_type | Identifier of an object link type | none | Assigns the field to a link type, see below |
JSON{ "target_project_id": 12, "label_field": "Titel", "link_type": "documented_in" }
The search covers the inventory number, the title field and the object ID. The object you are currently working on does not appear in the selection.
Because the configuration runs through the project hooks , the target project can be overridden per project, for example when an exhibition cites from a literature project of its own:
JSON{ "target_project_id": 12, "label_field": "Titel", "hooks": { "134": { "target_project_id": 15 } } }
Field points to a link
The field details maintain the link type in a section of its own, Field points to a link, not under Parameters. You choose one type for all projects; per project you can set a different one or leave it at Same as all projects. The types themselves are described under Link types .
| With a link type | Effect |
|---|---|
| Selection | First shows only objects of the object types the type allows. Show all object types lifts this |
| Setting the field | Creates the link of this type if it is missing |
| Clearing the field | Removes only the field value. The link stays |
| Deleting the link | Also clears the field |
A target of another object type or from another project is saved; saving then reports a warning. Without a link type, the field remains a plain reference, with no inverse on the target.
Subfields
Available everywhere as Feldname~unterfeld: in filters, in the Excel export and in Word templates:
| Subfield | Content |
|---|---|
~id | The object ID of the target |
~⟨Feld⟩ | Any field from the field catalogue of the target project, for example Literatur~Titel or Literatur~Jahr |
In the export the values are read in the target project. If a target is in another project, they come from its home project, otherwise from the readable project with the lowest ID. A filter on a subfield, on the other hand, searches only the target project: it does not match targets from other projects, even if the export shows their values.
Permissions
Title and inventory number only appear if you may read the target object, that is, if you have read
access to one of its projects. Otherwise the field shows only #⟨Objekt-ID⟩ (the object ID), and the
subfields stay empty in the export. A target you cannot read cannot be entered. See Permission model .
Formatting
The field type brings two formattings that cite:
| Formatting | Identifier | Result |
|---|---|---|
| Short citation | citation_short | The short citation in the citation style, for example (Meier 2001) |
| Full citation | citation_full | The complete entry as in the bibliography |
Neither is preselected anywhere, because the field type also serves for references without literature
(group of objects, part of). In templates they are called Literatur#citation_short and Literatur#citation_full. The Citation style on the field applies as long as the view or the export
does not choose one of its own; the order of precedence is described under Citation style . See also Formatting .
When another field type fits
| Need | Field type |
|---|---|
| A term from a vocabulary | Authority record |
| A person or institution with an address | Address |
| Several equal references without a fixed place in the form | The link alone, without a field |
| Several object references, each with details of its own next to it | A reference column in the JSON field |