The Relationship field that allows relating content to other content, similar to hyperlinks (links) on the internet and especially useful for creating press kits, print packages, landing pages by adding related visual content. For a press kit, you can link the hero image and the Logo.
You select Content Items based on the Query Filter of the Field. On assignment, you must provide information about the relationship between the assigned and the original content. The underlying relationship schema defined which relationship information you must provide.
Before creating a Relationship Field, you must create the schema used for providing information about the relationship. This schema shows up when assigning a Content Item in this field.
You can create a schema "Relationship" following a parent-child setup. When you connect your Relationship schema to the Relationship field the parent-child hierarchy is ignored. If you connect the Relationship field to a parent you will only see fields on the parent. If you connect the Relationship field to a child you will only see fields on the child, no propagated fields from the parent.
Related content items can be downloaded all together or placed all together into the basket, for further processing e.g. for editing or sharing. Additionally, each individual item can be downloaded directly or added to the basket.
Relationship Fields are not available in Batch Editor! You can not edit a single or multi relationship in the Batch Editor batch edit mode (only in single edit), nor Excel Roundtripping App. You can easily edit them via API.
Furthermore, Content Items or List Items cannot be sorted based on Relationship fields.
Picturepark does not use the Display Pattern on the Relationship Schema.
All relationship information in the view mode of a Content Item is hard-coded and not considering Display Patterns.
One item can be related. Examples are:
Multiple items can be related. Examples are:
Display & Handling
The relationship field items are displayed as a list, or thumbnails small or medium. The elements can be re-arranged if you have edit permissions on the Content Item and view permissions on the related Content Items.
Inside a relationship field, the Content Item permissions apply. For example, if you have a user that cannot view a Content Item in a relationship field he will get this view:
However, double-clicking on that field will allow him to view the relationship details - when the layer is visible and thanks to the "view for all" permission on the relationship schema.
On a Content item for a product, you might have a Relationship field for product photos. In your relationship schema for this field, you might have a single field for "View" that is, in turn, assigned to a List that provides the values Front, Top, and Side.
When a user relates a photo to the product Content Item, the field for "View" would appear, enabling the user to define the context of the related image. When the Content Item was published, this contextual information would be available.
Another valid approach is to use the Relationship field to relate creative files. Wether you are linking the zip package or individual files is up to you.
In addition, your relationship schema could include fields for Caption or any other context information about the related content.
Relationship Value Handling
Picturepark Setup Example
Layer: Corporate Information (ID: CorporateInformation)
Advanced search for field
Use in Display Pattern
Returned field value options
Returned field value
The field itself does not return values. You must access the individual values per option (e.g., data.corporateInformation.corporateLogo.mediaType)
Relationship Field Settings
The setting "name" is available for various things in Picturepark e.g. fields, schemas, business rules. This value defines what appears in the Picturepark interface. You can change the name at any time, and translate it into any configured metadata language. If you would like to add a translation for the name, just press Add.
The field id is the ID of your field, which is used to link to this field. The field id is always lowercase. The id of the field is set on the creation of a new field, using camel casing. You need the field id for the configuration of filters or display pattern.
The ID is automatically created from the name you insert:
You can open the Display Pattern Editor to see the JSON of a Content Item.
Single item relationship
Allowing one or multiple data entries into the Relationship Field. You cannot change this setting once saved.
The name of the relationship you create when assigning a Content Item.
Constructed from the name by removing spaces and special characters.
The type of items you can assign in the Relationship Field. Currently limited to Content Items only.
The underlying schema used to insert information about the relation e.g., a schema with two fields for legend title and description, which you must fill out when relating a hero shot.
Limit the Content Items available for selection by using a filter e.g., only show logos.
Only whole numbers (integers) are supported. By adding a minimum value, you set the field required.
Setting the maximum value to one turns a multi-item relationship to a single item relationship; however, we recommend to choose a single item relationship instead.
This allows ensuring that at least one item is always related e.g. for press kits the hero shot or the logo. The minimum value fulfills the same purpose, but we recommend using the correct required flag for the desired required option.
Select the default view for related items:
List view maximum rows
Select the maximum rows that should be displayed in the list view. The default is set to 4.
Thumbnail view maximum rows
Select the maximum rows that should be displayed in the thumbnail view. The default is set to 2.
Include in filters
Picturepark uses indexing settings from the relation schema.
Include in search
Keep in mind that Picturepark does not index metadata of the related content e.g., all the Product Information or an assigned Media Type. Only the relationship information given on the assignment of a Content Item is indexed.
The field setting "Boost" will boost the values in the search and helps you define the relevance of the content for your users. The boost parameter increases the relative weight of a term (with higher boost values) or decreases the relative weight (with lower boost values), but the increase or decrease is not linear. In other words, a boost of 2 does not result in double the score. You can select between 1, 10, 25, 50, 100, or 500.
Picturepark checks this setting against the allowed number of Search-indexed fields in your subscription plan. While it may be tempting to include all fields in filters and simple search also boosting them, you may revisit this idea based on your subscription plan limit.