Book Documentation Cap Tutorials

Settings

The structure and appearance of each container/view can be managed in the 'Settings' section.

Fields

The fields currently used in a container/view are presented in the 'Settings' section in the same form-style as in the 'New item' and 'Edit item' sections. This makes it easy to identify and alter fields.

You can drag and drop current fields to change the order, click the 'cog' icon to change settings, or click the 'cross' icon to remove them. Some fields, like the 'id' field and necessary system fields, cannot be removed.

Possible settings for each field differ, based on field type and whether you are managing a container or view. Views only offer the option to hide a field.

Common attributes are:

  • Title: field title shown throughout your 1202 system.
  • Requirement: determines if a field has to have a value and/or this value should be unique. Defaults to 'none'.
  • Hide: check to hide this field from overviews and the 'New item' and 'Edit item' sections. Saved values for this field remain untouched. You can delete all values by deleting the field. Defaults to off/unchecked.

Additionally, attributes for field types 'Text field' and 'Select menu expandable' are:

  • Length: length of the text input field shown (characters). Defaults to '30'.
  • Max. length: maximum length of the text input field (characters). Defaults to '100'.

Attributes for the field type 'Text box' are:

  • Lines: number of lines shown for the text box input. Defaults to '10'.
  • Line length: length of each line of the text box input before moving to the next line (characters). Defaults to '80'.
  • Type: whether the text box features extra controls for formatting text in either a visual ('Editor') or textual ('Markdown') way or not ('Plain'). Defaults to 'Plain'.

Attributes for the field type 'Time field' are:

  • Link field: select another time field (from the current fields) that is related to this field. Useful when working with beginning and end times. Defaults to 'none'.
  • Type: select if this time is a beginning or end time. The field selected as 'Link field' should have the opposite value. Defaults to 'none'.

For field types 'Select menu' and 'Radio buttons' you can set:

  • Options: create a list of options a user can select from when creating/editing an item. Add options by clicking/tapping the 'plus' icon, remove them by clicking/tapping the 'cross' icon. When you change an option that is currently set as a value for one or more items, the current values will not be changed. This option list will only limit the options available when creating/editing items. To change a current option, change the option in this list, and then adjust the items using the 'old' value by doing a search and multiple edit.

Lastly, for the field type 'Model block' you can set:

  • Code: text/code that will be parsed like a block element from a model. This makes it possible to create values derived from other values (or values from linked items) by using 1202 script.

For more about field types: view the 'Fields' documentation.

Below the current fields are two panes: one for adding a new field and one that contains removed fields.

New field

When you add a new field to a container, it effectively creates an extra column in the database to store data in. The field type determines the kind of data.

Views have no data of themselves; they merely present data from containers. Therefore, a 'new field' in a view is an existing field from the parent container or one of the linked containers. The field names show the container 'path'. For instance:

Text: Image: Title

...represents the title of an image linked to a text item.

Click the green 'plus' icon to add the desired field to the 'form' with current fields.

Remove field

Fields removed from the current set of fields are listed in the 'Remove field' pane. This listing does not include fields you've added via the 'New field' pane and where then removed.

Click the green 'arrow' icon to put the field back.

Note: When you remove a current field from a container, it will be permanently deleted. You cannot recover data that is lost from this action.

Links

The 'Links' pane determines which items can be linked (only applies to container). From items in the current container you can only link to items from containers listed here. Also, with 'Max. items' (at the right) you can set how many items can be linked.

Click the 'cross' icon to remove a container from the list. Select a container from the select menu and click the 'plus' icon to add a container to the list.

Note: Removing a container from the 'Link' pane will not remove any actual links. It only removes the possibility to link to this container.

Options

Options that apply to the container:

  • Title: container title shown throughout your 1202 system.
  • Link title: in panes listing linked items (section 'New item', 'Edit item' and 'Filter') a short description is shown for each link. This description is based on the field you select here.
  • Max. links per item in overview/hide links: linked items are shown in a separate column in the overview. You can set the maximum number of links shown or check the box next to 'Hide links' to hide the entire column.
  • Rows per page default: sets a default number of rows for the overview.
  • Sort default/descending/numeric: sets a default sort (and optionally, ascending/descending and treat as numeric) for the overview.
  • Save item while editing: will save drafts of items you edit when checked, thus serving as a backup. Does not apply to items that are not yet saved (i.e. when creating new items). Drafts will be deleted when you log out.
  • Save item versions: this will retain the old version of an item when you save it. This is especially useful in situations where multiple people edit the same items, possibly even at the same time. You can set the amount of previous versions that are retained, set '0' if no old versions should remain.
  • Tags: tags offer a way to group containers in a meaningful way. Tags can be used for one or multiple containers. The current tags for a container are listed in the 'Current' pane, tags that are in use only by different containers, are listed in the 'Available' pane. Add a tag by clicking/tapping the green 'plus' icon in the 'Available' pane. Change the tag properties (title, color) by clicking/tapping the 'cog' icon. If you want to use an available tag for the current container, click/tap the green 'up arrow' icon. To remove a current tag, click/tap the red 'down arrow' icon. Tags that are no longer in use by any container, are automatically deleted.

Options for views are:

  • Title: view title shown throughout your 1202 system.
  • Rows per page default: sets a default number of rows for the overview.
  • Sort default/descending/numeric: sets a default sort (and optionally, ascending/descending and treat as numeric) for the overview.

Actions

Main actions for containers are:

  • Save settings: saves the current settings and immediately applies changes where necessary.
  • Delete this container: deletes the entire container. All data in it will be lost permanently. Any views based on the container will also be deleted permanently. Use with great caution.
  • Create new view: create a new view based on the current container. A new view contains only the container's fields. Control permissions are automatically added to your account.

Main actions for views are:

  • Save settings: saves the current settings and immediately applies changes where necessary.
  • Delete this view: deletes the entire view permanently. Does not delete any actual data, because this resides in containers.
  • Rebuild this view: a view can get out of sync, showing incorrect or incomplete data. To correct this, you can completely rebuild the view. This does not affect the source data in the container(s).
  • Duplicate this view: create an exact duplicate of the current view. Control permissions are automatically added to your account.

The 'Settings' section has one action button (top right, in the section bar):

  • Reset: reloads the 'Settings' section, voiding any changes made.