Adding Simple Points

Learn how to add basic points to your projects

Boolean Point
Boolean example

The Boolean Point is a useful facility for quick recording, providing a virtually unlimited choice of results recording, either text or numeric, see design dialogue box below. While the default choices in the drop down lists are Yes, Yes/No, True/False, Safe/Unsafe, 1/0/99 and NA/ N/A, amend for any choice. The 1, 0, 99 style is useful for collection of observations which may then be subject to statistical analysis. The standard selections can be amended to sentences and paragraphs, which can be selected and loaded into reports.

Boolean properties


Selection Point
Selection eg

The Selection Point is particularly useful where a number of choices are presented and multiple selections may be necessary. The design dialogue box below shows potential for many Items to be presented with either Multiple or Single selection. The Items can be added, edited, deleted and moved up and down. Code-based provides the opportunity to collect numerical data or codes 'behind the scenes', eg 1;Normal, 2;Excited and so on, use the number/code first then a semi-colon (;) to separate from the text. The code-based values can be used as inputs for Math points, see below.

Selection properties

The Import tool facilitates the importing of content for the Selection Point, content must be sourced from a tab delimited txt text file to import. To set a value as default in Design mode, select value and point in page view and right click mouse to ' Save Default Value '.

Right-click of a Selection point in the Design window, presents the Convert to Drop Point option to create an equivalent Drop List point (see below), with the same characteristics. Similarly, a Drop List point can be converted to a Selection Point.


Edit Point
Edit eg1 Edit eg2

The Edit Point is used for entering text and/or numbers in the field. Standard Cut / Copy / Paste commands can be used, and Bar Code and RFID (radio-frequency identification) are accepted. The design dialog box below shows the Style options for text and numeric input and controls for Numeric Behaviour and Default Value for both text and numeric data. If numbers only should be entered by users and then may be inputs for Math and Logic points, the style Numbers only should be selected. Style also includes an option for Masked entry of either text or numbers, for use of passwords to control visibility of pages and points (in combination with Logic point). The size of the entry field is controlled by Physical Size , from many compact inline box options to 16 lines for entry of large amounts of text.

Up and down arrows, or 'spin buttons' can be used for quick entry of numbers. A Range can be set for numeric input; however, a default value within the range must be set otherwise the out of range warning would show. The Limit control enables a limit to the number of characters entered in the Edit point, this can be useful when outputting to databases and forms.

Default Value can also reference the current value of other points, evaluated at session creation time. Thus the default value for a point can
be <%OtherPointID%> ; for example, in drill hole sampling to enable 'from' and 'to' data.

To load data from Bar Code Scanners , tap the Edit point box for cursor activation before loading scan/s. The cursor will automatically be placed in any Edit point at the top of a page. Scanners are available to capture bar code using Edit point in Android, Apple iOS and Windows Mobile; eg the Socket Bluetooth Series 7 Scanner and KDC Line scanners . Bar code data input can be used to filter large data sets in the UltraDrop point (page 5) . Similarly, the Edit point can be used to capture RFID data from RFID scanners to filter large data sets; for example when identifying assets for maintenance.

For large blocks of text, in Android transcribe direct from microphone input to Edit point, in Apple iOS dictate with Dragon Dictation (free App) and copy and paste into Edit point.


Drop List Point
Droplist eg

The Drop List Point is useful for long text records for both single and multiple selections. The Drop List is also a compact way of managing possible selections, with many entry box size options. The design dialog box below shows important Style options for the listing of items: Editable/edit enables additions to the Drop List on the mobile device by entry into blank areas; Save will store the new items for future use on the particular mobile device on which they were entered. This facility allows additional design specificity, and flexibility, beyond the Project/application down to the level of particular users of the application. If a particular cached response needs to be removed on the mobile device, simply select it twice in a row, and a prompt will appear confirming the removal.

Droplist

To generate Code-based output, place a semicolon (;) between the code and the text visible in the Selection point. For example "150;Consulting Rate", would record 150 and make the number available for math operations.

The Multiple selection drop list enables multiple selections (including Code-based), choices are marked with a tick. Selections are recorded in data management separated by a semi-colon. Multiple selection Drop Lists cannot be edited on the mobile device.

