Details on controls

You can add your own controls to the CARL Source forms, including new tabs.
The operation of the various controls is described under this heading: Name, Field, Checkbox, Group, Button, Image, Column, Link, and Tab.

Procedure

Enter the customization mode to display the dedicated tool boxes.
On the "Control" palette, click on the one to be added and drag it to the location where you wish to position it. A new tab must be positioned next to the tabs already present.
Once the check is set, select it, change its format, and assign properties to it, see Properties of controls.

Specificities and operation of controls

The common properties of the controls are described in Properties of controls.

Name

A simple explanatory label generally to be positioned to the left of a field.

Specific properties:

Value: Text displayed by the name. To change the existing names, also see Customization of names.

If the name that you add to the form needs to be translated or broken down into several business domains, indicate the reference to the name created for this purpose in the value.

The format is #{file name.name code}, where "file name" is for the name file of the screen you are customizing.
For example: #{material.la_CustField} corresponds to the name you have created with the code "la_CustField" for the file of asset management screens.

Field

A text area, possibly an infozone, for entering or displaying an attribute value of the object on the form.

Specific properties:

Value: Indicates the attribute that will be displayed and entered in this field. See value of controls.
Default value: Default value of the field. You can use a dynamic expression; for example, {agent} designates the connected agent. This value will take priority over that defined in the dictionary or in the data access group.
For a date, the format must be dd/mm/yyyy hh:mm or yyyy-mm-dd. For example: 21/12/2012 08:00 or 2012-12-21.
Infozone: Code of the infozone to which it corresponds.
List: If the field is a drop-down list, fill in the code for the values list. The control automatically becomes a drop-down list.
Length: Maximum number of characters that can be entered into the field.
Mode: Present only for a comment field, if the number of lines is filled in. Select "visual" to display the formatting bar, "source" to hide the bar.
No. lines: To be filled in for a comment field defined as being on several lines (see the entry mask of the attribute in the dictionary). Its value defines the number of lines displayed and therefore the height of the field.
Read-only: A condition in which the field is read-only.
Example: #{formAnimator.bean.category !="ENERGY"}. The field will be read-only if the category is not "ENERGY'.
Maximum size: Only for fields used for downloading a file. This is the maximum authorized size for the file to be downloaded (example: Report to be downloaded).

The visual mode ("visual") only applies if the number of lines (see "No. lines" ) is entered and its value is not less than 4.

To test the null value for comment type fields, you have to indicate: #{formAnimator.bean.longDescValue == ""}

Checkbox

In order to create a checkbox, add a simple entry field. If the attribute assigned to a control is a "Boolean" attribute, the displayed control will be a checkbox.
In order for the checkbox to have two states (checked/unchecked), the attribute must be checked "required" in the dictionary.

Group

Panel for grouping several controls having the same topic.
For the group, indicate a layer value less than that of the controls, which will be located above, so that it will be in the background.

Button

Element triggering an action.

Specific properties:

Action: Indicate the value of the "ID" column of the CSSY_ACTION table for the line corresponding to the desired behavior.
Examples:
- EXCHANGERATEACTION opens the form for configuring the exchange rates.
- OPENDOCACTION opens the linked document of which the code is to be entered in the "Setting 1" property which then appears; see Value of controls.
- OPENURLACTION opens a URL.
- PRINTDEFACTION opens the default report or the report of which the code is to be entered in the "Setting 1" property.
- SENDMAILMSGTMPLACTION opens the form used to select a message template and send an e-mail.
Value: For assigning the name.
Label: Same principle as the value of the name.
URL: Path of the image displayed in the button; see Images. If the image is filled in, the button label will not be visible.

Image

Element triggering an action.

Specific properties:

Image: Path to the image on the CARL Source server if the image is still the same; see images.
Value: To be used if:
- the path to the image is the value of another field,
- the image is stored in the library or in a linked document of the entity; see Values of controls.

Column

For adding information to a list.

Specific properties:

Value: Contents of the column; see Value of controls.
Default value: Default value of the field. You can use a dynamic expression; for example, {agent} designates the connected agent. This value will take priority over that defined in the dictionary or in the data access group.
Infozone: The infozone code if the column includes an object code.
Column footer value: Content of the column footer value. This must correspond to an attribute of the list animator, for example: #{tableAnimator.totalLatenessCumul} for a column containing the cumulative delays in the supplier statistics.
Sequence: Relative position with respect to the other columns, from left to right.
Rank: Sorting rank upon entering the page. At the present time only one column can be the sorting column.
Sort: The sorting mode, "normal," "reverse," or "none," should be entered. To be used for the sort column; see also Result form.
- "normal" for alphabetical order (or chronological order for a date),
- "reverse" for reverse alphabetical order (or reverse chronological order for a date),
- "none" to disable sorting on the column added (so that this new column does not allow sorting).
Footer style: CSS style of the cell in the column footer.

Link

A hypertext link to a linked document or any other URL, or to an action (operation similar to the button in this case).

See Creating an alerter: Example.

Specific properties:

Action: Same principle as in the case of a button.
Value: For assigning a dynamic name; see Value of controls.
URL: Path to the image if the link is an image; see Images.
In this case, specify the height of the image in the "Height" property which then appears.

Tab

New tab for placing customized controls. If there are a lot of controls, use groups to organize them.

Specific properties:

Sequence: Relative position with respect to the other tabs, from left to right.
Tab: Indicate the identifier of the tab if the tab is displayed as default. Example: pa_Technician_DET_ Calendar to display the [Calendar] tab automatically when a technician sheet is opened.