Document Modelling

Tables

Model tables in Sophora.

Table

This field type will display a table. Every table has a headline and a summary, while you can add an arbitrary number of rows and columns. The first row is always used as a header. Available features include:

  • Text formatting (bold, italic)
  • Markup (inclding abbreviations)
  • Links (either to other documents or external links)
  • Images (add via drag and drop)
Parameters
ParameterDescriptionDefaultRange of Values
Spell Checking AvailableConfigure, if spell checking should be made available in the tablefalsetrue/false
Select Value ProviderAllow the configuration of additional settings. The resulting setting options will be made available between the table body and the summary.NoneSee section about aelect value input field types
Number of LinesDetermine how many table rows should already be there on startup2positive integers

Dynamic Table

Add a dynamic table to a document. Which columns should be part of the dynamic table is defined in a separate, associated childnode which you have to add as a valid child node name.

Parameters
ParameterDescriptionDefault ValueRange of Values
Visible EntriesThe number of rows which are visible at once in the table. Due to the marginal buttons of the dynamic table input field, every dynamic table has a minimum height. Therefore, depending on the number of lines per entry, more rows than the configured number could be visible.10Positive integers
Lines per EntryThe number of visible text lines within a table row.2Integers greater than or equal to 2
SortableSpecifies, if the values of each column can be sorted in ascending or descending order by clicking on the column headers.falsetrue/false
Hide Input AreaIf activated, the dedicated area to add a new table row will be hidden and has to be expanded manually, if needed.falsetrue/false
Hide Search FilterIf activated, the search filter field above the table will be hidden.falsetrue/false

With these parameters, you can only configure the appearance of the dynamic table in the document editor. The content is determined by a separate node type, which you have to add as a valid child node name in the childnode configuration editor. In general, you can use any document type that is available. Each property on that document's base tab will be represented by a column in the dynamic table. If you want to edit an input field type for a table column, you cannot do that in the table property configuration, but in the respective property configuration of the referenced document type. Hence, if you would like to configure a field as mandatory for every table row, you have to do that in the property configuration of the referenced node type. Consider the following example:

Create a nodetype (in our example sophora-demo-nt:tabledata) and add to it the properties which you would like to have as columns in your dynamic table. Configure each property in the desired way, i.e. in the way you want to have them displayed in the dynamic table - for example a string property as a select value and so on. Keep in mind, that the order of the properties here will determine the order of the columns in the dynamic table.

Subsequently, open the nodetype editor of the document with the childnode you want to configure as a dynamic table. Set the input field type to Dynamic Table and configure parameters for its appearance pursuant to their summary in the table above. Then, add sophora-demo-nt:tabledata as a valid child node name.

The resulting dynamic table should then look like this:

Geo Data Table

The input field type Geo Data Table is a field to gather and manage large-scale geographic information. Geographic data can be integrated manually via the table's capabilities or imported through an Excel import mechanism. A Geo Data Table is only available to those users who have purchased the add-on DDJM. Please note: In order to display geographic data on maps, the add-on Maps is also needed.

Parameters
ParameterDescriptionDefaultRange of Values
Map Provider ConfigurationDefines the appearance of the map and the behaviour of the search field. The configuration contains among others the map tile service to use and additionally available map styles. For the syntax see examples in the Map field.{providerName: 'osm'}JSON

Last modified on 2/22/24

The content of this page is licensed under the CC BY 4.0 License. Code samples are licensed under the MIT License.

Icon