Release notes for version 2018.2

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.

There are currently no critical issues in this release.

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.

There are no end-of-life functionality identified in this release.

Deprecated functionality

Deprecated functionality is available in this release, but will (most probably) no longer be available in the next release.

#23144 Trusted zone authentication

Trusted zone authentication will be replaced by new authentication mechanisms.

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.

#23072 Analysis - Filters (Desktop)

In older versions of Analysis, the same filter that was applied to the category, also needed to be applied to the value to get correct results. This has now been changed. In version 18.2, filters applied to the category will also (by default), be applied to the value. This means its no longer necessary to apply the same filters on the value.

Note: This only applies to filters applied to categories in the Analysis Designer. If the filter is applied on the Data Source in the Data Mart you will still need to apply the same filter to the value to get correct results.

#23073 Trusted users replaced by app model admin rights (Studio)

Users are no longer trusted on the app server, but granted app model admin rights in Genus Studio. To grant app model admin rights to a user, navigate to Security/Users in Genus Studio, open the user, and then select the App Model Admin check box.

Admin rights can only be granted by users which have admin rights. That is, you need to grant admin rights to your own account manually before you can grant admin rights to users which previously were trusted. Detailed instructions are described in the script 018.020.005.001.

#23078 Changes in builtin email address validation (Desktop;Web)

The builtin email validation check up to version 2018.1 has been to strict and prevented entering for instance nordic characters in the email adddresses. In order to support entering any character supported in an email address according to RFC 3696, we have changed the validation so that any character is allowed as long as the email address consists of a name and a domain separated by an @-sign. For customers that require a more strict validation, it is possible to add a validation rule for instance based on a regular expression for the email fields in the solution.

#23084 Components used for export to MS Word, MS Excel and PDF has been updated (Desktop;Services)

The third-party components used for generating Microsoft Word and Excel documents and also for generating and converting Pdf documents have been updated to the latest version. This may have impact on your resulting documents. Even after our testing, we have earlier experienced that these updates may have broken existing reports generated by Mail Merge in our customer solutions. Therefore, please make sure the report generation is tested as part of the upgrade process to version 2018.2.

#23108 App Model Admin kan now testrun form, tasks, agents etc (Desktop)

In previous versions only users added inn the App Administrator group could press File and App to test run tasks, Agents, Open Forms, call to Web Services and Call to Rest Services. This is now changed to all App Model Admins.

#23114 Changed implementation of round(), roundUp(), and roundDown() functions (Desktop;Services;Studio)

The following functions did not round floating-point values in a consistent matter, and have been rewritten for correct behaviour:

Math.round()
Math.roundUp()
Math.roundDown()
Real.round()
Real.roundUp()
Real.roundDown()

The round() function now produces a result corresponding to "Round half away from zero" as described in this Wikipedia article. The roundUp() and the roundDown() functions correspond to "round away from zero" and "round towards zero", respectively.

A new rounding function, roundHalfToEven(), has also been introduced, corresponding to the "Round half to even" rounding form, also called "bankers' rounding":

Math.roundHalfToEven()
Real.roundHalfToEven()

This rounding form is useful if you are adding rounded numbers.

#23116 Multiple appmodels per appserver are no longer supported. (Services)

#23120 Menu item Open in new Window is renamed in Forms

When a control only have one Open command, Genus added the Open in New Window menu item. Now we use the name of the command instead of a predefined text. This means that many grids and controls now will have a different name on the Open menu item. This was neccessary to change because Open in new window was in some cases not the best name choice. For controls that have checked the Open the default Form option, the menu item will now show Open + name on the concept.

#23133 Allow Remember Credentials requires explicit expiration (Services;Web)

The Genus Configuration tool provides a Directory property called "Allow Remember Credentials" (on the Authentication page), as documented here. Earlier, if the "Token expires after ..." field was left blank a default value of 30 days was applied. In Genus Apps 2018.2 this has been changed, so that an explicit value is required. If the "Token expires after ..." field is left blank the app will behave as if the "Allow Remember Credentials" option had been disabled.

Please note that wether or not the Remember Me checkbox is displayed on the login page is configured in the allowRemember property in the asconfig_web.js file in the web site folder. This value must be set according to Allow Remember Credentials in the Genus Configuration Tool.

#23143 Removed duplicate "Transparent" symbol (Desktop;Web)

A new transparent symbol with id 2262 was introduced in release 2018.2 but is a duplicate if the existing transparent symbol with id 1103. Please update usage of this symbol in your models to use symbol with id 1103 instead.

Major new functionality

#23074 General settings in Genus Studio (Studio)

Access to general settings moved from the ribbon to separate entries in the directory explorer:

Settings: Settings for the app model
Data/Data Sets: Settings for data sets

The UI has been simplified to a single page layout to improve usability.

Genus Configuration will soon be discontinued, and this is a preliminary step for moving the configuration of the app model to Genus Studio.

#23075 Analysis themes replaced by web themes (Studio;Web)

Analysis themes are replaced by web themes which are shared by all web-based components. Web themes are defined in Genus Studio, and you can assign a default theme both for the app model and for each data set.

