You are reading the documentation for an outdated Corteza release. 2023.9 is the latest stable Corteza release.

Page Block Reference

Refer to accessing Corteza  query language for details on how to filter multi-value fields.

Automation

The automation page block allows you to show automation with manual triggers.

Annotated image

The automation page block allows you to use both automation scripts and workflows.

If you can’t see your automation scripts make sure:
  • there were no compilation errors,

  • you refreshed your page after you’ve added the scripts,

  • the trigger defined a .uiProp('app', 'compose') constraint.

If you can’t see your workflows make sure:
  • there are no errors in the workflow,

  • the workflow has an onManual trigger,

  • the workflow is enabled.

Calendar

A calendar page block allows you to show events from different event sources in a calendar.

…​ …​

Supported calendar views:
  • month view

  • week view

  • day view

  • agenda view

Calendar page blocks support two event sources; reminders and records.

The reminders event source allows you to show your reminders as a calendar event.

The records event source allows you to show a record as a calendar event. This allows you to have a module for storing tasks which you can then show on the calendar.

When using records, you can define a pre-filter, which allows you to show only specific records. Refer to the QL reference for details.

The calendar page block pre-filter supports value interpolation.

Chart

The chart page block allows you to display a pre-configured chart on your page. Refer to Low Code configuration for more details.

Annotated image

Content

The content page block allows you to show static content on the page. This can be an important announcement, a how-to guide, or any other piece of information.

Annotated image

File

The file page block allows you to upload static files such as a TOS, a work schedule, or a brochure to the page.

Annotated image

The attachment is static and does not change based on the current context.

Table 1. Additional configurations:

View mode

Defines how the files are presented when they are being viewed.

DevNote list & describe the available options.

IFrame

The iframe page block allows you to embed an external website into your application.

Make sure to keep any iframe embedding limitation in mind.

Annotated image

Metric

The metric page block allows you to display a calculated numerical value based on the data in your namespace. This is usually an indicator important to your process. It may be information such as the total finances in your sales pipeline or the current number of open accounts.

Annotated image
Table 2. Additional configurations:

Label

Defines what the metric shows. The label doesn’t define any value restrictions, nor is it required.

Dimension module

Defines what records will be used when computing the metric.

Dimension filter

Defines how to filter the records when computing the metric. Refer to the QL reference for details.

The filter supports value interpolation.

Metric field

Defines what numerical field is to be used when computing the metric. Each module has a system-defined count field, which represents the total number of records conforming to the specified filter.

Aggregation operation

Specifies how the values are aggregated when the metric is computed. You can pick one of the count, sum, max, min, or avg functions.

Value transformation

Allows you to define how the result of the metric is transformed before shown in the page block.

Value transformation expressions are written as simple JavaScript expressions that return a single number based on the two variables.

DevNote provide some more insight into this.

Format

Defines the format string that is used when displaying the metric. The field supports all of the numeral.js formatting options.

The format is applied before the prefix and suffix.

Prefix

Adds the specified prefix to the resulting metric before it is shown in the page block. For example, the prefix of $ and the value of 1000 would result in the label of $1000.

Suffix

Adds the specified suffix to the resulting metric before it is shown in the page block. For example, the suffix of USD/h and the value of 1000 would result in the label of 1000USD/h.

Style

Allows you to define the visual aspects of how the metrics are shown.

Record list

The record list page blocks allow you to display records in a table. Record lists also provide the features for adding, importing, and exporting records.

When using the search box on the record list, the system only includes the selected fields.

Annotated image

You can trigger explicit automation scripts within the record list’s header. Click the "Automation" tab to select the automation scripts.

Annotated image
Table 3. Additional configurations:

Module

Defines the module that the record list is set to use when interacting with records.

Module fields

Allows you to define the fields and their order when displaying the table.

Allow inline record editing

Allows you to create, edit, and delete records directly from the record list when the containing record page is in edit mode.

This option is only available for record pages.

Hide add record button

Hides the + Add record button, which prevents you from adding new records from the user interface.

This does not prevent the records from being created if accessed from another user interface or by an automation.

Pre-filter records

Defines the pre-filter that is used when searching and displaying records on the record list. Refer to the QL reference for details.

Hide search box

Hides the search input box, which prevents you from applying additional filters to the record list.

The prefilter is applied regardless of this option.

Presort records

Defines the initial sorting that is applied when displaying the record list. Refer to the QL reference for details.

When applying custom sorting from the table, the presort is overwritten.

Hide sorting

Hides the sort controls from the record list preventing you from modifying the initial sort.

The presort is applied regardless of this option.

Records per page

Defines the maximum number of records that can be shown on a page.

Hide paging

Hides the paging controls from the record list, which prevents you from navigating between different pages.

Modify paging

Modifies the previous/next page controls to include a list of available pages, which allows easier navigation between pages.

It is advisable that you disable this option when the module contains a large number of records.

Show total record count

Shows the total number of records that conform to the defined filters.

We suggest you disable this option when the module contains a large number of records.

Allow records export

Enables the record export option and defines the Export button in the header of the record list.

Allow record selection

Adds a series of checkboxes on the record list, which allows you to perform operations over a selection of records.

Hide record reminder button

Hides the create reminder button preventing you from making record-based reminders directly from the record list.

When the feature is enabled, a reminder can be created by clicking on the reminder button next to the record.

Hide record clone button

Hides the clone record button, which prevents you from cloning records directly from the record list.

When the feature is enabled, a record can be cloned by clicking on the clone button next to the record.

Hide record edit button

Hides the edit record button, which prevents you from opening the record editor directly from the record list.

