Release notes for version 2018.1
Introduction
This document lists all user-visible changes to Genus Apps since the previous release.
This release note will be updated prior to the release and may also be updated as long as the release is available, e.g. with information of new patches or known issues. Please take note of the installation and upgrading comments, and the release notes change log.
Installation and upgrading
Prior to upgrading to this release, you must:
- Upgrade to the previous release. See the Release notes for the previous release for more information.
- Review the Expiry date of your Genus License File and install a new one if necessary.
- Review the rest of the release notes for this release. Pay special attention to any issues in the sections End-of-life functionality, Deprecated Functionality, Breaking Changes and Known Issues. You may have to perform manual tasks.
- Please note that there does not exist any Genus Upgrade Assistant for this upgrade.
For general information about installing and upgrading Genus Apps, see here. We especially recommend reviewing the System Requirements article.
Important issues in this release
Note
This section address the most critical issues and information for this release. These issues may require you to take corrective action either before or immediately after installation.
Link table in data mart no longer available. Data marts that contains link tables must be manually converted to using selection filtering on connections in release 2017.5. It is not possible to edit or load data marts containing link tables in release 2018.1.
Don't leave faulty data mart load plans running on auto! Each time it fails, it logs up to 1 MB. But since it may try to load every 2 minutes, it may amount to large volumes of data over time. See the article Data mart problem solving and FAQ for more information.
See also the following notes.
#23026 Genus Services requires a new version of IBM Data Server Driver Package for accessing DB2 databases (Services)
To access IBM DB2 databases Genus Services now requires "IBM Data Server Driver Package (Windows/x86-64 64 bit) Version 11.1 Mod2 Fix Pack2 iFix002"
For details, see https://docs.genus.no/developers/installation-and-configuration/system-requirements.html#database-access-software-requirements
End-of-life functionality
End-of-life functionality is functionality that was available in the previous release, but is no longer available in this release.
#22997 The support for Sybase is removed (Services)
Since Sybase is not used by our customers anymore, the support for this database system has been removed. Support for Sybase may be reintroduced based on customer demand.
#23041 Link Table in a Datamart is no longer available (Desktop)
"Link Table" was used to resolve circular connections in a data mart. This is now solved by using "Selection Filtering" on Connections.
IMPORTANT: Datamarts that contains link tables must be converted to using selection filtering in 2017.5 before upgrading to 2018.1
Deprecated functionality
Deprecated functionality is available in this release, but will (most probably) no longer be available in the next release.
#22994 Versions of Microsoft Windows Server older than 2016 (Services)
From the next release 2018.2, Genus Server will require Microsoft Windows Server 2016 for installation of Genus Services.
#23004 Removing on Lost Focus from ComboBox (Web)
Removing on Lost Focus from Combobox, as it does not consistently across browsers, and in most cases, it is more correct to use on Value Changed.
#23040 Views in Analysis is deprecated (Desktop)
In versions up to 2017.4 Views was a concept in an Analysis. The functionality is still present in 2017.5, but it is not possible to add new Views to an Analysis.
All the functionality in Views is available by other means. To migrate an analysis with Views, do the following:
- Save one copy of the analysis for each view, say A1 and A2 for an analysis with two views.
- In analysis A1, check all Actions which has a Command of Type Switch View. All of these must be converted to Open Analysis with Same Selection and point to A2. Do the same in analysis A2.
- In analysis A1, remove view A2. In A2, remove A1.
#23060 XY- and pie chart control in forms (Desktop)
Will be removed in next release. Replaced by functionality provided in analysis.
#23061 Gantt control in forms (Desktop)
Will be removed in next release. No plans for replacement of functionality.
Breaking changes
This section lists important changes introduced in this release. You will need to use this list in order to understand the changes you might need to make to your application to support the new release.
#22998 Changed serialization to JSON for collection values (Desktop;Services)
When serializing collection values to JSON, we would in earlier versjons serialize the values as a string containing all values of the collection separated with commas. This has now been changed so that the values are serialized as an array with the values serialized in the correct data type.
#23022 Initial Catalog connection string property is automatically assigned if supported (Services)
Unless the Initial Catalog connection string property is assigned explicitly when specifying Data Link in the Genus Configuration tool, the Data Link Database property value will now be automatically used as Initial Catalog. The exception is Oracle databases (which does not support the Initial Catalog property).
#23053 Symbols from image library is no longer loaded on Genus Services. (Services)
Support for using symbols from the image library is no longer supported on Genus Services as the loading and caching mechanism for images is not supported on Windows Server. The usage of symbols on Genus Server is limited and should only affect symbols displayed in distribution of Reports in Agents. Genus Apps for desktop is not affected by this change.
Major new functionality
#23017 Added detail pane to tables (Desktop)
When designing tables it's possible to add a detail pane. The detail pane can contain calculations and it can modify objects. Commands from the detail pane form can be added in the tables ribbon section.
#23025 Requirements imposed by the General Data Protection Regulation (GDPR) (Studio)
Support for reading and deleting audit trails introduced. For more information, see the Genus Apps documentation:
Read of audit trails was previously not supported. Deleting audit trails was supported, but the functionality has been extended with the following functionality:
- For object classes defined in your directory, it is possible to delete audit trails for a filtered set of objects.
- Delete audit trails irrespective of age.
#23029 Access to selected text for controls in actions (Desktop)
In some cases you might want to perform some logic based on the current selected text in a form control, such as executing a search or classify named entities in a text.
To do this, define a command targeting a task, and then attach the command to the On Context Menu Item Click event in a control supporting text selection. When the task is invoked from the context menu, the selected text can be accessed from the built-in Action Orchestrator data source within the task:
Action Orchestrator.Current Text Selection
Note that you cannot disable a command based on the value for the selected text. To determine what to do, define a decision block in the task.
Controls supporting text selection:
- E-Mail Address Edit
- File Preview (MS Word, MS Excel, PDF, text)
- HTML Edit
- Rich Edit
- Text
- Text Edit
- Text Popup Edit
- URL Edit
Minor new functionality
#23002 Added til to view name (Studio)
Added a tip to view name when selection table views in different contexts
#23007 (Analysis) Two dimensional grid now supports sorting (Desktop)
The two dimensional grid can now be sorted on both horizontal and vertical category. The setting is available in the designer under "Format" -> "Sort and Limit"
#23013 View symbol in the table header (Desktop)
The table header now shows the view symbol if the shortcut gets its name from the target. If no symbol is defined in the table view, the shortcut symbol is used.
#23015 (Analysis) Data Point Labels (Desktop)
The user can now specify custom data point labels. The option is available on Pie Chart and Doughnut Chart.
#23024 Convert an integer value to a HTTP status code (Studio)
Added function fromInteger to the HttpStatusCode enumeration defined in the Genus Apps language. The function converts an integer value to a HttpStatusCode:
HttpStatusCode.fromInteger(value : integer) : HttpStatusCode
One application of the function is to return a HttpStatusCode as a result of processing a request to a REST service defined in Genus Apps.
#23032 Language support (Analysis) (Desktop)
Implemented support for localization in Analysis. The user can choose between English and Norwegian.
#23038 The term "directory" replaced with "app model" (Studio)
In general, a directory is a structured listing of information.
The terms directory and app model have been used interchangeably in Genus Apps, but from now on we distinguish between these two concepts.
The directory is now the structure of a Genus app model, as displayed in the left-side menu inside Genus Studio. An app model is data (about a model) stored in a database and accessible through this structure by using Genus Studio. For more information, see https://docs.genus.no/terminology.html#app-model, https://docs.genus.no/terminology.html#directory.
#23042 Improved preview of Excel files in forms (Desktop)
Replaced preview of Excel files in MHTML-format with native Excel file formats.
#23044 View the current load state for data marts (Desktop)
Added functionality for viewing the current load state for data marts on different nodes. Available from the shortcut menu Load State in the Discovery portal (Discovery/Data Marts).
#23048 Generic Search now uses default operator (Desktop)
Now Generic Search will use default search operatior for eatch field that is used. This means that some fields will generate starting with while others may create a like statement.
#23049 New operators on fulltext search (Desktop)
We have added 3 new fulltext operatiors.
#23051 Added in-place editing of name in the directory explorer (Studio)
In-place editing of name enabled for most objects in Studio. Restricted to objects such as analysis, report, and data mart in previous versions.
#23052 Removed diagram view of the data mart from the analysis designer (Desktop)
In previous versions it was not possible to open a data mart if it was locked by an analysis. This restriction has been removed, and you can open the data mart in a separate window even if it is locked by an analysis (the data mart wil automatically be write protected). From an analysis you can open the attached data mart from the Actions window menu.
The same functionality has been implemented for an analysis which is locked by a data mart.
#23054 Analysis - Selection history (Desktop)
In older versions of analysis we kept 15 steps in our selection history. When this limit was reached, the oldest entry would be deleted. This limitation is now removed. The creator of the analysis now needs to keep in mind that the history can grow unlimited, and should therefore be cleared (e.g. on switch analysis)
#23055 Added a function in Advanced Expressions that evaluates a textual expression as a number. (Studio)
#23058 Navigation Pane is updated with new content control (Desktop)
#23080 Can now set default app for Genus Apps for Web installation (Web)
If there are more than one app available on a site, it is now possible to specify an app that will start automaticaly on page load. If it is only one app available, that one will start automatically.
#23081 Change in how Accelearor Search works (Desktop)
In previous versions accelerator search added a wildecard operator at the end of each search word. We now use the default operator on the search field when determening if a wildcard operator is added or not.
#23087 Analysis - New function: Math.abs (Desktop)
Added support for Math.abs in the formula designer.
#23119 Markdown now works with static content in text fields (Web)
#23121 Paste security (Desktop)
Copy and Paste Security is now added as functions on all Discovery objects with security and on searches.
#23130 A manual reload of a datamart will add a record in the reload history. (Desktop;Web)
#23139 Added support for 2-factor oauth login for web (Web)
Resolved issues
#22999 (Analysis) New functionality in dropdown component (Desktop)
The dropdown component can now filter data runtime. This can either be done by toggling "Show Excluded", which will remove disqualified objects, or by toggling "Show Selected", which will only show selected objects.
In addition, the following actions have been renamed on the component:
Select All -> Select
Clear -> Deselect
Lock/Unlock Selection -> Lock/Unlock
#23000 Filters applied to a report data source are ignored when the report is opened (Desktop)
Filters applied in a Run a Report effect are ignored when the report is opened using an Open a Form effect.
#23001 Fixed rendering of Analysis and Maps in the desktop client (Desktop)
The Analysis and Map control would sometimes not be rendered correctly in cases where the display scaling in Windows is set to other value than 100% due to a rounding error. This issue has now been corrected.
#23003 Fixed Select First syntax on DB2 (Desktop)
Some DB2 databases don't support Limit/offset. Change from using Limit to Fetch First xxx Rows Only
#23005 Ignore selection in formulas (Desktop)
Ignore selection will now work on formulas and formula values, regardless if the tile's category data source is affected by the selection
#23006 Active object not nullified by combo box control (Desktop)
Active object not nullfied when current selected item is cleared in a combo box control with binding type Object.
#23008 Fixed problem with serialization of non-ASCII characters when exporting JSON (Desktop;Services)
Characters outside ASCII range (32-127) has been exported uising a Unicode escape format (\uXXXX) but this caused problems reading the exported text. The export method has been updated to handle non-ASCII characters by writing them using UTF-8 instead so that the JSON produced will be more readable.
#23009 Fixed problem with updating cells where the user don't have read access. (Desktop)
If a property that the user dont have access to is listed, the column is removed. But if we have multiple rows, the column may still be created, but the cell for the given object is not created. If this object is updated we may try to update the column in the list and this caused Genus to crash.
#23010 Genus terminates when saving a data mart containing incomplete or invalid calculated fields (Desktop)
#23011 Filter method for 16-bit integer object class properties is set to None as default (Studio)
Changed behavior. By default the filter method is set to Number and Text Operators when the property is created. If the data interpretation is changed to Boolean, the filter method is set to Boolean Operator.
#23012 (Analysis) Background Image not being displayed on tile (Desktop)
Fixed an issue that in some cases could lead to the background image not being displayed correctly.
#23014 Fixed problem with missing font in Windows 7 (Desktop)
Some symbols used in Genus are rendered by using a font supplied by the operating system. On some Windows 7 installations, the version of this font is missing some of the required symbols. This issue has now been adressed by distributing the font with the software.
#23018 Show number of objects in trackdown from a report (Desktop)
When a table is opend in a stand alone window, the number of objects in the table is showed in the windows title if the option is checked in the table description.
#23019 Number format for fields in a local object ignored (Desktop)
Number format for fields ignored when a local object is displayed in a local object window from an open form effect.
#23020 Analysis configuration (Desktop;Studio)
In version 17.5 and older, analysis could be configured by creating a config.json file in the root directory of the analysis installation, i.e. at C:\Program Files\Genus\Server\wwwroot\Discovery\ on the app server. These configurations have now been moved to Genus Studio. See https://docs.genus.no/developers/defining-an-app-model/general-settings/web-settings.html for more information.
#23021 New fields not available in table views (Desktop)
Afther a user has customized fields in a view, the user must reset the current view to find new fields added by the Genus modeller. This problem is now fixed and all new fields will be added last in the available fields list
#23023 Fixed an issue with the date picker on mobile devices (Web)
#23028 Dynamic table and join aliases are generated in a way that makes two structually equal queries equal (Desktop;Services;Web)
By being equal the query execution plan cache on the server can be used
#23030 Fixed problem starting up Genus caused by installation of KB4055002 on Windows 7 computers. (Desktop)
#23031 Sort objects effect generates a SQL lookup for each branched field data are sorted by (Desktop)
If data are sorted by a field contained in a referenced class, such as Person.Employer.Name, values are looked up in DB for each object in the data source before sorting. Values should have been read in one batch when the data source was populated.
#23033 Fixed issue where Android Tablets where interpreted as phones for the Play Store app
This caused views created with the phone formfactor to be displayed on the tablets.
#23034 Analysis - Designer (Desktop)
Value properties are no longer cleared when changing field value.
#23035 Analysis - Designer (Desktop)
Number format on value will no longer be reset to default when changing fields on value.
#23037 Unable to add a calculated field to a local data source in a data mart (Desktop)
- Add a new local data source to a data mart, and then add a calculated field. Genus terminates when you try to write an expression. In addition, the name of the data source is not updated correctly in the Calculated Fields list.
- Add a new local data source and then save and close the data mart designer. Reopen the data mart. The local data source is not available in the Calculated Fields list.
Note from R&D: Bugs not related to local data sources, but to the Private setting for data sources (which by default is selected for local data sources).
#23039 Groups not available when defining criteria for a search folder (Studio)
In the Select Field or Group dialog, groups are not available, and it is not possible express an exist condition.
#23043 Object class wizard: Incorrect interpretation of RBDMS data type varchar(max) and nvarchar(max) (Studio)
Object class properties bound to columns of type varchar(max) and nvarchar(max) in MS SQL Server are by default assigned the data type ANSI String/Unicode String. The correct interpretation should be Textual large object (ANSI)/Textual large object (Unicode).
#23046 (Analysis) Designer crash (Desktop)
Fixed an error that caused the designer to throw an error. Also removed Switch View from the list of Action types. Already created actions with this type will still work as expected.
#23047 Analysis - Show Advanced Options (Desktop)
Show Advanced Options has been removed from the designer. All advanced options are now shown by default.
#23050 Fixed output from report to PDF when the report is empty. (Desktop)
In cases where the report was empty, the report would not be exported to Pdf or printed. This caused print preview to be blank and tasks exporting data to Pdf to fail. The functionality is now changed so that output is produced, containing just the column headers of the report.
#23056 Analysis - Ignore Selection and XYCharts. (Desktop)
Fixed an error that caused column charts to not get the correct color when ignore selection was enabled.
#23057 Analysis - Initial Selection (Desktop)
Fixed an issue where initial selection would not get applied properly.
#23059 Related local tasks are not automatically deleted when a data mart is deleted (Desktop)
#23062 Analysis - Context Menu (Desktop)
Fixed an issue where the context menu would not close after being opened.
#23063 Analysis - table sort icon (Desktop)
Fixed an issue where the header text would overlap with the sort icon.
#23064 Analysis - Fixed an issue where numeric values would not get right aligned. (Desktop)
#23065 Analysis - Fixed an error with datalabels not working properly (Desktop)
#23066 Fixed an issue where objects removed from filtered lists removed en extra item (Web)
#23067 Slow Automatic Formatting (Desktop)
Fixed issue with slow Automatic Formatting
#23068 Dialog Boxes displays title and button texts in the lauguage used in the Genus App. (Desktop)
#23069 Fixed issue with invalid File Name when opening in default application (Desktop)
#23070 Edit-locks on Data Mart won't prohibit loading (Services)
When a Data Mart is locked because somebody is modifying it, it will no longer fail to load on a server. Already running Data Marts will reload data only as sceduled. Altered structure for the Data Mart won't be read until the editor is closed and the edit-lock is released.
#23071 Error when changing views when a search field has focus in a table (Desktop)
When a Number Search Field had focus and the user changed view, an error occured.
#23079 Fixed bug in wildcard SQL-generation (Desktop)
When using advanced search, the wildcard operator returned an invalid SQL for fulltext index properties.
#23082 Error in copying table shortcut (Studio)
A table shotcut contains 1-N views. The copy shortcut function did not copy all the table views added to the shortcut, this is now fixed.
#23085 Error in evaluation of Month vs a Calendar time value (Desktop)
When a Time object was evaluated against a calendar time, the operators greater than and less than returned the inverted value.
#23086 Improved file upload with Selection: Take a picture on Windows (Web)
This should now behave the same as on iOS and Android, where there is a choice between using the camera and upload existing picture.
#23088 Handle of invalid file for import data effect (Desktop)
If we have an Excel file import and the user selects a JPG file, a user friendly message is now displayed.
#23089 Analysis - Data Mart loadtime (Desktop)
{loadtime} can now be used in the text-control to get the timestamp of when the datamart was loaded.
#23092 Remove Ribbon button when the user don't have access to the task (Desktop)
When a command in a table or a form runs a local or global task we now remove the command from the Ribbon if the user don't have access to the task.
#23093 Added user information in the Data Mart designer (Desktop)
When the user changes a Data Mart, the user will now be notified that the changes will not take effect before the Data Mart designer is closed. The Reload Data Mart function do not reload the Mart description if the description is locked for edit.
#23095 (Analysis) Time Slider bugfix (Desktop) (Desktop)
The Timeslider no longer stops working properly if you drag it outside the desktop window.
#23096 Analysis - Subset (Desktop)
Fixed an issue where the analysis would never finish loading if initial selection was applied.
#23098 Analysis - Map (Desktop)
Fixed an error that could cause the heatmap layer to not display correctly.
#23099 Analysis - Error handling (Desktop)
Fixed an issue that would could lead to the analysis crashing upon getting a new authentication token. All technical error messages are now also shown under a details-pane on the error-screen.
#23101 Analysis - Loading data (Desktop;Web)
Fixed an issue that in some cases could lead to longer load time when making selections in an analysis.
#23102 When browsing the next object the old document was visible in the previewer. (Desktop)
When showing a previewer while browsing objects the document from the previous object was visible if the new object file data was empty. We now display the message No Previewer Available.
#23103 Analysis - GeoJson (Desktop)
Fixed an issue where the maplayer would not update after selection.
#23104 Isolation Level "Read Uncommitted" incorreectly ignored for database commands (Services)
A side-effect of a code change introduced in Genus Services 2017.1 effectively disabled use of the isolation level "Read Uncommited" for all database commands.
A symptom of this issue has been experiences with database deadlock in high volume scenarios.
The issue has been corrected with the following Genus Services versions:
- 2018.2, file version 18.20.50.0 and later
- 2018.1, file version 18.10.164.0 and later
Oracle does not support Read Uncommitted and has hence not been affected by this issue.
#23106 Analysis Dropdown (Desktop;Web)
Fixed an issue where actions would be applied to all objects, instead of only visible objects.
#23107 Analysis - Dropdown (Desktop;Web)
Fixed an error with validating object state that caused some objects to not be visible in the list.
#23109 Analysis - Bookmarks (Desktop;Web)
Fixed an error that caused bookmarks to not be available before the analysis was restarted.
#23110 UI Block now blocks all key presses in input fields (Web)
When enabling UI Block for server calls, all key presses are now blocked, in addition to mouse clicks.
#23118 Analysis - Subsets (Desktop)
Fixed an issue where if the user tried to apply selections (via subsets) to a datasource that was not directly used in the analysis. The selections would not be applied. This worked as expected in Genus 17.5 and older versions, but due to performance optimizations it stopped working in 18.1.
The issue has been corrected with the following Genus versions:
- 2018.2, all available versions
- 2018.1, file version 18.10.175.0 and later
#23125 Preview of Word documents not updated on navigate (Desktop)
When navigating to the next or previous object in a form containing a preview control, the preview is not updated if the attached file is of type MS Word document.
#23127 Self-filtering not removed in data mart (Desktop)
If a data source is deleted from the self filter diagram view, the settings Filter on Self and Use as Self are not reset, and self connections are not deleted.
#23131 Fixed problem causing Genus Services to crash when generating reports in an agent. (Services)
#23142 Streaming of response data could result in timeouts or missing data (Services;Web)
An error in the response data encoding algorithm applied by Genus Services has been corrected. Malformed responses would be returned as a result of Base64 response encoding or response compression, if enabled. When triggered in Genus Web Apps this may be experienced as client side timeouts or missing response data.
#23205 Fixed "System.OverflowException: Conversion overflows" with SQL Server Decimal Type (Services)
An exception would be thrown occasionally when reading DECIMAL type values from SQL Server.
Known issues
Known issues are errors or lack of functionality. Known issues may be solved in a future release based on customer demand.
#23036 No longer warns user about leaving the page when redirected to another page in sign out command (Web)
#23045 Fixed issue where anonymous applications could crash after upgrading (Web)
#23115 Datamarts is not compatible with solutions having multiple appmodels on an app server. (Desktop;Services;Studio;Web)
Loading of datamarts in solutions where multiple appmodels are assigned to single app-servers may trigger random stability issues. Datamarts may stop and become unavailable when certain combinations of appmodel deploy and modifications to datamart occurs.
Multiple appmodels per appserver is not supported when using datamarts.
Tips and hints
Tips and hints are design decisions or answers to support questions that may be of general interest.
There are no tips and hints specifically targeting this release.
Change log
- 2018-03-05 Changed release stage from Beta to Release Candidate (builds starting with 18.10.131).
- 2018-02-19 Changed release stage from Alpha to Beta (builds starting with 18.10.105).
- 2018-01-29 Changed release stage from Pre-alpha to Alpha (builds starting with 18.10.66).
- 2017-11-29 Builds for this release will start with version number 18.10.
- 2017-11-17 Created (Alpha stage).