DataMax Software Group Inc. 1101 Investment Blvd. El Dorado Hills, CA 95762 USA RFgen Users Guide All Editions RFgen 5.2 © 2021 RFgen Software. A division of DataMAX Software Group, Inc. All Rights Reserved. RFgen 5.2 Users Guide Table of Contents Introduction to RFgen 1 Connection Tab 33 Basic Implementation Steps 2 Connection Tab - SAP 33 Configuration Overview 3 SAP Data Encryption 34 Configurations Shared by Dev Studio To Configure for JDE 35 and Services Console: 3 Adding A New Web Services Connection 40 Connections Shared by Dev Studio Configuring the Host Connection 42 and Services Console: 4 Configuring User Access Control 45 Configurations Available Only in Dev Studio 4 Adding or Removing RFgen Admin- istrators / RFgen SubAdmins 46 Connections Available Only in Dev Studio 4 Dev Studio Configuration Options 47 Configuring the RFgen Application Data- Configuring Menu and Key Settings 48 base 4 System Menu Configuration 48 Configuring Application Preferences 7 Function Key Actions 49 Configuring Application Services 10 Configuring the Scripting Environment 50 Configuring Environment Settings 14 Configuring Source Control Options 52 Configure System Environment 14 Configuring System Properties 54 Configuring Transaction Management DB Connection 19 Download Enterprise Objects 54 Create Application Event Database 19 Downloading ERP Business Functions 55 Configuring System Queues and Tasks 20 Downloading JDE Processing Options 55 Add New Enterprise Connections 22 Viewing Enterprise Objects 57 Adding a New DataSource Connection 22 Viewing ERP Business Functions 58 Connection, Pooling, Indexing, and Viewing JDE Processing Options 58 Availability Tabs 24 Mobile Unity Platform Services Console60 Connection Tab 25 Accessing the RFgen Server Console Pooling 28 (Mobile Unity Platform Console) and Ser- vices 61 Indexing tab 29 Management of RFgen Server Services 62 Availability Tab 29 To Stop or Start Services Using Com- Add an New ERP System Connection 30 mands 63 Configuring RFgen for SAP 31 To Enable or Disable Maintenance Mode 63 - i - Copyright © 2021 RFgen Software. A division of DataMAX Software Group, Inc. All Rights Reserved. RFgen 5.2 Users Guide Table of Contents To Enable Maintenance Mode 64 The Frame Control 82 Server Authorization 64 The Image Control 82 To Activate (Authorize) the Server 64 The ImageList Control 83 Authorize by Email 64 The Label Control 83 Phone Authorization Request 65 The Layout Control 84 Activation by web 65 The Line Control 86 Device Authorizations 66 The ListBox Control 87 To authorize Mobile, Offline Clients 67 The Map Control 87 To authorize Thin clients 67 The Memo Control 88 Enterprise: Reports Menu 68 The Menu Control 89 Mobile Development Studio Overview 69 The Panel Control 89 Application Tools and Controls 70 The Page Control 90 Applications Menu Bar 71 The PanelList Object 92 To Add a New Application (Form) 72 The RadioButton Control 92 Form Control Features 72 The Signature Control 93 To Add, Remove or View Pages 73 The TabControl Control 94 The Page Control 73 The TextBox Control 96 Keyboard Modes and Types 75 The TreeView Control 97 Keyboard Property Definitions 75 Using Mobile Themes for a Graphical Con- trol 98 Property FAQs 76 Form Properties Description 98 To Move a Control 77 The Page Control 100 TIPS for Placing and Sizing Objects on a Form 78 Manage Rows Collection 102 The Button Control 79 Manage Displays Collection 102 The ButtonList Control 79 Manage Icons Collection 103 The CheckBox Control 80 To Set Text Defaults in a Graphical Control 104 The ComboBox Control 80 To Validate Entries in a Graphical Con- The DateTime Control 81 trol 104 The DataGrid Control 81 - ii - Copyright © 2021 RFgen Software. A division of DataMAX Software Group, Inc. All Rights Reserved. RFgen 5.2 Users Guide Table of Contents Scripting with VBA 105 Resource Script View Ribbon Menu 105 Step B. Add Other Languages and Populate from Reference Language125 Scripting Rules of Precedence 106 Step C. Translate Text 126 SideBarMenus 106 To Localize Text in Graphical Displays 126 Configuring SideBar FKeys 107 Scripting Modules 128 Setting System Operations 107 To Make a Reference to Other Modu- Mobile Themes for SideBar 108 dules 128 Source Control Options in the Solution Keyboards-Customized 128 Designer 108 To add and customize a keyboard 129 Source Control Menu and Object States 109 To Stylize a Keyboard 132 Shelve Changes 110 To Import a Keyboard 133 Find Shelve Set 110 Devices 134 Text Resources (Language Translations) 111 To Add a Device Skin 135 Database Exports 112 Voice Applications 138 Data Transactions 113 Menus and Roles 139 To create a Data Transaction macro 114 Assign menus to user or user groups 140 Data Transactions Menu 115 Menus Tools 140 To Allow References to Global Scripts 116 Menus Simulator 142 Images 117 To Add Menus 143 Image Menu 118 User Overview 144 Themes: Signature 118 To Create New Users 147 Text Resources (Language Trans- To Assign Menus and/or Roles to a lations) 119 User 147 Text Resources (Language Trans- To Remove a User 148 lations) 120 To Limit User Access to Applications in a To Translate Strings into Multiple Shared Menu 148 Locales 121 To enable application access to spe- Before You Start 122 cific users 148 Step A. Add Your Primary Text 122 Profiles Overview 151 - iii - Copyright © 2021 RFgen Software. A division of DataMAX Software Group, Inc. All Rights Reserved. RFgen 5.2 Users Guide Table of Contents To Setup a Profile 151 To Debug Code 173 To select applications/items 152 Debugging options 174 To set the options for a Profile 152 To Test SQL Queries 175 To deploy/install the profile to a client 152 Transaction Queue Testing 177 To create a Mobile Profile 153 Device Overview 178 Profile Options 154 Solution Deployment 179 Screen Mapping 157 Authorized Devices Details 180 Themes Overview 158 Device Overview 181 Themes: Application Properties 159 Reports 181 Application Theme States 162 Application Statistics 183 Theme Element Descriptions 163 Task List 184 Themes: Application Colors 164 Performance Monitoring 184 To Enable Device Emulation 165 To Setup Performance Monitoring 185 Voice Tasks 168 Setup Connection to Transaction Database 185 To Import Voice Tasks 168 Setup Your Events Database 186 Testing Overview 169 Set Performance Monitoring Mobile Applications 169 Thresholds 187 Service Requests 170 System Event Log Menu 188 SQL Queries 170 Upgrade Report 189 Transaction Queues 170 Utilities 189 Voice Devices for Vocollect Sys- System Validations 190 tems 170 To Exporting Solution Files 191 To Test Your Mobile Apps 170 To Import Solution Files 192 Testing-Session Properties 171 Script Validation 192 Before You Start Testing - Session Properties 172 RFgen Client Software Overview 194 Session Properties - Fast Start Client Configuration Settings 194 Options 172 Thin Client Overview 195 After You Start Testing - Session Prop- Connect and Deploy to RFgen Clients 195 erties 173 - iv - Copyright © 2021 RFgen Software. A division of DataMAX Software Group, Inc. All Rights Reserved. RFgen 5.2 Users Guide Table of Contents Client Network Control Service 195 System DataBase is SQLite 218 Third-Party Mobile Device Management To Change Your Dashboard's Theme 218 Tools 196 To Set the Locale in Your Dashboard 219 Installing the RFgen Windows CE Client 196 User Management Console 220 Installing to the RFgen Server 196 User Management Console Menu 220 RFgen Client Install Process 196 User Management Console Menu Bar 221 Activating Mobile (Batch) Clients 200 To Add Menus and/or Roles 223 Activating Mobile (Batch) Clients 201 To Find and Replace, Export or Import Mobile Enterprise Dashboard 203 Menus 225 Mobile Enterprise Dashboard Menu 203 To Remove or Rearrange Menus 226 Overview of Dashboard Views 204 To Remove a Menu and its Form 226 RFgen Server Connections 204 Menus Simulator 227 To Set the Language in Your Dashboard 205 To Create New Users 227 To Change Your Dashboard's Appear- To Assign Menus and/or Roles to a User 228 ance 206 To Remove a User 228 To Configure Your Views 206 User Tools: Export or Import Users 229 To Monitor and Interact with an Active Cli- To Search Users 230 ent 209 Graphical Control Properties 232 To Broadcast a Message 210 How to tell if Themes is being applied 232 To Suspend or Terminate a Session 211 232 Display Options 211 Control Property Descriptions 232 Transaction Management Dashboard 213 Appendix B: Screen Mapping 246 Configuring the Transaction Management Dashboard 213 Theory of Operation 246 Run on Server 214 Screen Mapping 246 RFqueue Status Message 215 How to Make Screen Mapping Work 247 To Create or Select Your Data Source 215 Programming Philosophy 247 System DataBase is Access 216 Design Considerations for Screen Map- ping 247 System DataBase is Oracle 217 Screen Mapping Levels 247 System DataBase is SQL 217 - v - Copyright © 2021 RFgen Software. A division of DataMAX Software Group, Inc. All Rights Reserved. RFgen 5.2 Users Guide Table of Contents Logon Security Considerations - Screen Mapping 248 System Integrity Considerations 248 Keyboard/Special Key Configurations 249 Runtime Environment Variables 249 Configuring the Host Connection 249 Availability 253 VT220 Key Mapping 255 How to record a macro for a screen map256 Building a Start Menu Macro 257 The Send Keys Selection 258 Start Menu Macro – Record System Sign on 258 Start Menu Macro – Identify System Menu 259 Start Menu Macro – Record System Signoff 260 Start Menu Macro – Record Error Recovery 260 Start Menu Macro – Test Scripts 260 Building a Host Screen Macro 261 Host Screen Macro – Go to the Applic- ation Screen 262 Host Screen Macro – Identify the Application Screen 262 Host Screen Macro – Return to the Main Menu 262 Host Screen Macro – Test Scripts 263 Building a Host Transaction Macro 263 Recording Options 266 Building a Screen Mapping Application 267 - vi - Copyright © 2021 RFgen Software. A division of DataMAX Software Group, Inc.