Beginner s Training Manual

Transcription

1 Table of Contents Designing an App... 2 Modify Existing App Adding a Database Adding Controls to an Activity Activity Controls: Logic and Setup System Settings Designing the Added Activities Global Variables Overview

2 Designing an App 1. Left click on the Add symbol located at the Top-Left of your app builder window. The button will disappear and a Scanner will appear in the center of your App Builder window, this will be the first activity that is run on the device. 2. Click on the Scanner and a Menu will appear with an option to design the activity. Clicking on the Design Button will navigate to the Activity Designer Form. 2

3 3. This is where the dragging of controls is done to create functionality for each activity. Click on the Text Tab on the Right side of screen. The Show Text control will become the featured control and the Tab will change color to show it is selected. 3

4 4. Holding the mouse down over the Show Text Control s title allows it to be dragged to the line that says Drop Here 4

5 5. Type the word Hello in the box. Select the number 5 to choose the Text Size. Check the center box. Change the TextColour by choosing a color. For the BackColour, Right-Click the color wheel to view different shades of background colors. Select white for the BackColour. The text for TextColour and BackColour and the box where the text was written will show the colors selected. The X is for horizontal placement, the Y is for vertical line placement. Change the value of Y to 4. Tip: If you double-click the text box, the existing number will be highlighted and you can type a new number to overwrite the existing value. 5

6 6. Click on the Activity name and type Hello 7. Select the View Button to see the page design. 8. The Button Designer window will show the design features of the activity created. 6

7 9. The Function Keys can be set at this time to navigate to new or existing Activities by entering an Activity Name and pressing the Add Button or the function (i.e. F4) button. Type New Greeting in the box below F1 and press Add Type Say Goodbye in the box below F4 and press Add Close the Button Designer, then close the Activity Designer. 7

8 10. The AppBuilder Form will show the newly created Activities. 11. Write the App name: Greetings in the Field at the top of the form. Click the File Button and select the Save As Button. A dialog will appear. Choose a folder location and click Save. 8

9 12. Plug in a scanner and select the Sync button to the Top-Right. This will open the Scanner Sync Form. 9

10 13. Once scanners are detected, they will appear in the Scrollable Carousel. The buttons for loading databases From PC from the scanner and To PC to scanner, as well as Sync Time and Deploy are enabled. Select the Deploy button to load the app to the scanner. If Files exist on the Scanner, a prompt will appear to Erase Files. Selecting Yes will continue the process. Only select No if there are database files that need saving. 10

11 14. Several prompts will appear in the Bottom-Left corner to show the status of deployment. When the Ready OK status appears, the scanner can be unplugged. Do not unplug the Scanner before the Status of Ready OK appears. The App Can then be seen on the scanner. 11

12 Modify Existing App 1. Open AppBuilder. Select the File Button. On the menu, select the Load Button. Navigate to the previously saved App, select and click the Open Button. 12

13 Adding a Database 2. Select the Database Icon on the Top-Left of the App Builder Form. 3. On the Database Designer Form, name the Database Users by typing in the field at the top of the form. 13

14 4. Select the Add symbol located at the Top-Left of form to view the Column Designer Form. 5. In the Field Name Section, click the drop-down arrow and select the preset BARCODE option. The presets have the Field Type and Column Length already set. The Column Length can be changed. Click the Add Column Button on the Column Designer to add the Barcode Column to the Database. 14

15 6. Repeat steps 4 & 5, this time typing in the Field Name USER, selecting the Field Type TEXT, and setting the Column Length to 25. When all fields are set, the Add Column Button will appear. Select button to add USER column to database. Close the Column Designer Form. 15

16 NOTE: Each column created within a Database has a Global Variable (Global Variables are discussed later on pg. 39) that is created to represent where the value for that field is stored when requested from a specific row within the Database. Each one begins with DB_ followed by the DataBaseName_ (i.e. DB_Users_), and ends with the FieldName (i.e. DB_Users_BARCODE) 7. Clicking in the Space below the columns will add rows to the database. Type in fields: a Barcode, that can later be scanned, and a corresponding name of a User that will also be used later. Select the File Button. On the menu, select the Save Button. This will save the Database into the App. Close the Database Designer Form. 16