The Import tool facilitates the importing of content for the Drop List , content must be sourced from a tab delimited .txt text file to import. A list of hundreds of Items can be imported and scrolled for selection of choice on the mobile device. To set a value as default , select in on-page view and right click mouse to 'Save Default Value'.

Where long statements are included in Drop Lists, it may assist to reproduce these in point Guidance to assist the user, or to display the selection using a Layout point (see below).

(For more advanced drop list functions, see UltraDrop point on page 5)


Date Time Point
Timestamp eg

The Date/Time Point is used to record the time (and date if selected) of a particular action or observation. The Date/Time point complements the timing functions of Mobile Data Studio which always record the time and date a new session is started and finished with a project/application. The time and date recording are a reflection of the settings on the host mobile device or desktop PC. Date Format options are available for regional preferences. Date/Time point accesses the calendar functions on the mobile device and desktop PC, and can record current and other times.

On-screen, Date/Time points appear as a caption followed by a check box and date and/or time string. Tapping the check box will record the current time and/or date; arrow controls enable alteration to date and times, either by launching a calendar or first selecting the value and using arrows to make changes.

A number of date and time formats are available, including YYYY-MM-DD, DD-MM-YYYY and MM-DD-YYYY, with day and month text, and 12 and 24-hour time with and without seconds. Both Display and Output formats can be set; for example the popular DD-MM-YYYY format might be displayed but the universal YYYY-MM-DD be output.

There are three options for control of the Date/Time point, a simple box enabling tap to set the current date and time, the 'Native' Windows Mobile control and a Touch-friendly control displaying a large calendar which is useful for devices without a stylus. Download a Date Time Test project to try out various settings to suit Android, Apple and Windows Mobile devices and Date/Time application required.

6 date time

The Date/Time point can be used in combination with the Math point (see below) to record time elapsed for time-based charges and other purposes. If a Date/Time point is included in a Math point's expression, the time and/or date will first be converted into a number. Where a date is included, this number will be the number of minutes since January 1st, 1979. If there is only a time, the number will be the number of minutes since midnight. When the Date/Time point includes seconds, they appear as a decimal portion of a minute in math operations (30 seconds is 0.5 minutes). Note, that when using date Maths and exporting to databases, it is best to use the universal YYYY-MM-DD date format. Dates presented in other formats may not be interpreted correctly. If other formats are used, the Regional setting on both the mobile device and host desktop PCs or server must be aligned with the date format chosen. Download a Days Calculator demonstration project to see how the Math point interrelationship can be used; in this example to calculate the number of days between two dates.


Math Point
Math eg

Math Points allow a project to evaluate equations, drawing input from other data input points including Boolean, Selection, Edit, Drop List, UltraDrop, Logic, Date Time, and Math points themselves.

Each Math point has a fixed expression associated with it that it will evaluate to produce a result. These expressions can include 30 mathematical Operators and Functions , some of which are shown in the dialogue box image below.

Math operator

Mathematical operators , in order of precedence:

  • ^ power

  • * multiply

  • / divide

  • % modulus

  • + add

  • - subtract

Conditional operators , in order of precedence:

  • \= equals

  • !\= not equals

  • > greater than

  • < less than

  • >= greater than or equal to

  • <= less than or equal to

Logical operators , in order of precedence:

  • & and

  • | or

  • ?x:y If/Else

Functions take the form fn(x), where fn is the function name and x is an expression. Functions are:

  • abs absolute

  • inv inverse

  • int integer

  • sqrt square root

  • log10 log

  • ln natural log

  • exp exponential

  • sine

  • cosin cosine

  • tan tangent

  • arcsin asin

  • acos arccosine

  • arctan atan

  • deg2rad convert

  • rad2deg convert

  • random int irnd

  • random float frnd

Values from other points on the page (or indeed any other page in the project) can be used in the expression by including the ID name of the point. Note that referenced points must contain numeric data; however, this can be in code-based format. Points that are blank (ie points that have not been filled in) will be treated as numeric zeros.

