Hi Michel,
To begin to learn about modifying the address List file to create
a second address list, you can go to the Help Index on the QT by
pressing function with U and then I. Go down the list to where
it says "Address List topics"
You will be offered another list of choices about Address list
options. Go down the list to choose "Creating an Address List".
This seems to explain the process well. You can learn to make
simple changes or you can just change the name of the file to fit
your new address list type such as "Work".
Be sure to copy the Address List.klt document from the Keylist
folder to another folder such as General to work on it. By doing
that, you will keep the original Address List file intact and you
can "play" with the copied file without worry of messing anything
up. Remember to rename it before you copy it back to the Keylist
folder so that you will not overwrite the original file. You
will understand the information below better once you look at the
information in the address list file.
If you want to learn more about the types of fields you can use,
then the following text may be helpful to you as it was for me.
I wanted a list of information that was not at all similar to the
choices given in the default Address List file. I requested
additional information from Humanware and received the following
when I was still at version 4 or 5.
There was a problem when I upgraded to version 6.11. The data in
my custom address list became corrupted and I had to enter the
data again.
If you still have questions, I would be glad to try and answer
them for you. It is tedious to create a new definition file if
it is very different from the original, but, once done, it is
well worth the effort.
I will be glad to help with specific questions if I can.
Joleen
Begin Text Information from Humanware:
KeyList Definition Files
First line of a Definition File - the "database" line
To be a valid KeyList Definition File, the very first line must
contain the word:
database
with an optional parameter of a database name, for example it
could be:
database Address list
The database name is the name under which the actual data is
stored in the database volume file, keylist.cdb in the KeyList
folder. Keylist.cdb stores multiple databases and each database
has its own name. If no database name is given on the database
line, then the name of the definition file is used as the
database name. If there is a name, then that name becomes the
database name. This allows you to have more than one definition
file for the same database. For example, in addition to the full
"address list" you might have a "phone list" containing only the
name and phone number fields from the full address list. You
might also have a business address list with only business
details, etc.
Second line of Definition File
This is used in certain situations for compatibility reasons
purposes. It is unused in KeySoft any number can be used.
The Numbered lines
There must be one numbered line for each field defined by the
definition file. The numbered lines do not have to be in numeric
order. Their order determines the order in which the fields will
be presented in KeyList. The number identifies the field within
the database so the same number must not be used twice. Numbers
must be between 1 and 65535.
The format of these lines is as follows:
Identification number, Field type, Usage, Modifiers, Braille
grade, "Prompt", default value, "help message"
Each line must start with a number but the order of the other
parameters is not important. The "Prompt" must be in double
quotes and come before the help message.
Field type
This is optional and will default to string", if omitted.
Allowed types are as follows:
string Up to 250 characters
time The time according to the current time format.
date The date according to the current date format.
timeanddate The date as above followed by the time as above
word An integer between -32768 and +32767
uword An integer between 0 and 65535
dword An integer between -2147483648 and +2147483647
udword An integer between 0 and 4294967295
float A floating point number. Can be anywhere between 1.7 E
-308 and 1.7 E 308 and can contain up to 15 digits.
boolean A value of either "Yes" or "No".
autotime A time type that is automatically initialised to
contain the time the record was created
autodate A time type that is automatically initialised to
contain the date the record was created
autotimeanddate A timeanddate type that is automatically
initialised to contain the date and time the
record was created
Usage
This is optional and will default to general", if omitted. It
controls the way the field is spoken and/or used within KeyList.
For some usage types, the field type is implied and therefore
must be omitted.
general The default usage type.
spell Causes the field contents to be spelled
name Causes the text-to-speech to interpret the contents as a
name.
address Causes the text-to-speech to interpret the contents as
an address. For example "NE" will become "North East"
city Causes the text-to-speech to interpret the contents as a
city name
state Causes the text-to-speech to interpret the contents as
a state abbreviation. For example "NE" is "Nebraska"
country Causes the text-to-speech to interpret the contents as
a country name
organization Causes the text-to-speech to interpret the
contents as the name of an organisation
password Causes the field to be displayed as a row of asterisks
email Causes the field to be treated as an email address and
therefore offered as such if the database is selected
as the "address list" for KeyMail
file Used for multiple line entries. Rather than reviewing and
editing the contents directly in the record review area, the
user reviews and edits the field in the word-processor
environment.
concat A special field type that stores a concatenation of one
or more other fields. A concat field does not have a
prompt, instead a list of the fields to be concatenated
is put in quotes. For example:
120 "First name"
121 "Last name"
123 concat "120, 121"
Field 123 will contain the first name followed by the
last name.
concat fields are used mainly for specifying how a
database is to be sorted. See "sort order" below.
Modifiers
These are optional and are as follows:
autonum automatically includes a number sign before the entry.
autocap automatically includes a capital sign before the entry
or, in the case of computer braille or QWERTY entry,
converts the first character to upper case.
allcaps automatically includes a double capital sign before the
entry or, in the case of computer braille or QWERTY
entry, converts the whole entry to upper case.
Braille Grade
If a grade is omitted, KeyList expects the user to use his/her
Preferred Braille Grade. The user can change the entry grade in
a particular instance using the Grade of Braille" option in the
Options Menu. No translation is done on field entries, but they
are stored in the database in the grade use to enter them. If
you need to specify that a particular grade must be used for a
field them include an entry in the definition line, as follows:
G0 for computer braille
G1 for grade 1
G2 for grade 2
GX same as omitting the braille grade. The user's Preferred
Braille grade is assumed.
Prompt
This is mandatory and is the prompt that is displayed in KeyList
in the add and lookup options. A double quote must be typed
before and after the prompt. A prompt can be up to 30 characters
long.
Default values
Any field may optionally have a default value that is assigned
when a new record is created in the KeyList add" option. To
specify a default value, type d= and enclose the value in quotes.
For example:
124 "Blind baseball club member", boolean, d="N"
Will cause the "Blind baseball club" field to always initially be
set to "No". It can, of course, be changed to yes during entry
or modification.
A default value can be up to 50 characters long
Help message
You can optionally include a help message for any field by
enclosing a second string in quotes. This will be the first
message displayed when the user selects help. For example, the
line:
128 "Bank Balance", float, autonum, "Do not include a dollar
sign"
Defines a field to store a bank balance but when help is
requested, reminds the user not to include a dollar sign.
A help message can be up to 200 characters long.
Special lines
Sort order
The sort order specifies the number of the field on which the
database is to be sorted. More than one sort order can be
specified, however KeyList always uses the first one. If the
database is selected as the "address list" for KeyMail, KeyMail
will use the second sort order when looking up addresses. In
order to have records presented in an order that takes into
account more than one field, the "concat" field type may first be
used to create a field containing, for example, both a surname
and first name, in that order, and then the concat fields number
can be used as the sort order.
Announcement order
This specifies which fields will be displayed at the top of a
record display, and the order in which these fields will be
displayed. For example:
120 "First name"
121 "Last name"
Announcement order 120, 121
will result in the first and last names, in that order being
displayed at the top of each record.
However:
Announcement order 121, 120
will result in the last name being displayed first.
The Address List Definition File
database Address list
24
14865, name, autocap, "Last name"
14854, name, autocap, "First name"
16420, name, autocap, "Middle name"
16419, name, autocap, "Title"
14857, phone, autonum, "Home phone number"
14856, phone, autonum, "Business phone number"
14876, phone, autonum, "Cell phone number"
16515, email, G0, "Home email address"
16531, email, G0, "Business email address"
14885, phone, autonum, "Home fax number"
14884, phone, autonum, "Business fax number"
16448, address, "Street address"
16458, address, "Street address line 2"
16449, autocap, city, "City"
16450, allcaps, state, "State or county"
16451, spell, "Zip or post code"
16452, autocap, country, "Country"
14871, autocap, "Business Title"
14870, autocap, organisation, "Company name"
14872, autocap, "Department"
16453, address "Business street address"
16457, address "Business street address line 2"
16454, autocap, city "Business city"
16455, allcaps, state "Business state"
16456, spell, "Business zip or post code"
16392, G0, "Web page"
16393, file, "Notes"
24594, concat, "14865, 14854"
24595, concat, "14854, 14865"
announcement order 14854, 14865
sort order 24594, 24595
___
To leave the BrailleNote list, send a blank message to
[EMAIL PROTECTED]
To view the list archives or change your preferences, visit
http://list.humanware.com/mailman/listinfo/braillenote
