Fields in Picturepark save metadata values or values of the List Item or Virtual Item content. A group of fields serves basically as a form for data entry. You know different types of fields from any form on the internet, where you must provide data like your name, email, or phone. Picturepark offers different Field Types, each suited to particular types of information. Picturepark fields are used in all schemas (Fieldsets and Relations, Lists, Layers, File Types, Virtual Types). The values are accessed in Channels via Filter, in Display Pattern, and Business Rules.

Create a field

Create a Field

Open or create the schema where you want to add a field e.g., a list, layer, virtual type, fieldset, and relation.

  1. Open schema settings by clicking the gear icon.

  2. Select fields in the sub-menu.

  3. Add a field.

Get the field path

Access the Field Path

The field path is the hierarchy of the field, which is the path where you can find the field. For the configuration of filters or display pattern, you need to access the value via field id or field path.  The field path always starts lowercase. 

layerId.fieldId
CODE
  • Example: the field path for a field added to a layer follows its hierarchy, mimicked in the UI, but displayed with names.

    • 1. layer 1.1 field = Product information>Products

    • 2. layer 2.1 field = Descriptive Keyword > Keywords

    • 4. layer 4.3 field = Multimedia information > Sources

  • You now need the ids for the Layer and field to build the correct path. The UI shows the names.  

    • In the menu "Layers," you find this information per Layer. You can open the Layer directly with the open icon

    • In F12 developer tools, you can access the JSON information, which lists layerId and fieldId too.  

  • Path Syntax

    • productInformation.products

    • descriptiveKeyword.keywords

    • multimediaInformation.sources

You can open the Display Pattern Editor to see the JSON of a Content Item. 


Get the field id

Access the Field ID

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: 

  • Example: You insert the field name "My NeW fielDs #1 Purpose?

  • Automatic Id: myNeWFielDs1Purpose

You can open the Display Pattern Editor to see the JSON of a Content Item. 


Update a field

Update a Field

Open the schema where you want to edit a field, e.g., a list, layer, virtual type, fieldset, and relation.

  1. Open the settings with the gear icon.

  2. Select fields in the sub-menu.

  3. Find your field.

  4. Select the edit icon next to it.

Video on how to update an existing field.

Some settings cannot be changed:

  • Field Type

  • The ID of the field

  • Specific field properties:

    • Allow only single or multiple items for fieldset, relationships and tagbox

    • Adding translations for text fields

    • From date to date time and vice versa

    • From number to decimal and vice versa

When updating search settings, check the main menu for search indices badges and open the settings to reindex if required.

When updating the required flag, some items may miss the new required values. The Content Platform shows a message to inform you about this. However, there is no actual check if content items are affected. Admins must search for the field to find affected content items and batch edit them to add the required values. (see the search for a field). The required check does not work for fieldsets and relations. There you must open the fieldset schema and check its usage in the overview panel – this does again not work for nested fieldsets (fieldset in fieldset in fieldset). Consider a batch edit or excel update to ensure data integrity.

Reuse a Field Name or Field ID

Reuse a Field Name or Field ID

Open the schema where you want to re-create a field with a different ID or field type, e.g., a list, layer, virtual type, fieldset, and relation.

  1. Open the settings with the gear icon.

  2. Select fields in the sub-menu.

  3. Find your field.

  4. Remove the field.

  5. Check the main menu for search indices badges and open the settings to reindex.

  6. Re-open the schema and add your field again.

    1. Now you can use the same ID and change the field type.

    2. You can just create the field as a new field.

When removing the field all values are removed. Please export all values via Excel Export and use this Excel to populate the new field with the correct values.

Update the order of a field

Update the Field Order

This order is used for input so the order your users see. Open the schema where you want to update the order of fields, e.g., a list, layer, virtual type, fieldset, and relation.

  1. Open the settings with the gear icon.

  2. Select fields in the sub-menu.

  3. Find your field.

  4. Select "Reorder" from the panel toolbar

  5. Drag & Drop the fields into the correct order

  6. Save

Video on how to re-order fields.

You cannot reorder fields on a child that are propagated from a parent. Those fields are always at the top. The save button will be greyed out. 

Delete a field

Delete a Field

Open the schema where you want to edit a field e.g. a list, layer, virtual type, fieldset, and relation.

  1. Open settings with the gear icon.

  2. Select fields in the sub-menu.

  3. Find your field.

  4. Mouse-over your field. 

  5. Select the remove icon next to it.

  6. Confirm your desire to remove the field. 

If you delete a field, you can only reuse the same ID when you update the status of Content and List Items from the Settings. Check the Main Menu for a badge that informs you about the necessity to perform an update. Removal of a field from a parent and adding the field to another parent works just fine without status updates.  

The field will not be removed from Filters or Display Pattern they are referenced in. You will need to do this manually. 

What could happen is: 

  • Display of "Invalid template" in display patterns, if you worked with liquid tags

  • Empty Filter in the Content Browser

You cannot remove a field that has XMP mappings

Field Types in Picturepark