When the feature is enabled, the record editor can be opened by clicking on the edit icon next to the record.

Hide record view button

Hides the view record button, which prevents you from opening the record viewer directly from the record list.

When the feature is enabled, the record viewer can be opened by clicking on the view icon next to the record.

Record organizer

The record organizer page blocks allow you to define a series of columns (stages) that the record of a given module may reside in. The records are moved around using the drag-and-drop interface.

A single record organizer page block defines one column. Add additional record organizer page blocks to define additional columns.

Annotated image
Table 4. Additional configurations:

Module

Defines the module that the record list is to use when interacting with records.

Pre-filter records

Defines the pre-filter that is used when searching and displaying records in the organizer. Refer to the QL reference for details.

Label field

Defines what field is used when displaying the record in the record organizer.

Description field

Defines additional text that is used when displaying the record in the record organizer.

Record sort field

Defines what field is used to define the order of the records. When a record is repositioned, all of the related records change the value of the fields to represent the new order.

Key field

Defines what field is used to define what column the record is in. When a record is repositioned, the value of the given field changes to represent the new state.

Key value

Defines what value the key field must have to be shown in a given column.

Record revisions

The record revisions page blocks allow you to display the revision history tracked for a particular module. The revision history is listed in ascending order, with the latest change at the bottom.

Annotated image
Table 5. Additional configurations:

Preload record revisions

Defines if the record revisions page block should display the revision history unconditionally or if the page block should load the revision history on demand (when unchecked). Keeping the option disabled may help with performance regarding more extensive revision histories, but you can generally enable it.

If the revisions are loaded on demand, the page block displays a show record revisions button that allows the user to load the revision history.

Annotated image

Show changes for all fields

Defines if the revision history page block should show all changed values or just a subset. If the checkbox is unchecked, the table underneath lets you pick what fields the page block should show.

Record

The record page block allows you to display the contents of the records on the record page. When creating or editing the record, record page blocks provide a way of input or manipulation of the values.

Record page blocks are available only on record pages.

Annotated image

You can define multiple record page blocks for the same record page, which allows you to group corresponding things together.

Social media feed

The social media feed page block allows you to embed a specified feed directly into your application.

Currently, only Twitter feeds are supported.

When added on a list page, the specified feed is provided as a fixed URL address.

When added on a record page, the specified feed is provided either as a fixed URL address or as a URL field. Using a module field instead of a fixed value allows a social media feed to change depending on the context.

Annotated image

Comment

The comment page block allows you to show the records in a comment-like formatting.

…​ …​

Table 6. Additional configurations:

Module

Defines the module that the page block will use when showing the comment list.

Pre-filter

Defines the pre-filter that is applied to the records when showing the comment list. Refer to the QL reference for details.

Title

Defines what module field should be used when displaying the comment’s title.

Content

Defines what module field should be used when displaying the comment’s content.

Reference

Defines what module field will be used to store the reference to a specific record the comment is for. This allows you to show specific comments for specific records.

Sort

Defines the direction in which the comments will be sorted. The sorting is done based on when the comment was created at.

Report

The report page block allows you to show particular reporter components inside your Corteza Low Code app.

…​ …​

Table 7. Additional configurations:

Report

Defines the report the page bock will use when showing data.

Display element

Defines the display element from the selected report the page block will use when showing data.

Geometry

The geometry page block allows you to show a map with markers, lines and polygons from different geometry values of different record sources.

…​ …​

Table 8. Additional configurations:

Zoom min

Defines the minimum zoom level of the map.

Zoom max

Defines the maximum zoom level of the map.

Lock bounds

Defines if the map should be prevented from being panned out or zoomed out of the current rectangular area of the map, specified by its longitude and latitude coordinates. This means that the map will only display the area within the bounds of the specified coordinates and prevent the user from panning or zooming out beyond those bounds.

Navigation

The navigation page block allows you to define custom navigation inside your Corteza Low Code applications applications. The navigation can be an addition to the pre-defined one or a complete replacement.

…​ …​

Table 9. Additional configurations:

Appearance

Defines the style of the navigation

Supported appearances:
  • Tabs

Annotated image
  • Pill

Annotated image
  • Small

Annotated image

Justify

Sets equal width for all elements on the navigation

Options:
  • Justify

Annotated image
  • None

Annotated image

Alignment

Defines the text alignment of each navigation item

Supported alignments:
  • Left

Annotated image
  • Center

Annotated image
  • Right

Annotated image

Navigation item type

Defines the functionality of a navigation item

Supported navigation item types:
  • Text: This type displays a navigation item as just test with no extra functionalities.

  • URL: This type of navigation item has a URL option. When clicked, it will redirect to the corresponding URL.

  • Compose page: This type of navigation item has a Compose page option. When clicked, it will redirect to the corresponding Compose page.

  • Dropdown: This type of navigation item has a dropdown option. When clicked, it will display a dropdown with the corresponding dropdown items.

Tabs

The tabs page block allows the grouping of different page blocks to declutter and make it easier to navigate a page.

…​ …​

Table 10. Configurator Options:

Add Tab

Allows you to create a new tab.

Adding a page block to the tabbed page block removes it from the main page.

Title

Determines the title of the tab. If not set, the title of the page block is used, and if that is not set, a generic name based on the kind of the page block is used.

Edit

Allows you to access the page block configurator of a tabbed block.

Add Block

Allows you to access the page block configurator of a tabbed block. Allows you to add a new block that is immediately tabbed. Access this configuration by clicking on the + add button.

Delete

Allows you to delete a tabbed block.

When you delete a tabs block, tabbed blocks can be restored to the main page.