|
|
Pocket PC Creations Skills - Page 4
Pocket PC Creations Skills - Design
|
Creating
a Project (continued) |
|
|
Design
- Point - Properties (continued)
 |
|
Custom
Point
|
|
|
The Custom Point
enables special points developed/programmed outside of Pocket PC
Creations to be placed within Pocket PC Creations to take advantage of
it's many standard features. Custom points can be developed in Visual
C++ or another language capable of creating COM objects and placed into
the Pocket PC Creations program folders on the desktop PC and Pocket PC.
Such Custom points are then available for use in Design of projects; the
UltraDrop, Print, Numpad and Telegram
points are described below, and there are specific pages describing GPS,
Voice,
Camera Images, Event
Counter, Stopwatch
, Incrementor ,
Slider and
Formatter
custom points. Pocket PC Creations version 6 installation now includes these
custom points, thus there is no need for separate installation of
the included custom points.
Beyond
this Skills tutorial is information for programmers on Creating
Custom Points.
|
|
Features:
- UltraDrop extends the power of the standard Drop List
point.
- Supports many columns of information stored with each
selection.
- Each column can optionally be used to set the value of a
dependent point.
- Selections can be filtered by matching a column with a precedent
point.
- Flexible text formatting allows one or more columns to be used
to generate selection text (and output values).
- Easy to use data input and editing, including tab-delimited text
import.
- Automatically incorporate 'Dynamic' data
text files into projects open on the Pocket PC Creations server.
Wireless Pocket PCs communicating with the Pocket PC Creations
server are prompted for the download of the latest version of the
project with the data included.
- Multiple-selection and
output of data to Edit points.
- Many applications. Images below are drawn from the Sales
Force project.
|
|

Within the UltraDrop point any number of independent Columns
can be created and named, ready to accept data. In this case, columns
have been created to record different information about each product
in a catalogue, such as its Name and Price.
Each column can be configured to output its value to another point
on the page (or elsewhere in the project). If the Enforce outputs
option is checked, these dependent points cannot be overridden
manually, thus if output is to be edited on the Pocket PC, uncheck
Enforce outputs.
Typically, data from columns is output to Edit and Math points. The
output can be used to Filter other UltraDrop points in a series, see
below.
Tip: If sentences or paragraphs of text are loaded as 'data'
into columns, output to Edit points which are full width and more than
one line so the output can be easily read.
|

The UltraDrop Data page is used to enter and edit the
selections that will be offered to the user. Existing selection items
are displayed in the list, and can be edited, deleted, and moved up or
down the list. New selections can be added via the Add button.
When adding or Editing a selection, a text entry field is displayed
for each column that has been configured.

Data can be imported from a tab-delimited text file using the Import
button. Each line in the file will be treated as a single selection,
with the value for each column separated by a single tab character. If
more columns are present in the file than in the UltraDrop point, they
will be ignored. Tab-delimited text files can be generated from
programs such as Microsoft Excel and Microsoft Access.
Tip: After entering a new item, hold shift and press enter
to immediately add another. This avoids having to click the Add button
again.
|

The Options tab displays options which affect the Formatting
behaviour of the UltraDrop point and it's Appearance on the
project page.
Each selection in the UltraDrop point is displayed as a text string
in the drop down list box. To create this text string for each
selection item, the Display format string is used. The format
string can combine one or more Column values into a string of text,
potentially adding other punctuation in the process. A similar format
string is available for the Output of the point from values in
Columns, which is
recorded in the session database, and seen by other points
(such as Math points).
The format string is processed by replacing each instance of < ColumnName > with the value associated with that column.
The UltraDrop point supports multiple-selection in the
primary drop list and multiple output of data to Edit points where
items can be separated by either a semi-colon, comma or period (full
stop) to facilitate composition of reports and output to databases
and spreadsheets. For example, ending sentences or paragraphs with a
period assists composition of statements for reports.
|