17 Adding Controls to an Activity 1. From the App Builder form, click on the Activity Named Hello and select Design from the menu. 17

18 2. On the Activity Designer form, select the Display Tab, which will highlight the controls from the Display Family. Drag the Clear Screen control to the Drop Here area above the Text control. 18

19 3. Repeat Step 2 by selecting the Scan Barcode Tab, highlighting the Scan Barcode control and dragging it to the Drop Here area below the Text control. 4. Repeat Steps 2 and 3 by selecting the Database Tab, highlighting the Find Record control and dragging it to the Drop Here area below the Scan Barcode control. 19

20 5. Continue with the previous steps by selecting the Flow Tab, highlighting the Decision Flow control and dragging it to the Drop Here area below the Find Record control. All of the controls are present to give this App some functionality. The next few pages will describe the logic of and how to set each of the controls. After setting up all of the controls, View the display elements of the page on the Emulator. 20

21 Activity Controls: Logic and Setup 1. The Clear Screen Control is added to clear the scanner screen of any previous back colors before setting it to the chosen color. In this instance, Right-Click the color wheel to display the background colors and select White. This will change the Scanner background White to match the selected color. 2. The Scan Barcode Control prompts the scanner to accept a Barcode when scanned. The Barcode Value is stored in what is known as a Global Variable called SCAN_BARCODE. Note: See pg. 39 for details on Global Variables. The SCAN_BARCODE variable will be used in step 3. Symbologies are set when specific Barcode configurations are requests. Minimum and Maximum lengths can also be set. For the Greetings App, the defaults will be used. 3. The Find Record Control is used to search a database by Name, saved in the App, for a Value (i.e ) or a Global Variable that has been filled with a value as a result of some other action. (i.e. Scanning a Barcode, which stores the Barcode value in the Global Variable: SCAN_BARCODE ) Because that Value can exist in more than one column, the Field where the value would be stored in the Database must be chosen. 21

22 4. The Decision Flow Control is use to decide where to navigate when a specific condition is met. Here the DB_Users_BARCODE Global Variable is used for determine what will comparison. The comparison type chosen is whether the DB_Users_BARCODE Global Variable EQUALS the Value entered. The Value can be one that is chosen (i.e ), one that is stored in a Global Variable (i.e. SCAN_BARCODE) or checking whether the variable DB_Users_BARCODE has no value (i.e. leave Value empty) which is the option here. 22

23 5. The Go to Activity controls connected to the Decision Flow control designate what Activity is next if the condition is met or not met. Here if the DB_Users_BARCODE Global Variable EQUALS a Value of Nothing (meaning it was not found and is represented by no Value being entered), The App will navigate to the Activity named Say Goodbye. If the DB_Users_BARCODE Global Variable EQUALS a Value and is not blank, the Find Record Control found a Value in the BARCODE Field of the Database that matched SCAN_BARCODE, and will navigate to the New Greeting Activity. Select New Greeting for the No Item Link and press Add. Select Say Goodbye for the Yes Item Link and press Add. 23

24 One More Addition 15. View the display elements of the page on the Emulator by pressing the View Button and notice that the screen only says Hello. Close the Button Designer and Scroll up to the first Text Control. 24

25 The screen would be more intuitive by adding another Text Control to allow the user to know that a Scan Barcode is waiting for an action. 16. Drag another Text Control to the Drop Here area below the first Text control. 17. Change the Y of the first Text Control to 2 and the second Text Control Y to Set the Size, TextColour and BackColour of the second Text Control to match first Text control. Remember to check Center. 25

26 19. In the Text area, Type Scan I.D. to prompt the user to Scan an I.D. Barcode. 20. Press the View Button once more to see the new changes. Close the Button Designer. Close the Activity Designer. NOTE: The only controls viewable on the Button Designer are those that show display-type elements (i.e. Text, BackColour, Images, etc.) 26

