With QuickFillhandler a support person can quickly fill in all the commonly added information onto a data card.

QuickFill handler's User Interface consists of three elements: QuickFill data card reference selection drop-down, the Show button and the Select button. The elements created by this handler are visible in edit mode of a data card only.

The QuickFill reference drop down contains a list of pre-defined source data cards with pre-defined values for configured attributes. The Show button allows the User to view the currently selected QuickFill data card values. The referred QuickFill data card values are shown in a dedicated pop-up window. The Select button is shown next to the Show button. Once the user selects a quick fill data card from the drop down and clicks Select button all the pre-configured values are instantly applied to the currently edited data card.

Standard solution -attribute with QuickFillHandler

Quick Fill Configuration Data Cards

QuickFillHandler copies values from a separate source data cards to the data card that is being edited. Template of source data cards is defined by the Reference settings of the attribute. Values are copied from source data card to target data card by matching attribute codes.

Example configuration data card for quick fill:

List of quick fill configuration data cards. Obsolete data cards can be hidden by DataCardHiddenStateHandler and they are not selectable anymore.

Folder Permissions for Quick Fill Configuration Data Cards

Source data cards for quick fill configurations can be stored to a separate folder. Normal users can have read-only -permission to that folder. They will be able to use the quick fill function, but not edit the configurations. Privileged users, who are able to edit the configuration data cards, should have create-, update-, and delete permissions to that folder.

Folder permission configuration for quick fill source data cards:

Quick Fill Configuration Templates

Values to be used in quick fills are configured in data cards of separate template. The attribute with QuickFillHandler must be configured to refer the quick fill template. That template may have only those attributes, that are needed in quick fill. Users, who are using quick fills, must have at least read-permission to that template and its attributes. Users, who are maintaining quick fill configurations, need create-, update- and delete permissions for the template and its attributes.

Source template for quick fill configuration that matches with Incident-template

Attributes

Values to be copied are defined by attribute codes. Codes of source attribute and and target attribute must be same. In general, source and target attribute must have exactly the same datatype. There are some exceptions that help implementing the source template.

Attribute permissions are obeyed on both source and target attributes.

If target attribute is non-static single value, only currently blank value is updated i.e. old value is not replaced. Static single-value is replaced though.

If target attribute is multi value, new value(s) from source data card are added i.e. old values are not replaced. If quick fill would generate a duplicate value, it will not be added.

New value for text attribute will be added at the beginning of the new value.

Supported data types and possible conversions

String and Text

Source string is copied as target string. Source text is copied as target text. These datatypes can't be mixed. Following macros can be used:

• $USER$ - Current user's name from admin data card.
• $USERID$ - Current's user id.
• $DATE$ - Current date.
• $TIME$ - Current time.

New value for text attribute will be added at the beginning of the new value. It may be a good idea configure text value like: $USER$ added comment on $DATE$ $TIME$

Integer

Source integer value is copied to target integer field. That can't be mixed with float.

Float

Source float value is copied to target float. That can't be mixed with integer.

Date, Date and Time

Source date is copied to target date. Source date and time is copied to target date and time. These datatypes can't be mixed. Source attribute can be string value with now-macro, for example:

• now
• now + 1d
• now + 45m

References

Referred data card of source attribute is added to target (back)reference attribute's value.

Back reference cannot be used as source value.

Embedded references cannot be used at all.

Source- and target may be different attributes. Target attribute must be able to refer to the new target value. This means that both source- and target attributes must refer to the same template, unless a macro expression is used.

Source attribute can be string value representing user-macro. For example:

• #user# - Current user's admin-data card.
• #user:person# - Current user's admin-data card's reference to a person data card.

Static Values

Source attribute for target static attribute may be same static value, any other static value or string. Target static value must match with source value when comparing their values as string.

Attribute Configuration

The attribute of this handler must be a single value reference attribute that can refer to one template only.

Table 1. Attribute Settings

Table 2. Optional Attribute Metadata