- Classic tap spot collections are associated with\nplain text that appears on the telnet screen.<\/li>
- Classic tap spot collections are processed in\nresponse to a user tapping on a location on the device screen.<\/li>
- Classic tap spot collections require that a list\nof delimiters be configured to identify tapped text.<\/li><\/ul>\n\n\n\n
When using Classic tap spot collections, a user will tap on a\nword or number on the device screen and the device will send to the server a\nmessage containing the row and column that was tapped. Using the defined delimiters,\nthe server will then analyze any text that may exist at the tapped location on\nthe application screen and see if the text is properly delimited. If so, the\ndelimited text will be compared to the \u2018spot text\u2019 in each spot entry contained\nin the classic tap spot collection. If a match is found, the \u2018mapping\u2019 will be\nsent to the telnet host which will forward the input to the data collection\napplication for processing. The classic tap spots work well for identifying\nsingle words, numbers and other simple text on the application screen. The\nclassic tap spots are compatible with all StayLinked Clients that have\ntouch-capable screens.<\/p>\n\n\n\n
Classic tap spot collections can be\nfurther configured at the Telnet Host Entry where you can use \u2018Emulation\nProperties\u2019 to make adjustments to classic tap spot processing for a specific\nTelnet host. Additionally, you can take advantage of the \u2018Screen Recognition\nand Reformatting\u2019 feature set in StayLinked to customize classic tap spots on a\nscreen-by-screen basis for a specific Telnet host.<\/p>\n\n\n\n
SmartTE Tap Spot Collections<\/h3>\n\n\n\n
- SmartTE tap spot collections generate graphical\nbuttons that appear on the device display.<\/li>
- SmartTE tap spot collections are processed as\neach telnet screen presentation event is received, analyzed and forwarded to\nthe device screen.<\/li>
- SmartTE tap spot collections use literals and\nregular expressions to identify patterns on the screen that can be converted\ninto graphical buttons for display on the device screen.<\/li><\/ul>\n\n\n\n
The SmartTE implementation of tap spot collections are processed\nas each telnet screen presentation event is detected. Each affected row of text\non the telnet screen is processed and scanned for patterns that match the tap\nspots contained in the collection. Every matched pattern is converted into a\ngraphical button that is sent to the client for display. The button will have a\ncaption and a mapping. The caption can be literal text or variable text\nextracted from the pattern. The mapping can be literal or variable. The button\nwill be positioned on the telnet screen at the location where the matching\npattern was located. If the button is pressed, the associated \u2018mapping\u2019 will be\nsent to the telnet host which will forward the input to the data collection\napplication for processing. The SmartTE tap spot collections are compatible\nonly with StayLinked Clients that have SmartTE graphical capabilities. More\ninformation about SmartTE Tap Spots can be found in the \u2018Screen Recognition,\nReformatting and SmartTE Guide.\u2019<\/p>\n\n\n\n
This section describes the methods\nprovided to configure and tailor the Tap Spot Collections feature. <\/p>\n\n\n\n
Selecting a Tap Spot Collection<\/h3>\n\n\n\n
When you select Tap Spot Collections from the server tree or the Manage menu, a list of collections will appear in the main display panel. There are three \u2018pre-defined\u2019 Classic Tap Spots collections that are used as the \u2018default\u2019 for each emulation type, 3270, 5250 and VT. These pre-defined collections cannot be renamed or deleted.<\/p>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_50-1024x713.jpg\")
<\/figure>\n\n\n\nAdd<\/strong> \u2013 Select this menu option to add a new tap spot collection.<\/p>\n\n\n\n
Edit <\/strong>\u2013 Select this menu option to exit an existing tap spot\ncollection.<\/p>\n\n\n\n
Copy<\/strong> \u2013 Select this menu option to copy a tap spot collection so\nthat it can be pasted into this or another StayLinked Server that you are\nmanaging.<\/p>\n\n\n\n
Paste<\/strong> \u2013 Select this menu option to paste the last copied tap spot\ncollection into this StayLinked Server.<\/p>\n\n\n\n
Delete<\/strong> \u2013 Select this menu option to delete an existing tap spot\ncollection.<\/p>\n\n\n\n
Import<\/strong> \u2013 Select this menu option to import a previously exported\ntap spot collection into this StayLinked Server.
<\/p>\n\n\n\nTap Spot Collection Maintenance<\/h3>\n\n\n\n
This dialog provides the ability to map specific screen text to their corresponding emulation mnemonics, letters, text or combinations of these. You may right-click on a key spot entry to bring up a context menu.<\/p>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_51.jpg\")
<\/figure>\n\n\n\nTap Spot Collection Name:<\/strong> Enter a unique name for this collection.<\/p>\n\n\n\n
Delimiters:<\/strong> This option controls the \u2018kind\u2019 of this Tap Spot\nCollection. If you leave this option completely blank, then this will be a\n\u2018SmartTE Tap Spot Collection\u2019. If you enter a string of characters to be used\nas \u2018delimiters\u2019, the this will be a \u2018Classic Tap Spot Collection\u2019. If you do\nenter delimiters, each character will be used to identify the limits of a word\nor number that is tapped upon.<\/p>\n\n\n\n
Fill Short Number:<\/strong> Use this drop-down selection to cause either a\nField Exit key, an Enter key or Nothing to be automatically appended to tapped\nnumbers that are shorter than the field into which they are being entered.\n(Applies to Classic Tap Spot Collections only.)<\/p>\n\n\n\n
Allow Tap Cursor Movement?:<\/strong> This option, if selected, will allow the\ncursor to be moved to the location that was tapped, so long as that location\ndid not contain a Classic Tap Spot. Deselect this option to prevent inadvertent\nmovement of the cursor to protected areas of the display.<\/p>\n\n\n\n
Tap Numbers?: <\/strong>This option, if selected, will cause all numbers that\nappear on the session screens to be treated as tap spots (useful for numbered\nmenu lists, etc.). (Applies to Classic Tap Spot Collections only.)<\/p>\n\n\n\n
The information displayed in the\ncolumns of the tap spot collection list includes the following:<\/p>\n\n\n\n
- Spot Text<\/strong>\n\u2013 The unique text used to find a tap spot.<\/li>
- Mapping<\/strong>\n\u2013 The action that will be taken when a tap spot is tapped upon.<\/li>
- Caption\nText<\/strong> \u2013 For SmartTE tap spots, this is the caption that will be displayed in\nthe graphical button. <\/li>
- Background<\/strong>\n\u2013 For SmartTE tap spots, this represents the button background color.<\/li>
- Caption<\/strong>\n\u2013 For SmartTE tap spots, this represents the button caption text color.<\/li>
- Border<\/strong>\n\u2013 For SmartTE tap spots, this represents the button border color.<\/li>
- Alignment<\/strong>\n\u2013 For SmartTE tap spots, this describes the alignment of the button caption\ntext.<\/li>
- Row<\/strong> Range<\/strong>\n\u2013 For SmartTE tap spots, this describes the range of rows on the host screen\nfor which this tap spot entry will be processed.<\/li>
- Notes<\/strong>\n\u2013 Provided for your convenience. These notes have no effect on tap spot\nprocessing. They can, however, help you to organize and manage your tap spot\nentries by providing a place to record the purpose of this tap spot entry for\nfuture reference.<\/li><\/ul>\n\n\n\n
From the File Menu:<\/strong><\/p>\n\n\n\n
Save Changes:<\/strong> Select this menu option to save the current tap spot\ncollection.<\/p>\n\n\n\n
Export:<\/strong> Select this menu option to export the entire tap spot\ncollection to a file.<\/p>\n\n\n\n
Preview:<\/strong> This option is available in SmartTE tap spot collections only and will not appear in classic tap spot collections. Select this menu option to display how these tap spots would be displayed against screen maps that have been captured from emulation sessions. Screen Maps are described later in this article or in the SmartTE Guide. This option opens the list of screen maps and applies the SmartTE dynamic tap spots to your screen maps so you can see how they will appear in production.<\/p>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_52.jpg\")
<\/figure>\n\n\n\nNote \u2013 Leaving your cursor over a button that appears in the preview will show you a tooltip with the \u2018Notes\u2019 and \u2018Mapping\u2019 that created that particular button.<\/em><\/strong><\/p>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_53.jpg\")
<\/figure>\n\n\n\nNote \u2013 Starting with v15.2 you can double click on a Screen Map to disable the preview and return to the original display. Further double clicks on your selection will toggle the display between the preview and original screen.<\/strong><\/p>\n\n\n\n
Exit:<\/strong> Select this menu\noption to close this dialog.<\/p>\n\n\n\n
From the Spot Entries Menu:<\/strong><\/p>\n\n\n\n
Add:<\/strong> Select this menu option\nto add a new tap spot entry.<\/p>\n\n\n\n
Edit:<\/strong> Select this menu\noption to edit the selected tap spot entry.<\/p>\n\n\n\n
Delete:<\/strong> Select this menu option to delete the selected tap spot\nentry or entries.<\/p>\n\n\n\n
Copy Spot:<\/strong> Select this menu option to copy the selected tap spot\nentry to the clipboard.<\/p>\n\n\n\n
Paste Spot:<\/strong> Select this menu option to add a copied tap spot entry\nfrom the clipboard.<\/p>\n\n\n\n
Copy Attributes:<\/strong> Select this menu option to copy the attributes of\nthe selected tap spot entry to the clipboard.<\/p>\n\n\n\n
Paste Attributes:<\/strong> Select this menu option to update all of the\nselected tap spot entries with the attributes from the clipboard.<\/p>\n\n\n\n
Load Defaults:<\/strong> Select this menu option to replace the current list\nof tap spot entries with a default standard list of tap spot entries.<\/p>\n\n\n\n
Add Tap Spot Entry Dialog:<\/strong> Use this dialog to enter a new tap spot entry to the list and its associated mnemonic\/text.<\/p>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_54.jpg\")
<\/figure>\n\n\n\nSpot Text (Classic):<\/strong> Enter the text, as it will appear on the\nscreen, which you wish to make tap sensitive. The text can only be entered in\nany case, but the matching is not case sensitive. The text on the screen must\nappear between two of the defined delimiters.<\/p>\n\n\n\n
Spot Text (SmartTE):<\/strong> Enter either literal text or a Regular\nExpression. The updated area of the telnet screen will be scanned for matches\nto the literal text or for pattern matching with the Regular Expression. To\nenter a Regular Expression, you must add the [regex] prefix to the Spot Text.\nThis prefix will cause the screen analyzer to handle this tap spot entry using\nRegular Expression processing.<\/p>\n\n\n\n
Mapping (Classic):<\/strong> You can select a mnemonic from the drop-down\nlist, or type in the character or literal text that you wish to map to this\nentry. <\/p>\n\n\n\n
Mapping (SmartTE):<\/strong> You can select a mnemonic from the drop-down\nlist, type in a character, type in literal text or specify a regex substitution\nexpression that you wish to map to this entry.<\/p>\n\n\n\n
Caption (SmartTE):<\/strong> Enter literal text or a regex substitution\nexpression that will be used for the graphical button caption.<\/p>\n\n\n\n
From Row \/ To Row (SmartTE):<\/strong> Enter a from and to row which will\nrestrict processing of this tap spot entry to only this range of rows on the\nhost telnet screen.<\/p>\n\n\n\n
Notes:<\/strong> Provided for your convenience. These notes have no effect on\ntap spot processing. They can, however, help you to organize and manage your\ntap spot entries by providing a place to record the purpose or function of this\ntap spot entry for future reference.
<\/p>\n\n\n\nSample (SmartTE):<\/strong> This button will display a sample rendering of the current graphical button attributes for Background, Caption, Border colors and Caption text alignment. Click on this button to present a menu from which you can select which attribute to modify. When you select the options for Background, Caption or Border color, you will be presented with a dialog that you can use to specify the RGB color value that will be used for the graphical button attribute color.<\/p>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_55.jpg\")
<\/figure>\n\n\n\nUsing the RGB Color Picker, you can select pre-defined colors from the grid palette or choose a color from the disc palette. If you know specific RGB values that you wish to use, you can type them into the R, G and B textboxes in either decimal or hexadecimal. The \u2018Selected Color\u2019 preview will show the current color assigned to the caption and will be updated based upon changes you make in the dialog. For convenience, you can also recall the last used color by clicking the \u2018Use Last\u2019 button.<\/p>\n\n\n\n
Update Classic Tap Spot Dialog:<\/strong> Use this dialog to update the selected Classic Tap Spot Entry. <\/p>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_56.jpg\")
<\/figure>\n\n\n\nSpot Text:<\/strong> Once a Classic Tap Spot entry is created, you cannot\nupdate the Spot Text. Instead, delete the tap spot entry and add a new tap spot\nentry.<\/p>\n\n\n\n
Mapping:<\/strong> You can make changes by selecting a mnemonic from the drop\ndown list, or typing in the character or literal text that you wish to map to\nthis spot.<\/p>\n\n\n\n
Notes:<\/strong> You can update your notes to help you manage this tap spot\nentry.
<\/p>\n\n\n\nUpdate SmartTE Tap Spot Dialog: Use this dialog to update the selected SmartTE Tap Spot Entry.<\/p>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_57.jpg\")
<\/figure>\n\n\n\nSpot Text:<\/strong> You can make changes to the literal text or Regular Expression. This example will find a menu item on the screen by looking for the Regular Expression pattern of (1) space, followed by (2) digits, followed by (1) period, followed by (1) space. The two digits are enclosed in parenthesis which causes the value to be \u2018remembered\u2019 and referenced using the $1 special value. You can have multiple \u2018remembered\u2019 values, each referenced using the $# special value.<\/p>\n\n\n\n
Mapping:<\/strong> You can make changes by selecting a mnemonic from the drop-down list, typing in a character, typing in literal text or specifying a regex substitution expression. This example uses the $1 special value to reference the two digits that were found on the screen. The two digits will be followed by the [enter] mnemonic which effectively types in the menu number and presses ENTER when you click on the graphical button on the device display.<\/p>\n\n\n\n
Caption:<\/strong> You can make changes to the caption that will be displayed on the graphical button. This example uses to special values to control the look and text of the graphical button caption. [rgb ######] is a caption prefix which specifies an RGB color value to be used for the button background color. is a special value which causes the button caption to contain 57 characters of text from the screen directly to the right of the matched pattern. In this case, the buttons generated by this regular expression will all be exactly 57 characters long creating a nice row of buttons, one for each menu option.<\/p>\n\n\n\n
From Row \/ To Row:<\/strong> Enter a from and to row which will restrict\nprocessing of this tap spot entry to only this range of rows on the host telnet\nscreen.<\/p>\n\n\n\n
Notes:<\/strong> You can update your notes to help you manage this tap spot\nentry.<\/p>\n","protected":false},"excerpt":{"rendered":"
In addition to traditional keyboard and scanner input to your data collection application, your users can also interact with the screen to provide input to your data collection application. StayLinked allows you to configure the session to provide specific input to your application when users tap on specific plain text…<\/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":"\n
Administrator User Guide - Managing Tap Spot 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 Tap Spot Collections – StayLinked\" \/>\n<meta property=\"og:description\" content=\"In addition to traditional keyboard and scanner input to your data collection application, your users can also interact with the screen to provide input to your data collection application. StayLinked allows you to configure the session to provide specific input to your application when users tap on specific plain text...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-tap-spot-collections\/\" \/>\n<meta property=\"og:site_name\" content=\"StayLinked\" \/>\n<meta property=\"article:modified_time\" content=\"2021-05-19T23:22:59+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_50-1024x713.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=\"12 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-tap-spot-collections\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_50.jpg\",\"contentUrl\":\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_50.jpg\",\"width\":1065,\"height\":742},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-tap-spot-collections\/#webpage\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-tap-spot-collections\/\",\"name\":\"Administrator User Guide - Managing Tap Spot Collections – StayLinked\",\"isPartOf\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-tap-spot-collections\/#primaryimage\"},\"datePublished\":\"2020-01-24T20:30:51+00:00\",\"dateModified\":\"2021-05-19T23:22:59+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-tap-spot-collections\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-tap-spot-collections\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/managing-tap-spot-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 Tap Spot Collections\"}]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","_links":{"self":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/2147"}],"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=2147"}],"version-history":[{"count":0,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/2147\/revisions"}],"wp:attachment":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/media?parent=2147"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=2147"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=2147"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}} - Mapping<\/strong>\n\u2013 The action that will be taken when a tap spot is tapped upon.<\/li>
- Spot Text<\/strong>\n\u2013 The unique text used to find a tap spot.<\/li>