Properties of a Tile control

The Tile control displays the total returned from a query in a compact way to display this information on a dashboard.

The Tile control is available for Desktop, Phone and Tablet forms.

Use the following tabs to configure the properties of a Tile control.

General

Name Description

Type

The type of the control.

Name

A unique name for the tile. (Default: Tile1)

Security token

Makes the information in the form secure. See Security tokens.

Visible

Makes the control visible at runtime. (Default: Selected)

Session ID

Global or form variable or form control that is used as session ID.

Data source

Optional. The Query (Workqueue query, Job query, System query) or .Net action that is used by the tile control at runtime. (Default: Query)

You can configure a Tile control to show the result for a .Net method so that you can use the tile to show information other than the count returned from a query. For example, show the number of logged on users, or the number of notes for a job.

  • If you do not configure a query and load the form at runtime, the control appears but the number is not displayed.

  • If you set the query dynamically, the control appears at runtime and the query is applied when the action executes and displays the total returned from the query result in the tile.

  • If you set a .Net query, every time the refresh interval is reached, the .NET action is executed again, which in turn updates the value on the tile at runtime.

  • If the .NET action is configured as a multi-lingual action, the correct action based on current language is executed.

Title

The title of the Tile control to display at runtime. (Optional)

Item description

The description of the Tile control to display at runtime.

Image

The image to display on the tile at runtime. Select an image from the store such as home.png. (Optional)

Image width

The width of the image on the tile. (Default: 40%)

Default color

The default color used for the tile. (Default: Blue)

You can configure the text color on the tile to automatically adjust to black or white depending on the contrast ratio so that you can use any color for the background of your tile and the text on the tile will always be visible. The font size on the Tile control cannot be changed and the font family is taken from the theme applied.

When you add a Tile control to a form at design time and select a background color, the text color on the tile appears as follows at both design time and runtime:

  • The text color is black if the contrast ratio between white and the selected background color is < 4.5.
  • The text color is white if the contrast ratio between black and the selected background color is > 4.5.

When conditional background colors are configured, the font color is automatically adjusted.

Conditional color

Allows the user to define multiple rules to apply to change the color based on the query result. For example:

  • Count greater than 10 = Green

  • Count greater than 40 = Amber

  • Count greater than 70 = Red

To add a conditional color rule for the tile control:

  1. Click .

  2. On the Count greater than list, select a value.

  3. On the Color list select a color.

  4. Click Add.

    If a conditional color rule is not applicable, the default color is applied.

Refresh interval

The interval at which the Tile control on a form should be refreshed automatically. (Default: 0 Seconds). When you view a form with the Tile control at runtime, the tile is refreshed at the given interval. If the interval is 0, then the tile is not refreshed.

When you import a form or upgrade TotalAgility from an earlier version, any forms with Tile control with value in minutes will be displayed as the equivalent value in seconds.

  • When you add an onclick event to a Tile control, a hand cursor appears when you hover on the tile so that when you click the Tile, the onclicked event is fired and the configured actions are executed. For example, when you configure a Redirect action, you are redirected to a form that has a Job, Work queue or Workload control with the query details and count on the tile. If there is no onclick event configured, then the cursor remains as the standard pointer arrow.

  • You must use the Update control properties action to set the DynamicQueryName, DynamicQueryID, DynamicFilterField, DynamicFilterValue or DynamicQueryType properties.

  • When you add a form with the Tile control to a package with associations, the queries used by the control are added to the package.