Partner Software Release Notes

Unreleased changes

(9/15/2006 Russell/Paul) Merged code from trunk - took some logging out of the Trimble stuff in the palm translator.
(9/5/2006 Thrane) Creating release branch for 3.7.11
(9/5/2006 Jaim) Enabled the distance and the angle fields. They were disabled for user input to select angle format but now it is enabled.
(9/5/2006 Jaim) Set defaults for method, linetype, and options picklists per Bill's request.
(9/1/2006 Russell) Added Staking Buddy importer for Pocket PC.
(9/1/2006 Russell) Show post-processing actions in the Field Designer all the time, not just when a Trimble GPS is configured.
(9/1/2006 Russell) Fixed HDOP and PDOP in the CollectTrimbleDialog.
(9/1/2006 Russell) Added breadcrumbs to track down the Trimble lose-the-Bluetooth-signal-and-it-locks-up bug.
(8/28/2006 Russell) Fixed a bug in the Trimble stuff where PDOP was mistakenly returning the HDOP value.
(8/28/2006 Russell) Added breadcrumbs to track down the Trimble lose-the-Bluetooth-signal-and-it-locks-up bug.
(8/25/2006 Eric) Added the ability to count unit categories across jobs (and to group them by unit category or an arbitrary header field) to the Jobs module.
(8/25/2006 Eric) Added ability to save and email count queries.
(8/25/2006 Russell) Fixed typo.
(8/25/2006 Russell) Added clipping to formatted lines. This fixes a bug where the machine locks up if it's drawing huge, million-foot lines.
(8/25/2006 Jaim) Fixed old span length bug.
(8/25/2006 Jaim) Fixed Follow Road action so it doesn't interfere with Trimble's Correct Points.
(8/25/2006 Russell) Fixed HDOP, PDOP and Satelite display bugs in the Trimble status displays.
(8/24/2006 Eric) Many changes:

New feature: Automatic record counting (jobs, service orders, outages, whatever the module is keeping track of).
The List Index now has a counts control, where you can specify the field to count (integers and picklists only) and a date field to range over (with before and after dates).
This eliminates the need to import data into Excel or Access for most simple queries. Advanced counting is still best done via Access and an OBDC connection, but this goes a long way toward eliminating that need.
Future updates will include a way to save count queries as well as (for the jobs module) counting across unit categories.
Note: Existing clients getting this roll will need to change a bit of site configuration to keep the List Index formatting clean. Open MasterInstall/PartnerWeb/config/generic/4.0/PartnerWeb/templates/custom/jobs.tpl and delete the first two lines and the last four lines. Hand copy the file to the WorkingInstall is you don't want to bother with a full update.

(8/23/2006 Eric) Picklists with a value of 0 were getting dropped by php, due to the whole 0=null issue I solved for integers back on 7/20/06. Now it's fixed for picklists too.
(8/23/2006 Eric) Admins can now view the hub's copy of a job's .job file and the archived .job file from the reports folder. These links are located in the "Report" tab for each job.
(8/23/2006 Eric) The "Partner Web Modules" page now has a link to view the Hub log.
(8/22/2006 Eric) Admins can now view the hub's copy of a job's .job file and the archived .job file from the reports folder. These links are located in the "Report" tab for each job.
(8/22/2006 Russell) Uncommented some of my code that got commented out in the merge.
(8/17/2006 Jaim) Fixed the NaN bug that was causing the "Offset Line" feature to draw weird lines. It should be working properly.
(8/17/2006 Jaim) Changed the "Survey Location" gui behavior a bit. Previously you could not click anywhere but the survey location window. Now, you can pan/zoom and do any other FieldDesigner functionality while the survey location is up.
(8/17/2006 Jaim) Turned off the "Coordinates" feature in survey location for now. Thinking that user can (and, most likely will) enter coordinates that do not make sense and corrupt the whole job. Without ample error checking, this feature is a ticking time bomb. Will revisit this later.
(8/16/2006 Jaim) "Survey Location": Now in FieldDesigner we have the ability to add locations by typing in distance and angle. An initial location must be highlighted for this feature to work. "Survey Location" button launches a gui that has several options of angle format, linetype selection, and options of creating a new location, copy an existing location, and inserting a template.
(8/16/2006 Jaim) "Offset Line": Partner now has the ability to perform offset staking from existing line/road on the map. This feature is located under "Data" tab and allows the user to input offset feet and indicate linetype.
(8/16/2006 Jaim) "Convert to Location": I have added a button to convert a station into a partner location. The station needs to be highlighted first.
(8/16/2006 Jaim) "Location Navigation": Added a picklist under "Edit Location" window where user can navigate from one location to other locations without having to get out of edit location window. This picklist consists the construction ids of all the locations in the job and selecting will load that location.
(8/16/2006 Jaim) "Front Deflection Angle Display": Now, you will be able to see the front deflection angle of a location. This will help users selecting assemblies etc. This is just a display but needs to be made sure that its showing correctly.
(8/15/2006 Paul) Fix to fileSets behavior in FileSetFrontend of map translator.
(8/15/2006 Paul) There is now a constructor for NamedPolygonSet that takes just the path; it defaults to readOnly=false. This means the original scripts will work the same way without modification.
(8/15/2006 Russell) Fixed a bug where the FD would crash on certain kinds of difficult to reproduce errors in the Trimble stuff.
(8/15/2006 Paul) Reverted hsqldb.jar to version from release branch due to speed problems with newer version.
(8/10/2006 Paul) Fixed problem with empty or null FilesetFrontend fileSets parameter; now nulls are converted to an empty list. Be aware that an empty fileSets list will behave the same as a null - it will go through ALL file sets, whereas you might expect it to go through NO file sets.
(08/02/2006 Eric) Staker2Packrat was being called before unit information was updated in the ConfigManager. I put things to the correct order.
(8/03/2006 Eric) Updated ManageUnitFields.tpl so text and layout is consistent with the other pages.
(7/24/2006 Paul) updated XMLGenerator.magik to support SmallWorld v4.
(7/24/2006 Paul) Various changes to Arc frontend testing changes with how the translator deals with annotation tables. Watch for problems.
(7/21/2006 Russell) Made the text on the CollectTrimbleDialog very, very large.
(7/20/2006 Eric) Integer fields with values set back to "0" were not making it to the hub. Found bug in Edit.php -- the check for POST values was true/false, and values of "0" were being converted to "false" by PHP. Changed check to null/notnull.
(7/20/2006) Fixed support for specified fileSets in DXFFrontend and ShapefileFrontend in 4.0 viewer.
(7/19/2006 Russell) Changed "Add GPS Location" and "Move GPS Location". They used to collect GPS points for a hard-coded 3 seconds, but now the user controls how long they collect points and how many points they collect.
(7/19/2006 Russell) Fixed a bug in Guppy where if a file was locked on the server or the client it would hang the Guppy conversation. This change could affect the Hub and the Field Designer.
(7/17/2006 Russell) Added an error message if Partner Trimble hasn't been installed.
(7/17/2006 Russell) Took out excessive logging in TrimbleDaemon.
(7/13/2006 Russell) Changed Trimble propagation. Before, all Trimble files propagated from the Field Designer to the Hub. Now, SSF files, the data that gets postprocessed, gets copied from the Field Designer to the Hub, and the CSV, the postprocessed data, gets copied from the Hub to the Field Designer.
(7/13/2006 Russell) Added an error message if Partner Trimble hasn't been installed.
(7/13/2006 Russell) Added an error message if the Pathfinder Office Export hasn't been set up right.
(7/11/2006 Russell) Added getNumberOfPositionsInFeature() to TrimbleDaemon.exe.
(7/11/2006 Russell) Made the GPS Status Window always on top.
(7/12/2006 Russell) Fixed a bug in TrimbleDaemon.get*Files() where it was crashing when the Trimble or the Export directories weren't there.
(7/10/2006 Russell) Problem with using wrong version of Java.
(7/10/2006 Russell) Satellite info doesn't work with a real GPS, so commented it out.
(7/10/2006 Thrane) Additional fixes to release notes (Russell notes from 7/5 missing).
(7/6/2006 Paul) support for dumps in Smallworld.
(7/6/2006 Paul) Forgot to remove hack to ArcInfo frontend for WindMil non-feature data.
(7/6/2006 Paul)Added two new script hooks to the field designer. BeforePrint is run right after the user presses the print button. AfterPrint is run just before the web browser is launched. Both have the variables "gui" and "job". FieldDesigner/config/partner/BeforePrint.py FieldDesigner/config/partner/AfterPrint.py
(7/6/2006 Russell) Moved GPSStatusPanel from gui to apps.MapBrowser because of JarMake dependency problems.
(7/6/2006 Russell) New TrimbleDaemon.exe.
(7/5/2006 Russell) Zoom to GPS no longer zooms when the GPS has lost satellite fix.
(7/5/2006 Russell) Added the GPS status popup window to the Field Designer.
(6/30/2006 Paul) support for pre-checkin script at FieldDesigner/config/partner/BeforeCheckin.py
(6/30/2006 Russell) In GPSSettings, changed the COM port field from a dropdown to a text field. Bluetooth drivers create virtual COM ports as high as COM40, which would make the dropdown too long.
(6/29/2006 Paul) fixed bug in SQLScripter that was causing a StackOverflowError on SQL hub interfaces.
(6/29/2006 Russell) Added a warning message to the "Create Existing Location" in the Field Designer. This was the original way to collect GPS locations, but this way does not collect postprocessing data. Field Designer warns the user and cancels the action.
(6/28/2006 Eric) Viewing the material tab while adding a new unit would give an SQL error. Locket tab to "Unit Info" and set id to zero.
(6/23/2006 Thrane) Added Maps/resources/legends/ to zip files created by ZipUpConfig and ZipAndUploadConfig.
(6/22/2006 Eric) Revision 22: The data validation scripts were trying to validate floats as integers on form submit. This has been fixed.
(6/15/2006 Russell) Merged with the sandbox/russell branch. This adds Trimble support through TrimbleDaemon.exe instead of through the Java Native Interface. It also includes the meters-to-feet conversion fixes.
(6/12/2006 Russell) Fixed several incorrect meters-to-feet conversion factors scattered thoughout the code. We now use a constant defined in ProjectionLib, and we now use US Survey Feet everywhere. This could change the following parts of the Partner system:
- In the Map Browser and Field Designer, the GPS dot.
- The Ops Manager putting ops data on the map.
- Reprojecting jobs.
- In the Palm Map Viewer, the GPS dot.
(6/12/2006 Russell) Trimble integration is ready for testing.
(5/17/2006 Russell) Fixed a bug where Field Designer jobs weren't closing because of the Trimble stuff.
(5/16/2006 Russell) Only starts the Trimble thread if Trimble support is turned on in GPSSettings.tof, because the Trimble thread was popping up error messages about missing DLL's on Windows 2000.
(5/15/2006 Russell) Merged with the sandbox/russell branch.
(5/15/2006 Russell) The TrimbleDaemon thread is initialized on every application with a splash screen. This shouldn't be a problem, but it needs to be tested.
(5/15/2006 Russell) The GPS code has changed considerably. We need to test NMEA GPS, following the GPS on the map, and staking with the GPS in the staker.
(5/15/2006 Russell) I added new fields to GPSSettings.tof, so we will have a bunch of old GPSSettings.tof files with missing values. The defaults shouldn't break an existing NMEA configuration.
(5/10/2006 Russell) More Trimble touch-ups -- position logging to find a bug.
(5/9/2006 Russell) Added Trimble settings to the GPS Config ctron.
(5/5/2006 Russell) Tested and fixed the Hub support for Trimble files.
(5/3/2006 Russell) Added working Trimble support. The Field Designer has a new action, Correct Locations, there is a new native library, PartnerWin32.dll, and there is an installer, Platform/resources/PartnerTrimbleSetup.msi, to install the Trimble ActiveX components and the ATL runtime library.
Jobs can now write SSF files as they are staked. Trimble-specific settings have been added to GPSSettings.tof to control this new behavior.

