{"id":2159,"date":"2020-01-24T13:37:41","date_gmt":"2020-01-24T21:37:41","guid":{"rendered":"https:\/\/portal.staylinked.com\/sl\/kb\/?post_type=ht_kb&p=2159"},"modified":"2023-02-16T08:14:24","modified_gmt":"2023-02-16T16:14:24","slug":"managing-smarttiles-collections","status":"publish","type":"ht_kb","link":"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-smarttiles-collections\/","title":{"rendered":"Administrator User Guide – Managing SmartTiles Collections"},"content":{"rendered":"\n

StayLinked SmartTiles offer\ncustomized on-screen buttons for various tasks that are independent of the\nemulation screen. These tiles can be globally set based on standard client settings\nor customized to provide the desired on-screen buttons to work with the context\npresented to the users.<\/p>\n\n\n\n

SmartTiles are primarily used to\ncreate custom keyboards. They allow you to place buttons as simple as single\ncharacters or more complex macros. They can be used for navigation, screen\nplacement and other features, much like the options available in SmartTE.<\/p>\n\n\n\n

Organized into \u2018collections\u2019 each\nset of tiles can include any desired buttons organized into pages. This allows\nyou to use centralized configuration tools to create a custom interface for\ndifferent device types and screen sizes.<\/p>\n\n\n\n

By example, you might create three\ncollections, one for a \u2018landscape orientation\u2019 wrist wearable, another for a\n\u2018portrait\u2019 style handheld computer and a third for a full screen vehicle mount\nor desktop computer. Each of these collections might have multiple pages,\nallowing the user to cycle between different types of tiles.<\/p>\n\n\n\n

These collections are then served to the devices configured to use them. Clients must be at least version 14.4 or newer to take advantage of these features.<\/p>\n\n\n\n

SmartTiles Collections are configured in the Emulation Settings section of the Administrator. You can right click in the blank area of the SmartTiles Collections window for a list of options: <\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Add:<\/strong> Create a new collection from scratch.<\/p>\n\n\n\n

Design:<\/strong> Make adjustments to the selected collection<\/p>\n\n\n\n

Copy:<\/strong> Copies the selected collection to the Administrator\nClipboard.<\/p>\n\n\n\n

Paste:<\/strong> Use a copied collection create a new collection.<\/p>\n\n\n\n

Delete:<\/strong> Remove the selected collection.<\/p>\n\n\n\n

Import:<\/strong> Create a new collection that is a copy of an exported\ncollection. This allows you to import collections from outside sources or use a\ntemplate. Your installation may include various samples and templates.\nAdditional templates may become available for import from the StayLinked\ndownloads site.<\/p>\n\n\n\n

Unused areas of a collection will become transparent, showing the emulation screen contents. You can see these areas in the image below as the grey and white checkered area. Buttons created in this area share the SmartTE button design options. The configuration panels include the options listed below. Each page in a collection will be the same dimensions, with the selected page showing in the design area at the top of the screen.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The top File menu has the following options. <\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Save Changes:<\/strong> Saving your collection will cause changes to take effect\nas the user navigates or refreshes pages within any existing sessions that are\nusing that collection.<\/p>\n\n\n\n

Export Collection:<\/strong> Writes the selected collection out to an XML\nfile that can be imported on any v14.4 or newer StayLinked server.<\/p>\n\n\n\n

Select Font: <\/strong>This option allows you to change the font size and aspect ratio of the designer. Changing fonts will shape the designer to the height and width of the font selected, but will not change the display font. Changing the font size will resize the design area to be larger or smaller making it easier to work with the space on your PC.<\/p>\n\n\n\n

Note that collection pages will\nnot be presented to devices with a viewport using a smaller row and column size\nthan the assigned SmartTiles Collection. You can confirm the viewport\ndimensions of any session by double clicking the session in the Administrator\u2019s\nconnections list, or with a right click > Details.<\/p>\n\n\n\n

The Tile Elements list box will\nshow each button that has been added to the selected page. You can click on the\nbuttons or on the elements in the list for any commands that affect that\nbutton.<\/p>\n\n\n\n

The following options are\navailable in each collection:<\/p>\n\n\n\n

Name:<\/strong> The description or title for each SmartTiles collection is\nfor general information.<\/p>\n\n\n\n

Allow Horiz Upscale:<\/strong> This option allows the collection to fit into\na device screen that is wider than the collection size.<\/p>\n\n\n\n

Horiz Align:<\/strong> Used when the SmartTiles collection is not as wide as\nthe device screen, this allows you to set collections to the left, center, or\nright edge of the device screen without having to exactly match the width of\nthe device screen as long as the collection is smaller than the device screen.<\/p>\n\n\n\n

Tile ID:<\/strong> This value is automatically assigned a key number used\nwhen configuring devices to use SmartTiles. Tile collections are referenced\nusing a Tile ID and a page number, separated by a comma. See the section below\nfor more information about implementing collections on your client devices.<\/p>\n\n\n\n

Rows:<\/strong> Sets the height of the tile collection.<\/p>\n\n\n\n

Columns:<\/strong> Sets the width of the tile collection.<\/p>\n\n\n\n

Allow Vert Upscale:<\/strong> This option allows the collection to fit into a\ndevice screen that is taller than the collection size. <\/p>\n\n\n\n

Vert Align:<\/strong> Used when the SmartTile collection assigned to a device\nis not as tall as the device screen, this allows you to set collections to the\ncenter, top, or bottom of the device screen without having to exactly match the\nheight on the device screen as long as the collection is smaller than the\ndevice screen.<\/p>\n\n\n\n

The following items are displayed\nin the list box columns at the bottom of the panel. Adding additional pages can\nbe done by right clicking in this list box.<\/p>\n\n\n\n

Page Number:<\/strong> This is the number of each page in the collection. The\npage numbers are automatically assigned. You can change the page number and order\nby dragging or moving pages up or down in the list box. Context menu options\ninclude Move Up and Move Down when alternate clicking on an individual page in\nthe list box.<\/p>\n\n\n\n

Page Name:<\/strong> The descriptive name of each page in the collection.<\/p>\n\n\n\n

Element Count:<\/strong> The number of buttons on each page of the collection.<\/p>\n\n\n\n

You can add new buttons once you\u2019ve created a new collection and page. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The button dialogue includes the\nfollowing configuration options:<\/p>\n\n\n\n

Row and Column:<\/strong> Set the position on the tiles area based on the upper-left\ncorner of the button.<\/p>\n\n\n\n

Height and Width:<\/strong> Set the size of the button. Buttons can span\nmultiple rows and columns, and will stretch to fit the area.<\/p>\n\n\n\n

Transparency:<\/strong> Set the alpha level of the button from 0 (opaque) to\n100 (transparent). Higher numbers are more transparent allowing the emulation\nspace behind the button to show through. Note that the Administrator Tile\nDesigner will not show transparency and transparency should be tested on a\ndevice screen for best results.<\/p>\n\n\n\n

Starting in v15.1 build 208, clients can be configured (smarttile_caption = 0 or 1 ) to ignore transparency settings for the caption on buttons that are at least partially transparent. This is available as a client setting and applied to all SmartTile buttons with transparency. Both the client and server versions are required for the support of this feature.<\/p>\n\n\n\n

Caption:<\/strong> Enter the label to be displayed on the button to describe the action the button provides. Releases after May 4th, 2022 (Administrator build 214, Android client build 228 and iOS client build 144(5) newer) add the option for using a [newline] mnemonic to split captions over multiple lines.<\/p>\n\n\n\n

Script:<\/strong> The action script to be executed when the button is used.<\/p>\n\n\n\n

Keyboard Button:<\/strong> Select this checkbox to use the pressed transparency setting for on-screen keyboards. This changes the transparency while the button is depressed to the value set for the Client Setting configured under Scanner and Keyboard >  Smart Keyboard Fade While Pressed.<\/p>\n\n\n\n

Show in SmartMenu:<\/strong> Select this checkbox to include this button on a SmartMenu. SmartMenu uses an OS dialogue list box to present all on-screen buttons and SmartTiles with this option selected.<\/p>\n\n\n\n

Fonts:<\/strong> Use this button if the Tile button caption should be displayed using a font other than the device default. This also applies to the Administrator design tool, which defaults to the Roboto font for standard button display. See the section below about FontAwesome for more information. Buttons have the following display settings, accessed by clicking the \u2018sample\u2019 button in the right edge of the panel.<\/p>\n\n\n\n

Buttons have the following display settings, accessed by clicking the \u2018sample\u2019 button in the right edge of the panel.<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Background Color:<\/strong> Sets the background color using the RGB color picker\nor select \u2018use last\u2019 to repeat the previous color.<\/p>\n\n\n\n

Caption Color:<\/strong> Sets the text color using the RGB color picker.<\/p>\n\n\n\n

Border Color:<\/strong> Sets the button border color using the RGB color\npicker. Client settings can be used to change the size of the button border if\ndesired.<\/p>\n\n\n\n

Alignment:<\/strong> Set the caption to left, center or right aligned on the\nbutton area.<\/p>\n\n\n\n

Restore Defaults:<\/strong> Sets the button properties back to the default\nvalues.<\/p>\n\n\n\n

Right clicking on in the design\narea provides the following options:<\/p>\n\n\n\n

Edit:<\/strong> Allows you to adjust the options within that button\nconfiguration.<\/p>\n\n\n\n

Delete:<\/strong> Remove the selected button.<\/p>\n\n\n\n

Copy Button:<\/strong> Make a copy of a button, allowing you to paste in into\na blank area of the designer.<\/p>\n\n\n\n

Paste Button:<\/strong> Place a copied button into the selected area.<\/p>\n\n\n\n

Copy Attributes:<\/strong> Copy the colors and caption alignment of a button.<\/p>\n\n\n\n

Paste Attributes:<\/strong> Apply the colors and caption alignment from the copy attributes of a button.<\/p>\n\n\n\n

Switching Between Tile Pages<\/h3>\n\n\n\n

SmartTiles are organized into pages\nto keep pertinent content on the display and avoid showing users options they\nmight not need. SmartTiles collections used for customized keyboards are\ncommonly organized by pages of function keys, scripts, numeric, and\nalphabetical buttons. Most handheld devices would not be able to clearly show\nany screen contents if all of these buttons were included on the same tile.<\/p>\n\n\n\n

The following mnemonics can be used\nin buttons or keyboard map entries to step through the various tiles in a\ncollection:<\/p>\n\n\n\n

[tile_show #,#] <\/strong>This will take the user directly to a tile collection\nID and page, as entered in the number options. For example, [tile_show 4,3]\nwould display page three of tile collection four. [tile_show ,3] would display\npage three of the current collection. [tile_show] would show the current page\nin the current collection.<\/p>\n\n\n\n

[tile_hide]<\/strong> This removes the current tile from the screen, allowing\nthe user to see the emulation space. Once hidden, the user would need to select\nan extended keys or keyboard map entry to show a new collection and page.<\/p>\n\n\n\n

[tile_toggle]<\/strong> This is a combination of the hide and show mnemonics\nwhich will hide the tile if it is currently displayed, or show it if it was\ncurrently hidden.<\/p>\n\n\n\n

[tile_prev]<\/strong> Displays the previous page in the current SmartTile\ncollection. Using this mnemonic on the first page will wrap back to the last\npage of the current collection.<\/p>\n\n\n\n

[tile_next]<\/strong> Displays the next page in the current SmartTile\ncollection. Using this mnemonic on the last page will wrap back to the first\npage of the current collection.<\/p>\n\n\n\n

[tile_cycle]<\/strong> This mnemonic works much like the next option, except\nthat it includes a blank or hide option after the last page of the collection.<\/p>\n\n\n\n

[tile_refresh] <\/strong>Used primarily during initial testing and design, this mnemonic will request the latest copy of the collection page from the StayLinked server. This allows you to immediately see any changes on the collection page on your device without having to change pages or reconnect.<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

In addition to these mnemonics, there is also a client setting that can replace the typical Keyboard button on SmartTE devices with a SmartTiles button. This button acts like the [tile_toggle] mnemonic above, but also replaces the standed two finger tap gesture. Without this setting, a two-finger tap would hide or display the Smart Keyboard, but this setting will change the gesture to perform a [tile_toggle] on the current SmartTiles page.<\/p>\n\n\n\n

Implementing SmartTiles Collections<\/h3>\n\n\n\n

Once\nyour collection is created, you can enable it on devices using several methods.<\/p>\n\n\n\n

The\nmnemonics listed above will not work until a collection has been assigned to\nthe device. You can assign an initial collection by setting a default\ncollection client setting, or using a Screen Recognition Host API for the\n\u2018SmartTiles Commands\u2019 with the [tile_show #,#] mnemonic. Note that using a\ncollection ID with a page of 0 will assign the current collection but will not\ndisplay a page. Once the collection is assigned, you can use the mnmeonics\nabove to navigate the various collections and pages. Note that using these\nfeatures to change collections will set the new current collection, causing the\nmnemonics above to cycle through that collection until a new collection is\nselected.<\/p>\n\n\n\n

Client\nsettings will be the best choice for a fixed set of pages on a particular model\nor type of device. The client setting can set the default collection and page\nfor the client to start with. In the example below, the device would be\nassigned to collection number one but no page would be displayed until\nadditional SmartTile mnemonic commands are issued by the user or StayLinked\nserver.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Note:<\/strong> Make sure your clients support this feature before sending\nthe client setting. Clients that are not at least v14.4 will not write the setting\nand will not try to implement the setting unless the setting date is adjusted\non the StayLinked Server. Clients should show the default collection number and\npage in the ini file when successfully implemented. Based on the example above,\nthe entry in the client configuration would read:<\/p>\n\n\n\n

smarttile_startup_id = 1,0<\/code><\/p>\n\n\n\n

For a more intuitive implementation, StayLinked Screen Recognition features can be used to display a collection and page. This is accomplished using the Host APIs section of screen recognition. This might be used to show the tile page that best supplies valid options to your users. For example, moving to a screen that prompts for the entry of quantities might take the user to a tile with numeric buttons and common quantitiy amounts.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

SmartTiles and FontAwesome<\/h3>\n\n\n\n

Similar to the implementation of SmartTE, SmartTiles can take advantage of the icons in FontAwesome. By changing the font to FontAwesome, buttons can access the [uni XXXX] range of characters in the FontAwesome library. A comprehensive list of these icons can be found online by searching for FontAwesome Cheatsheet. These three icons for example:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\"\"<\/figure>\n\n\n\n

SmartTiles Performance<\/h2>\n\n\n\n

Starting with StayLinked Server version 15.3 build 214 when used with an Android Client v15.3 build 230, SmartTiles support caching options. This allows the clients to locally store data that would previously been updated with each server update. This implementation improves the user experience by reducing communication updates between the client and server.<\/p>\n\n\n\n

Caching is automatic when current server and client versions are used. Caching can be disabled using the Client Settings feature through the StayLinked Administrator, allowing specific clients to be configured as desired. If you're making changes to SmartTiles and not seeing them reflected in new sessions, you'll want to disable this caching using the Client Setting until your changes have been distributed. Once the changes are pushed to affected devices, we recommend you re-enable caching for improved performance.<\/p>\n\n\n\n

The new mnemonic [tile_refresh #,#] can be used to re-acquire the collection from the server. This allows dynamic content to update variables that may be used for button labels or contents.<\/p>\n\n\n\n

<\/p>\n","protected":false},"excerpt":{"rendered":"

StayLinked SmartTiles offer customized on-screen buttons for various tasks that are independent of the emulation screen. These tiles can be globally set based on standard client settings or customized to provide the desired on-screen buttons to work with the context presented to the users. SmartTiles are primarily used to create…<\/p>\n","protected":false},"author":7,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[23],"ht-kb-tag":[],"yoast_head":"\nAdministrator User Guide - Managing SmartTiles Collections – StayLinked<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.staylinked.com\/knowledge-base\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Administrator User Guide - Managing SmartTiles Collections – StayLinked\" \/>\n<meta property=\"og:description\" content=\"StayLinked SmartTiles offer customized on-screen buttons for various tasks that are independent of the emulation screen. These tiles can be globally set based on standard client settings or customized to provide the desired on-screen buttons to work with the context presented to the users. SmartTiles are primarily used to create...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-smarttiles-collections\/\" \/>\n<meta property=\"og:site_name\" content=\"StayLinked\" \/>\n<meta property=\"article:modified_time\" content=\"2023-02-16T16:14:24+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_59.jpg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"14 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/#website\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/\",\"name\":\"StayLinked Knowledge Base\",\"description\":\"Partner Portal Resources and Support\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/portal.staylinked.com\/sl\/kb\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-smarttiles-collections\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_59.jpg\",\"contentUrl\":\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_59.jpg\",\"width\":126,\"height\":159},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-smarttiles-collections\/#webpage\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-smarttiles-collections\/\",\"name\":\"Administrator User Guide - Managing SmartTiles Collections – StayLinked\",\"isPartOf\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-smarttiles-collections\/#primaryimage\"},\"datePublished\":\"2020-01-24T21:37:41+00:00\",\"dateModified\":\"2023-02-16T16:14:24+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-smarttiles-collections\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-smarttiles-collections\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-smarttiles-collections\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/portal.staylinked.com\/sl\/kb\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Articles\",\"item\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Administrator User Guide – Managing SmartTiles Collections\"}]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","_links":{"self":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/2159"}],"collection":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/comments?post=2159"}],"version-history":[{"count":3,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/2159\/revisions"}],"predecessor-version":[{"id":4195,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/2159\/revisions\/4195"}],"wp:attachment":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/media?parent=2159"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=2159"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=2159"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}