Release Notes‎ > ‎

Release Notes 2.0

This page lists the changes made in version 2.0 of SEED-Platform. 
  • The "Github Issue" numbers in parentheses have links to the SEED-Platform Open Source Github repository Issue List.  
  • If there are links in the description of the changes, following those links will lead to a more detailed description of the changes. 
If you have any questions about releases or changes to the program, please email seed-support@lbl.gov



2.0
(1/20/2017)

Updated 1/25/2017


Data Model


Changes from V 1.5

  • The data is now stored in two table structures, one for Tax Lot/Parcel information, one for Property/Building Information

  • Each record in those tables is associated with a time period called a Cycle, which can correspond to a benchmarking compliance cycle.


Navigation Bar


Changes from V 1.5

  • PROJECTS: disabled for the current release because we want to work with users to make sure we have a feature that solves user needs, which the previous iteration of Projects may not have.

  • INVENTORY: BUILDINGS is now INVENTORY, because the program is now storing and displaying data from the perspective of Tax Lot/Parcel and Property/Building.

  • API DOCUMENTATION: added an implementation of the Swagger API framework to display the program API structure for developers.

  • LOG OUT: moved Log Out to the last option of the Navigation bar from an option in the user account, which makes it more straightforward to log out of the program


.

Data Import


Changes from V 1.5

  • Specify Time Period/Cycle: Each time a file is imported, it must be associated with a Time Period/Cycle.


Known Issues

  • Green Button Data: Green Button Data upload is disabled. This feature is being reworked.

.

Mapping


Changes from V 1.5

  • Assign fields to Property / Tax Lot: The new data model requires that during field mapping, each field be assigned to either the Property or the Tax Lot table.

  • Matching field names: The Matching field name Tax Lot ID is now called Jurisdiction Tax Lot ID. The other Matching field names remain the same (Custom ID 1, PM Property ID and Address Line 1)


Known Issues


  • Display of mapping list is very slow when there are many fields (1215): In some cases, such as a Portfolio Manager file with 250 fields, the program can take over a minute to display values from the pulldown list in the Mapping field, or to let you type in a field.


.

Mapping Review Screen


Changes from V 1.5

  • Tabs for each table: There are now tabs for the Property and Tax Lot fields and records, depending on how the data is mapped.

  • All the data is loaded: it is possible to scroll through all the records in the import file being reviewed


Known Issues


  • Mapped field names sometimes not shown properly: In some cases, the actual “field name” may be displayed in the column header, such as in the case below property_type, rather than the “display name” which in this case should be Property Type. However, if there is data in the field, then the program has been able to put the data into the table.


  • Property Tab when only Tax Lot data is mapped: If Jurisdiction Tax Lot ID is mapped, there will be a View by Property tab showing just that field, when no fields were mapped to the Property table.  This is currently there by design but can be confusing.



Matching


Changes from V 1.5

  • Changes for New Data Model: Matching has changed due to the new data model. Based on how field are mapped to “matching” fields, the program first does a “merge” on records and data in the same table, and then “pairs” records between the Property and Tax Lot tables.


