Content Control components are configuration items that define how data on a Grid or Properties card container in Construct Preview displays and acts. These components use data in the database to dynamically change the behavior of a container at run time.
These components define standard Construct Preview control statuses for columns on a container where the control statuses are based on data rather than a column property. Control statuses currently supported are:
0: Disabled
1: Enabled
2: Hidden
To determine the visibility of a column on a container, using the following column properties:
Control Status: Governs the visibility of a column using one of the following options:
Enabled: Displays the column on the container. This is the default value.
Hide: Hides the column or column data on the container.
Disabled: Protects the column. Displays as read-only columns when in edit mode.
Control Status Field: Uses a deferent column from the same grid or form container dataset whose per-row value controls whether this field is disabled (0), enabled (1), or hidden (2). This property offers an alternative to using a separate dataset to control the state of a field.
In addition, select Syniti reserved words can be defined in a Content Control component for example, ccdAdd, ccdEdit and ccdDelete. Currently, Construct Preview supports:
Conditional configuration dataset (CCD): Equivalent to Data Control Views in the legacy Construct. CCD defines record-level control based on conditions that individually determine the control status of each column in a record.
Page Control View (PCV) dataset: Sets the control status of a specific column for all rows within a grid or form container using a single instruction, including the parent container.
When a page loads, Construct Preview uses the following hierarchy to determine page and column control (as in, which pages and columns display for a user):
WebApp Security Group
Page Security
Container Security
Column Properties
PCV
CCD
In this hierarchy, the most restrictive prevails. Once the control status of a column has been limited, it cannot be made less strict. For example, if one of the controls on a page sets a column to hidden (2) using the Control Status column property, the column is hidden even if a CCD sets the column to enabled (1).
Note
Datasets used in Content Control component are case sensitive. If a field is aliased differently from how it is defined in a page's table (for example, CopyClassData v. CopyCLASSData), the field may not display properly in Construct Preview.