Existing analysis themes will be converted to web themes when you upgrade to this version.

#23091 Analysis - New action (Desktop)

Added a new action - reload datamart. When pressed, the client will unload the current datamart, and reload with updated data.

#23112 Run a Search effect (Desktop;Services)

The Run a Search effect executes a Genus Search connected to a modeled object. The effect has three different result types. 1. Return the number of objects from the result. 2. For each result we can create a object and add object identifier and name. 3. Open the Search in Genus (this option will not work on a server).

#23132 Hiding groups in advanced Search

A Search Group section is added on the Search folder in the Object Class Dialog. Groups are added based on inbound properties and in this section you can select witch groups you want to hide

#23148 Internal Data Id counter is changed from 32 bits int to 64 bits int (Studio)

The data id counter is now changed from 32 bits int to 64 bits int. The Business Engineer may still use 32 bits int, but it is possible to use 64 bits int. The App Model id counter is not changed.

Minor new functionality

#23076 "Administrators" security group renamed to "App Administrators" (Studio)

Harmonisation of concepts after introducing app model admin rights (replacing access given to trusted users).

#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.

#23087 Analysis - New function: Math.abs (Desktop)

Added support for Math.abs in the formula designer.

#23090 The Merge Data Effect can now be executed without specifying merge data source. (Desktop;Services)

This is useful when the effect is used to convert a file without merging data.

#23097 Open connected task in Run a Task effect (Studio)

It's now possible to open the connected task from the Run a Task effect.

#23111 Modelling connection to a Genus Search (Desktop;Services)

It is now possible to create a column with data interpretation Search. The search can be executed in the table context menu and in the reference field context menu. A search can also be executed in the Run a Search effect.

#23113 Analysis Heatmap (Desktop)

Added support for user selection.

#23117 Object class dialog - live update section moved (Studio)

Live Update section located in the Events tab moved to the Data Provider tab
Events tab renamed to Auditing
Option Live Update/Objects are updated automatically renamed to Enable Live Update
Option Live Update/Objects are updated when this property is changed renamed to Aging Property
Option Live Update/Objects are updated by user initiated action removed

#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.

#23122 New lookup field implemented (Desktop)

A lookup field that can search and select data from one datasource (rest-service etc) and show reference to another datatype.

#23124 Optimalization in the Create Objects effect (Desktop;Studio)

When creating a large xml-document from multiple data sources with many objects, we can use the Filter Connection option to make a filter connection between the data sources.

#23126 Added support for merging Excel workbooks into a PDF document (Desktop)

Support for merging Excel workbooks into a PDF or Word document added to the Merge Documents effect.

#23128 Pie explosion (Desktop;Web)

Added support for pie explosion. The option is available under Format, then under Pie Options. The option is by default disabled. The option can only be used in combination with ignore selection.

#23129 Listing the Trigger properties for a Rule (Studio)

When listing Object Class Rules in Genus Studio, the list now contains a column with trigger properties.

#23130 A manual reload of a datamart will add a record in the reload history. (Desktop;Web)

#23134 Naming of Local Objects (Desktop)

When designing a Local Objects it is now possible to select a Name Property on the Data Source. This allowes the modeller to use a local object in a drop down control.

#23136 The table control in cell selection mode now supports selection of multiple ranges. (Desktop)

#23138 Added restrictions based on user rights or locks in the controls for manual data mart loading. (Desktop;Studio)

#23139 Added support for 2-factor oauth login for web (Web)

#23140 Logging of Rest Service (Services)

It's now possible to log input and output from a Rest Service in the audit event.

#23141 Interpretation phone number on web (Web)

Fields with interpretation phone number will now be telephone links on web.

#23145 Logging of invalid objects in a Form (Desktop)

To log all invalid objects in a Form, press Ctrl-Alt-Shift-L.

#23155 Timeout seconds on File Upload effect (Web)

It's now possible to set timeout for the File Upload effect

Resolved issues

#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.

#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.

#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.

#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)

#23135 Dropdown (Desktop)

Dropdown has been renamed to Selector.

#23137 Handling of null values in JSON (Services)

We now handles null values when serializing JSON values.

#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.

#23167 Analysis: Resolved an issue with subtraction operator (Desktop;Web)

If a formula defined in the analysis designer consisted of trailing subtractions, the output of the formula would be evaluated incorrect. For example: 100 50 25, would result in 75, instead of 25.

#23203 Data validation error for an object class property containing an RTF document not displayed correctl (Desktop)

If the data size is set for an object class property containing an RTF document, violation of the size is not displayed correctly by the RTF editor.

Known issues

Known issues are errors or lack of functionality. Known issues may be solved in a future release based on customer demand.

#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-09-10 Changed release stage from Release Candidate to Release (builds starting with 18.20.160).
2018-08-20 Changed release stage from Beta to Release Candidate (builds starting with 18.20.147).
2018-08-06 Changed release stage from Alpha to Beta (builds starting with 18.20.127).
2018-03-23 Created (Alpha stage).