Amiga ISO Collection

home *** CD-ROM | disk | FTP | other *** search

/ Amiga ISO Collection / AmigaUtilCD1.iso / Database / FLD-AA21.LHA / AddressAssist_Install / Manual / English / AddressAssist.doc < prev next >

Wrap

Text File | 1995-09-13 | 51.9 KB | 1,361 lines

* A d d r e s s A s s i s t Release 2.1 v40.17 (14 September 1995). The BEST address database program for the Amiga computer family. Copyright (C) 1994-95 Quarz Development / Alex H. Schneider - Shareware - * * * *** If you fail to expect the unexpected, the system will crash! *** *** Hope, I didn't! *** Introduction ************* ADDRESSASSIST is a new database program for managing addresses. But why ADDRESSASSIST??? You really might ask this question! But as always, there was one big reason for writing a new program (among many others): Many programs available in the width of the networks provided many functions, but none of them combined all my desired functions with a nice, intuitive and WB 3.1 compatible graphical user interface. This was the hour, when this program was born! Now - with release 2 - many new features have been added to make ADDRESSASSIST one of the best address management programs in the AMIGA world of computing! And more features will follow soon! The program is distributed as Shareware. See Copyright and Registration, for details about your rights and the restriction of the freely distributable version. Highlights of AddressAssist ============================ What is special with ADDRESSASSIST ? To get a short overview over the program's possibilities, read the following list of highlight features, which are among many others included: * 16 field address database including 4 user definable text fields (new in release 2: 2nd 'Name'-field and an all new 'Group'-field to distinguish up to 10 address groups) and two additional multi-line remark fields with unlimited field length in separate windows. * Very nice and intuitive user interface based on MUI (which makes it size and font sensible, 3.1 compatible) * Two types of database/record view: the database List view provides easy overview and access while the record Form view enlightens the record's details. * Ability to change the set of records to be viewed: all, only selected or unselected or view the records by group. * More than one data files can be used with ADDRESSASSIST: all database configuration - like the FreeX field name or or the Group names - as well as all specific program and printer interface setup are stored in the data files, if desirable with an icon. * Ability to define selection of records. A selection may be viewed, printed and exported separately. Powerful filters to define : field string match and group match filters are provided for include, exclude or toggle records to or from a selection. * Powerful printing-interface for output address lists and labels by providing user definable and flexible output format: output text style and format; new for release 2: user definable record field ordering and field length definitions for list printing. Ability to load and save specific printer setup. * Possibility to use the templates for simplified input of address data. * Powerful database sort feature, possibility to use several index as well as sort in up- or downward direction * Flexible Import/Export filters for ASCII files with user definable file format: new in release 2: user definable record field ordering. * Import/Export filters for TransfileSF (TM) software (for transfer data with Casio pocket computer) * Copy address data to AMIGA clipboard. For use with word processors, for example. * Easy navigation through records by a set of 'QuickAccess'-controls (known from Superbase) * Special function for removing identical records * Localized under WB2.1 and above. Built-in English language. German, French, Italian and Norsk catalog translations and empty catalog description file provided. Documentation in english, german und french!. * Works with WB2.04 and above, needs MUI v2.3 or above Magic User Interface (MUI) =========================== To provide maximal comfort, the user interface of this piece of software was designed to use MUI extensively. MUI is a separate product which is copyright by Stefan Stuntz. Based on famous BOOPSI (Basic Object Oriented Programming System for Intuition), it provides a great enhancement and possibility of standardisation of the Graphical User Interface (GUI) mainly for the user. More than that, from the point of view of the developers, it makes life much easier to provide a consistent, and so called style guide conform GUI for a software project. Use MUI in your own software projects to make you programs even better!!! See `Readme.MUI' for more information about MUI, its distribution and where to get it from. Textfield gadget ================= Since Release 2.1, ADDRESSASSIST supports textfield with more than one lines, which are implemented in separate windows. In order to use these, the textfield.gadget must be installed on your system. `textfield.gadget' is a separate product and is Copyright by Mark Thomas. The Version 3.0 of `textfield.gadget' is supplied in the ADDRESSASSIST-archive and will be installed by the installation procedure, if you wish. See `Textfieldgadget.readme' in the `gadgets' drawer for more information. What is new ************ This chapter gives a short introduction into the new features of the latest program versions. It doesn't give any information about bug fixes or other internal stuff. See History & Future, for more information about this. Release 2.1 (21.6.1995) ======================== Added 2 Remark fields ..................... Two new record fields are added to the database layout: The `Remark 1' and `Remark 2' field are of unlimited length and support multiple lines. They are implemented in separate windows. See Using the remark fields, for more information about this new feature. Added Record template ..................... ADDRESSASSIST now sports a special feature, which enables you to use a record template to create a new records with common data (Record template). Selective record view ..................... This feature is a consequence of the combination of using selections and groups with the view concept: The set of records, which should be displayed, may be changed following the criterias of selection state and group assignment of a record. See Selective record view, for more details about this interesting topic. Release 2.0 (11.6.1995) ======================== Added more record fields ........................ There are two new record fields in ADDRESSASSIST's database layout. First, there is a second 'Name'-field for use of first names or similar (the influence of public pressure! :). Secondly, an all new 'Group'-field is provided, which allows up to 10 different groups two be distinguished. Groups may be used to create selections by group using the new filter functions. Enhanced database view ...................... In release 2 there are to types of database views available: * List view for quick overview of all records currently in the database and their selection state. * Form view for a detailed information on the current record. The views are both part of the main window, implemented as MUI's page groups. You can switch between the views by using the new View Menu strip or by the new view button (`']['') on the bottom right of the main window. Preferences & preferences window enhanced ......................................... ADDRESSASSIST has now a new file structure for its preferences. There is now an own 'AddressAssist' directory in the `envarc:' assignment, which contains all program specific preferences and files. . Now ADDRESSASSIST now strictly distinguishes between program and database preferences. See Preferences, for more details about this and how to change the preferences data. Enhanced printer interface .......................... There are four new features of the printer interface. First, it is now possible to load and save the printer interface setup; i.e. you can save several of your preferred set-ups for printing labels, address list (yes, that works also now!!!) etc. separately. Second, support for *real* list printing is added: you can specify the width of each data field column in number of characters. If the contents of a field has more characters than the specified column width, data is simply truncated on output. Providing the ability to change the ordering of the record fields in printing is the third new feature (see below for more information about this). The last new feature is a simple switch, which enables you to choose whether or not to print empty data field lines of a selected data field (Many thanks to A.Becker for his suggestion). Enhanced sort interface ....................... The sort interface is only slightly enhanced by providing now index for all available record fields. Added powerful selection filter functions ......................................... To create a selection, there are two all new filter functions available now: * Field string match provides flexible pattern matching of the record field strings for adding, removing or toggling records from or to the selection. * Group match enables you to add, remove or toggle records by their group flags. The selection filters are accessible from main window's `Filter' button in the List view or the appropriate menu item in the new Selection menu. Added user definable record field ordering .......................................... You can now choose your own record field ordering for printing and ASCII import/export. This allows more flexibility in your print : f.e. you can print first names in front of family names in labels, phone numbers after address information in lists etc. If you like to import from or export to another database program, the record field ordering in the export/import file mostly differs from the one your program can read or write %) - Ask Murphy! ADDRESSASSIST solves this problem by flexible field ordering for ASCII import/export. Change ordering in the `Preferences window''s `ASCII import/export' page. Now you can easily import address data from other programs regardless what is their record field order and also number of records. Program overview ***************** Program controls ================= The main work field of ADDRESSASSIST is the big `main window', where you can recognise four different control groups: * Database View Group provides two types of database views: The `Database List view' and the `Record Form view'. This is the main working place when workung with the address database. See Database view functions, for more information about this important topic. * Database Group with the 3 buttons used for quick access to database I/O functions Database file I-O functions. * Record Group with the 5 buttons used for quick access to record edit functions Record support functions. * Record access-control Group with the 6 buttons used for quick access to a specific record in the current database. See Database navigation, for more details. There is a menu strip attached to the main window, which provides access to all available functions of the program: * Project Menu holds project (database) related functions like file I/O and printing. * View Menu provides an access to view related functions such as selection the desired view type. * Record Menu holds all address (record) related functions. * Selection Menu holds all database selection related functions. * Process Menu holds special functions like database import/export, sorting and the user preferences editor. Database format ================ The record fields .................. The ADDRESSASSIST's database provides 16 record fields, which should be enough for the most address management tasks, at home and in business. In the context of this database and the manual, an 'address' is referenced as *record*. `Salutation' length: 255 chars; useful for printing address labels `Name' `Name2' length: 255 chars each; first and last name or company name `Phone1' `Phone2' length: 255 chars each; useful for phone and fax numbers `Street1' `Street2' length: 255 chars each; street and number or additional information `Place' length: 255 chars each; post code, city and state information `Free1' `Free2' `Free3' `Free4' length: 255 chars each; user definable fields, see below. `Code' length: 255 chars; useful to distinguish between several classes of addresses by using an appropriate character code for each of the different classes. Classes of addresses may be, for example, private or business addresses and hotels, restaurants or companies. `Group' 10 Checkbox buttons providing distinction of up to 10 address/people groups. `Remark1' `Remark2' 2 multi-line text fields of unlimited length for free use (Using the remark fields). Using the user definable fields ................................ If all the given fields do not fit your needs, you can define the four `FreeX' fields to your own desire. Do this by giving them a name of your choice and then use them consequently in your database. The record field names can be changed in the `Preferences window' which is accessible through the Change preferences... item of the Process menu. Using the remark fields ........................ If your still not satisfied with data fields, there are more for you: 2 remark fields of unlimited length and an entry may consist of multiple lines. These fields are accessible in two separate windows: the `Remark Windows'. Just type text into the textfield gadgets of these windows and it will be stored with the current record in the same way the other fields are. You can open or close these windows using the Remark Window x items of the View menu. The multi-line remark fields are available only if the `textfield.gadget' is installed on your system. See Textfield gadget. Database navigation ==================== ADDRESSASSIST provides several controls for navigating through the records of the address database. They are all accessible through the buttons of the `Record access-control group' on the bottom right of the window, but may also be reached by keyboard shortcuts: `'<<'' (Shortcuts: `left' or `down' arrow); moves to the previous record. `'>>'' (Shortcuts: `right' or `up' arrow); moves to the next record. `'|<'' (Shortcuts: `shift left' or `shift down'); moves to the first record of the database. `'>|'' (Shortcuts: `shift right' or `shift up'); moves to the last record of the database. `'=='' (Shortcuts: `=', `ramiga =' or `space'); moves to a record by entering a key string to find it, see Find a record. `']['' Toggle between the two database views. From the listview gadget in the `Database List View', you can directly activate (set to current) a record by mouse click. If you double-click on a record in the listview, the view changes to `Record Form view'. Database view functions ************************ The database view section covers: Database view types ==================== ADDRESSASSIST provides two modes of database view: The Database List view and the Record Form view. The `List view' gives a quick overview over the records in the database and the possibility of quick access - by double click with mouse - to a record. The four buttons below the listview in the `Database List view' provide an easy way to access the selection edit functions (Create a selection of records). The `Record Form view' - with 13 field string gadgets, a record selection switchbox and a 10 groups field - may be used to get or edit detailed record information. This is the main working place when editing the address database. There are many ways to switch between the two views: From `Database List view', you can directly access a specific record just by double clicking on it in the list view gadget (or you may use the `'Edit'' button and the appropriate menu item in the Record menu). The use of the buttons from the `Record group' will change the view automatically to `Record Form view'. The `']['' button changes the view type easily. From the View menu, you may also use the List view or Form view items to directly select the desired view. Remark windows =============== The two remark windows contain the text field gadgets for the two `Remark' data fields. See Using the remark fields, for more details about this interesting topic. The windows may be accessed through the View menu: Use Remark window 1 and Remark window 2 to toggle availabilty of the remark windows. Selective record view ====================== In a database with a huge number of records included, one may easily fail to overview a set of records needed at the time. Therefore, ADDRESSASSIST gives the possibility to display the record selectively. Use the View menu to change the set of records that should be displayed: View all records displays all records currently available in the database. View only selected and View only unselected displays only records, which are currently selected / not selected. View by groups... opens the `Groups selection dialog' and lets you select the records, which should be displayed, by their group assignment. Use the View groups button-bar in the `List view' for a quick access to this function. Database file I/O functions **************************** The database file I/O functions are: Load/Save... project files =========================== ADDRESSASSIST stores databases to disk by default in so called project files, which can be read only by ADDRESSASSIST. Since release 2 of ADDRESSASSIST, all preferences data - such as FreeX field names, group names, current sort index and direction, current ASCII import/export preferences, current printing interface setup etc. - will be stored within the project files. You can access the project file I/O functions through * the Menu Project * the gadgets in the `Database group' on main window * as well as though Shortcuts New clears the current database in memory and you may begin to work on a new database. You will be prompted to save changes to the old database if necessary. Load... opens the filerequester window which prompts for the filename of the address database to be loaded. Then the database will be read from disk if possible. If there is already a database in memory, it will be entirely cleared. You will be prompted to save changes to it if necessary. (Shortcuts: `o' or `ramiga o') Save... writes the current database to disk with its associated filename. If there is no associated filename then you will be prompted to input a filename by the filerequester window. (Shortcut: `ramiga s') Save as... (only in Menu) opens the file requester window which prompts for the filename of the address database to be saved. (Shortcut: `ramiga a') Import/Export selection ======================== If you like to use only a part of your database in another stand alone database file, you can export a previously defined selection by using the Export... function from the Selection menu. In the same way, you can import other ADDRESSASSIST database project files (Import... function from Selection menu). When importing from a database file, only the record data will be read from the file; preferences data of the current database in ADDRESSASSIST will left untouched. Import/Export ASCII files ========================== If you like to transfer data of an ADDRESSASSIST database to or from other databases on the AMIGA (f.e. Superbase, MaxonTwist) or on other platforms (f.e. MS Access, DBase, Filemaker), you may do this by using ASCII files. In ADDRESSASSIST, ASCII files can be read/written by the Import/Export ASCII... functions in Menu Process: Import ASCII... opens the filerequester window which prompts for the filename of the ASCII data file to be imported. All records will added to the current database. Identical records may be deleted later by a separate function (`Remove redundant records...' from Menu Process), if desirable (Remove redundant records). Export ASCII... first opens a dialogbox where you can specify whether to export all records or only previously selected records (Create a selection of records) from the current database. Then you will be prompted to input the filename for the ASCII export data file. The format of the ASCII data files is as follows: The end of each record is marked by a special char, the so called `Record separation char'. The fields within a record are separated by another specific char, the `Datafield separation char'. The default chars are 'LF' (ASCII 10) for record separation and ',' (ASCII 44) for field separation. You can change the separation chars in the `ASCII import/export' page of the `Preferences window', accessible through the Change preferences... item of Menu Process. Since release 2 of ADDRESSASSIST, it is possible to define the record field ordering for ASCII import and export. If the record entries in your imported ASCII file contain less record fields than ADDRESSASSIST provides, the missing fields will left blank. On the other hand, if the imported ASCII datafile contains more record fields per record, the surplus fields will be ignored. Import/Export Transfile SF =========================== If you use a Casio SF-7000, SF-7500, SF-8000, SF-9000 or SF-9500 pocket computer for your address management and also have the software package 'Transfile Amiga SF 7000' from Yellow Computing providing the special cable for connection of the Casio to the AMIGA's serial port and the transfer program 'TFSF', you can read or write its telephone data files (*.tele) directly with ADDRESSASSIST using the Import/Export Transfile... functions accessible from Menu Process. Import Transfile... opens the filerequester window which prompts for the filename of the Transfile telephone data file (*.tele) to be imported. All records will be added to the current database. If necessary, all identical records can be deleted by the separate function Remove redundant records... from Menu Process afterwards (Remove redundant records). Export Transfile... first opens a dialogbox where you can specify whether to export all records or only previously selected records (Create a selection of records) from the current database. Then you will be prompted to input the filename for the Transfile telephone data file. As the Casio's database format differs little from the one used in ADDRESSASSIST, there were some additional definitions necessary: In the Casio SF/Transfile (TFSF) database, all datafields may have more than one line entry, each line separated by a linefeed character (ASCII 10). Comparing this to the ADDRESSASSIST database, the Phone field of TFSF may have a maximum of 2 line entries (for `Phone1' and `Phone2' field in ADDRESSASSIST) and the Address field max. 3 line entries (the first two for `Street1' and `Street2' fields and the last for the `PC/City/State' field). The 6 FreeX fields in TFSF are used as follows: The first four fields become the ADDRESSASSIST's `Free1-4' fields. The fifth field is the `Salutation' and the sixth field becomes the `Code' field in the AMIGA address manager. Database edit functions ************************ The Database edit functions are: Find a record by key string ============================ You can find a record from the current database by a key string. The program compares `all' fields of the records with the key string and returns the first record, that matches the key string. You can access this function from Menu Record or from the `'=='' button in the controls group on the main window. Set key... opens a string requester prompting you to input the key string. After accepting by clicking `OK', the database will examined for the given key and the first matching record is made the current one. The first record which will be searched is the current one. (Shortcuts: `=' or `ramiga =') Sort the database ================== The current database may be sorted by different `index' and in both `ascending' and `descending' direction. The default sort mode is `ascending' by index Name. You can change the sort mode through the Process menu. Sort database... opens the sort mode dialogbox, where you can choose the `sort direction' and select the appropriate `index'. By pushing the `'OK'' button, the database will be resorted in the desired way. (Shortcut: `ramiga r') The current sort mode is displayed in the title bar of the main window. Create a selection of records ============================== A special feature of ADDRESSASSIST is the capability to create a selection of records, which then may be treated (print, export, assign groups) separate to all other records of the database. Whether a record is selected can be seen from the star `'*'' preceding each record in the listview gadget of the `Database List view' or by the checked checkmark gadget on the top right of the `Record Form view'. All selection related functions are collected in the Selection menu. The selection edit functions are also accessible by the 4-button bar below the listview gadget in the Database List view. Add all/All selects all records of the database. (Shortcuts: `a' or `ramiga a') Remove all/None deselects all records of the database. (Shortcuts: `n' or `ramiga n') Toggle current/Toggle changes the selection state of the current record. (Shortcuts: `t' or `ramiga t') Filter.../Filter opens the `Filter' dialogbox. Selection Filter dialog. (Shortcuts: `?' or `ramiga ?') Import/Export... provides access to the selection import/export functions.See Import-Export selection.... Print... opens the `Print Setup' dialogbox, with the Selection cycle gadget (`Page setup') set to `previously selected'. Selection Filter dialog ------------------------ The `Selection Filter dialog' window consists of two main controls. At the top of the window, there is the Action cycle gadget, which lets you choose, whether to include, exclude or toggle matching records to or from the selection. Below is the Match type page group, which provides access to the controls of the two match types available: Field string match ................... The `Field string match' controls consist of a number checkboxes - one for each record field - and the actual Match string gadget for input of the string to match one or several record string fields. Use the checkboxes to indicate whether or not the match operation should be applied to a record field or not. A match would mean that the entire string `TEXT' is used up in matching the `PATTERN' and conversely the matched `TEXT' uses up the entire `PATTERN'. The match function supports the following formats in the match string: * `'*'' matches any sequence of characters (zero or more) * `'?'' matches any character * `'\'' suppresses syntactic significance of a special character * `[SET]' matches any character in the specified set, * `[!SET]' or `[^SET]' matches any character not in the specified set. A set is composed of characters or ranges; a range looks like 'character hyphen character' (as in 0-9 or A-Z). `[0-9a-zA-Z_]' is the minimal set of characters allowed in the `[..]' pattern construct. To suppress the special syntactic significance of any of `'[]*?!^-\'', and match the character exactly, precede it with a `'\''. Group match ............ Use the Group checkboxes of the `Group match' controls to indicate whether a record should match a group or not. Remove redundant records ========================= A sometimes really useful feature is the possibility to remove identical records from the current database. For example, if you use several database programs on different platforms (at home and at work) or the Casio SF pocket computer for address management: if you then like to put together all records from two ore more databases, you would have to remove all the identical records manually from the joined database. In ADDRESSASSIST this can be done with the Remove redundant records... function, which is accessible from Menu Record. Remove redundant records... examines the database for identical records and prompts whether or not to delete found identical records. When you specify to delete `All', you will not be prompted anymore. There will be a message at the end of the operation confirming, that there are no more redundant records in the database memory. Database print function ************************ ADDRESSASSIST provides a really powerful print interface which enables you to print your addresses with many (user definable) print formats for address lists or labels. You may specify all relevant parameters for text printing including, for example, how many records should be printed on one sheet of paper (very useful for label printing) or whether or not to print the record field names. For each datafield, you furthermore may specify separately whether or not it should be printed at all, which style should be used for printing and how many linefeeds should be printed after each field. All these parameters can be changed in the `Print Setup' dialogbox, which is accessible through the Print... item of Menu Project. The dialogbox consists of three pages, which are described separately: If you choose `'OK'', the program will print with the specified parameters. By selecting `'Save'', you are able to store recently changes to the print parameters without printing. Leave the dialogbox with `'Cancel''. Page setup =========== In the `Page setup' page, you are able to change the page format parameters to your desire and select, whether to print all records or only previously selected records. Selection toggles between printing `all', `previously selected' or only `current' records. Create a selection of records. Print Mode toggles between printing or not the datafield names. This is useful while printing labels, where you don't like field names as against of printing an address list. LF before address and LF after address indicate the number of linefeeds to print in front of / after the records. With Records per page it is very easy to take care of not to split addresses on two pages or to print the desired number of addresses on a predefined label sheet. Use this together with Page Length from the `Print setup' page. Set Records per page to a zero or a value smaller than zero to prevent ADDRESSASSIST from checking the number of addresses printed on one sheet of paper. Field print (new in release 2) lets you select whether to print all selected fields of a record - regardless if there is any data or not - or print only fields with data. This is useful in label printing. Record field options ===================== For each record field, there are 4 separate controls available, which make even the craziest formats for printing a record possible: Use the Checkbox to indicate whether or not to print this field at all. The Linefeed Cycle changes the number of linefeed to be printed after each record field. You can select from `no LF' up to `3 LF'. The Style Cycle changes the print style for the record field. You can choose between `Normal', `Bold', `Italic' or `Bold-Italic'. Use the Columns width text field to enter the width of each data field columns for real list address list printing. Enter a value of zero or smaller than one to add only a single `<space>' at the end of the field data (only, when no LF are selected, of course!). Record field order =================== In the listview of this page, all record fields are listed in their current print order. To change the ordering, use the `'Up'' and `'Down'' buttons to change the place of the currently active field in the listview. Printer setup ============== In the `Printer setup' page, you may select the output device: output to printer or output into an ASCII text file. When using the printer for output, you furthermore may change current printer page length and paper margins. The Printer text field shows the currently selected preferences printer driver. Change the printer driver by using the `Printer preferences' program from your workbench distribution. Page Length indicates the number of lines, which can be printed on one sheet of paper. Top Margin is the number of empty lines on the top of the paper. The cycle gadget Line Spacing toggles between `six' or `eight lines per inch'. Left Margin indicates the left margin on the paper in number of characters. Right Margin indicates the right margin on the paper in characters, counted from the left side. Formfeed print provides the possibility to choose, whether or not to send a Formfeed (FF) to the printer after each printed page. Use this switch if you have problems like always printing an empty page after f.e. label or list print. Output to toggles current print output device: `Printer' (PRT:) or text `File'. Record support functions ************************* The Record support functions include all available functions for working on and with individual records: New record function ==================== The new record function is accessible through the Menu Record or through the `'New'' button in the `Record group' of the main window. New cleans the display of the current record, after prompting you to save changes to the cleaned record if appropriate, and then activates the first string gadget for input of a new record. If you use the record template, the display will not only be cleared but filled with the data of the template. See Record template, for more details on this topic. (Shortcuts: `n' or `ramiga n') Save record function ===================== The save record function is accessible through the Menu Record or through the `'Save'' button in the `record group' of the main window (Shortcut `s'). Additionally you will be prompted automatically for the save function, either when leaving the last datafield string gadget (`Code') by a `return' or by selecting a function which would cause the loss of recently changed data. Save saves recent changes to the current record or adds a the current as a new record to the database. (Shortcut: `s') Edit record function ===================== The edit record function is accessible through the Menu Record. Edit activates the first datafield of the current record (`Salutation'), which is the same action as when clicking with the mouse on this gadget or another of `current record edit group''s string gadgets. This is useful, if the program is used only by keyboard. (Shortcut: `e' or `ramiga e') Duplicate record function ========================== The duplicate record function is accessible through the Menu Record or through the `'Duplicate'' button in the `record group' of the main window. Duplicate adds a new record to the database using the data of the current record. You will be prompted by a requester to confirm this action. (Shortcut: `d' or `ramiga d') Delete record function ======================= The delete record function is accessible through the Menu Record or through the `'Delete'' button in the `record group' of the main window. Delete removes the current record from memory. You will be prompted by a requester to confirm this unrecoverable action. (Shortcut: `l' or `ramiga l') Copy record function ===================== The copy record function is accessible only through the Menu Record. Copy copies the text data of the current record to the AMIGA's clipboard, where it can be read and used from other application. Use this to copy the current address of ADDRESSASSIST into to a word processor or a text editor. (Shortcut: `ramiga c') Set/remove group assignments ============================= There are two methods to change the group assignment of the records. Use the 10 group checkboxes in the `Record form view', if you like to edit only the current record. If you like to change similar groups assignments of several records, ADDRESSASSIST provides functions to simplify this process: Set/remove group... opens the `Group assignment' window, with a cycle gadget and a set of group checkboxes. The `Apply to...' cycle gadget lets you change the set of records (`all' or `only selected records', `current record'), which you would like to assign or remove the assignment from specific groups. Use the group checkbox gadgets to indicate which groups have to be assigned to. Record template ================ The record template function gives you the possibility to easily add new records, which have some texts in several record fields common. F.e. if you have a couple of addresses in the same town, country and of the same type, you can create a record Template with the common data, and then use the template when you create new records. The template includes all data of the record text fields, the group field and the selection field. The two remark fields are not saved in the template. The Use Template menu item may be used to check whether or not the record template should be used, when creating a new record. If it is not checked, there will be an empty record in the form view. Otherwise your template record is displayed. See also New record. Use the Save current as Template to save the current record as a Template. The data of the template will be stored in the database file and is still available after a restart or reload of the database. Preferences ************ Since Release 2, ADDRESSASSIST strictly distinguishes between program and database preferences. While the preferences data's are the same, database preferences is linked to a database file and will be saved and reloaded automatically when you save or load a database from disk. Program preferences is used when starting an new database by the `'New'' command and to save the path of the current database file. Saving the path of a database - with the new menuitem `Save paths...' in the Project Menu - file will cause ADDRESSASSIST to reload this database file automatically the next time you start the application. This might be very useful if you work mainly on only one database project. To change the database preferences, use the `Change preferences...' menu item in the `Process menu' to access the `Preferences window'. The preferences items are splitted into four page groups: * Free field names to change the names of the four `FreeX' fields. * Group definition to change the names of the 10 groups. * ASCII import/export: change the record field ordering for import/export of ASCII files as well as the `record' and `record field' separator char. Import-Export ASCII.... * Program to change program specific preferences: decide to save project files with an icon or have a save reminding requester popped up when a record is changed. There is an own 'AddressAssist' directory in the `envarc:' assignment, which contains all program specific preferences and files. These are the general preferences file `AddressAssist.prefs', the key-file `AddressAssist.key' (register *NOW* to get this one) and the print preferences files `*.ppref', which contain printer interface specific setup. See Database print function, for more details about this topic. You can change the program's data-icon by changing the icon `def_AddressAssist.info' in the ADDRESSASSIST preferences directory in `envarc:'. An icon is stored with the project file, if the appropriate switch in the `Preferences window' is set. Program history & future developments ************************************** Program history =============== * Release 2.1 (5.9.95), version 40.17: - Completed english and german documentation. - Added a french translation of the documentation and the catalogs. A big bunch of thanks go to Alexandre Sforza - Added an italian tranlation of the catalog file. Thanks go to XXXX - Pressing return in the database listview will change to the record view of the current record. - Some bugs fixed and internal optimisations. * Release 2.1 beta 1 (21.6.95), version 40.16: - Added 2 multi-line remark fields in separate so called remark windows. - Enhanced database views: now you can choose the set of record to be viewed. - Added record template function. - Some bugs fixed and internal optimisations. * Release 2 (11.6.95), version 40.15: - German documentation added and English documentation enhanced. - Norwegian catalog translation added (by Eirik Bogsnes) - Many minor bugs fixed and internal optimisations. * Release 2 beta 4 (30.5.95), version 40.14: - Record form view: Field data is now saved without pressing ENTER each time you change a field string. - Record form view: View adjusted to be height flexible - Preferences window: Auto move to next text field added. - Print Preferences: Changed pattern of print prefs files to #?.ppref instead of *.ppref - Key search: now searches a string in all record fields. - General: Check Name AND Name2 field for record addition. Now only one of the Name fields, Name OR Name2, must contain data to add a record to the database. - General: Localized Continue and MUI copyright string in AboutWindow as well as the Title/Status string. - General: Cleanup Config behaviour, separated program/database prefs data - Many minor bugs fixed and internal optimisations. * Release 2 beta 3 (23.5.95), version 40.12: - Preferences dialog: Added Save button to save changed preferences directly - Preferences: Added switch to turn off Record Save dialog. - Printer Interface: Added switch to suppress FormFeeds (FF), ignored when printing to file. - Documentation: updated - Changed preferences file format for future extensions!! - General: Added function to delete selected records. - General: Added Phone1 and Phone2 index for sorting (missing Name2 was a bug!). - General: 'Turbo' version no longer needs FPU. Why should it???? - Many bugs fixed * Release 2 beta 2 (15.5.95), version 40.11: - Bug fixed: Selection toggle button/menu no work properly - Bug fixed: List/label print field length bug fixed - Documentation: updated to release 2 * Release 2 beta 1 (9.5.95), version 40.10: - General: Added 2 new database-field: Firstname and Group field for 10 different groups - Views: Added view concept by providing 2 different views switchable in one window: database list view and record form view - Printer Interface: Added user definable record field ordering - Printer Interface: Added database field length for line list printing - Printer Interface: Load/Save individual print setup - Printer Interface: Added switch to print only used fields of an address (thanks to A. Becker for its idea) - Selections: Added powerful selection filters: field string match and group match - Some bug fixes - Sorting: Added more all sort index, except for phone fields - General: New preferences file structure, save preferences in address project files. Added support for project icon and WB-Start with project file. - Some bug fixes * Release 1.0 (26.10.94), version 38.15: - First public release. Future developments =================== This is a list of future enhancements for ADDRESSASSIST. Remember, the future of this program also depends on you, the user: register immediately and make suggestions, bug reports. * Enhance printer interface: - Adding header and footer line feature for list printing - Adding templates for printing labels and list, for more features in printing: Field titles and separators in lists, support for multi-column label sheets. * Enhance Import/Export of Transfile/Casio SF data: - Add direct read/write filters for Casio SF from serial device. (Does anybody know how to write data to Casio SF pocket computers, reading is no problem...) * Add application specific functions to the AREXX Port * Add more flexible output format, user definable, f.e. "printf"-format using specific markers * Ask for groups information when importing from ASCII * Add cycle gadget for salutation field * Add User definable format of listview * Add datatype to display AA data with tools like Multiview. * Enhance GUI with Icon-Buttons. * Add import module for DFA and probably other AddressManagers on the Amiga (for an easy cross update to ADDRESSASSIST :) ). Copyright and Registration *************************** ADDRESSASSIST is copyrighted 1994-95 by Quarz Development / Alex H. Schneider. All rights reserved. The program is distributed as Shareware. The freely distributable archive contains the unregistered version of the program. It is limited to work with only 15 records. The freely distributable archive may be freely redistributed, as long as no charges other than reasonable copying and handling fees may be collected. The program may be distributed only as originally released, in the complete archived form. No changes of any kind may be made to the ADDRESSASSIST binary, documents or archive, and I will not answer for any problems that may result from a modified binary. The suggested basic registration fee is SFr 30 (Swiss Francs), DM 30 or US$ 25 (no other currencies accepted), which gets you an entry in my database of users and a personal key file. This key file disables the restrictions of 15 records and will work with all updates of the program that will be available on the networks in the future. This key file is *personal* and definitely *not* freely distributable. You will receive the key-file immediately after I got the registration fee by email or by mail. If you also like me to sent to you a printed manual together with the newest version of the program on disk, an additional postage is necessary. See `Orderform.txt' to register or for more information about registering. Register now!!!! Thank you for supporting Shareware. Trademarks .......... Amiga, Amiga Workbench and Amiga Kickstart are registered trademarks of Commodore-Amiga Inc. Installer and Installer project icon are (C) Copyright 1991-93 Commodore-Amiga, Inc. All Rights Reserved. MUI is (C) Copyright 1993-94 Stefan Stuntz (see `Readme.MUI') for details. `Textfield.gadget' is (C) Copyright 1995 Mark Thomas (see `TextFieldGadget.txt') for details. Transfile Amiga SF 7000 is a registered trademark of Yellow Computing. All other named trademarks reference to their appropriate manufactor or seller. Disclaimer *********** THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Acknowledgements ***************** Despite all the efforts of me (the author), ADDRESSASSIST would never be what it is now without the help of several people and institutions, who should be thanked very much for their contribution at this place: * My wife and my little daughter Ramona for their patience. * A very special thanks goes to Arto Becker, Eirik Bogsnes, Kevin Kirk and Alexandre Sforza (in alphabetical order) for their great, critical beta testing and the many suggestions, flames and blames:) ! * An extra thanks goes to Alexandre Sforza, who did the great work of translating the catalogs *and* the manual to french. All those who have ever written a GNU-Texinfo file know what I mean! . * Eirik Bogsnes for his Norwegian translation of the catalog file. * Alessandro Basso for his Italian translation of the catalog file. * The SAS Institute for their excellent C/C++ compiler. Too bad they left us!! * Stefan Stuntz for his great Magic User Interface (MUI) * Mark Thomas for his more than only useful `textfield.gadget'. * Escom/AT for buying the AMIGA and last but not least Commodore for ...! Contacting the author ********************** For questions, registration, suggestions or bug reports please contact me by mail (NEW!!!!!): Alex H. Schneider Kruggasse 179 CH-5462 Siglistorf Switzerland / Europe or by email, internet (no registration): schneidr@igt.baum.ethz.ch schneida@hoggar-ether.ethz.ch or by phone (no registration): ++41 56 53 18 13 (at home, NEW!!!!!) ++41 1 633 30 40 (at work) Index ****** Contacting the author Contacting the author Copy record function Copy record Copyright Copyright and Registration Create a selection of records Create a selection of records Current record edit group Program controls Database edit functions Database edit functions Database file I/O functions Database file I-O functions Database format, overview Database format Database group Program controls Database print function Database print function Database view functions Database view functions Database view types Database view types Delete record function Delete record Duplicate record function Duplicate record Edit record function Edit record Field string match, selection filter Field string match Filter, selection Selection Filter dialog Find a record by key string Find a record FreeX fields Using the user definable fields Future History & Future Group match, selection filter Group match History History & Future Import/Export ASCII files Import-Export ASCII... Import/Export selection Import-Export selection... Import/Export Transfile SF Import-Export Transfile... Introduction Introduction Load/Save... project files Load-Save... MUI, Magic User Interface Magic User Interface New record function New record Page setup Database print function Preferences window Preferences Preferences, database and application Preferences Printer setup Database print function Program controls Program controls Record access control group Program controls Record field options (printing) Database print function Record field string match, selection filterField string match Record group Program controls Record group match, selection filter Group match Record support functions Record support functions Record template Record template Registration Copyright and Registration Remark fields, windows Using the remark fields Remark windows Remark windows Remove redundant records Remove redundant records Save record function Save record Selection Filter dialog Selection Filter dialog Selective record view Selective record view Set/remove group assignments Set-remove group assignments Sort the database Sort the database Template Record template textfield.gadget Textfield gadget user definable fields Using the user definable fields Using the remark fields Using the remark fields Views, view types Database view types