Label Types are used for defining labels, that is label layout and content, to be used in label printing. They are also used to provide the mechanism to set up the fields and values to be displayed in the matrix cells for graphical presentation of activities, and to perform the HTML scripts for email subjects and body text.
The table below lists and describes the fields on the Activities Label Types card:
| Field | Description |
|---|---|
| Code | A unique ID for the template. |
| Description | General description. |
| Default Printer | The default printer to use for label printing. Note: Ignore this field when the label type is used for other purposes than labels and tickets. |
| Default Admission No. Series | The number series used to assign a unique barcode value or number to each printed label or ticket. Only applicable when the template is used in ticketing. |
| Physical No. of Copies | Defines how many copies should be printed when the label type is used for labels or tickets. |
| Confirm Dialog | Specifies if a confirmation dialog is shown or requested prior to printing. Only applicable for labels and ticketing. |
| Open Email Dialog | Specifies if the email should be opened and be editable prior to sending. |
Use the Script action to edit the layout and the content of the script which the template is presenting.
Note: The script might be used for labels or tickets (and therefore be a printer output), or it might be used to define the layout and content of email subjects and bodies. In those cases the script might include HTML tags and settings as well as references to values in the tables, for example activity and/or reservation fields, or any related table information.
When you create the templates, you can add information that derives from Business Centraltables. The format is #Tableid.FieldId#.
- The Insert Field action provides a list of available tables, and when selected, a list of the fields that are available in that table.
- The Field Format action allows the formatting of the field, as defined by standard formatting options in Business Central.
- The Insert Parameter action allows additional values to be defined and assigned to the script. LS Retail Partners can add to this list of parameters using extensions, if needed.
Note: The Activity Balance and the Reservation Balance amounts are parameters and available for display through the parameter options and not as table fields. The parameters 105 and 106 are samples of parameters that pull in multiple lines into the script.
The following parameters are available for the Caption Script on an Activity Matrix view template, to present availability information on cells for resources with quantity-based capacity (Capacity Based On set to Fixed Quantity or Location/Day/Time Specific Quantity on the resource group — the settings typically used for classes and courses). Each parameter returns the value for the cell's own date, time, and location:
| Parameter | Value |
|---|---|
| 17 - Matrix Resource Capacity | The resource's scheduled capacity for the cell's date, time, and location. |
| 18 - Matrix Resource Availability | The resource's remaining available capacity for the cell, that is capacity minus existing bookings. This is the same value used to determine if the cell is shown as available, fully booked, or overbooked. |
| 19 - Matrix Resource Entries | The number of booked units for the cell, that is Matrix Resource Capacity minus Matrix Resource Availability. |
Note: These three parameters only resolve correctly when used in a Matrix Template's Caption Script. The matrix date, time, and location context they depend on is not available when a script runs elsewhere, for example in the Resource Caption Script, the Tooltip Script, or a label, ticket, or email script.
Note: For resources with Capacity Based On set to Unit Tracking, Matrix Resource Capacity currently returns 0, so Matrix Resource Entries does not reflect the true booked count for those resources.
The Actions menu also provides multiple commands to set a default reservation, activity, or member contact to become the default setting for the Preview screen.
Note: The Preview screen only supports HTML formatting. It may not display the correct outcome when it is used to define label or ticketing scripts for specific label printers.
Implementation Partners attention: The parameter option is the best option to implement new views that require more logic than simply adding a new field to the related tables. See Parameters 105 and 106 on how to implement scripts that are adding multiple lines. Codeunit 10015806 "LSC ACT Label Print" is a sample (framework) on how to implement new parameters to the script mechanism. This codeunit provides all the necessary subscribers and samples on how to add new features to the script framework, which is both used by the label and the email output logic.