Added "Add GPS" button to the design tab. This button adds a new Location at the current GPS position and, if the user is post-processing the job, adds a point to the SSF file.
(5/1/2006 Paul) Modified Checkin process to move Trimble GPS files around. Files are stored in the Field Designer in FieldDesigner/data/Trimble/ and on the Hub in Hub/data/Trimble/. Three files are associated with each job; .ssf (original, uncorrected GPS), .cor (corrected GPS), and .csv (readable text version of corrected data). Only the SSF is copied to the hub; the others are generated by Pathfinder office and copied down when the job is checked out.
(5/1/2006 Russell) Added the first pass at Trimble support. NMEA GPS support has several untested changes.

Release Candidate 3.7.10

Overview

This is a minor release, primarily bugs fixes and a couple features for the Map Translator and Partner Web.

See the notes below for more information about the changes.

General

(5/15/2006 Paul) New version control and release process. Code and ingredients are all stored in subversion now, rather than on the Partner intranet filesystem. Expect problems until we get the release process tested.
(4/27/2006 Paul) ZipUpConfig and ZipAndUploadConfig now include Partner4.0/config/ in the zipfile.
(5/19/2006 Paul) Added more breadcrumbs to the hub log to help diagnose the disappearing notes problem.
(5/11/2006 Paul) Turned on breadcrumbs in PolylineFollower to help with Hancock-Wood label problem.
(5/11/2006 Paul) Added some breadcrumbs to the addNote facility in the hub to address the MidSouth problem.

Field Designer

Some preliminary work was done to this release for native Trimble support, however the code is not active in this release. Watch for bugs related to this however.

Map Translator

(6/16/2006 Paul) Added a new type of namer, suitable for use in RoverDatatypeNaming.tof or any of the style naming tofs. It is... PythonNamer! Once again, we take all the safety features off and give you a straight scripting solution to the problem instead of a complicated configuration method. Use PythonNamer in place of SplittingNamer or Namer. It should work in both regular and Palm translators. It works just like a PythonTransform except that you have to set a result value equal to the name. Example:
```
new com.PartnerSoft.text.PythonNamer {
  "script" = "
someValue = original.getString('someField');
someOtherValue = original.getString('someOtherField');
if someValue == 'bonk':
  result = 'blaivat';
else:
  result = someOtherValue + ' doodle';
"
  }
```
(6/15/2006 Paul) In the MilSoft translator frontend, we had some code for UCS to trace upstream to find the feeder name for each section. This never made it across to the Palm translator frontend. I have done so now. I also increased the coordinate resolution from 4-byte Java floats to 8-byte Java doubles. This might resolve some rounding issues reported by Bill Forester of TechServ.
(6/15/2006 Paul) Added ESRI shapetypes 10 (which appears to be like a PolylineM) and -1610612686 (which appears to be some ARCSDE arc type) to the SDE shape reader in the ArcInfo frontend.
(4/27/2006 Paul) Added in fields #50 and #51 to the Milsoft STD file reader in the WindMil fronted of the Map Translator. #50 is labeled "sectionGUID", since it appears to be the GUID of the section itself, and #51 is labeled "priorSectionGUID" since it appears to be the GUID of the parent section. #51 is also a GUID, but it seems to be the same for all records; perhaps it is a unique ID for the STD file as a whole, or for the version of MilSoft, or something else.
(5/11/2006 Paul) Applied a granularity reduction to 1.0 (feet) before labelling in the 3.x translator. Also enabled granularity reduction, which had been manually turned off for some reason. Be alert for bugs caused by this; I can't remember why we turned it off.

Hub

(6/12/2006 Paul) MidSouth note-disappearance bug should be fixed.
(6/9/2006 Russell) Fixed a problem with MSWestNAD83's projection. I changed scaleReduction from 1.0 to 0.99995.

Palm Tools

Partner Web

(5/24/2006 Eric, Partner Web Revision 19) Fixed a problem in verbs/Edit.php -- installations NOT using the new config manager were displaying null table cells rather than edit boxes for all string fields.
(4/26/2006 Eric, SVN 16) Added "Logged in as:" to center of header bar, as per Jody Wheeler's request.
Moved material explosion csv creation to the ConfigManager's python script, thus removing the manual step of creating the explosion from the Partner Web.
(4/25/2006 Eric, SVN 14) Aesthetic cleanup of data validation
Changed "View Unit" to grab icons and diagrams from Master Install instead of Working Install.

Added new "Import Unit/Material Breakdown from CSV File" feature to the Manage Material section of the Config Manager.
(4/21/2006 Eric, SVN Revision 12) Added "required" parameter for header fields. It's set via a checkbox in "Configure Header Fields" in the ConfigManager. Required fields are indicated in the edit form via red asterisks after the field name and a red border around the input box.
Also added client-side validation. Required fields are validated, of course, as well as checks that integers, longs, and doubles really are integers, longs, and forms. Validation happens twice: via an onChange event and an onSubmit event. Invalid data are clearly indicated.

Also tweaked CSS to indicate the currently focused inbox box.

Also fixed a bug that incorrectly set some strings to a maxLength of 0.

