Language:


Creating a Register

After creating an App, the next step is to create a register. A register is where information of a particular type will be stored, in the form of records. Each record will in turn consist of a number of fields. The process of creating a register includes naming the register and specifying the fields that it will contain.

In these web pages, we will illustrate the process of creating an App by designing an application that can be used to record the results of stock counts. The application will need a Stock Count register, which will be a register with some header fields and a matrix or grid. The header fields (Number, Date and Location) will contain information that is only required once per Stock Count record. The matrix will allow the quantities of each Item in stock to be recorded: this information is required for each Item, many times in each Stock Count record.

To begin creating a new Register, open the Register Definition register by clicking the [Tables] button in the Master Control panel:The 'Register Definitions: Browse' window is opened, listing any Register Definitions that already exist:If you clicked the [Select This App] button as described in step 6 on the Creating an App page, the ‘Register Definitions: Browse’ window will be empty.

To enter a new Register Definition, click [New] in the Button Bar or use the Ctrl-N (Windows) or ⌘-N (Macintosh) keyboard shortcut. Alternatively, highlight a Register Definition similar to the one you are about to design and click [Duplicate] in the Button Bar.

The 'Register Definition: New' window opens, empty if you clicked [New] or containing a duplicate of the highlighted Register Definition.

First, use the fields at the top of the window to name and identify the register, as follows:
Name
Each register should have an "internal" name and a "public" name. It is unlikely that these will be the same. The internal name is the name given to the register inside the program. The public and internal names are usually different because the internal name cannot contain spaces, full stops or other unusual characters.

Specify the internal name for the register here. Include at least one alpha character in the name and do not use spaces, punctuation marks or special characters of any kind. Use the underscore _ instead of a space. Ideally, the name should reflect the purpose of the register.

Icon
Paste Special    Choices of possible entries
Use this field to specify the icon that you would like to be associated with the new register in the Master Control panel. Some of the icons are illustrated below:

The Binder is the default option.

You must mark the Register Definition as Enabled (below) for it to appear in the Master Control panel. You will need to quit and restart before the register appears in the Master Control panel.

Description
Specify the "public" name of the register here: this is the name that will be shown in the Master Control panel underneath the icon specified above.

Enabled
Mark the Register Definition as Enabled when you are ready for it to appear in the Master Control panel. If the Register Definition is Enabled when you save it for the first time, it will appear in the Master Control panel immediately. Otherwise, you will need to quit and restart after enabling a Register before it will appear in the Master Control panel.

UUID
The Universally Unique Identifier is a unique code that is generated automatically and assigned to each Register Definition. You cannot change the UUID.

App
Use this field to connect the Register Definition to an App. Enter the UUID of the relevant App here.
Save the Register Definition by clicking the [Save] button in the top right-hand corner.

Having created a register, please click the links below for more details about:

Go back to:
See also: