Release Notes

Copyright (©) 2002-2006, Jemmac Software Ltd

 

--------------------------------
ST 4.0  - released 5th  June 2006
--------------------------------
Summary:        The stOPCServer, various Scaling enhancements and a new Graph Style of "Stacked Strip Chart".
 
Enhancements
------------  
stPro
        0582:   Added a 5% gap to the top and bottom scales of pens in Auto Scale mode.  This improves the clarity 
                of the trend by preventing pens from lying on the X-axis or along the top of the plot.
        0581:   If the Plot Properties Mapping Tab was used to select a new pen, hitting apply on the Pens tab caused
                the focus to swap back to the original Pen.
        0570:   Improvements have been made to the scaling logic when handling near zero values .
        0569:   A new User Preference of "Enable Auto Rounding" has been introduced.  When set, this option
                rounds the scales for new pens when they are mapped.  Note, pens defined in existing plot files
                will not be changed as a result of enabling this option.
        0568:   A new User Preference called "Round Intermediates" has been introduced.  When set, this option
                means that the intermediate Y-axis scales will be rounded to the same accuracy as the min and max
                scales.  Note, selecting this option can cause the rounded scales to be offset significantly from
                the actual range for the pen in order to guarantee that the intermediates can be rounded.
        0561:   A new Hot-key has been added to directly launch the Edit Data Source Dialog (F6).
        0559:   The Item Details Area Right-Click menu now launches the Plot Properties Pens dialog when the top entry
                in the menu (the Item name) is clicked.
        0558:   The Plot Right-Click menu now launches the Plot Properties dialog when the top entry in the menu (the 
                Plot name) is clicked.
        0557:   The Plot Compression Mode can now be set via the Plot Right-Click menu or the Plot drop down menu.
                A Hot-key has also been added to allow the user to toggle through the Compression Modes (ALT-Y).
        0555:   The user can now control the 'horizon' of available history when connecting directly to an HDA
                OPCServer via the Tools->Edit Data Source dialog.  This improves the behavior of the Time scroll bar.
        0554:    When adding items from an OPC Browse list for direct Connections, the focus in the "Available for Pens"
                section of the dialog is now set to the newly added item.  This provides a visual confirmation that the 
                pen was added successfully.
        0553:   The list control dialogs now remember columns width set by the user across invocations.  Column widths
                can either be manually set, or set to automatic in which case they will size to the longest data item.
        0546:   Display name is now an optional column for Item list controls (such as the Plot Properties
        0543:   A new User Preference of "Prompt to Save on Exit" was added.  This allows the user the option of exiting
                without being prompted to save changes to the Session, Plot or User Preference files.  The default
                behavior is to Prompt to Save (as has always been the case).
        0542:   If a plot is loaded from a CSV file with data of duration an hour or less, the plot duration is set to
                that defined by the data set.  Previously it always defaulted to showing an hour.
        0539:   An X-Flag has been added to the auditing to log Active Directory Group searches during the logon process.
        0538:   A new User Preference of "Y-axis labels use Pen Colors" has been introduced.  The default is for
                this to be enabled.  When disabled, the Y-axis labels are shown using the Foreground color from
                the Users Color Palette.
        0537:   A rounding option has been added to the Pen Scaling logic.  This can either be set to Auto, or the
                user can manually specify the rounding required on a per Pen basis. 
        0536:   The Pen Scale multiplier and offset fields can now be user with all Scaling modes except Actual.
                Previously these were only available for "Link to Pen".
        0535:   A new Scale Mode called "Group" has been added.  The Min and Max scales for a group use the 
                Min and Max observed values of all members of the Group.  This differs from Link to Pen, as with
                Linking the 'lead' pen always sets the scales.
        0533:   A menu option has been added to allow all the Toolbars to be toggled off with a single click.
        0524:   stPro can now load sphcsv files that contain multiple data sections.  When this occurs, each section
                if assigned it's own Plot window.
        0518:   The algorithm used to calculate the number of grid lines on a plot has been improved to reduce the 
                impact of the font size when determining the number of grid lines to show.
        0515:   When connecting directly to an OPCServer, the item browse tree select logic can now be toggled via
                the keyboard via the Space Bar or the Right Cursor Key.  Items can also be removed from the 
                "Available for Pens" via the Delete Key or using the Left Cursor Key.
        0513    A new Graph Style of "Stacked Strip Chart" has been introduced.  This displays each pen in its own
                trend plot so that the trend lines do not overlap. The Graph Style can be toggled via the Ctrl-Y
                key or via the Plot Properties Details Tab.
 
 stOCX
        0047:   New API Methods added to allow the user to specify the characters to use for the Field and Record
                delimiters for API's that return lists - SetDelimiter().
        0046:   New API Methods added to return the last observed API error as a string - GetLastError().
        0044:   Added various additional attributes which can be read or set via the GetPenAttribute/SetPenAttribute
                API's.  Examples of the new attributes are: "FILTER", "DESCRIPTION" and "ROUND".  See the Online
                help for the full list.
        0041:   New API Methods added to manage Plot Attributes - these are GetPlotAttribute() and SetPlotAttribute.
                Example attributes that can be managed are: "COMPRESSION", "STYLE" and "DURATION".  See the Online
                help for the full list.
        0036:   New API Methods added to validate a pen - IsValidItem().  Note, this method requires that the Item
                is mapped to a Pen before it's validity can be verified.
        0034:   New API Methods added to manage User Preferences - these are GetUserPreference() and SetUserPreference.
                Example preferences that can be managed are: "AUTOROUND", "HGRID LINE" and "OPC ALIASES".  See the 
                Online help for the full list.
                
stManager
        0153    Users can now set an item offline when manually adding an item to an SDR.
        0148:   A registry key of "GroupQueryMethods" can be used to override the order used to determine if a 
                user is a member of a specific Group.  Values are 1 - use the NetAPI, 2 - Use Active Directory
                and 4 - Use Windows Security.  The default value is 5 (Use NetAPI and then Windows Security).
        0141:   The User can now set the default resolution type for a DL.  This allows the resolution type to
                be set to Manual for OPCServers that do not implement the standard OPC Item properties for
                Engineering Units and Description.
        0095:   It is now possible to add all the leaves under a branch when selecting OPC items from a browse
                tree.  **  NOTE ** - this enhancement applies to all the SapphireTrend clients.
                
SapphireCollector
        0106:   The Collector now handles Service Shutdown Requests in addition to Stop requests.
 
stOPCServer
                New Product introduced for V4-0.
              
stOPCAdmin
 
                New Product introduced for V4-0.
 
stTabularHistory
        0078    The duration of the 1-minute Snapshot window can now be set via the Properties dialog.
        0077    Tabular history now includes a trend window which can be used to trend the items
                within the Item selection drop down list.  The trend is displayed in a separate window
                to the main application.
 
stTHOCX
        0007    New API Method to get the Pen Handle for the selected Item - GetSelectedPenHandle().
        0006    New API Method to add an Item via its Alias Name - AddItemViaAliasName().
        0004    New API Method to Remove all the Items from the Item Select list - RemoveAllItems().
        0003    New API Method to set the duration of the 1 min snapshot list - SetMinuteListLength().
        0002    New API Method to get the color assigned to a given Pen - GetItemColor().
        
Installshield
        0040    The Installshield was revised to deliver the stOPCServer and the stOPCAdmin processes.
        
Bug fixes
---------
stPro
        0579:   For Direct HDA connections Bad values were not being displayed properly.
        0573:   Clean installs were generating an error message in the audit file relating to a registry key that 
                could not be read.  The key that could not be read was an optional parameter, so the error should 
                not have been reported.
        0571:   The Time Offset field on the User Pref Advanced Tab would not allow a negative offset.
        0566:   Manually entering a time on the Plot Properties details tab and then hitting enter without having
                changed focus away from the time data entry field incorrectly Cancelled the operation.
        0552:   When loading CSV files with gaps in the data into stPro it was possible to end up with data 
                points being attributed to an adjacent time slot.
        0551:   Assigning OPC items whose name contains a space (i.e. "S 101.PV") to a Y-axis scale no longer 
                splits the name across multiple lines on encountering the space.
        0550:   Previously if the "Use OPC Item Aliases" User Preference was set and a plot file loaded, the 
                alias names were correctly displayed in the item details area, but not for the y-axis selectors.
        0548:   The columns on the Plot Properties Mapping Tab no longer resize following a right-click.
        0547:   The display name is now preserved when using the Browse->Change Item dialog to changed the 
                OPC item that is assigned to a pen.
        0545:   The Filter and Manual entry box on the Plot Properties Mapping Tab now operate on the Alias
                when the User Preference of "Use OPC Item Aliases" is in effect.
        0541:   Addressed an Automation Interface crash when loading a Session file on Windows 2000.
        0540:   When browsing for collectors from a multi-homed node, it was possible that no sapphire collectors 
                would be found.
        0539:   The X-Flag can now be set from the User Preference Auditing Tab (providing debug information on
                the Active Directory calls used to determine which Groups a user account is a member of).
        0532:   With previous releases it was possible for stPro to consume large amounts of CPU if a dialog was
                left over a plot for a significant period of time.  This was due to a known failing with Windows
                events which was outside the control of the application.  It is now being worked around.
        0531:   Loading a Plot file where the Collector is partially specified (i.e. Collector = "") left the
                application in an inconsistent state.
        0527:   The Fit to View logic now takes the Preview Pane into consideration.
        0512:   In some situations hitting Apply on the Plot Properties Pens Tab set the active focus to Pen 1
                regardless of which Pen was being viewed before Apply was hit.
        0494:   Manually defined Data Source entries for locally defined OPCServers (Class ID all zeros) now function 
                properly.  Previously, a connection could be made with the server and it's namespace browsed, 
                but no Item values could be read.
        0490:   When browsing for an OPCServer Client side registrations were incorrectly displayed in addition to 
                the proper Server definitions.  This could make it look as a Server was installed on a node, when
                in fact only Client side registration had been performed.  Note, as a consequence of this fix DA 1.0
                OPCServers can no longer be detected via Browsing in SapphireTrend.
 
stOCX
        0049    Added logic to guard against API calls being made before the object is properly rendered.
        0045    If you used the SavePlotFile API without having previously used the dialog save the "Connection = " 
                line was not correctly formed.
        0043    The Item details Tooltips were not working in Excel.
        0030:   The stOCX About dialog now uses the latest stPro icon.
        
stManager
        0152:   The stManager now allows Account or NT Group names up to 50 character long.  Previously the Name 
                data entry field on the Security Tab was not set to scroll, thus limiting the maximum length of 
                name that could be specified.
        0146:   The Add Multiple Items dialog was not correctly resizing its buffer when dealing with more than 20
                Data Locations.
 
SapphireCollector
       0108:    The Collector has been modified to respect the Online column for Batch Adds.
       0105:    The Collector now returns an appropriate error when all its user connections are in use.  Previously
                it returned an error implying the Client and Collector Network API versions were incompatible.
 
stTabularHistory
        0082    A GDI object resource leak was fixed in Tabular History.  In previous releases this could cause
                rendering issues and other windows behavioral problems when Tabular History was left running for
                extended periods of time.
        0080    The Item select drop down was no honouring Font Size changes.
        0079    The color palette is now wrapped when assigning more pens than there are pen colours.
 
stTHOCX
        0008    Added logic to guard against API calls being made before the object is properly rendered.
        0005    If stOCX and STTHOCX were embedded in the same container, calling LoadTabHistFile caused the stOCX
                pens to stop updating.