Picklists now show an empty option at the top of the list. Fields that are not set will appear blank, as in the Field Designer. The blanks are filtered out when the form gets submitted, so the Hub won't complain about null values.
(4/21/2006 Eric, SVN Revision 10) You can now configure the Field Designer's location header field editor through the Config Manager. You'll find it under "Manager Header Fields" => "Configure Header Tabs".
Existing installs will want to "rebuild your data from your Working Install" (right there on the same page) to import the current configuration into the database.
(4/21/2006 Eric, SVN Revision 9) Added support for maximumLength parameters for strings.
Added new "text box" data type that shows a text area rather than a text input in forms (if the maximumLength parameter is not set -- HTML doesn't support maxLegnths for text areas).

Changed the displayed data types to more human-friendly names rather than "long", "boolean", etc.
(4/21/2006 Eric, SVN Revision 8) When deleting units or picklist values, a cursory check of the jobs database is made to see if the unit is currently being used. If so, deletion is not allowed. However, the search is on the unit name or picklist value (since that is what is stored within the job). If the item is renamed, but has not yet been posted to the Working Install, the search (using the new name) finds no matches and allows the deletion to proceed. This breaks jobs.To fix, I have modified verbs/ManageUnits.tof and verbs/ManagePicklists.php to also do a check for any pending rename requests for that unit or picklist value, and if so, disallow deletion.
(4/21/2006 Eric, SVN Revision 7) Added "select all" and "inverse all" toggles to the bottom of every listing in every module.
Also renamed javascript/headerFieldProperty.js to javascript/partnerScripts.js and adjusted templates/header.tpl

Version 3.7.9 Tuesday, May 11, 2006

Overview

This is primarily a maintenance release, though it includes substantial changes to the Partner web based on feedback from Eric's class in March. The other major new feature is the addition of Trimble laser range finder support to the Field Designer

In the Map Translator, the way in which labelling works has been changed, so look out for issues with this. Also, note several issues with the Palm/4.0 translator are addressed - but as a result, the 4.0 maps produced may be somewhat larger than before on AutoCAD based systems. A work around was also added to allow 4.0 maps to be in negative coordinate space

This stable release is directly based off of beta 2006.04.18-14.40.

See the notes below for more information about the changes.

Field Designer

(3/30/2006 Eric) Tweaked page break options for Staking Sheets and other PDF reports.
Tables can now be forced to break to a new page. To use, add newpage='true' to the table's opening tag:
```
            <table newpage='true'>
          
```
Also, Repeating pages should be a bit better at pagebreaking. We had seen text, especially page titles, running on the bottom of the previous page rather than the top of its own page.
(2/17/2006 Paul) Changed the default memory usage of Field Designer to 128M. Eric reports that there is an increased number of OutOfMemoryErrors happening during staking sheet generation.
(12/20/2005 Russell) Added LaserRangefinder support to FieldDesigner. Configured in GPSSettings.tof with all the same settings as a regular GPS only with laserRangefinder prefixed to all the field names.

Map Translator

(3/31/2006 Paul) Ported support for polyface meshes in DXF files to the PalmTranslator.
(3/30/2006 Paul) Modified behavior of map translator's "keepUpright" labelling flag so that it only affects rotation, not revolution (the "autoRotate" flag).
(3/30/2006 Paul) Fixed PalmTranslator so that it can handle DXF coordinates stored in scientific notation. DXFs from microstation seem to do this. I had hacked around that in the 3.7 translator ages ago but never put it in the PalmTranslator source.
(3/6/2006 Paul) Added support for ExcelDataRecordSource to the PalmTranslator.
(3/3/2006 Paul) The transformScript property of DataRecordSource was not being set correctly, and transformation was therefore not happening. This broke the UCS "dat" frontend for 4.0.
(2/9/2006 Paul) We're leaving the translator graphic data merging feature turned off. This affects only MilSoft and AutoCAD-based maps, and only the Palm/4.0 map translator. Be alert for problems caused by map size increase.
(1/30/2006 Paul) Turned off data merging in 4.0 translation for DXF files as well. Note that this is NOT the same as DatabaseDumpMerge; it is the merging of the rover data associated with graphics that come from the same original source graphic.
(1/26/2006 Paul) Turned off data merging in 4.0 translation for WindMil maps. It was causing problems with data selection in Ozarks. I'm not sure if this will have other side effects; it will definitely increase the overall size of the mapset by around 2x.
(1/19/2006 Paul) Added a new set of parameters to the translator, originX and originY. These can be found under the "Result projection" entry. Setting these negative will allow you to generate map sets with items in negative coordinate. If you have this problem (e.g. Medina) then set it to some point below the bottom-left corner of their map. Otherwise leave it alone. You do have to have the latest 4.0 map viewer for this to work right - highlights break in older ones - and the Palm Map Viewer will likely have issues as well.
This addresses issue http://service.partnersoft.com/request/71.
(12/23/2005 Paul) Downgraded PalmTranslator message "Null attribute tag for Attribute null with default null" to an info. Still not sure why it's happening.
(12/23/2005 Paul) Fixed problem in PalmTranslator that caused the logged warning "Invalid textAlignment type: bottom right".

Hub

(4/11/2006 Paul) Forced all floats to type DOUBLE in the Jobs database to try and fix a precision error at Hancock-Wood.
(3/8/2006 Paul) Fixed a log entry in URLLib that wasn't giving the full stack trace for a NullPointerException. Also attempted to fix a likely cause for the NPE.

Palm Tools

(1/28/06) Got StakingBuddyToCSV working again. It now uses the CardDir preference, and the CSV rows it generates now match up to a Location's expected fields.
(1/13/2006 Russell) The Palm tools now support the new Palm Tungsten Tx.
(1/13/2006 Russell) Reverted the Bluetooth support in the Palm tools to an earlier version. It's not as automated (the connection dialog still appears) but seems more stable.
(12/22/2005 Russell) Fixed the meters-to-feet factor in Staking Buddy loading yet again. We were using standard (international) feet, we needed US Survey Feet, and of course they are different just to make everybody crazy. Note that any jobs loaded from staking budy using rolls between this one and 11/5/2005 are off due to this factor.

Partner Web

(4/18/2006 Eric, SVN Revision 6) In the PartnerWeb Config Manager, Added ability to control Unit Header Field placement within the Field Designer for both location and span units. Make sure your WorkingInstall is using the latest header information and "rebuild your data from your WorkingInstall" (under Configure Header Tabs) before you begin using this feature.
(4/6/2006 Eric) Fixed a bug, added a (potentially major) new feature.
(4/6/2006 Eric) First, database backups were displaying the incorrect timestamp. That has been fixed.
(4/6/2006 Eric) Second, you can now attach arbitrary files to job reports. Pull up any job in the Partner Web and click on the "Reports" tab. If any reports have been created, you'll see the report index embedded in the page (as before). Below that, there is a small uploader form, where you can upload any file off your computer into the job's reports. If any files have already been attached, you'll see a list of them. If you're a Partner Web administrator, you'll also be able to delete them. Files can be attached to a job even if the FieldDesigner's reports have not yet been created, and even if the job is currently checked out. As long as the job exists, you can throw files at it. Also, they can be of any format, even if it's the most obscure AutoCAD-generated filetype you can think of. However, just because you can attach it doesn't mean anyone else can read it...
(3/28/2006 Eric) On the heels of the successful Partner Web training classes comes a slew of UI improvements, bug fixes, and new features. Among the highlights:
- Commonly used actions are listed as tabs across the page rather than a vertical list on the upper-right.
- Duplicate header fields and header fields with empty variable names cannot be created.
- The in-place editor for field labels will not allow you to completely blank out the label
- You can now add new header fields at both the top and the bottom of the page, to save on scrolling
- New header fields are now available to the Administration Module for setting permissions and adding to queries without having to run the ConfigManager and restarting the Hub. To maintain compatibility, older systems still adding fields by hand to the .tof files will continue to need to restart the system.
- The Job Number will always be the first column in queries, and it can never be hidden or removed.
- Pre-defined queries can now be modified and saved as Personal Queries, including hiding columns.
- If you belong to the admin group, you can now edit queries directly from the Job Listings page, without having to make your way to the Admin module and then to the proper group. Look for the little pencil graphic -- click on it to be taken directly to the edit query screen for that query.
- If a Job Number does not exist, you will now be told so. Previously, it would take you to an empty "view job" screen, which was mighty confusing.
- While viewing a job, if you have the proper capabilities, you can now Sever Checkout, Regenerate Reports, Change Status, and Remove Job directly from the job view screen, no matter what head tab you are on. Additionally, the Change Status form button has been consolidated with the Apply Changes button, so you can make all of your changes at once. The Sever Checkout, Regenerate Reports, and Remove Job calls will happen after any other changes are saved, so you can make your changes and (for example) force the changes into the reports with one click.
- While viewing a job, if you are able to change the status, you will also see if the job is currently checked out, and to who.
- When creating Forms, you can now print the current date and time in four different formats:
```
$sys_time -> 08:50:55
$sys_date -> 28/28/2006
$sys_date_long -> Tuesday March 28, 2006
$sys_date_time -> March 28, 2006, 8:50 am
          
```
- To use sys_time, for example, place {$sys_time} in your document where you want the current time to be printed.
- The current system Partner Roll date is now printed within the footer of every page.
(3/6/2006 Eric) I tweaked the on-the-fly report generator (known as "Forms" in the Partner Web) to automatically pass the entire module's DataDictionary to smarty as individual variables named the same as the field name. This makes creating new reports trivially easy (no need to crawl through the DataDictionary as an array within the template).
I included a sample template in the roll (MasterInstall/PartnerWeb/config/generic/4.0/PartnerWeb/templates/custom/forms). To add a report to your jobs, open your Jobs.php module file and look for the follow lines:
```
var $forms = array (
);
          
```
In between those two lines, add:
```
  "template" => "Name of the Report"
          
```
where template is the name of the template file you created and Name of the Report is, well, the name of the report.

If you have more than one report, add commas at the end of each line EXCEPT the last.

One note: even though we call them "Forms", they are not for HTML forms that accept data. Instead, they are meant to be used as reports that are printed (paper forms) or other infrequent uses. They are created on demand and never saved, unlike Job Reports, which are saved to the filesystem and only regenerated when specifically told to.
(3/6/2006 Paul) Fixed the CSVFileBuilder so that it handles outputting backslashes correctly (you need two since it's an escape character, e.g. \\)
(3/3/2006 Eric) I've added a slew of bug fixes, new features, and general polishing to the Partner Web.
- Fixed a problem with importing unit information into the system via CSV files when the unit name contained quote marks.
- Limited unit info field names to letters, numbers, dashes, and underscores. Other characters were breaking the XML job dump files used to create PDF reports.
- Added the javascript libraries from script.aculo.us to the system, which enables AJAX and other modern "Web 2.0" behaviors.
- Added tabbed displays throughout the system using CSS. Most notable is the job view pages, where the header tabs are really, truly tabs.
- Because of the new CSS and javascript, we officially no longer support Microsoft Internet Explorer 5.0 and earlier. The javascript is (for now) confined to the ConfigManager sections of the Partner Web, so the main issue with using old browsers will be aesthetics. The system will look ugly.
- Finally, the big new feature is a system to create and edit the job view display for the partner web. Before this was controlled by hand-editing JobView.xml, but now users of the complete Partner Web Configuration Manager will be able to create that configuration using drag-and-drop controls. The ability to create, label and reorder tabs is there along with the ability to place job fields and section labels within those tabs in any order you want. Also, Individual header field labels can be edited in-place on the page without having to go to the "Manage Job Headers" page. Documentation is lagging behind, of course, but it will all be written and available for the 2006 Spring Training.
- One feature still lacking -- the job view display editing system currently only affects the Partner Web. The job, location, and unit header pages for the FieldDesigner must still be managed through their individual .tof files. Future releases will combine all of these configurations within the Partner Web Configuration Manager.
(2/27/2006 Eric) I fixed a hole in the web Config Manager that allowed a user to add location units to the span side of the filter tree and vice versa. That is, of course, bad. You can't do it anymore.
(2/23/2006 Eric) Partner Web now supports booleans, but with a twist. HTML checkbox elements do not submit a value if the box is not checked, so I had to make booleans a paid of true/false radio buttons. It's obvious when you look at it, but the GUI is different from Java's boolean control (a single checkbox). Just so you know.
Existing PartnerWeb installs need a change to the Jobs module file. You'll find it in MasterInstall\\PartnerWeb\config\generic\4.0\PartnerWeb\modules and it's called Jobs.php.

About half-way down, look for the following lines:
```
          } elseif ($newFieldType == "java.lang.Integer") {
              $newField["type"] = "integer";
```
and immediately after them add the following two lines:
```
          } elseif ($newFieldType == "java.lang.Boolean") {
              $newField["type"] = "boolean";
          
```
(2/23/2006 Eric) I re-did the javascript/DHTML calendar widget to a vastly superior one. In addition to a pretty pop-up calendar, you can also type in english and have the date magically formatted into the right format for your system (as defined in the module's php configuration file). You can try things like these:
- Today
- tod
- tomorrow
- tom
- yesterday
- 6
- 6th
- 6th October
- 3rd of Feb
- 10th Feb 2004
- 14th of Februrary
- 12 feb
- 1 ja
- next Friday
- next fri
- next m
- last Monday
- last mon
- last m
- 2004-8-8
- 2004-04-04
- 1/24/2005
- 4/26
(2/17/2006 Eric) Added fix to web Config Manager that strips out non-alphanumeric characters from (job, location, and unit) header field names.
(2/17/2006 Eric) When deleting picklist values, the 4.0 CM checks the job database to make sure no jobs are currently using that value. This worked for Job Header fields, but produced a SQL error for unit and location headers. It now checks the correct tables, based on field type.
(2/17/2006 Eric) Job Queries now have their permission group's name prepended on the Job Listings index page. Previously, users who belonged to more than one group with queries named the exact same thing (but returning different results) couldn't tell which was which.
The functionality is not backwards compatitble. Previous Partner Web installations will not break, but they won't display the group name, either. To fix, add two lines to MasterInstall\PartnerWeb\config\generic\4.0\PartnerWeb\modules\jobs.php
First, search for the line:
```
        "All" => array(
```
and insert below it this:
```
                "groups" => "Everyone",
```
Second, search for the line:
```
        $newQuery["clearAction"] = $row[7];
```
and insert below it this:
```
        $newQuery["groups"] = $row[8];
```
That will do it (after applying this or later rolls, of course)!
(2/3/2006 Eric) This is really configuration, but it will be standard issue for all future clients, so maybe it deserves mention in the release notes.
You can now view reports for multiple jobs in the Partner Web. While listing jobs, select the jobs you want to view, choose "View Reports" in the "Do the following to selected items" drop-down, and then click "Make It So". The report index for the jobs will all open in new windows. You may have to configure your browser's pop-up blocker to allow the Partner Web to spawn new windows.

For current customers, you can (fairly) easily add this abiltiy to your system.

Open MasterInstall/PartnerWeb/confog/generic/4.0/PartnerWeb/modules/jobs.php

Add the following to the top of the array of $listActions:
```
  "viewReports" =>  "View Reports",
```
Add the following function to the group of functions near the bottom of the file and change localhost to the IP address or computer name of your Hub:
```
function viewReports($context, $module, $ids) {
      global $PartnerWeb;
  require_once('NewHub.inc');
      if (!$ids || count($ids) <= 0) {
          return;
          }
      foreach ($ids as $job) {
echo "";
    }
  }
```
You can follow the example to add actions that spawn new windows to the Edit Job screens, or to specific reports, or any other web address by changing the http address to suit your needs.
(2/2/2006 Eric) Partner Web Personal Queries could break if they included a field name that was named the same as a MySQL reserved word ("group", for example). I made minor changes to how queries are saved in the database as well as how they are parsed by the PHP engine. This should fix the problem, but EXISTING SAVED PERSONAL QUERIES WILL LIKELY BREAK!
If your existing personal queries are only displaying the module's key field (job number, unit name, or material code), your queries will have to be repaired. This can be quickly done by Eric at Partner, but if you want to do it yourself, open the "queries_user" table in the Partner database and edit the "sql" column to take out the table name before each field.

For example, if your SQL column looks like this:
```
            select jobNumber,Jobs.jobName,Jobs.staker from Jobs order by ''
          
```
change it to:
```
            select jobNumber,jobName,staker from Jobs order by ''
          
```
(2/2/2006 Eric) The Job Manager now offers "subsections" within job header tabs. Before today, all of the header fields were displayed one after another down the page. Now, you can add subsection labels that will be bolded and centered across both columns. To use, edit MasterInstall/PartnerWeb/Config/Customer/php/JobView.xml
Add a new line where you want the subsection label to go, putting an asterisk (*) at the beginning of your label within the "name" field. For example, your file might now contain a tab that looks like this:
```
<tab name="Job Status">
<field name="csr"/>
<field name="staker"/>
<field name="stakedDate"/>
</tab>
```
You can add two subsection labels thusly:
```
<tab name="Job Status">
<field name="*Customer Service"/>
<field name="csr"/>
<field name="*Staking"/>
<field name="staker"/>
<field name="stakedDate"/>
</tab>
        
```
Note: A web-based GUI to build this file is planned for the near future for 4.0 ConfigManager users.
(2/2/2006 Eric) In the Job Manager View Job screens, if a non-existing field was called for in JobView.xml, no header data was displayed for the entire page. Now, invalid fields get ignored and the rest of the page will happily display. On the down side, the bug was a good way to proofread your XML for you...
(1/9/2006 Eric) Added currency formatting to GenericLibrary.xsl. Currently US Dollars are supported. To use: in the layout XML file, for the line that calls the field to be formatted, add the parameter " currency='dollars' " to have a dollar sign added in front and two decimal places added. Formatting (but not conversion) for Pesos, Pounds Sterling, Euros, and Yen available upon request.

Version 3.7.8 Tuesday, January 10, 2006

Overview

This is primarily a maintenance release, most notable for the changes to the Map Translator supporting the 4.0 translator and viewer.

Config Manager

(10/27/2005 Paul) Removed two customer-specific scripts, ConfigManager/resources/scripts/DumpMaterials.py and ConfigManager/resources/scripts/MaterialsToCSV.py, from the roll.
(10/28/2005 Eric) Fixed queries to filter out null dates when a "before" date or "after" date is specified.
(10/28/2005 Eric) Added a new PartnerWeb module for installing the v4.0 map viewer. The first time it's used, manually go to http://hubaddress/NewPartnerWeb/V4Installer That first time, it will add itself as an installed module and will then be available on the PartnerWeb homepage -- http://hubaddress/NewPartnerWeb Its permanent address (for redirects from other pages and apps, etc.) is http://hubaddress/NewPartnerWeb/V4Installer
(11/8/2005 Eric) Fixed a problem in the conversion script to the new Config Manager that left units with commas and quote marks in their names out of the filter tree.
(11/4/2005 Eric) I changed ConfigManager/resources/scripts/PostConfigFromDatabase.py. It was ignoring associated unit quantities, setting them all to one. It's fixed now.

Field Designer

(9/28/2005 Paul) ValidateLocation.py now has access to the staking application via a variable named "staker". This is an instance of com.PartnerSoft.apps.Staker.FieldStaker.Staker. Jaim specifically needed to tell if the script was running on a location in a template... here is how you do that:
```
editingJobTemplate = staker.controls.getJobFileCard().isEditingJobTemplate();
editingHeaderTemplate = staker.controls.getJobFileCard().isEditingHeaderTemplate();
if editingJobTemplate or editingHeaderTemplate:
  ....
        
```
(10/13/2005 Paul) Fixed a bug with ValidateLocation.py processing that was closing the EditLocation dialog even if the script failed.
(10/13/2005 Paul) The "Copy units to location" action now pops open a confirmation dialog listing the items to be copied.
(10/13/2005 Paul) Made the new copy units popup behavior configurable; you must put the following line in StakerConfiguration.tof to enable it:
```
"mapCopyPopups" = true;
```
(10/27/2005 Eric) Added date formating library to GenericLibrary.xsl. To use: Set a default date format for the document in the top section of the staking sheet format tof file (where margins, etc. are set) by adding the line "default-date-format='MMddyy'", where 'MMddyy' is the desired date format (Java-style). In most cases, the format found in DomainConfiguration.tof should be used. If a default is not set, MMddyy will be used. For the date field, in the line that calls the field either add the parameter "date='true'" to use the default format or "dateFormat='MMddyy'" to set a specific format for that field (again, Java-style). This allows you to have different fields to use different formats, as NISC often does.
(11/4/2005 Russell) The meters-to-feet constant in the staking buddy importer was off by just a wee bit. Enough to matter at South Plains, though. Fixed.
(11/18/2005 Eric) Added option to grid-style staking sheets to print only the span length for a given span unit, ignoring the footage field. If "Add Span" is not checked, it will use the footage field and ignore the span length. To use, add " quantity='spanFootage' " the the column's XML definition.
Previous undocumented options include:
- 'false' (prints only the unit)
- 'only' (prints only the quantity)
- 'wireNumber' (prints the quantity in parens followed by the unit)
- 'wireSpan' (prints only the total footage)
The default when nothing is specified is 'wireNumber' when the quantity is less than 1000 and 'false' when the quantity is greater than 1000.

These options are only used on grid-style staking sheets.

Map Viewer

(10/24/2005 Russell) GPSSettingsCtron.tof now has a fix that allows Bluetooth GPS users to configure their GPS devices with the GPS Settings configurator, whereas before they had to edit GPSSettings.tof by hand.
(11/16/2005 Paul) Added a configuration option to control the minimum distance at which polyline vertices are placed during automatic drawing via GPS in the Map Viewer. The configuration setting is in GPSSettings.tof, named "autodrawGranularity". It is a floating point number greater than 0, defaulting to 100. The GPSSettings GUI has a control to edit it. This addresses feature request http://service.partnersoft.com/request/34.

Map Translator

(10/10/2005 Paul) Fix to the DataRecordSourceFrontend in the Palm Translator.
(10/13/2005 Paul) The 4.0ConvertMapsAndPack now launches a separate GUI so the user has some idea it's working.
(10/13/2005 Thrane) Additional changes to 4.0ConvertMapsAndPack to support headless, scheduled execution.
(10/19/2005 Paul) Fixed a problem in the palm translator with long text strings from ACAD not beging truncated to 255 characters.
(10/24/2005 Paul) Extremely speculative fix to the connectivityPosition for locations; this tries to order the traversal "tap-first", by first choosing branches that have the fewest downstream locations.
(10/31/2005 Paul) Fixed bug in PalmTranslator where it wasn't adding xrecord- fields for EPE mapset.
(11/1/2005 Paul) Added a new switch to DatabaseDumpConfig. If you set "copyToMapset" to true, then the 4.0 ConvertMaps utility will convert the database dump from MapTranslator/data/DatabaseDumps/DumpName.dump to Partner4.0/maps/Background/lookups/DumpName.packrat. This lookup object can then be used in scripts in 4.0 to support one-to-many data relationships and other hacks.
(11/3/2005 Paul) Fixed a problem with merged find items generating a black entry.
(11/7/2005 Paul) Fixed a NPE in the Palm Translator config converter.
(11/3/2005 Paul) Modified behavior of find item generation in 4.0 translator. Since find items now map a name to a data item, rather than a name to graphics as it did in 3.7, it doesn't make much sense (and causes problems) to specific individual pieces of a merged data item to include in a find item. This only occurs in cases of merged data, which is only currently done in AutoCAD and WindMil mapsets. For example, a block explosion will generally create a point object and a polyline object for each block insert. These are then merged, but if only points are included in the find item, strange things happened.
SO, now the 4.0 translator TOTALLY IGNORES the "includePoints", "includePolylines", and "includeText" switches in find item configuration. It ONLY includes things in a find item based on their datatype.
(11/17/2005 Paul) Kludged support for Greystone-style multi-nomenclature in the PalmTranslator. Basically I toss the config away, since nomenclatures are configured with scripts in 4.0 anyway.
(11/17/2005 Paul) To deal with multiple, disjoint sets of geometric connectivity (e.g. different layers for different scales in AutoCAD), I've added a new control field, "partnerConnectivitySet". This can be set to any desired string, but does nothing other than distinguish geometric junctions. For example, for one set of primary lines you can set this to "A", and for the finer detail ones you can set it to "B". The nodes from two connectivity sets will never be connected with each other.

Hub

(11/2/2005 Paul) Removed the SEDC socket scripts from Hub/resources/scripts on Bill's request. We'll maintain them as individual config henceforth.
(11/17/2005 Paul) Added a new property to all ExternalInterfaceModules. The property is named "doNotExportField", and should be set to the name of a JobInfo field of type java.lang.Boolean. If the value of this field is true for a given job, then that job will not be sent/written/whatever. A log message is entered noting this fact.

Palm Tools

(12/8/2005 Russell) More robust Bluetooth handler in Staking Buddy that handles intermittent Bluetooth connections and handles the Palm turning off and on.
(12/8/2005 Russell) Added Laser Rangefinder support to Staking Buddy.

Partner Web

(12/4/2005 Eric) Fixed a recently-introduced bug in the Partner Web that prevented columns in Personal Queries from displaying properly. Symptom was only the KeyField would appear (Job Number, Unit Name, etc.). Now all specified columns will show.
(11/18/2005 Eric) Added Boolean support to Headers Fields portion of the 4.0 Config Manager.

Version 3.7.7 - Tuesday, September 27, 2005

Overview

There are three major enhancements in this release, along with the usual sackful of bugfixes.

We have done a complete rewrite of the configuration manager, converting the interface to a web-based version. The new Config Manager is easier to use, and allows direct editing of many of the supporting configuration data required by accounting and mapping interfaces. It also has better import and export mechanisms. Eric has also put some finishing touches on the 4.0 Partner Web.

The Palm Tools have undergone substantial enhancements, including real-time pan and zoom capability in the PalmOS Map Viewer and improved support for the various models of Palm-compatible computers and the even wider variety of GPS devices.

The other major enhancement is less visible, but critical to version 4.0 map viewer deployment. We have made many changes to the Palm Translator (aka 4.0 translator), to generate electrical connectivity, allow multiple legends, and do various housekeeping duties for version 4.0 installations.

The remaining changes are mostly bugfixes and minor features. We are now devoting most of our development effort to version 4.0, so we are doing our best to simply keep the version 3.7 codebase stable.

Config Manager

(8/13/2005 Eric) This release contains a web-based replacement for the old Configuration Manager. All Partner Systems installed since May 2005 will use this as the default CM. Partner Systems from prior to May 2005 will continue to use the old system unless a pressing need requires a conversion. Conversion is fairly simple, but should only be done with assistance from Partner Software. Once a system is converted, it cannot go back. Full documention for this new Config Manager will shortly be available from Partner Software.

This release also contains the 4.0 Partner Web. Some Partner Systems have already been using it, but this release moves some of the configuration files. Consequently, customers using the 4.0 Web who apply this roll should create a 4.0 directory in MasterInstall/config/generic and move MasterInstall/4.0/system/hub/PartnerWeb and MasterInstall/4.0/system/hub/php to this newly-created directory before applying the roll.

Finally, this release contains some transitional files needed for those moving to the 4.0 Map Viewer. If this does not apply to you, propagation with this roll will break. To fix, delete MasterInstall/4.0TransitionPackage.
(8/24/2005 Eric) Fixed the 3.0ConfigManager JavaApps entry.
(8/18/2005 Eric) Modified some python scripts in the web-based ConfigManager to fix MySQL connection problems.
(8/18/2005 Paul) Fixed the ConfigManager playpen loader so that it will resolve associated units in the associated units list of playpen unit files from their String names. They are normally stored as pointers, but that is much more complex to output from the web-based one.
(8/12/2005 Paul) Fixed lookup-fixing update scripts so that they ignore files other than .tof or .job.
(7/21/2005 Paul) Added ImportUnitInfo to JavaApps. If you want to add it to a stable roll just add the line:
```
ImportUnitInfo           com.PartnerSoft.apps.Staker.ctron.UnitInfoImport
```

Palm Tools

(6/15/2005 Russell) New version of the Palm Map Viewer:
- Realtime pan and zoom enabled for ARM devices, i.e. the T5 and the Garmin.
- High-resolution support. Most high-resolution devices are also ARM devices.
- Added scrolling informational messages during startup so the user knows what's going on.
- Added a 'Copying from card' message if the Map Viewer copies a more recent version from the card.
- The Bluetooth GPS no longer connects automatically. Instead, when you click 'Connect Bluetooth GPS' it connects to the last known device. This increases the startup speed and makes it easier to switch between Staking Buddy and the Map Viewer.

Map Translator

(9/8/2005 Paul) Added support for shapefile types POINTM, POLYLINEM, and an unknown 3-coordinate type with code 9. Also fixed POINTZ, which didn't seem to be skipping both the Z and M coordinates (this may never actually be a problem in practice). Both translators should have this now. This affects shapefile and ArcInfo frontends.
(8/31/2005 Paul) Added new app, 4.0ConvertAndPackMaps, which takes care of automating some housekeeping things when translating and posting 4.0.
(7/28/2005 Paul) Palm translator now adds a field "partnerConnectivityJunctions" containing the list of junctions identified for an item (including those generated from geometry). For debugging purposes.
(7/28/2005 Paul) Palm translator now retains the data object for any item participating in connectivity, regardless of whether the graphic is discarded (e.g. due to extreme shortness).
(7/25/2005 Paul) Twiddled the Palm translator connectivity granularity to allow ridiculously small granularity.
(7/22/2005 Paul) In the Palm translator connectivity generator, used a set instead of a simple list to store junctions; this will prevent a graphic from being in the same junction more than once.
(7/22/2005 Paul) In the Palm translator, polylines with connectivity now list all of their vertices as potential connection points. This should fix at least some of the NISC cases.
(7/21/2005 Paul) Fixed serious bug in extents trimming in PalmTranslator; if you didn't have extents set it deleted the entire map set.
(7/21/2005 Paul) Added an old kludge from the DXFTranslator, block-to-line conversion. We used to use this to convert Cumberland's strange lines (which are really a rotated and scaled block insert) to a regular polyline, back when we didn't have block explosion capability. Now it becomes useful again since we need regular lines to do geometric tracing. To configure, create a file MapTranslatorc/config/preferences/DXFBlocksToLines.tof like this:
```
{
   "BLOCK1" = 100,
   "BLOCK2" = 200
}
```
The numbers are scaling factors; don't ask me.
(7/14/2005 Paul) Extent limits on LODs were not supported in the Palm translator. Now they are, but it's probably broken.
(7/14/2005 Paul) Fixed behavior of the Palm translator so that it handles the labelling case where you do not set an explicit style name for a label. It should default to using the regular naming if you do not specify one.
(7/14/2005 Paul) Fixed a bug with the partner_geometryLength field missing in the Palm translator. Note that this field only exists for ArcSDE translations, as it is a simple copy of the "len" field from the feature geometry table.
(7/8/2005 Paul) Fixed a problem with find item generation where it broke if the find item name had spaces as a prefix or suffix.
(7/8/2005 Paul) Fixed some holes in the Cog framework that were messing up Namings with indexes that had slashes in them. This was a problem for map legends that had graphic types with slashes.
(6/16/2005 Paul, Thrane, Bill) Fixed connectivity generation so that it allows both geometric and explicit connectivity models to connect. You have to set the variable partnerConnectivityMethod to "both" if you want this behavior.
(6/16/2005 Paul, Thrane, Bill) Numerous infrastructural changes to support propagation of 4.0 on map viewer-only sites and within the existing 3.7 system. Changes include:
- Added MapTranslator/resources/lib conatining 3 batch files
- Added Apache to map translator roll zip file.
- Added 4.0TranstionPackage.
- Added startApache and stopApache batch files
- Added Apache/resources/service folder and subs
- Added
```
4.0ConvertMaps      com.PartnerSoft.tools.ExecSystemCommand MapTranslator\resources\lib\4.0ConvertMaps.bat
4.0EditConfig       com.PartnerSoft.tools.ExecSystemCommand MapTranslator\resources\lib\4.0EditConfig.bat
4.0MapViewer        com.PartnerSoft.tools.ExecSystemCommand MapTranslator\resources\lib\4.0MapViewer.bat
```
  to javaapps.txt
(6/10/2005 Paul) Fixed connectivity generation in the Palm translator so that sources are treated as primary devices - i.e., that all primary lines are considered to go through the source rather than around it.
(6/10/2005 Paul) Finally, a way to generate additional map legends for the 4.0 map viewer. It's an enormous kludge, but at least it will let people do it.

An example is probably the best way to document. We'll make a new legend called "Electrical" that's going to have the landbase turned off.

First, you need to make new entries in their customer JavaApps.txt file like this:
```
ElectricalViewerConfig     com.PartnerSoft.apps.MapBrowser.rover.RoverLegendCtron -n Electrical Maps/resources/
ElectricalMapControlCtron  com.PartnerSoft.apps.MapBrowser.rover.MapControlCtron -n Electrical Maps/resources/
```
Then, add the apps to your TranslationControlGUI.html as usual.

They should then run just like the regular and palm legend configuration apps. Run them to get a default copy at least.

Everything else should be automated. The Palm translator will convert and generate the new legends, and the 4.0 ConvertMaps will move them in.

In the 3.x filesystem, our example will be stored in Maps/resources/legends/Electrical/MapControl.tof and Maps/resources/legends/Electrical/RoverLegend.tof.

Field Designer

(9/15/2005 Paul) Fixed error that occurred when trying to create a location in the staker from a GPS location pointer. The error was caused due to the deg/min/sec format of the latlong data in the pointer; I've added "Dec. Lon" and "Dec. Lat" displays as well and this is what gets copied into the job.
(8/31/2005 Paul) Made some changes to the behavior of ValidateLocation.py to support modifying the list of units inside the script.
(6/13/2005 Paul) Fixed a problem with copy units, where the staked unit info wasn't cloned properly, and changing a value (e.g. phase) on a unit on one location also changed it on another.

Hub

(8/4/2005 Paul) Fixed problem with nulled and zeroed dates not getting set correctly in the jobs database. This is a weird problem; the Java date parser deals strangely with dates like 0/0/0 and seems to interpret them as being in the year -1898 or the year 0002 or both. I've kludge it to report an SQL NULL for any year less than 100, sorry for folks trying to track staking jobs in Roman times.

Other

(8/18/2005 Paul) Changed a scaleReduction in Projections.tof from 1.0 to 0.99995, to fix a 10-meter error in GPS projection.
(8/12/2005 Paul) Added JDOM library; this is an XML reading library.

Version 3.7.6 - June 7, 2005

Overview

This release is primarily a large collection of bug fixes and minor enhancements. The biggest exception to this is the Palm Translator, which has undergone major revision to support the 4.0 Map Viewer, and to fix a number of outstanding issues with the Palm map set, especially with regard to labelling.

We now support a major new facility, unit explosion to material. This is useful for customers (generally municipalities) that have no work order system or whose work order system does not do parts explosion or warehouse picklist generator. However, other customers may find it useful as an adjunct to their accounting system. We also now support detailed costing based on material breakdown; however this requires extensive configuration so we do charge extra. Contact Andrew for details.

The Palm tools have greatly improved, both in speed and useability. We now support a wider number of PalmOS-compatible devices and GPS units.

The Config Manager application is migrating to the Partner Web; the majority of its functions (unit and picklist editing) are already implemented as web controls.

The Field Designer has gotten several new features, especially in its reporting capabilities.

Primarily, however, we have endeavored to make this release a solid foundation for the migration to 4.0. The Hub supports 4.0 web-based propagation, and the Palm Translator supports the new connectivity and dynamic tracing feature in the 4.0 Map Viewer.

Compatibility and Upgrade Warning

A few of the changes in this version will cause upgrade problems unless additional configuration is done.

ArcInfo users, especially Origin GIS, may be affected by a change in the way ArcInfo domain values are handled. We were passing them through before as codes, and now are handling them properly as names. This may affect field values such as phase. Transforms and some other configuration may have to be modified to address this. Contact Thrane for details.

The Palm Map Viewer and translator now support custom Palm icons. This is a great new feature, however by default it will use the same icons as the desktop version, which can look pretty terrible on the Palm. Fixing this is a simple matter of assigning more appropriate icons in the Configure Palm Viewing application. Contact Thrane for details.

New Features

Map Viewer

(12/3/2004 Paul) I've added some more hotkeys to control map viewer functions, per a request from Wade Glass (Delta EPA). The functionality isn't as good as I'd like; I believe what Wade wants is an almost completely keyboard-driven interface and that has proven surprisingly hard to do with the 3.x map viewer software. I'm going to spend some time with the 4.0 map viewer and try to get it right for that version. However, there are now the following keystrokes:
- [Home] - recenters on the keymap at zoom 0
- [ctrl-d] - shows view data tab
- [ctrl-f] - shows find item tab
All hotkeys only really work when the map view has the "focus"; back when I first implemented hotkeys I fixed the map view so that it grabs the focus whenever the mouse moves on the map, which is a little strange, but seems to work better than not doing so. There must be a better way to handle this so I will look into it further. So if hot keys aren't working, move the mouse over the map and that should fix them.

Field Designer

(4/22/2005 Paul) Added a new property to Location, "connectivityPosition", which is a string index you can use to sort locations based on their relationships and takeoff location. The current format is the takeoff location's constructionID, the takeoff location's index number (which may change from sort to sort), and the index number of the individual location (which may also change from sort to sort), separated by dashes. Don't depend on the format to be meaningful, though. This should allow sorting where each takeoff's children are listed separately, and that the order is more or less from the takeoff to the end of the line, separated by branching etc.
This property is only updated when you save, print, or regenerate reports. It is saved in the job file but may not be accurate if other nonsense has happened. You may need to add an entry to BuiltinLocationFields.tof to see it in the XML staking sheet file.

(3/18/2005 Paul) Added nomenclature to available variables in SaveJob.py. Use thusly:

          from com.partnersoft.graphics import Coord3D

          name = nomenclature.nameFor(Coord3D(x, y, 0))

(3/3/2005 Paul) Added addSpanLength, specifiedQuantity, and footage values to SpanUnits in the XML staking sheet.
(2/17/2005 Paul) Added the ability to use a MappedTranslator in an interface to lookup another different field value. This is fairly complicated, and specific to things like the CADP interface. Here is an example that should be close to what we need for Dixie. Whether it's useful for anything else, I have no idea. This is not a general template facility; it only works if you just use the backtick field, and the backticks must be the first and last things in the string or it will use the string literally.
```
          new com.PartnerSoft.apps.Staker.interfaces.FieldTranslator {
              "fromName" = "unitAggregate.status.name",
              "toName" = "Const_Acct"
              "translator" = new com.PartnerSoft.apps.Staker.interfaces.MappedTranslator {
              "mapping" = {
                            "New" = "`job.header.jobInfo.newConstAccount`",
                            "Existing" = "99999",
                            "Retire" = "`job.header.jobInfo.retConstAccount`" }
              }
        },
        
```
(1/13/05 Paul) Added new map data action to staker. "Copy Units to Location" is the same as "Copy To Location" plus it copies any Span Units or Location Units. It also copies any location info fields, just like "Copy To Location".

Palm Tools

(2/3/2005 Paul) Palm Updater now manages two required configuration files, MapViewer.xml and StakingBuddy.xml. These are used to set configurable data collection fields. These are copied to the card in the /partner directory. It will first look for each file in Shared/config/customer/palm, and if it's not in there, it will copy the default ones from Shared/config/generic/palm (supplied in this roll).
(1/4/05 Paul, Russell) PalmOS icons.prc file is now dynamically generated in the Map Translator from real icons. This allows custom icons to be used. However, be aware that you may have to tailor the icons used in the Palm legend to look good on the Palm. I also changed the PalmOS installer so that it does not copy the icons.prc from generic Map Translator, and the PalmOS Map Viewing config so that it points at the normal icons in Maps/resources/icons/standard and Maps/resources/icons/custom.

System Hub

(4/20/2005 Paul) New field "strictJobManagement", in DomainConfiguration.tof. If "strictJobManagement"=true, the Hub's behavior changesso that it doesn't let a lot of things slide that we've allowed over the years. For example:
- you cannot renumber a job to replace a "new" job. This is otherwise allowed (e.g. to allow renumbering a job to match an existing new SEDC job).
- you cannot checkin a job at all if if is not specifically checked out to you. We waffled a good bit on this issue before, but now we have a switch to control it.
- you cannot add a job whose number already exists in the Hub. This was allowed previously; it could happen e.g. during FieldDesigner checkin if you first removed the checkout receipts from the bottom of the job file.
(2/11/2005 Paul) Added a unit filter tree report to the Config Manager. It's generated along with the orphaned unit and unit reports from the Location Units and Span Units edit screens. Ugly but functional.
(2/4/2005 Jaim) Improved handling of material explosion configuration. Includes a new app, MaterialsXMLToCSV, and changes to the Config Manager GUI, ConfigManager/resources/scripts/DumpMaterials.py and ConfigManager/resources/scripts/MaterialsToCSV.py
(2/4/2005 Paul) XML staking sheet file now includes staked unit info fields.
(2/1/2005 Paul) Checkout receipts now includes the name of the interface responsible, or "UNKNOWN" if not known.

Operations Manager

(4/26/2005 Paul) Backported current version of Hunt Turtle TS2 interface from 4.0 to 3.7. Adds additional fields and fixes some problems.

Map Translator

(4/18/2005 Paul) Added connectivity generation to the Palm translator. See http://developer.partnersoft.com/wiki/index.php?title=Connectivity for details on configuration.
(5/16/2005 Paul) Re-enabled map data combining. This is intended to remove duplicate copies of data items when the graphics for that data item have been exploded or scattered in some fashion (e.g. DXF block explosion). It should make the Palm/4.0 map set smaller.
This time it is sensitive to how data enters the system - it only combines things that originated as a single object in the original GIS. For example, the WindMil frontend generates one point and one polyline object for each WindMil STD record. If they are left with the same datatype and output data, they will match and be merged. However a different line in the STD file that happens to have the same viewable data will not be merged. As another example, if the data is left alone and consistent for all parts of an exploded DXF block, the pieces should be merged together as one highlightable data item as well.
(4/26/2005 Paul) Implemented connectivity generation for explicit connectivities, based on the fields partnerConnectivityID and partnerConnectivityConnections.
(4/22/2005 Paul) Added additional logging to indicate number of nodes and junctions during connectivity generation. Also, a warning is issued for nodes with more than 10 primary or secondary nodes.
(4/22/2005 Paul) The granularity for geometric connectivity generation in the PalmTranslator is now configurable. Set the field "connectivityGranularity" in MapTranslator/config/preferences/4xConfig.tof like so:
```
{
  "texelBitSize" = 16,
  "connectivityGranularity" = 1.0
}
```
The default is 1.0.
(4/22/2005 Paul) The MilSoft frontend now propagates the value of feederName out from the substation breaker to all downstream nodes.
(4/14/2005 Paul) Placement of devices in WindMil, and leader line behavior, is now configurable, albeit in a pretty obscure fashion. To configure, edit the WindMilFrontend section of your MapTranslator.tof and add the following fields. You only need to override the ones you want to change. By default, all symbols are not placed at source (value = false), but the behavior of snap is weirder. Anyway, to modify the values for transformer (section type 5), do this:
```
"positionSymbolAtSource" = {
     "5" = true
     },
"snapLeaderLines" = {
     "5" = false
     }
```
The following is the current default configuration for snapLeaderLines:
```
 "snapLeaderLines" = {
      "0" = false,
      "1" = false,
      "2" = true,
      "3" = false,
      "4" = true,
      "5" = true,
      "6" = true,
      "7" = false,
      "8" = false,
      "9" = false,
      "10" = true,
      "11" = false,
      "12" = false,
      "13" = false
      },
        
```
(3/22/2005 Paul) WindMil frontend now automagically loads results data from a .RSL file of the same name (and in the same directory) as the .STD file. If the .RSL file is missing, doesn't worry about it. It merges the data in with the same names as those in the first line of the .RSL file. I've implemented this as single-pass, since it looks like the records are in the same order in both .RSL and .STD. I realize this may not be robust enough to depend on, but if it does work out it should be much more efficient than dumping the CSV to a DatabaseDump. I did put in some verification to make sure that it complains if the records aren't in the expected order.
(3/21/2005 Paul) Added a new switch for find items in the map translator. The property is "internal", labeled "Internal only?" in the GUI. It only affects the Palm translator, not the 3.x translator. If checked, the find item is generated but placed in a directory named "internalfinds" instead of "finds", and will not be visible in the "Find item tab". However, it will be available for use by scripts and internal facilities in the 4.0 Map Viewer.
(3/15/2005 Paul) Added support for "polyface meshes", an obscure "feature" of the DXF POLYLINE entity. Should fix the problems we were seeing trying to translate CableCAD export.
(3/10/2005 Paul) Added an additional report output to the DXFRoverLegendLineColorSetter. MapTranslator/data/reports/DXFDatatypes.tof should contain a list of the datatypes that came from each drawing.
(2/11/2005 Paul) Fixed constantWidth support (again) and added it to Palm Translator too.
(2/11/2005 Paul) Added support for "constant width" property in LWPOLYLINE entities in DXF files to translator.
(1/27/2005 Paul) Added new field for ArcSDE translations, partner_geometryLength. This is the 'len' field out of the geometry table for a feature.

Miscellaneous

(2/17/2005 Paul) Fixed the behavior of FixedLengthRecordDef so that it pays attention to field-specific default values. FixedLengthRecordDef is in interfaces such as the CADP interface. Configure like so:
```
           new org.jcon.text.FixedLengthFieldDef {
              "name" = "Cfms_code",
              "position" = 323,
              "defaultValue" = "233",
              "picture" = new org.jcon.text.NumericPicture {"length" = 3}
        },
        
```
I have only enabled this for export; I am wary of regression bugs so am trying to do the minimum necessary.

Bug Fixes

Map Viewer

(3/28/2005 Russell) Fix to Java GPS code for Dixie bug.
(1/27/2005 Paul) Fixed a memory leak in the dataVoice ops interface.

Field Designer

(5/26/2005 Paul) Fixed a nasty bug that was breaking the unit filter trees when the filter node did not have a label.
(4/20/2005 Paul) Added a dialog to the Field Designer that informs the user that they didn't actually open a job when they don't select anything and hit OK. It doesn't come up if they hit Cancel.
(4/20/2005 Paul) Fixed a confusing behavior with the Open Job window; if you select a job on one tab, then switch to e.g. the "New" tab and hit OK, it selects the (now invisible) job you had already highlighted. Now it should clear any selections from hidden tabs when you change.
(4/20/2005 Paul) Added a display for the currently-open job number to the top of the job tab. This used to be at the top of the window but that's where the license info goes now.
(1/13/05 Paul) Changed "Create Existing Location" action to just "Create Location".

Palm Tools

(3/9/2005 Russell) New version of Palm map viewer. Fixed icon transparency, which wasn't working in the previous releases. Fixed icon selection, which used to be off by several pixels.
(2/8/2005 Russell) Some Staking Buddy jobs are copied from the map instead of surveyed with the GPS, and these jobs now show up correctly in the Field Designer. I also fixed some bugs with the new Staking Buddy job importer.
(2/2/2005 Russell) New versions of Palm Map Viewer and Palm Staking Buddy to support merged find items. You must retranslate your PalmMaps to get the new, correct format.
(2/1/2005 Russell) Changes to Palm map icon support.

System Hub

(5/13/2005 Bill) Changed order that SEDC Sockets interface looks for district field value - uses Job info first, then falls back on built-in district code.

(5/11/2005 Paul) Plugged hole in checkouts logic that was causing errors of the following form:

WARNING Request for nonexistent version 0 in JobCheckouts for Job 1051032; I'll fix it.
ERROR   Exception
ERROR    due to java.lang.ArrayIndexOutOfBoundsException: -1
ERROR   java.lang.ArrayIndexOutOfBoundsException: -1
ERROR     at java.util.ArrayList.get(Unknown Source)
ERROR     at
          com.PartnerSoft.apps.Staker.server.JobCheckouts.checkoutSetFor(JobCheckouts.java:152)

This was primarily occurring in the Daffron interface.

(4/20/2005 Paul) Put in extra check on the job header checkedOut field. It should put a warning in the log if checkedOut is false but there is a jobReceipt, or if it's true and there is no receipt. It also fixes it.
(3/17/2005 Russell) In TextRecordInterfaceModule, changed it to write to a temp file, then rename the temp file to the export file name after we're done. This prevents reading partial export files. Specifically, Jaim has a Python script that checks for an export file every sixty seconds, and if exporting takes longer than sixty seconds, a very common situation with large jobs, then his Python script reads a partial export file.
(3/14/2005 Paul) Added additional sections to the XML staking sheet to distinguish "unit info fields" from "staked unit info fields". The <unitInfo> section has the generic unit info (from the CSV files and config manager); the <stakedUnitInfo> section has the configurable fields the staker edits for the unit (e.g. phase, ref1/ref2).
(2/10/2005 Eric) Updated ConfigManagerGUI.html and staking sheet engine.
(2/9/2005 Paul) Added accounting code for staked unit info field values in the staking sheet xml. I added them as a property "accountingCode". It is equal to the name if the value isn't a picklist item.
(2/4/2005 Jaim) Updated version of Hub/resources/scripts/NISCXMLImport.py.
(1/25/05 Bill) Updated Hub/resources/scripts/SEDCSocketExport.py and Hub/resources/scripts/SEDCSocketImport.py.
(12/8/2004 Paul) Preliminary support for NISC MultiSpeak XML interface.

Map Translator

(5/27/2005 Paul) Fixed a NullPointerException in the Palm Translator's find item indexer.
(5/27/2005 Paul) Fixed a ClassCastException in the Palm Translator's connectivity generator.
(5/26/2005 Paul) Fixed some error messages in the AutoCAD frontend, and maybe the cause.
(5/19/2005 Paul) Fixed problem with discardInvalid option in find item generation.
(5/16/2005 Paul) Fixed the PalmTranslator so that it deals properly with text color differences between Palm and Standard legends.
(5/16/2005 Paul) Fixed a problem with line style names in the palm translator. May have affected colors, dunno.
(5/16/2005 Paul) Fixed a problem with text disappearing in the 4.0 viewer. You have to retranslate to fix it. Also, fixed a recent bug with text drawing as black rectangles; this was introduced when I fixed translucent line support.
(5/16/2005 Paul) Fixed a some problems in the MilSoft palm translator frontend.
(5/13/2005 Paul) Fixed some of the grosser labelling problems in the Palm Translator.
(5/3/2005 Paul) PalmTranslator now trims all find item values to remove leading or trailing spaces.
(4/22/2005 Paul) The PalmTranslator wasn't culling out degenerate polylines properly from the data - they weren't in the tiles, but they could still be accessed via connectivity.
(4/20/2005 Paul) Fixed a bug in the PalmTranslator where it didn't deal well with long strings. It now truncates them to 256 characters.
(4/14/2005 Paul) Twiddled tile size for upper LODs in 16-bit palm translator.
(4/14/2005 Paul) Updated fields in WindMil frontend to match v7 spec. Changed the names of the following fields:
- controlledPhase to controllingPhase
- nominalOfOutput to nominalOutputVoltage
- nominalOfTertiary to nominalTertiaryVoltage
- overcurrent-A to description-A
- overcurrent-B to description-B
- overcurrent-C to description-C
Added new section type: 13 (Consumer).

Added a bunch of fields too; too many to list but most sections now include "failureRate" and "repairTime". Check all your datatypes for new or modified fields.
(3/30/2005 Paul) Fixed bug in style merging in palm translator.
(3/23/2005 Paul) Fixed a fairly nasty bug in both translators. When you label using a point, you have the option of including the data. If you do not include the data, the idea is that the point will just be graphical, not selectable or findable. A good example is flow arrows.
Unfortunately, this didn't work correctly in either translator. In the 3.x translator, the data is dropped and the point is not selectable (good), but the data still shows up in find items (bad). In the Palm translator, the data isn't dropped, the point is still selectable, and it shows up in the find items (bad, bad, and bad).

Hopefully this is fixed now. This might result in substantially smaller map sets, especially for the palm - imagine removing all the primary data from all the flow arrows on primary lines.
(1/31/2005 Paul) Modified the palm translator so that it doesn't toss duplicate names from a find item. This is needed to get the Palm and 4.0 viewer to work like the 3.x viewer. Still does not merge entries, however.
(1/14/05 Paul) PalmOS Map Viewer config now has a distinctive window title.
(1/4/05 Paul) Fixed a problem with spaces being eliminated during Smallworld XML parsing.
(1/3/05 Paul) Changed position on milsoft switches to standard (end of leader line).

Miscellaneous

(5/5/2005 Paul) Cinco de Mayo! Latest oracle JDBC driver.
(4/25/2005 Paul) Fixed the behavior of splash screens when they can't find a proper splash screen file. It shouldn't come up with a picture, but it shouldn't crash either. This was a surprising problem at Withlacoochee.
(4/7/2005 Paul) Put stronger wards around PartnerDate.getDateString(); this was causing the InvocationTargetException that actually crashed Buckeye's hub. The other (see below) was a problem, but did not result in a crash per se. Both of these are caused by bad data in some fashion - the first was in trying to read a date from the TOF file; the second in trying to write one. Verify that the SQL date format, the user date format, the dates coming from ATS, and the dates stored in the .job files are all valid.

(4/5/2005 Paul) Put stronger wards around PartnerDate.setDateString(); this was causing a

java.lang.IllegalArgumentException: dateString: invocation target
          exception for class com.PartnerSoft.data.PartnerDate

(3/29/2005 Paul) 4.0/system was missing from the Platform package.tof specification. This broke the Palm updater.
(2/14/2005 Paul) Added ConfigManager/data/playpen to ZipUpConfig.
(12/16/2004 Paul) Added .jnlp to file extension list for PHP processing in the Apache http.conf. This is required to support 4.0 beta installations.

Version 3.7.5 - November 22, 2004

Overview

This is primarily a bug-fix release. It does include some important changes to the 4.0 (Palm) translator that are required to support the 4.0 Map Viewer, which is in beta-testing. The Map Viewer now exports shapefiles for redlining. Also, the SEDC Sockets interface is in general release and running at several sites.

New Features

Field Designer

(8/26/2004) DomainConfiguration now supports a switch, "stakeBackwards". If true, then when adding intermediate station points, they are added from the source. This is actually more like staking multiple locations. One peculiarity, though, is that when you start, you must have the downstream location selected (the one whose backspan to which you are adding points). This is the only way I can know for sure which span is being modified, since a source can have multiple front spans. Otherwise, it should work in a reasonably straightforward fashion.
(11/12/2004 Russell) Added support for latest CSV-based Staking Buddy format to Field Designer.
(7/29/2004) Renumber locations now has an "Are You Sure" dialog.
(7/21/2004) New FieldDesigner map data action. "Copy to Location" is very similar to "Create Existing Location". It copies the fields from the selected map object but does not copy units. It requires that you click on the map near the location to copy to (this may not be terribly obvious).
Minor feature for William Northcutt. I've added an "Insert selected alternative" button to the Manage Alternatives window. This inserts the selected one into the current one, merging the two (but not deleting the selected one).

Map Viewer

(9/2/2004) Added "miscellaneous map data" to the Map Viewer. The ultimate kludge, it lets you add all kinds of crap to your map. Well, only points now, but the way is clear for more crap later. You have to set up a legend (which enables it) and add points from Python map data actions scripts. See the "Adding miscellaneous data" section of the Customization Guide for an example.
(8/5/2004) Map Viewer can export shapefiles. ArcView was complaining about these last time we tried them; please test.
(7/29/2004) Added scriptable coordinate display to the Map Viewer. The script has two variables, 'x' and 'y', and should set the variable 'result' to a string with the desired value. The script should go in Maps/config/partner/CoordinateDisplay.py. Examples are in the customization guide.
(8/25/2004) Cleaned up RunPython map data action. It was using a straight Python interpreter rather than our normal wrappers, so it was missing variables like "log". Also added a variable "mapApp", which gives you access to the map application (viewer, ops, whatever). Also added a variable "data" that is a Cog. So now you can access data less weirdly by e.g.:
```
latDeg = data.getInt('modified.latDeg')
lonDeg = data.getInt('modified.lonDeg')
```
Note that those are forward apostrophes, not backwards. This is the same style of access popularized by our Python map transforms and Python Hub interfaces.

Having access to the map app lets you use remote-control features. Here are some examples:
```
from java.util import ArrayList

command = "zoom"
args = ArrayList()
args.add(3)
mapApp.handleRequest(command, args)

command = "center"
args = ArrayList()
args.add(823485)
args.add(1002434)
mapApp.handleRequest(command, args)
          
```

Operations Manager

(8/6/2004) Added circle-drawing function to Python ops query. Example is in the ops manual.

Hub

(7/20/2004) Hub scripting debut. Hub scripts will all go in Hub/config/partner/scripts. The first is BeforeJobCheckin.py. You get the variables "job" and "log", and you can modify the job all you like. This is run every time a job is checked in, before the actual check-in happens. It uses a "smart" loader, so should re-load if the script is modified or otherwise saved.

General

(8/13/2004) Thrane added the ability for the client installer to install for all users.
(7/21/2004) I've extended the jython path to include the following directories. They are listed in order of priority; a file in a directory listed first will override a file of the same name in a directory listed later.
- Shared/config/preferences/python
- Shared/config/customer/python
- Shared/config/partner/python
- Shared/config/generic/python
Use the usual "import filename" convention of python to include libraries in these directories.

Bug Fixes

Map Viewer

(10/7/2004 Thrane) A while back we fixed Map Viewer printing so that it launched Acrobat directly. Then printing wouldn't work on 98 so I made a new Shared/resources/Start.bat. Map Viewer PDF printing now works with both 2000/XP and 98.
(10/6/2004) A file needed for GPS/serial port support was missing from the roll. The file javax.comm.properties has to be in Platform/resources/jre/lib/. If it is missing, the Map Viewer will not list any comm ports in its log. This has happened before; essentially whenever we swap out JREs, we have to recopy it into RollIngredients. Anyway, this roll should include it and solve the problem.
(7/26/2004) May have uncovered an annoying bug that prevents disabling GPS support in the Map Viewer/Field Designer/Headless Staker. Basically, it was enabling GPS if it found a config file, without checking to see if enabled is true.

Operations Manager

(9/16/2004) Squashed some error messages (from missing find item lookups) in the dataVoice interface.
(8/19/2004) Added support for querying TS2 turtles by status (as opposed to just those that are out). I've added documentation to the ops manager manual.
(8/5/2004) Ops Manager now supports arbitrary Python queries. You write a script to feed a map data hopper, and it does the rest. Example of use is the Lightning Strike example in the Ops Manager manual.

Map Translator

(10/22/2004 Paul) Fixed a bug in reading ArcGIS polygons at New Hampshire. The results looked like the "pen" wasn't being picked up between polygon draws, so there were weird connecting lines joining them.
(8/30/2004) Map Translator now supports exporting data to shapefile format. In data type configuration, check "Dump data as shapefiles?" Results are divided into point and polyline shapefiles, named MapTranslator/data/shapefiles/`datatypeName`-point.shp etc. The DBF will includes only the configured fields, plus geometry info (x, y, rotation, offsets for points, none special for polylines) and datatype name and style name.
(8/26/2004) ArcInfo-coded domain values are now for both Palm and regular translators, for Access, Oracle, and SQLServer databases.
(8/6/2004) Default text color for new items in rover legend should now default to red instead of white. It's supposed to be controlled by the defaultTextStyle in the RoverLegend object, but it's so complicated we'll just punt and go with red. Anyone with a red map background should seek treatment.

Hub

(11/12/2004 Bill) Fixed problem with large jobs in SEDC sockets interface.
(7/29/2004) Awhile back, we modified the checkin logic to prevent checkin of a job (with a checkout ticket) when the job was not marked as checked out on the hub (no checkouot ticket). Previously it allowed this, but in some cases would overwrite the job with an older copy (e.g., if you somehow managed to have two copies on two different Field Designer computers). Unfortunately, the cure was worse than the disease; you have to go through some annoying hoops to get a job with this problem to check in now. So, I've put it back the way it was. However, to prevent data loss, I've added a new feature to the hub—job archiving. This saves the job to Hub/data/jobs/archive/`jobNumber`-`timestamp`.tof whenever the software is concerned that data may be lost. It currently just does this before performing this kind of unsafe checkin, but I'm sure we'll find other uses for it.

General

(11/17/2004 Paul) ChecksumGenerator now ignores any file named thumbs.db. These are system files generated by Windows XP and cause all kinds of problems if we try to manipulate or delete them.
(10/26/2004 Paul) OperationsManager directory should be back in the MapTranslator roll.
(10/21/2004 Paul) Fixed a problem with GPS that Jefferson found.
(8/31/2004) Fixed ClassCastException in shapefile export.
(8/26/2004) Reduced warnings about latlong and xy fields in ProjectionTransform to just regular entries. These were causing problems with single-line lightning strike files at UGI; rather than risk regression bugs by messing with BinaryFixedWidthDataRecordSource, I'm squashing the errors.
(8/13/2004) Thrane fixed some things in the NIS installer support.
(8/6/2004) Maybe fixed a Y2K problem with the shapefile DBFs. DBF v3 uses a byte (256 values) to represent years, but the utilities I have seem to only properly interpret it as a two-digit year.
(8/6/2004) Set the python path to use absolute directory names in an attempt to make Windows behave.
Changed the wording on the online help for linetype dashing to emphasize not using too many parameters.

Palm Tools and v4.x Codebase

(11/17/2004 Paul) Fixed a major problem in the Palm translator. Detail reduction on polylines was applying the granularity from LOD 0 to all other LODs as well; this makes for some crappy looking lines.
(11/17/2004 Paul) Palm OS^® translator no longer requires RoverFileSetHoles.tof to run correctly.
(10/27/2004 Paul) Fixed problem in 4.0/Palm translator where it wasn't deleting data/data.packrat.temp and data/hilights.packrat.temp.
(10/22/2004 Paul) Added batch file for StakingBuddyToShapefile - FieldDesigner/resources/StakingBuddy/StakingBuddyToShapefile.bat.
(10/19/2004 Paul) Added Shared/resources/4.0/ directory. Currently, this is to support converting maps from an http source. I suspect more kludges will be added later.
(10/18/2004 Paul) Fixed problem in Cog XML writing that was be the source of the GPS location bug at South Plains. The XML writer was using the number-formatting code that was designed for users and only has three significant decimals; this was enough to throw the calculations off. I've modified this to allow as many decimals as required.
(10/18/2004 Paul) Modified Palm (4.x) translator so that it copies the entire 4.0/config/ directory into PalmMaps/resources/ for use by the 4.0 viewer.
(10/18/2004 Paul) Modified Palm (4.x) translator so that it generates a "Standard" legend as well as the Palm legend. Both should show up in the 4.0 viewer.
(10/6/2004) Fixed Palm translator so that it applies granularity to coarser LODs and tosses out too-short polylines.
(8/10/2004) Staking Buddy points now get assigned location IDs. The Staking Buddy importer ignores [NaN] and [Inf] values for numeric fields. These special values were creeping in through some bad math in Staking Buddy and causing divide-by-zero exceptions.
(7/29/2004) 4.0 translator was complaining about 4xConfig.tof when it's missing. I made it shut up.
(7/29/2004) Fixed 4.0 translator's Oracle Arc/Info support.

Version 3.7.4—Tuesday, July 13, 2004

Overview

This is mostly a bug-fix release. However, it should be noted that many of the bugs fixed were serious show-stoppers for the Palm translator. Therefore, this release represents a far more mature Palm toolchain than any in the past.

New Features

Map Viewer

You can now add map data actions to a regular Map Viewer. This is a capability previously only available in the Operations Manager and hard-coded into the Field Designer. You need to put them in the file MapViewer/config/partner/MapDataActions.tof. It should look like this:
```
{
    "Do something cool" = new
          com.PartnerSoft.apps.MapBrowser.actions.RunPython {
          "scriptTemplate" = "
...
"
    }
```
See the Operations Manager and Customization manuals for ideas and examples.

General

At a loss to deal with the many and varied versions of CSV files, I have implemented a configurable parsing algorithm for CSV. In CSVDataRecordSource, you can now specify the property CSVType to indicate what bizarre flavor-de-jeure of CSV you're trying to parse. Currently, there are only two, but I expect more to come:
- "default" uses the poor suffering algorithm whose thankless job it is to try and figure out the fields from whatever mess is given it—tab delimited, double-quoted, etc., etc.
- "quote-comma-quote delimited" specifies a much simpler and robust algorithm that assumes the CSV was generated using the unsophisticated-but-simple method of tacking a double quote (") at each end of the line and sticking "," (quote, comma, quote with no spaces) between each field. It is able to thus blithely ignore embedded quotes, commas, tabs and other nonsense, as long as you don't of course have a "," embedded in a field. This is a line-oriented algorithm so no embedded newlines either. It strips leading and trailing spaces from the line and from each field as well. NOTE WELL that this will ONLY work with files that have quote-comma-quote between EVERY field in the line.
Here is an example of usage:
```
new com.PartnerSoft.io.formats.csv.CSVDataRecordSource {
    "path" = "Data/INSTALL.TXT",
    "CSVType" = "quote-comma-quote delimited",
...
          
```

Palm Tools and v4.x Codebase

Added support for 16-bit texel coordinates to the 4.0 translator. These are used in the new Palm Map Viewer, which is only currently deployed to Walton. To configure, create a file in MapTranslator/config/preferences/4xConfig.tof that looks like:
```
{
    "texelBitSize" = 16
    }
```
File copies in 4.0 now use the Java nio.channels framework. This framework uses operating-system level data copying and can be substantially faster than my old routines (which copied into buffers in the JVM). This seems to help speed on the UpdatePalm utility in particular.
The 4.0 directory is now included in Platform's package.tof. This directory is required for UpdatePalm and any scripts using the new 4.0 Partner API.

Bug Fixes

Palm tools and v4.x Codebase

KNOWN BUG: translators with multiple frontends with the same name (e.g., "dat") will not work correctly in the 4.0 translator. This may or may not be an actual bug, but it can cause problems with weird configurations.
Fixed some issues with unused LODs in the 4.0 translator. This was occuring at UGI, which has 4 LODs (0-3) but LOD 3 was not used in the Palm translator. All lines were dropped, since it was trying to use an infinite granularity to simplify them. Keep an eye out for other problems with this kind of config.
Fixed a problem with scaling in the 4.0 translator.
Fixed some internal problems with 4.0 Cogs. This was manifesting as a problem with translator datatype naming when a SplittingNamer's groupName included a slash, but was really a deeper (and more obscure) problem with data naming in general.
Fixed a problem with the Palm (4.0) translator find items; it was dumping objects that were indexed but were not visible.
Fixed a problem with the WindMilFrontend in the Palm (4.0) translator.
Fixed bug in multiple-merging in Palm (4.0) translator.
Put in extra error-checking code to handle blank lat/long data from Staking Buddy XML files.
Russell lightened up the Regions.packrat file (used by NAD2NAD) by some 90%. Should make partner.jar much smaller.

Hub

Fixed a problem that cropped up in Randolph's SCT interface.

Operations Manager

Fixed annoying errors when you set DataVoice find items to null.

Map Translator

Excessive translator logging should be gone now. Let me know if it's not.

Field Designer

Staking sheet xml should now use unique locationIDs in references rather than constructionIDs.

Version 3.7.3

Plugged an NPE that occurred when setting staked unit info fields, possibly after loading a Staking Buddy job.

Version 3.7.2—Wednesday, June 8, 2004

Legend selector for photo backgrounds was not showing up as promised.
Fixed problem with Map Viewer printing.
Fixed sign problem with originY in UTM projections. It only seemed to affect NE Indiana, since most UTM state planes have a originY of zero.
Renamed old "centralMeridian" field to "originLongitude" in Projections.tof for UTMs to make absolutely sure it's not screwing things up.
Bug in Map Viewer GPS support that prevented GPS button from appearing.

The add outage action for the ops dataVoice interface now supports configurable account types, likey so:

        "staticMapActions" = {
            "Enter outage" = new com.PartnerSoft.apps.OperationsManager.interfaces.DataVoiceAddOutage {
                "accountType" = 2,
                "accountField" = "Account Number"
                }
            }

Default is 1; High Point for whatever reason needs 2.

Version 3.7.1—Thursday, May 27, 2004

Overview

This is a formal release of some minor features and bug fixes since version 3.7. Several bugs cropped up in the Palm Map Translator, and we added some features to make background images or photos easier to use. Also, all our customers seem to be moving their maps around these days, so we've added support for NAD27 to NAD83 conversions to both the Map Translator and Hub.

New Features

Map Viewer

A legend selector now appears for map sets with background images (aerial photos, etc.) that allows you to selectively view vectors, images, or both. It appears automatically, under the south pan button.

Field Designer

The add unit python scripts now have access to the current state of the location info editor. This is different from what's actually stored in the location object until you hit the OK button, which saves the fields to the object. You can get at the values via the currentLocationInfoValues variable:
```
          phase = currentLocationInfoValues.getString('info.phase')
        
```

Operations Manager

For dataVoice interfaces, you can now set consumerFindItemType and/or lineSectionFindItemType to null to disable functionality related to consumer or line sections. It still verifies (and complains) if you specify a nonexistant find item, but if it's null, it will disable them silently (logging as info).

Map Translator

Palm (4.0) Map Viewer now puts out various reports about a cut. See 4.0/reports/translator/index.html after your next translation. This includes a report in 4.0/reports/Sizes.html that provides byte sizes of each graphic type and each data type for your edification. Also provided is a handy Sizes.csv for your graphing calculator or whatever.
Added a new app, PalmMapControlCtron. This is just like the MapControlCtron (aka, "General Map Settings") app; use it to set the center point, background color, etc. separately from the regular map viewer if you like. I'm surprised we've gone this long without it.
Made some changes to WindMil frontend to clean up appearance and placement. For one thing, some icons (e.g., transormers) are now autorotated to match their spans.
DataRecordSourceFrontend now supports lines. Set "lines" = true and set your variables so that there is an x1, y1, x2, and y2, and it will take care of the rest.
In either translator, setting the data value "partner-ignoreObject" to true in any map graphic object will cause the graphic to be discarded. This can be done up-front in DataRecordSourceFrontend or in transforms, e.g.
```
original.setString("partner-ignoreObject", "true")
        
```
or
```
original.setBoolean("partner-ignoreObject", 1)
```

Hub

Guppy can now run as a Windows NT/2000/XP service. See Platform/resources/service/ for installer/uninstaller and config.
New job mangling tool allows reprojecting (e.g., from NAD27 to NAD83) the coordinates for locations in jobs. This is a script that has to be installed as a version update in the config manager. To do so, add a file like the following e.g., ConfigManager/data/scripts/new/ReprojectJobs.py:
```
from com.PartnerSoft.apps.Staker.tools import JobProjectingFileMangler

originalProjection = "TXNorthCentralNAD27"
newProjection = "TXNorthCentralNAD83"

args = [originalProjection, newProjection]
JobProjectingFileMangler.main(args)
        
```

Bug Fixes

Map Viewer

Fixed GPS support so that it can be shared by more than one program in the same Java process. This was causing problems with Jefferson's new disconnected ops manager setup.
Anytime a CustomerMapNomenclature is loaded, it will toss out the old "tester" property entirely. This is no longer needed and is a big confusing mess in most nomenclature configs.

Added the ability to combine nomenclatures into a single big string. Watch out for size problems in the Map Viewer GUI. You just configure it as a list of other nomenclatures thusly:

new com.PartnerSoft.apps.MapBrowser.CustomerMapNomenclature {
    "translator" = new com.PartnerSoft.apps.MapBrowser.MapLocationMultiTranslator {
        "subTranslators" = [
            new com.PartnerSoft.apps.MapBrowser.GridMapTranslator {
                ...
                },
            new com.PartnerSoft.apps.MapBrowser.GridMapTranslator {
                ...
                }
            ]
        }
    }

General

When any app needs to display a PDF file, it now uses Shared/resources/Start.bat instead of starting IE. This should bring up Acrobat directly, which is faster and requires less memory etc. A similar trick really helped performance on the Linux version at Walton.

Field Designer

Fixed problem with the configurable python GPS loader in Field Designer. It was automatically multiplying by meter-to-feet, even when there was no projection.
Cleaned up some of the Staking Buddy projection code.

Map Translator

The file selector no longer allows selection of directories. Double-clicking to go into directories was difficult on eBlvd. You can still manually set directories in the list by editing the TOF file.
Fixed annoying bug in Palm (4.0) translator that messed up find items for datatypes that had a custom data type label applied.
Fixed a bug in Palm (4.0) translator that didn't apply the specified style name to derived graphics (labels).
Fixed HostNames bug in 4.0 translator.
Finally fixed weird South Plains bug. Symptom is missing point icons in Palm Map Viewer. Cause is both complicated and uninteresting.
Fixed case-insensitivity problem in Oracle ArcInfo frontend to 4.0 translator.
Fixed NAD2NAD problems in 4.0 translator.
Fixed a problem with a packrat file for NAD27/83 conversions missing from the jars.

Operations Manager

Downgraded Ops Manager error message about missing settings file to just info.
Fixed some problems with the Operations Manager's parameterization features.

Hub

Eric tweaked the Hub Service config; it was stopping if it didn't complete launch in 30 seconds.
Fixed problem with Python library paths in Hub service.

Version 3.7.2—Tuesday, April 27, 2004

Satilla found a nasty bug resulting from my trying to block checkins after a job has had its checkouts cleared. I think I have the logic sorted out now.

Version 3.7.1—Monday, April 26, 2004

Fixed problem with location info field picklist item resolution during CreateExistingLocation from map.

Version 3.7—Thursday, April 22, 2004

Overview

We are proud to finally announce version 3.7. This has been in beta-testing for some time, but due to the large number of major changes and new features, it has been difficult to wrap it all up and get it out the door as a final release.

Palm support has been improved across the board. The Palm Map Translator has been completely replaced, with the software that will become the version 4.0 map translator. This fixes many of the compatibility problems and memory usage issues of the old Palm Map Translator, as well as many minor problems. The Palm Map Viewer and Staking Buddy are robust and performing well. Staking Buddy now allows you to add assemblies, generate cost estimates directly, and then load them into the Field Designer. We've tried to improve manageability of the Palm tools by making sure all software will run directly off SD/MMC cards without installing to the Palm itself and by adding a graphical installer tool that takes care of copying everything to the right place on a card.

In the Field Designer, we do a better job of storing GPS data for later use, including placing it on staking sheets. We can now load GPS data in arbitrary formats. For example, you can load post-corrected GPS data from a text file or database.

We have added a few more tricks to the Operations Manager—users can now edit settings that control queries and have named configurations. We have implemented a version of the construction manager that allows construction crews to download their jobs into the Ops Manager, view the staking sheets in the field, and make changes to job header fields (e.g., construction date), without requiring a full-time network connection.

Interfaces have also been a big area of focus. We now support the latest SEDC STKTRANS format as well as the sockets-based SEDC UPN interface. We have a full interface to NISC iVUE. We now support assembly-to-material explosion. We have also implemented interfaces that allow changing job data via emails and text messages.

In fact, there's so many new features we've had to organize them by program. Enjoy.

New Features

Palm Tools

Staking Buddy now includes the ability to add assembly units and generate job cost estimates right on the Palm. This requires that the Staker2Packrat utility be run from the ConfigManager to generate the unit and cost database for the SD ca