AddressAccess ============= - the faster card file - Version 1.61e - 20.06.96, by Thorsten Lange, Hamburg, Germany copyright 1995-1996 Thorsten Lange and his licensors. All rights reserved. Preface ------- Just a note before we get started: This program is shareware and must be registered for only US$25 if used after a trial period of about 4 weeks. Although the functionality of this version isn't limited (only using it as backdrop is diasabled), registered users have a couple of advantages (for details see chapters "Shareware" and "Registration"). Any suggestions or error reports are welcome (even from unregistered users). My postal and email address can be found in chapter "Registration". Since English is not my native language I apologize for possible "unidiomatic expressions" and errors. So any corrections in this respekt are welcome, too. AddressAccess supplies an easy and efficient interface to the cards stored in your Newton - no more using the slow overview function to find a person's address. AddressAccess features: - Sort your cards by first name, last name or company (or as marked on the cards). - comfortable editor for easily changing or adding cards with optional non-floating keyboard - quick searching: only enter the first few characters of name you are looking for - supports NOS2.0 systems (i.e. landscape mode, backdrop and calls application) - use a lot of 2.0-names-fields (multiple addresses, custom fields) even with 1.x systems (stored NOS2.0 compatible also on 1.x systems) - Address is formatted according to the country. - Direct dialling of phone numbers without any further dialogs (after a configurable delay). - Direct beaming of cards. - Direct beaming of your card (NOS1.x: define it once, NOS2.0: owner info is used). - together with "i++" V1.10 or higher on 2.0-systems: - create a new card directly from the "i" button (without opening names or AA - fast!) - open the built-in names (usefull if AddressAccess redefines the names button) - And a lot of user-configurable options (redefine names button, select one of five different keyboards,...) Please note: the screenshots in this documentation are made using a 2.0 system. On NOS1.x they may look different. Before using AddressAccess please read chapter "configuration" carefully since the default settings do not take advantage of all features (i.e. sorting by company,... is disabled). The reason why can also be found there. I hope you will enjoy this program - so much that you will gladly register your copy :-) Installing AddressAccess ------------------------ AddressAccess consists of two packages. For Newton OS1.x (V1.11 or better) please install: "AA_OS1.pkg" und "AA_Ext.pkg". And for Newton OS2.0 please use: "AA_OS2.pkg" und "AA_Ext.pkg". "AA_Ext.pkg" ist an extension, that doesn't show up in Extras in NOS1.x. In NOS2.0 it will be located in the "Extensions" folder. It's best to install both packages on the same store. Never remove the extension while AddressAccess is open (even wait a minute after you have closed it). Functional description ---------------------- The key to efficient access to your cards is the user interface. On the screen you see at a glance: - information about a selected person - a list of cards matching a search-criterion (beginning of first name, last name or company) - a keyboard for entering the criterion Each character entered on the keyboard will be added to the search string. The list of matching cards will be updated automatically and the information about the first matching card will be displayed. Normaly only a few characters will be sufficient for finding the right card. "But there will not be enough space left for displaying all information about a person!" a critical reader might add. That's why I divided the data of one card into four parts: phone&pager&email, postal address, notes and custom fields. With just a single tap you can fast and easily switch between these display-modes. In most cases phone&email will be sufficient. Every input on the integrated keyboard will be added to the input field above. Instead of "Enter" a key for clearing the search string is provided. Or just enter a capital letter to replace the text entered so far (if this option is checked in "prefs.". There is also an option for automatically pressing the shift-key after a configurable delay) On the right side of the input field you can select what field shall be used for sorting and searching: first name, last name or company. If you select "standard" ("std.") the cards will be sorted the same way as in the built-in card file. In the middle of the screen there is a list of all cards matching the search criterion. Every time you change the criterion this list will be updated and the first card will be selected. You can select any other card of the list by tapping on its name (or switching to the next/previous with the standard arrow-keys). If there are more matching cards than there are lines, then arrows for scrolling are displayed on the right side. For a full-screen overview of all matching cards just tap the overview button. At the top of the screen the following information about the selected card is being displayed: Name, company, title (optionally), folder of the card, phone/pager numbers (with descriptions) and email address. To dial a number, tap on the phone icon at the left of it. On NOS2.0 systems there is (optionally) another button representing the "calls" application. Tapping this one will open "calls", create a new log-entry and dial the number. At the upper right corner there are "tabs" for changing the display mode: display the postal address, the note (full screen or card size) or custom fields. It goes without saying that the notes can be updated. In every mode there will be scroll arrows at the right hand side if more information is available. In notes mode these scrollers are always present to allow entering large notes. In the upper left corner there is a button for opening/closing the "Styles" dialog. Each address is formatted according to the country (if the country is missing the owner-country is used for the default format). So an American address will be city, state zip country while a german one will be zip city country The country name must be written according to the "nationality" of your Newton: On "English speaking" systems it is "Germany" while on German ones it is "Deutschland". Up to now, there have still been countries missing. So if you encounter an ill-formatted address please contact me! "i" opens a popup menu with items for opening the about box ("info box" - where you can enter your registration code) or changing preferences (see chapter "Dialing preferences" and "Configuration"). If "i++" (>=V1.10) is installed the selected additional items will be displayed, too. The "A-Z" Button toggles an additional floating button bar (on top of the bottom row of the keyboard, so it is mostly useful only if a keyboard with a space bar is used) showing the alphabet. Tapping a letter clears the input field and inserts the letter in one step. "Extra" opens a small menu which allows you to open the built-in card file (in any modes). After pressing the "New" button a menu pops up. You can select wether you want to create a new person or company card. Afterwards the editor integrated in AddressAccess will show up with a blank card (the country is filled by default with the owners country). The "action button" (envelope) allows you to beam your card (see also chapter "configuration"), beam, duplicate or delete the selected card. With NOS2.0 or higher you can also print, fax, mail or export to the notepad the selected card. Editor ------ Since V1.50 an editor is included in AddressAccess. For NOS2.0-users this editor provides a more comfortable way for changing multiple fields since you don't have to pick the fields seperately. NOS1.x users have the additional advantage that they can add fields to their names that are introduced in 2.0. The information is stored (mostly) the same way as on 2.0 systems so when transfering a card from 1.x to 2.0 this additional information will be preserved. There are three different ways to open this editor: - create a new card using the "New" button - tap on any field in the card display and the editor opens in the corresponding mode - if you have installed "i++" V1.10 or better you can create a new card from the i-menu in most applications (NOS2.0 only). Or with NOS1.x use "TapNew" V1.20 or better to create a new card from the notepad. The editor uses different modes simmilar to the card display. A button bar on top allows switching between modes with a single tap. A few notes about the editor: - Switching to an additional address is done with the "Address" picker in "Addr."-mode. - Use this picker also to add an additional address (select "new Address from the popup menu, be carefull: at the moment you can only delete an entire additional address with the built-in card file in 2.0). - In phone,pager or email mode all empty entries will be removed when you leave this mode -> To erease an entry just clear out the corresponding field(s). - The keyboard-button at the lower left corner toggles the on-screen keyboard of AddressAccess (not the floating standard keyboard). - All changes will be saved when the editor is closed or an other card is displayed. - A new card without any information will not be added (if choosing new accidentally). - The country of a new card will be set by default to the owner's country. >> Editor and NOS1.x << - Because of compatibility the type of the first email will always be set to "Email". - For an easy transition to NOS2.0 I would recommend that you enclose the dialing prefix of a phone number in brackets. >> Editor and NOS2.0 << - With NOS2.0 some input fields provide the last 8 values in a popup menu (in addition to the built-in card file zip codes are remembered, too). - At the moment no input fields support ink text (because of compatibility with 1.x). If you have entered ink data with the built-in card file it will be automatically "recognized". - Hitting "Tab" on the on-screen keyboard moves the cursor to the next input field. If necessary the window will scroll to this field. - In dates-mode you can enter birthdays and anniversaries. Here you can also specify the text that is used in dates for the note. Only if you press the corresponding "Add" button the displayed information will be written in the calendar (and an old belonging appointment will be removed). Dialing preferences ------------------- When selecting "Dialing Prefs" from the i-button a dialog will be displayed. Depending on the Newton OS version there are different options available. > Dialing prefs with NOS 1.x < At first the delay between tapping the phone-icon and dialing the number can be controlled by a slider. Radio buttons allow you to choose whether Newton shall use the built-in speaker or a connected modem for dialing. This corresponds to the settings in the built-in card file. Other options control the current area code and a dialing prefix (as in the built-in card file). Additionally AddressAccess offers the possibility of deactivating these settings temporarily (without having to blank out the respective lines). > Dialing prefs with NOS 2.x < With the first picker you can select the current owner and the workplace setting from the owner info for the right areacode, dialing prefix ... (This selection is - as usual - valid for all applications in your Newton. So this also controlls which owner card will be beamed by "Beam Me Up", if there are multiple owners defined). The next controls what service should be used to dial the number ("Modem", "Speaker" or "Telephone"=do not dial at all, usefull for logging calls without any dialing). "Dialing method" defines what should happen after tapping the phone-icon. - "AddressAccess": Use the dialing floater of AddrAcc that waits a configurable time before dialing (use slider at the bottom of this dialog to control the delay). - "Standard, direct": The built-in dialing routine is used (always waits three seconds before dialing and shows up a control pannel afterwards) - "Standard, dialog": This is the Newton-way of dialing. The standard slip will be displayed to control various settings before dialing will be initiated. If you check "Show call log button" there will be two buttons next to each phone number. The second one will open the calls application, create a new log entry and dial the number (this will always use the standard dialing method). Configuration ------------- Additional preferences can be set in one dialog box (i/Prefs.). Note: use scrollers at the right to display different parts of the settings. If you use NOS1.x and want to be able to beam your card quickly you have to define it once. Just select it in AddressAccess and press "Selected card is mine". From now on you can beam it by tapping "Beam me up, Scotty" (routing menu). Using NOS2.0 defining a card isn't necessary since the actual owner info will be transferred. Checking "Quick Start" makes AddressAccess start up a little faster but at the price of showing an empty list and no card. Otherwise a list of all addresses is shown and AddressAccess opens to the card shown when it was closed last. At next you can select a keyboard for AddressAccess. You have four opportunities (omitting the row with numbers and/or with space&option) to enlarge the display area for the list of matching cards. Note: the more lines are displayed the slower is AddressAccess while searching. By default "Capitals clear input line" is checked. So you do not have to clear the input field before entering a new search string - just start with a capital letter. Therefore "Auto-Shift" is quite usefull: After a (customizable) delay after the last character entered the "shift" key will be pressed automatically since you normally want to look for a new card afterwards. Another options is "delayed searching": If you disable this option (by moving the slider to the left edge) AddressAccess updates the list of matching cards after each character entered. Although searching is quite fast there is a delay between taps. For people who use to enter multiple characters very fast, better performance will be obtained if AddressAccess waits a little while after each keystroke for further modifications and searches only once. The delay between a keystroke and the beginning of the search can be controled by a slider. I would recommend setting the slider about one third from the left. The "Card display" can be customised, too. Checkboxes control wether to show honorifics (before the persons name) or titles (on the divider bar). And you can set the height by specifiing the number of lines (i.e. in phones mode). Note that this will be ignored when using landscape mode. With "Index/Sorting" you can install additional sort/search orders. Select the indexes you need and press "Update". Your cards will be scanned to build an index. This might take a few minutes! Since this is a procedure that modifies your data I strongly recommend making a backup before installing indexes!! Any RAM-Card (Flash) you have used, must be updated once. So insert one after the other and press "Update" again. Unckecking "Internal Store" skips the data stored internally and speeds up the process (only usefull with NOS1.x). But don't forget that the internal store has to be updated at least one time! If you ever want to revome AddressAccess completely from your Newton (I hope you never will ;-) then remove all indexes first to free up the additional memory allocated for them. Therefore uncheck all indexes and press update (and repeat this for all memory cards if you have use multiple cards). The last section offers some options for system patches: - Checking "Global search with AddressAccess" replaces the built-in card file when making a global search ("Search"+"All"). - You can modify the "Names" button: tapping it will open AddressAccess. (Hint: together with "i++" V1.10 or better AddressAccess alows opening the built-in names via the "i-menu" of most applications like the notepad). - "Detect changes by built-in card file" should always be checked until you encounter problems with other applications that modify the built-in card file. Unckecking will remove a patch but afterwards AddressAccess will not be able (while opened) to detect any changes in data automatically (changing a name or receiving a beamed card). Using AddressAccess with Newton 2.0 ----------------------------------- To provide compatibility with NOS1.x AddressAccess does support most of the new 2.0 features but not all of them. Especially group-cards and electronic ink are not fully supported (ink is displayed in the card view but cannot be entered using the editor). A future 2.0-only version will certainly address this. But there are a couple of advantages right now when using NOS2.0 together with AddressAccess: - Sorting by last name also respects the first name when last names are equal (and vice versa). - Building indexes is faster. - The routing menu enables printing, faxing,... and export of the card-data into notes - When using "i++" V1.10 or better the i-menu will be extended and on the other hand AddressAccess adds menu-items for use in "i++". - Selecting birthday/anniversary is more comfortable than with NOS1.x and dates can be added to the calendar. - Some editor fields remember the last 8 values for fast access via popup menus. Comments and known limitations ------------------------------ - You can enter any character in the search string. But searching (at the moment) is case and diacritical-mark insensitive. - Newton1.x only: Switching folders is very fast. But the fastest search results are still obtained when selecting "All Cards". - Do not remove a memory card while AddressAccess is showing an address stored on that card. You might confuse your Newton (but reset should fix this). - Duplicating a card in the built-in card file (and modifying its contents) will not be detected by AddressAccess properly. It will show the same card twice. Restarting AddressAccess fixes this. Better solution: use "duplicate" in AddressAccess! - NOS 2.0 only: When a card is received (beamed) AddressAccess will not always switch to it automatically. - NOS 2.0 only : Any folder defined locally in the built-in names app doesn't show up in AddressAccess but you can create a local folder with exactly the same name in AddressAccess to use this when filing cards. - NOS1.x: In the editor there will be no cursor displayed when only the AddressAccess keyboard is open (but the cursor is present and can be set to any location - but will remain invisible). - There have been some problems reported with Newtons running an OS older than V1.11. I cannot test/fix this since OS1.11 was the first one available in Germany. Version history --------------- V1.20e first English release V1.50e - New editor for easyly adding/changing names data. - Mostly there is no need for opening the built-in app. - Tapping on a field in card display (i.e. name, address, ...) opens the editor in the right mode -> dialing is now invoked with a special icon - A lot of additional fields (from NOS2.0) are now available on 1.x-systems (i.e. multiple addresses, pagers,...). The data is stored 2.0-compatible to allow transfer from 1.x to 2.0. - The "New" button pops up a menu for selecting the kind of card to be added (person or company) and afterwards opens the new editor instead of the built-in app. - "About-box" and prefs moved to a 2.0-like "i-button" - You can select one of fore different keyboards. - For people who use different owner names (i.e. one for business and one private) there can be now two different registration codes. - NOS2.0 only: - Export names-data to notepad. - "Beam me up" uses owner info -> no need to define a card in names - Print, fax and email support. - Sort by lastname respects also first name and vice versa. - Adding birthdays/anniversaries with a text you want. - Extents "i++" (>=V1.10) functionality: - Create a new card from the "i-menu" (without opening AddressAccess) - Open the built-in names-app (usefull if AA redefines the names button) - Supports two registration codes for different owner names at the same time - Some minor bugs are fixed (seems like I was the only one who noticed them;-) V1.55e V1.50e unfortunately had some bugs because I developed it within a very limited time frame. I hope that all are fixed by now. I'm really sorry for this! I would recommend that you reset your Newton after replacing V1.50 with V1.55 to make sure that there aren't any leftovers. The following bugs are fixed by now: - Fixed a bug that made AA throw error "-48807" on NOS1.x - If you added custom field labels with the editor then it could happen that an error was thrown when displaying a custom field. - Removing email addresses (and dates with NOS1.x) should always work by now. - The editor didn't always address the title slot properly so in some cases it didn't use the data entered in the built-in app. (Note now some titles entered with AA1.50 doesn't show up anymore) - Fixed a bug that made the built-in names app of NOS2.0 get stuck in overview mode. If you have encountered this just open the built-in app from AA1.55 (not in overview mode) and everything should be alright again. - With NOS2.0 it could happen that the cursor jumped back from the notes view to the search crit. input line. - And some other small things are changed (i.e. the divider bar in the card display isn't broken if there isn't any text to display) Because fixing bugs isn't very much fun I included some new features, too: - Card display - Titles are optionally shown (on the divider bar). - Honorifics can be displayed. - The height of the "card" can be controlled. - Tapping an empty line will open the editor in the corresponding mode. - If the country is missing in the current address, it will be formatted according the owners country. - Improved NOS2.0 support - AA now works in landscape mode. - Dialing also supports the built-in routines, Worplace settings, the calls app and more => new dialing prefs dialog for NOS2.0 only - Editor - the size of labels is adapted to its contents to prevent tapping it accidentally when writing in an input line. - the address-popup shows the second address line if the first is empty - together with "TapNew" V1.20 or higher from Ralph "Kalli" Kaiser, creating a new card directly from the NOS1.x-notepad (similar to i++ with NOS2.0) is now possible. V1.60e - AddressAccess is now significantly faster than V1.55 at some actions (i.e. startup even without using "Quickstart", searching, switching modes). - The main part of V1.60 is now optimized for OS2.0 for even better performance. - The layout has be revised for a better "look&feel" (and to be more OS2.0 like by using more icons). - The handwritting recognition in the editor is improved (especially with OS2.0). - The editor now features an optional built-in keyboard that doesn't float above the input fields. - NOS2.0: The "Tab" key of the keyboard in the editor moves the cursor to the next input field scrolling the window if necessary. - There is an option for a new, very small main keyboard. - "Auto shift" is a new (optional) feature: AddressAccess will press the shift key after a configurable delay so you can start with a new search without clearing the input field (since a capital letter clears it). - There have been some minor bug fixes (i.e. when formatting a foreign address or freezing of modifier keys when using a non-US keyboard) V1.61e - Added support for Newton Register/Kagi so you can pay by credit card, ... - Some slight changes in the layout (New and Extra buttons) - Fixed two small bugs - The keyboard wasn't updated properly when pressing the "clear button" while Shift was pressed - An error occured when adding a new card that doesn't match the search string (only when standard sorting is selected). Shareware --------- This program is shareware. So you may try it for free for about four weeks. After this trial period you have to pay a fee (US$25) if you're using it on a regular basis. Since you should be able to really try this program there are no functional limitations when using an unregistered copy (except for the fact that only registered versions can be used as backdrop)! But some people need a "motivation" to register their copy which is very easy (just put money in an envelope and send it to my address listed below) and cheap - see chapter "Registration" for details. So registered users have the following advantages: 1.) Email support for questions/problems 2.) For the present I email new versions of "AddressAccess" to registered users - if they don't have WWW access to download the latest version from my homepage http://pobox.com/~bnet/thorsten. 3.) When using this program, a notification will be displayed that you have to register your copy. The more you use this program the more often the notifications are displayed. After entering the registration code no more messages are displayed. This code also enables using AddressAccess as Backdrop on Newton 2.0 Systems. And everybody has the advantage that I will continue working on the program. You can register AddressAccess bei sending cash, using CompuServe's SWREG forum (ID 9876). Or you use "Newton register" to pay by credit card, US check, ... using Kagi. For more informations about registering AddressAccess please read the enclosed file "register.txt", check out my homepage http://pobox.com/~bnet/thorsten or just contact me by email: 101353.2024@compuserve.com or Thorsten_Lange@kagi.com Copyright notice ---------------- AddressAccess is copyright 1995-1996 Thorsten Lange and his licensors. All rights reserved. This program is Shareware - IT IS NOT FOR FREE. You are allowed to try out AddressAccess for four weeks for free. If you continue using it you have to register your copy. For more information see chapter "registration" above. Please support development of cheap and reliable software for the Newton and pay for Shareware you are using regulary! Restrictions ------------ You may not decompile, reverse engineer, disassemble or otherwise reduce the software to a human-perceivable form. You may not modify the software or the documentation. Disclaimer ---------- You expressly acknowledge and agree that use of AddressAccess is at your sole risk. The software and related documentation are provided "AS IS" and without warranty of any kind. I make no warranty of the performance of this program, expressed or implied. In no event will I be held responsible for any damages or loss as a result of using AddressAccess. When this disclaimer does not apply, my liability will be limited to the amount paid for the product. Famous last words ... --------------------- Apple and Newton are trademarks of Apple Computer, Inc., registered in the United States and other countries.