The Advanced properties of the UltraDrop point support
automatic Filtering of its selections based on the value of an
external precedent point (in this example a Drop List point) and Data
Sharing.
Filtering provides three options, exactly matches,
is a substring of, and is a prefix of. Applying Filter
options, only those
selections whose value for the elected column matches the value of the
elected point will be displayed in the UltraDrop point. Filtering can
be driven by any point; for example, by an Edit point receiving bar
code data from a scanner. Try the Filter options to determine what is
most appropriate for a particular project.
By default, if there is no value in the elected filtering point,
the UltraDrop point will remain empty. This behaviour can be modified
so that all selections will be displayed by default.
To use Data Sharing, simply turn it on and then select
another UltraDrop point from the list (which will only show UltraDrop
points). This will configure the current UltraDrop point to share data
from the selected 'base' point. Data cannot be edited data
in the current point, as any changes need to be made to the base
(copied) point.
It is important to ensure the column set up is the same in shared
UltraDrop points, that is, the same number of columns (although they
can have other names, and different management/output of the shared data).
This Data Sharing mechanism can dramatically reduce the file
size of projects which have multiple instances of the same data, for
example sales projects. It also reduces loading time.
Dynamic Data draws its data either from a nominated
text file on the Pocket PC or from the desktop PC or server
when the project is opened; this is a convenient way to update
and maintain large data sets.

The path for the tab delimited text file when a project is opened
on the Pocket PC should be \Path\Filename.txt. The UltraDrop
point is effectively data sharing when Dynamic Data is used. On the
Pocket PC, if the content of the nominated text file is changed,
closing and re-opening the project will present the new data set.
The .txt
files need to be transferred to the Pocket PC, either via ActiveSync
from My Documents with standard sync, or via a File point and
saved to My Documents (or other) on the Pocket PC. The Dynamic Data
.txt files aren't attached to or imbedded in the UltraDrop, they are referenced by
it.
When a project is opened on a desktop PC or server, the
UltraDrop point will be updated frequently by automatically
referencing the source text file. Wireless Pocket PCs logging into
the server will be automatically prompted to receive the updated
project. This updating process can be tracked in the wireless
Activity Monitor and text Log. When this process is used, the
project containing the UltraDrop point is being automatically
updated through embedding the data, there is no separate transfer of
text files. This is the preferred process for wireless deployments. |
|
|
|
|
The Print point enables attachment of a
HTML Template to which data from a session can be output for print
of a HTML file with third party software. The HTML file can also be
attached to emails.
A HTML template suitable for use with Pocket PC Creations
is a standard HTML file, with one important exception: - whenever
Pocket PC Creations detects a tag of the form <%pointIDname%>,
it will replace the entire tag with data from the named point, where
point ID Name is the name of the point, eg Customer, Company.

The Output requires specification of Save in Folder,
for example \My Documents, and Filename or naming pattern,
using %pointIDname%.htm to dynamically name files from
session data, where point ID Name is the name of the point; for
example %Customer% %OrderNumber%.htm .
The control Use non-standard printing is an alternative
that will invoke the web browser print process if appropriate print
drivers are installed.
In operation Tap to print will display the output to HTML,
and make the file available for printing with third party software,
such as PIEprint.
Sketch point images (eg signatures) will be output within HTML
pages, these should be deleted from the Pocket PC periodically, so
they don't use excess storage space.
Pocket PC Creations also supports
output to HTML from the Session Window as an alternative for either
printing or attachment of HTML reports to emails; see page 5 of
Skills and 'Export HTML for Printing'. |
|
|
Numpad
Point |
 |
|
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 (Pocket PC 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.
|
|

|
Numpad points
are convenient inputs for Math points, and can also accept text
for flexibility. |
|
|
|
|
Telegram point is a function to be able
to accept jobs, track, conduct searches and do other tasks live from
within a session. The Telegram point is supported by the
Data
Script functions of Pocket PC Creations which enable events to
be handled by segments of VBScript. Using the Telegram point a
project on the Pocket PC can send a small packet of information to
the server at any time, independent of session management.
Similarly, the Pocket PC Creations server can also send telegrams to
Pocket PCs at any time, in response to any event, independent of
session management.
The Telegram point is a departure from the normal approach in
Pocket PC Creations which doesn't require programming to design and
deploy projects, because it requires use of Data Script. However,
the Telegram point adds powerful functionality for wireless
deployments at the enterprise level.

In point Properties a TelegramName is required to be set,
which identifies the telegram. This allows multiple, independent
Telegram points in the same project without getting confused. An
option is provided to Show popup alert messages on the Pocket
PC client.
Data Transfer properties enable selection of either or
both Send from client to server and Send from server to
client. A field is shown displaying points in the project which
could participate in the telegram; click to select relevant points
for the the telegram. The GUID is the unique identifier for the
session. The option Only if field matches filters a telegram
being received; when enabled, the Telegram point will make sure that
the telegram contains a value for the check point that matches the
value in the current session. If there is no match, the telegram is
ignored.
In operation on the client Pocket PC, Tap to send actions
the telegram. |
|