27 System Settings NOTE: After completing each activity or periodically, it is a good idea to save the App, in case the machine crashes, loses power or battery, etc. 1. In the top Left-Side of the App Builder, select the Settings Button The Scanner Settings Form allows the user to set features globally on the scanner that, if not changed in individual cases, will effect each instance where that feature is present. 27

28 2. Scroll to the second Family of Settings. 3. Set the Font Size to 4. Backlight should be on and set to High. The Cursor should be off and set the TextColour to the Sky Blue to match the Text on the Hello Activity. Set the BackColour to White by Right- Clicking the color wheel and selecting it. Close the Scanner Settings Form. Save the App from the File menu to save Scanner Settings. 28

29 Designing the Added Activities 1. Click on the Activity Named New Greeting and select Design from the menu. 29

30 2. On the Activity Designer, select the Display Tab, which will highlight the controls in the Display Family. Drag the Clear Screen control to the Drop Here area. Notice the background colour is now preset to White. 3. Select the Text Tab, which will highlight the controls from the Text Family. Notice the Text Size, TextColour and BackColour are already set. This is a result of the saved Scanner Settings. Drag the Text control to the Drop Here area. Even though the default Size is set, change the Size to 5, change the Y to 2, and check the Center box. In the Text area, Type Welcome. 30

31 4. Next select the Globals Tab, highlighting the Show Global control and dragging it to the Drop Here area below the Text control. Notice again, how the Scanner Settings are present on the Show Global control. 5. Change the Y to 4. Check the Center box. From the drop-down, choose the Global Variable DB_Users_USER to print the user that was found in the Database. 31

32 6. Repeat Steps 3 and 4 by selecting the Flow Tab, highlighting the Wait control and dragging it to the Drop Here area below the Show Global control. This control waits for the user to press a key to move forward. 7. Continue with the above step, highlighting the Go to Activity control and dragging it to the Drop Here area below the Wait control. Select the Hello Activity from the drop-down and press Add to navigate to that Activity after the Wait control sees a keypress 32

33 8. Press the View Button once more to see the new changes. Close the Button Designer. Close the Activity Designer. 9.Click the File Button. Click the Save button to Save the App. 33

34 10. Click on the Activity Named Say Goodbye and select Design from the menu. 11. Drag the Clear Screen control to the Drop Here area. Drag the Text control to the Drop Here area below Clear Screen. Change the Y to 2, and check the Center box. In the Text area, Type Not Authorised 34

35 12. Drag another Text Control to the Drop Here area below the first Text control and set the second Text Control Y to 4. Check the Center box. In the Text area, Type See Administrator. 13. Select the Flow Tab, highlighting the Wait control and dragging it to the Drop Here area below the Text control. 35

36 14. Continue with the above step, highlighting the Go to Activity control and dragging it to the Drop Here area below the Wait control. Select the Hello Activity from the drop-down to navigate to that Activity after the Wait. 15. Press the View Button once more to see the new changes. Close the Button Designer. Close the Activity Designer. 36

37 16. Click the File Button. Click the Save button to Save the App. NOTE: This App is ready for the scanner, provided the logic is correct. The next few pages describe how to test the logic of all of the controls within the app. 37

38 17. Click the Run Button to see the Full App with all the functionality in the Emulator to test the Logic. 18. Select the Play Button. After the Text appears, press the Scan Button, which shows the Scan Barcode Control. Type a Barcode and press the Plus Button to see the Logic work. If the Result is not desired, open the Activities to fix logical errors. When satisfied with the tested outcome, close the form and deploy the App. (pg. 9) 38

39 Global Variables Overview To view or add Global Variables, click the Global Button. The Global Variables Form will appear. Global Variables can be either System generated or user defined. System generated Globals cannot be deleted nor can their values be edited when deployed to the scanner. The sole purpose of the Globals is to store a value that can be used within the App. To Add a Global Variable, complete all of the feature boxes and click the Add Button. To modify, Left-Click the row in the grid, and the feature boxes will populate with the fields. If an existing Global has already been selected, click the Add button first, then complete all of the blank feature boxes, next click Add to save the new Global. 39