Known Issues

  • Program Hangs on 100% Complete (#1217): When the matching has finished, the 100% Complete dialog box remains, so it is necessary to click the Cancel button to remove it and then click on the Inventory Navigation bar to see the imported/matched records


  • Matching status dialog box does not reflect correct state of data (#1221): under some circumstances, when the program finishes matching, it presents a dialog box about the status of the matching. In this version, the information on that dialog is likely to be incorrect.


  • Program creates Property record even when only Tax Lot fields are mapped (#1219): under some circumstances when only matching a file to the Tax Lot table (for example if the Property tab was displayed in the Matching Review screen), the program will make an extraneous Property record that can be seen in the View by Property tab after the data has been matched.

    Sometimes this Property record is paired to a Tax Lot record, in which case if it is deleted, the Tax Lot record is also deleted.

    If it is not paired to a Tax Lot record (ie, there is no “+” to the left of the record, or no value displaying in the Associated Building Tax Lot ID or Jurisdiction Tax Lot ID fields, the record can be safely deleted.


Click on the Checkmark column to the left of the record to select the record and then Delete Selected from the Actions pulldown list.


When you delete the record, the program will indicate whether it is going to delete 1 property record, or 1 property record AND 1 tax lot record (in which case you should not proceed with the delete)


  • Hand Matching is not enabled: The ability to match and unmatch records “by hand”, i.e., override the automated matching done by the program (which existed in version 1.5), is not enabled in this version of the program.


Inventory List View

Changes from V 1.5

  • Rework of Buildings (now Inventory) screen: Due to the new data model, there have been significant changes to the main screen where imported data is viewed.
    See the V 2.0 Users Guide for a complete description of the new Inventory List and Detail views.

      • Tabs: There are two tabs, View by Property and View by Tax Lot

      • Cycle: Each data view is associated with a Cycle

      • Page Title: Title of page is now either Properties or Tax Lots, depending on which tab is selected, and no longer contains the number of records

      • Number of records:  the number of records is moved from the page title to the right hand side of the tab, because each tab can have different records

      • Links at the top of the page:

        • Buildings link (in V 1.5) is now called either Tax Lots List or Properties List, depending on which tab (Property or Tax Lot) is selected

        • Labels admin link moved to Organizations

      • All records displayed at once: the program no longer loads just 10 - 100 records at a time. When a tab is selected, the program loads the grid with all the appropriate records

      • Actions pulldown: the name for the pulldown list that was called Building Actions is now Actions

      • Filter by label: Clicking inside this field only shows the labels that are assigned to records currently being viewed (rather than showing a list of all possible labels), based on the Cycle and Tab selected

      • Filter Input box: The value(s) entered into the filter boxes are applied immediately upon typing them; there no longer a need to press the Enter key to activate them, or click on an Update Filters button (in V 1.5)

      • Sorting: Sorting can be accomplished two different ways: 1) click the column header and it will do a simple ascending, descending or original sort; 2) click the arrow on the upper right of the column and it is possible to do hierarchical sorting (see the User Guidelines for more details)

      • Show all, Matched and Unmatched pulldown: This pulldown (in V 1.5) has been removed. The “+” column indicates whether there are records matched between the Property and Tax Lot tables

      • Info button to access Detail view: To see the detail view of a record, click on the “info” icon on the left side of the tab grid.


Known Issues

  • Actions pulldown: the Actions pulldown does not contain options for creating and adding to existing Projects, as Projects have not been implemented in this version.

  • Sorting alphanumeric fields does not work properly in all cases (#1218): There are some fields (generally defined as numeric) that the program is not sorting properly when the data is alphanumeric. One example is a Zip Code field that would generally have 5 digits, but in some cases may have 9 digits with a hyphen separating the 5 digit and 4 digit sections.

  • Some mapped data is not displaying in detail and list view (#1213): Under some circumstances, not all the mapped fields are displayed in the List or Detailed view, and are not available to select in the List Settings for either view. It is therefore important to check in both the Mapping Review screen and the final records in the Inventory lists (Property and Tax Lot) to make sure that all the fields in the original file are displayed. If they are not, it may be necessary to reimport the data and change either the mapping or the field names in the original file.

  • Slow display of records for large data sets (#1105): For organizations that have more than a few thousand records in either the Tax Lot or Property tables, the display of the records can take several seconds, because the program is loading all the records into the view. However, once the records are loaded, the actions in the view (filtering, sorting, etc) will be very responsive.

  • Deleting Records (#1214): Deleting records (from the Actions pulldown list) will delete associated Tax Lot and Property records. If this is not desired, it might be necessary to label the record in question for deletion but not actually delete it in this version of the program. Future versions may include the option to delete the record in question without deleting it’s paired record, and should include the feature to allow un-pairing of records (unmatching “by hand”), which would then allow deletion of the records without deleting the previously paired record.

  • Hide Column doesn’t persist (#1220): The Hide Column feature doesn’t persist the state of hidden columns when moving off the current view. When coming back to that view, the hidden column will no longer be hidden.

    The work around is to define which columns should be visible in the List view through the List Settings feature.


Inventory Detail View


Changes from V 1.5

  • Default Detail view will not show all fields: The first time the Tax Lot or Property Detail view is accessed, not all the fields will be displayed. However, using the List Settings allows all the mapped fields to be selected for display (with the exceptions noted in #1213).

Known Issues

  • Import history not displayed (#1139) (but edit history is displayed): The import history for a given record is not being captured or displayed in the Detail view (this history was captured and displayed in V 1.5). However, when a record is edited in the Detail view, the program does keep the history.


List Settings

Changes from V 1.5

  • Field Display status and order: In List Settings, the functions of selecting which fields to display and setting their order happens in the same screen and does not need to be saved. The last state of the fields is saved automatically.

  • Separate List Settings for Tax Lot and Property Detail view: The program allows a different List Settings “state” for Tax Lot and Property Detail views.

Known Issues

  • Property and Tax Lot indicators are not always correct (#1170): In List Settings, the program attempts to indicate whether a field belongs to the Tax Lot or Property table. However, in come circumstances, those indicators are not correct. But these indicators are strictly informational and don’t affect the display of the data if the fields are selected


  • Multiple fields with the same name (#1171): In List Settings, there may be multiple instances of the same field name, possibly with the wrong marker for which table it belongs to, with no indication which will contain data.


Generally, the first one in the list will be the one that will display data. However, if that isn’t the case, the work around for this situation is to select all of the fields, go back to the list view, determine which one shows data, and from the list view, use the Hide Column option (accessed from the down arrow in the upper right of the field column) to hide the fields that do not have data.


Labels

Changes from V 1.5

  • Label Admin is under Organizations: The Label admin screen used to be in the Building list (which is now either Tax Lot or Property) but has been moved in this version to the Organizations view


Organizations

Changes from V 1.5

  • Cycles Admin link added: Cycles are defined in Organizations

  • Labels Admin link moved: The Labels admin link is moved from the old Building list to Organzations

Known Issues

  • Cycles:

    • There is currently not an option to delete existing cycles


API Documentation

Changes from V 1.5

  • API Documentation in navigation bar: This version has a new option in the main Navigation bar called API DOCUMENTATION, which will display a Swagger API platform which shows how each API is used in the program as well as having the option to test API functionality


Administration (Superuser)

Changes from V 1.5

  • Admin screen: The list of organizations under the admin screen now shows the Parent ID if there are suborganizations, as well as the internal database organization ID, the date the organization was created, and the Property and Tax Lot record count by Cycle.

Known Issues

  • User account without an organization (#1024): The program will allow a superuser to create a user account without an organization, so make sure that all the fields are properly defined, including the organization, when creating new users.

Bug Fixes

  • Performance enhancements: It is much faster to view the organizations in the program, as well as to delete records from organizations.