Project Viewer Readme Program build: 25EA Readme last changed: 21.05.2002 I. Introduction Using Project Viewer you can visualize projects and events in a clearly arranged manner. Heart of the program is the 4-weeks overview, where up to ten tasks or resources per category can be displayed at the same time (you can manage more of course). The tasks and resources are assigned to categories and can have their own color (only avaliable on color devices). You can select of ten different event types for the presentation of different events. The data of projects displayed with Project Viewer can be saved in DB 0.2.x-compatible tables (s. Installation section). Using the DB tools you will be able to exchange with Desktop applications. II. Installation and Usage FIRST INSTALLATION: Please see documentation file or on-device documentation for further information about the usage of Project Viewer after installing as described below. Installation: Project Viewer comes as stand-alone PocketC application (SA). You need to install ALL files located in the "First_Installation" folder via Hotsync. Execute "PV install" application from your Palm Launcher to finish installation. Memory usage: 215 kB (temporary additionally 130 kB required) Please follow the Tutorial after installation to get a first impression. HOW TO UPDATE: Install ALL files located in the folder "Update" to update your ProjectViewer (via Hotsync). Notes for those updating from a build prior 18BN (ignore at first installation): 1. Please delete any prior build of ProjectViewer before installing this new release !!! 2. Before updating from any prior build please consider the following information: - Database structure has changed! If you use DB compatible databases and would like to do so in future, please add the following fields at the end of the named databases with DB: - ProjDB Preferences : 1 field type string name proposal "T/R" usage: Task and resource diasplay switch - ProjDB Projects : 1 field type string name proposal "Color" usage: Color identifier - ProjDB Events : 1 field type string name proposal "Name link" usage: Identifier of the task/resource the event is assigned to 1 field type string name proposal "Not on WE" usage: Disables/enables the presentation of the event on weekends or holidays Notes for those updating from a build prior 197I (ignore at first installation): 1. Before updating from any prior build please consider the following information: - Database structure has changed! If you use DB compatible databases and would like to do so in future, please add the following fields at the end of the named databases with DB: - ProjDB Preferences : PLEASE NOTE: Field "T/R" has been added as of build 18BN, but has not been listed in this update section. Please append field "T/R" first as described in the previous paragraph before adding the following field. 1 field type string name proposal "AdvO" usage: Disables/enables advanced overlap recognition Notes for those updating from a build prior 19MH (ignore at first installation): 1. Before updating from any prior build please consider the following information: - Database structure has changed! If you use DB compatible databases and would like to do so in future, please add the following fields at the end of the named databases with DB: - ProjDB Projects : 1 field type string name proposal "Valid from" usage: contains first day, the task/resource can have events 1 field type string name proposal "Valid to" usage: contains last day, the task/resource can have events Notes for those updating from a build prior 1B3K (ignore at first installation): 1. Delete indices database or install the provided empty indices database ("ProjDB_Indices.PDB") before starting Project Viewer. PLEASE NOTE: As of today the documentation does not describe the functions added with build 18BN and newer - check history, on-device documentation and tutorial file instead. III. Build history E=Error correction; F=Functional change; T=Technical change; C=Cosmetic change 21.05.2002 [25EA] - E: working with more than 9 projects resulted in wrong event presentation sometimes 14.04.2002 [24EC] - E: changing an event type does result in a wrong indices update sometimes - C: info about current time, date and year were displayed at the end of the indices sorting after changes in preferences dialog sometimes 13.04.2002 [24DA] - E: created wrong memo header when creating a new memo for a resource (which has no address book entry) - E: info about current time, date and year was not shown immediately after creating/changing an holiday again 20.03.2002 [23KM] - E: validity period check for tasks/resources didn't work properly - F: creating or changing an event does now execute more often a validity period check for tasks/resources - F: time displayed in 4-weeks view header is refreshed after most actions on main screen now 20.03.2002 [23K9] - E: recently added selected day and current timeon 4-weeks view header has been shown even when category dropdown was activated - E: Totals report didn't calculate events with set "Not on weekend" parameter properly 19.03.2002 [23JB] - E: creating an event from within event list view didn't return to main screen correctly - E: week numbers haven't been displayed correctly with DMY date format setting - E: "Searching Address book entry..." message was located on top of screen sometimes - F: date output uses date format separator from PalmOS preferences ("." or "/" or "-") - F: added selected day and current time to 4-weeks view header (made week numbers bold for better recognition) - T: as Advanced Overlay is not supported on Sony Clié hi-res devices, activating this function disables Sony Clié hi-res support on next program run 17.03.2002 [23HB] - E: indices update didn`t return to main screen after creating a new event sometimes - E: "Not on Weekend" option didn't work properly on "Create Event" dialog - E: some event types shortcuts haven't been displayed in the evnt detail view (got lost in code cleaning) - E: starting/ending event hasn't been selected in event list sometimes - E: restored event selection depending on their event type group (effects event list now too) - E: restored output of MDY format to be displayed with a 2-digit year - E: changing week start in preferences didn't paint the events properly until next program run - E: in 4-weeks view displayed year depends on first displayed day now - F: added reporting function collecting all events of a task/resource and displaying its usage in days: - Milestones/normal events and Interuptions are summarized separately - values per event type and day: Mlstn = 1.0 day Prio 1 = 1.0 day Prio 2 = 2/3 day Prio 3 = 1/3 day Prio [1] = 1.0 day Prio [2] = 2/3 day Prio [3] = 1/3 day Break = 1.0 day Brk AM = 1/2 day Brk PM = 1/2 day - values of events with set "Not on weekend" flag are reduced following the expectation that they cross a weekend every 7th day and a holiday every 28th day (formula: y=x*19/28+2) - full color support - considering this all, the reporting function should not be used for serious actions like performance controlling or even billing - but it provides a good general overview - F: added reporting function displaying all events of the current event list (up to eleven at once) - F: supports PalmPrint™ for printing both reports described above - F: supports Export to MemoPad for both reports described above - F: if creating a task/resource from within a resource category its type is preset to "resource" (but can be changed) - T: uses much faster sorting and searching functions of the new PToolbox version (thanks again Joe) - T: added warning if one required database is not available (as mentioned in the readme, it is recommended to install the provided DB databases) - T: ProjectViewer requires PToolbox Library 7.2.4 now - C: texts that are too long to be displayable in full length, end with ".." now in every case - C: reduced year digits in event detail window to two if dates become to long - C: added progress indicator for the task/resource operations moving, copying, deleting and reporting 24.02.2002 [22OC] - F: lookup function for resources looks alternatively for a memo if no address has been found (and offers to create a memo if none exists for the resource) For more read PVhistory.txt IV. License Project Viewer is shareware. Thus you can test the program and check if it is of use for you before buying. The shareware version of Project Viewer has no major functional limitations against the registered version except the following restrictions: - on odd days you can only select display periods 45 day prior today if you work with more than a few tasks and resources, - the 4-weeks view title is set to "Unregistered" on every program run - the dialog backgrounds show a "Unregistered" message - scrolling within the Extended period is available via scroll arrows only - some minor speed improvements take effect for registered users only Please register via www.PalmGear.com, www.PDAssi.com or contact me via mail if you live in the EU, especially in Germany. Registration fee is $19.95 per license. V. Known Issues Following odd (but not critical!) situations might occur sometimes (no solution yet): - the preferences screen shows strange values for all settings - calling the preferences (or an edit) window does raise a "Global ref out of range" error or a soft reset - tapping at the very bottom of the event list in detail window can cause the call of a wrong event Please note: the named issues are mainly caused by tight ressources and may not occur on newer devices like Palm IIIx, Palm Vx, m500, m505 or similiar. VI. Contact Please check the homepage http://www.Project-Viewer.com for updates and support - or contact me directly via Support@Project-Viewer.com (only in German or English please!). VII. Thanks and Credits Project Viewer uses adapted versions of "PocketGui" and "CControls", the free native library "PToolboxLib.prc" and the free font database "Ants-XS.pdb". My thanks go to the programmers/creators of this softwares/databases. See reference information at the end of this document. My thanks go also to Jeremy and Kevin from OrbWorks for developing PocketC, to Maxime for developing CryptoPad (which I both used while programming Project Viewer on my daily way to/from work via Berlin suburban trains the last half year) and to the developers of PRCedit (www.individeo.net). Thank to Nelson Ferreira (nelsonf@brturbo.com) ProjectViewer is available in Portuguese now! VIII. Recommended Software I do recommend some software in the documentation file that is not owned nor developed or supported by me. Please check the following information about these 3rd party programs. DB This free (GPL-ed) program is in development, but has already a stable interface for importing/exporting several database formats - including its own. The format supported by Project Viewer is the DB 0.2.x format which is not the current one, but the tools continue to support this format. Please check http://sourceforge.net/projects/palm-db-tools/ for updates, the import/export tools and support if desired. I thank Tom Dyas for developing this software. Afterburner III I'm (of course) registered user of Afterburner III. If you get used to this hack you wan't miss speeding up your Palm even in simple applications - as you will see a difference on every action. I was lucky to be able to overclock my Palm IIIx to 45MHz and above (but above doesn't seem to add any speed) and my m505 runs on 52MHz, but has problems with font painting sometimes. Check the Afterburner III documentation! Because overclocking is not recommended by Palm Inc. and you may lose your manufacturer warranty! Check PalmGear for updates of Afterburner III - and register if you would like to use all features and support Daniel (danwee@cyberway.com.sg). X-Master This programs in general does the same as HackMaster from Edward Keyes - it manages Palm OS system extensions (aka Hacks). But it is better in some way and it is free. X-Master is required to run Afterburner III. Please check the homepage http://linkesoft.com/ for updates and support. I thank the programmer(s) of LinkeSoft. PalmPrint™ This software is required to use the recently added printing capabilities of ProjectViewer. The program is available in two versions: "PalmPrint" (including user interface) and "SCS Print Server" (no user interface, cheaper than PalmPrint). ProjectViewer requires the "SCS Print Server" for printing, but works the same way with PalmPrint. Visit http://www.stevenscreek.com/ for more. IX. Reference information DBiced - Icon Editor Modifications by me: - Changed name of the icon memo from "DATBK3" to "PVicons" - Term "DBiced" has been changed to "DBiced for PV" in all texts and menues Legal statement of the author: DBiced is free! Contact: http://www.inertron.com/ ____________________ CControls Modifications by me: - When setting the current selection (Csetcursel) in a dropdown the current shown part of the dropdown is "scrolled" down so the selection is visible (paying attention to the scroll steps). - Text fields which are longer than 80 characters raise a warning message as the getsd() function of PocketC does not support longer text - Added support for ProjectViewer icons (=two DateBk3 icons) in dropdowns (kinda slow momentary, but works) - Replaced getsd() function with getsm() function for multi-line text input without the 80 character limit (to 256) - Added color support for most GUI elements (was not that simple, as inverting a marked item does not lead to white text on blue ground) - Cdestroy() command does now delete the control completely Legal statement of the author: CControls and CEditor can be used for free. I am a freelancing consultant and these programs are part of my "active advertising". The only "price" for the usage of CControls is that you may mail me a copy of an interesting application which you have programmed using CControls (it would be great to see what can be done with PocketC and CControls). Contact: http://www.mscon.de/ ____________________ PocketGui 1.2 Modifications by me: - When setting the current selection (GSelect) in a list the current shown part of the list is "scrolled" down so the selection is visible (paying attention to the scroll steps). - Added support for hard keys when scolling through lists. - Marks only an item if one has been selected before. - Minor design adjustments for Project Viewer Main screen. - List entry interface assimilated (resistance was futile :-) - uses an internal table of Project Viewer now. - Adjusted dropdowns to show the selected value right oriented - Added color support for all used GUI elements (was not that simple, as inverting a marked item does not lead to white text on blue ground) Legal statement of the author: PocketGui comes as source code. You are welcomed to include it into any applications written for your personal use for free. If you want to use it in compiled form in an application which is sold, used commercially or distributed as shareware, you must send me a registered copy of your application. Contact: http://www.geocities.com/siliconvalley/orchard/1936/ ____________________ PToolboxLib.prc Legal statement of the author: I am making the Pocket Toolbox Library freely available to the general public. You may use it in a commercial product, but you may not sell the library. If you do use it in any publicly available commercial or freeware product, please give me (Joseph Stadolnik) due credit and please include a link to this web page in your documentation. The Pocket Toolbox Library comes with absolutely NO WARRANTY of any kind. I cannot be held liable for any data loss or damage to a system resulting from the use of this library. As for payment for my efforts, I only request that you send me a complementary copy of any software that you publicly release which uses the Pocket Toolbox Library. Contact: http://www.geocities.com/retro_01775/PToolboxLib.htm ____________________ Ants-XS.pdb Legal statement of the author: For freeware it's free, of course. Contact: http://www.rainerzenz.de/palm/alphafonts.html X. Legal Disclaimer for Project Viewer and all related documents THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING (BUT NOT LIMITED TO) THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING (BUT NOT LIMITED TO) PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, LOSS OF USE, DATA OR PROFITS; OR BUSINESS INTERRUPTION HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ***