Entry configuration

For reading/editing the value of an entry property or merged value in the case of multiple entries, we use the following non-editable/editable block configurations explained in Introduction to Details Pane Templates

Entry property = All other properties

Single-selection

read

Use a combo-box if one can find the field by keyboard

CODE

{{combo-box model=model field="XXX" editable=false}}

Use a select-box if one cannot find the field by keyboard such as the DAVID/DISTRIBUTIONENDPOINTS which uses images not text.

CODE

{{select-box model=model field="XXX" editable=false}}

Use a text-box if there is no specific option to pick from.

CODE

{{text-box model=model field="XXX" editable=false}}

Use a date-time for date time properties such as CreateDate (this will become the date-time with editable=false).

CODE

{{format-date model.CreateDate}}

Use a check-box for boolean properties such as the Perfect flag (we’ll streamline the configuration later).

CODE

{{check-box model=model directEditFieldName="Perfect" defaultLayout=false checkedNumeric=model.Perfect backgroundColorOn="lightblue" icon="fas fa-thumbs-up" label="PERFECT" iconFontSize="25px" boxWidth="100px"}}

For numbers, we use for now a converter (we’ll develop a number-box with an input format)

e.g.

CODE

{{format-filesize model.FileSize}}

edit

Same as read but model=editModel (instead of model=model) and remove editable=false.

text-box

for now we use an input text, not the text-box component

CODE

{{input value=editModel.XXX type="text"}}

date-time edit configuration not yet streamlined

CODE

{{date-time value=editModel.XXX format="L"}}

check-box edit configuration not yet streamlined

CODE

{{check-box defaultLayout=false readonly=false checkedNumeric=editModel.Perfect backgroundColorOn="lightblue" icon="fas fa-thumbs-up" label="PERFECT" iconFontSize="25px" boxWidth="100px"}}

number-box

we can use an input number, use case not yet used

Multi-selection

read

Same as single-selection but model=editModelArray

text-box is not yet available for that use case, use bulk-text-box for now

date-time is not yet available for that use case, use merge-date-time for now

check-box is not yet available for that use case, use merge-check-box for now

No use case for numbers yet

edit

Same as single-selection edit but model=editModelArray, and we optionally use a checkbox to enable/disable the change of the property, then add stateChanged=$changeXXX.

CODE

<tr>
<td>
{{check-box checked=$changeXXX}}<label>Change XXX:</label>
</td>
<td class="editable-field">
 <.... see possible block below>
</td>
</tr>

XXX is the property name such as Distribution or Title.
XXX can also be a custom field X/Y, where $changeXXX becomes $changeX$Y.

e.g. for custom field DAVID/DISTRIBUTIONENDPOINTS, use stateChanged=$changeDAVID$DISTRIBUTIONENDPOINTS

Default specific behaviors of comboboxes/selectboxes

For some entry properties, we preset some default behaviors that you can overwrite in the details pane template.

e.g. entry.Distribution is by default in multiselection, you can enforce single selection as follows

CODE

{{combo-box model=editModel field="Distribution" multiSelection=false}}

Some combobox/selectbox behaviors are used only for some entry properties.
See the descriptions and possible values of specific behaviors below.

Combobox/Selectbox behaviors	Possible values	Description
allowEmpty	true or false	adds an empty option in the drop down for setting the value to an empty string
ariaLabel	any string	ARIA message when focusing on the control
distinct	true or false	only for Author and Editor to use distinct values from the database instead of the list of possible definition values
multiSelection	true or false	if true, allows to multiselect values.
source	stringified list of strings	A subnet of options e.g. Class : `source="['Audio', 'Music']"` or for any string custom fields, : `source="['Value1', 'Value2', 'AnyOtherStringValue']"`

See the list of specific behaviors that you can overwrite per entry property :

Entry property	Default combobox behaviors
Class	`source='[...all available classes allowed in the entry table...]'`
Ressort	`ariaLabel="Select ressort"`
SubRessort	`ariaLabel="Select SubRessort"`

Entry definition properties	Default combobox behaviors
other definition properties see available definition fields in Adding combo-box component and binding to dynamic data sources	`allowEmpty=true`
Author	`canCreate=true` `allowEmpty=true` `distinct=false`
Broadcast	`canCreate=true` `allowEmpty=true`
Distribution	`multiSelection=true` `canCreate=true` `allowEmpty=true`
Editor	`canCreate=true` `allowEmpty=true`
Motive	`canCreate=true` `allowEmpty=true`

Entry custom fields

Default combobox/selectbox behaviors

all custom fields

source='[]'

DAVID/DISTRIBUTIONENDPOINTS

it uses a select-box

multiSelection=true

optionImagePath="imageUrl" (specific to this field)