For example, an expression to add the values entered into two other points named A and B would simply be "A+B". While this is a simple case, more complex expressions can easily be constructed, involving fixed constants and brackets. For example, to take the average of three points named Alpha, Beta and Gamma: "(Alpha+Beta+Gamma)/3".The dialogue box below shows another example, and the drop down selection facility to import points into a math equation. Practice the Math point to experiment with it's power and versatility, confidence will soon develop to apply it to many valuable projects. The Sales Force projectcincluded in the Examples folder of Mobile Data Studio software (C:\Program Files\Mobile Data Studio\Examples\SalesForce.ppc) makes use of the Math point on the Product page.

Math insert

The syntax for the If/Else logical operator is (conditional expression) ? (true expression) : (false expression). The brackets are not necessary, and any of the three expressions could be constants or variables or more complex compound expressions. The If/Else operator group has the lowest precedence. For example if there is a point 'INPUT', and the objective is to create an expression that is equal to INPUT squared if INPUT/2 is greater than 5, or INPUT cubed if INPUT/2 is less than or equal to 5, write: ((INPUT/2)>5) ? (INPUT^2) : (INPUT^3).

Random function irnd(x) generates a random integer between 0 and x-1 (meaning that there are x possible values); frnd(x) generates a random decimal between 0 and x inclusive (it could be, eg 2.456).

A full range of Decimal and Hexidecimal Accuracy control is available. There is support for non-English locales, as determined by hardware system settings (Settings > System > Regional Settings on mobile device and Control Panel > Regional Settings on desktop PC). Thus if Regional Settings specify "," as the decimal character and "." as the digit grouping character (which is opposite to the English system), then these settings will be reflected in Mobile Data Studio.

On-screen, Math points appear identical to Edit points, but are read-only. The value will be computed automatically. The result calculated and displayed in a Math point will be recorded in the results like any other point, and is available for examination or in Mobile Data Studio server.


Numpad Point
Numpad items

The Numpad numeric keypad enables rapid entry of numbers using fingers rather than stylus. Tap pad icon to launch Numpad. To support international use, in Design the Numpad has an option for Decimal character , based on either Auto (device settings), period/full stop, or comma. The Numpad point has a control in Design mode to set the range within which data can be collected, and to limit the digits in the number. Note that a period/full stop, or comma, is regarded as a digit; thus five digits could be 45.76.

Numpad properties
Numpad

Numpad points are convenient inputs for Math points. Please NOTE the Apple iPad does not support a small numeric keypad input; the input is via the keyboard which launches on use of Numpad point.


Outlook Point
Outlook eg

The Outlook Point enables the importing of Contacts information from Microsoft Outlook via Pocket Outlook on Windows Mobile Pocket PCs and Smartphones. Please NOTE, the Outlook point is not supported for Android and Apple devices, see alternative below. The design dialogue box shown below presents options for selection of contact information which can be imported from Pocket Outlook to a Mobile Data Studio project in the field. This facility assists with automatic entry of contact information in the field, avoiding time consuming manual entry. Depending on the fields chosen, appropriate captions and ID names are automatically generated for each field point, the captions can be manually changed to suit common terminology. The 'Body' field presents Notes from Outlook. The presentation output into Edit points can be adjusted for compact inline designs. Checking the Options box allows new contact information to be added simultaneously to Pocket Outlook and a Mobile Data Studio project in the field.

Outlook

Outlook contacts are accessible during a Local Session on a Tablet, desktop or notebook PC. Microsoft Outlook on a desktop PC can accept/import contact information from a wide range of programs (eg Access, ACT), this information then synchronises with Pocket Outlook on the Pocket PC via ActiveSync.

Outlook Contacts Categories can be used on the Pocket PC, to conveniently filter large lists of Contacts. Tap the Category header to filter Contacts, and then re-open the Outlook point drop list to view the Contacts in the Category.

Android icon
Apple icon
ANDROID and APPLE NOTE: the Outlook point is not supported for Android and Apple devices. However, Outlook Contacts on desktop PC can be exported to Excel and imported to the UltraDrop point (see page 5) to manage Contacts on Android and Apple devices. The Dynamic Data function of the UltraDrop ensures Contacts are up to date.
Outlook contacts ultradrop