Overview of previous release notes

May 2023

The version LUY 7.4.1 is a small hotfix release, in which we fixed some bugs in our 7.4 release.

• Fixed some issues associated with LUY running on OracleDB

• Fixed an issue with external sharing of list view reports

April 2023

We are pleased to introduce LUY 7.4.0, our next major release.

For this release, our main focus is aimed at introducing our new LUY help center, bringing major security improvements, further improving the overall LUY performance, continuing preparations for our new frontend, as well as some bug fixes.

1. New features 

1.1 New LUY help center

We gave our help center a complete overhaul:

We've rewritten all help center articles to be easier to understand.

Our new help center features a more performant search that will help you find information even faster.
You can access it either directly from the start page, the top right corner while reading another article or via this link.

The new help center allows you to easily switch between different versions of LUY, including switching between on-premise and cloud-only information. With that you directly get information matching your version of LUY.

With this release, we've also added a migration script to automatically update help links in LUY, in case they are still pointing to our old iteraplan.de-domain.

2. Improvements

This release features multiple security improvements for LUY.

2.1 iTurm security improvements

We've updated iTurm's password hashing algorithm to bcrypt to increase the strength of password hashes.

We’ve also removed an admin function which allowed to do password mass updates in iTurm.

Rehashing to bcrypt will happen automatically.

2.1 Other security enhancements

We've removed our SQL interface to deactivate the ability to access the LUY database via SQL directly. Based on customer feedback, this feature was no longer in use.

2.3 Performance improvements

We've improved the performance of our landscape diagram, especially:

• when coloring elements by attribute.

• when showing partially connected elements.

3. Fixed bugs

• Fixed an issue with our filter where in certain cases hierarchical elements were not filtered correctly.

• Fixed an issue where landscape diagrams would break with certain attributes as columns.

• Fixed an issue where LUY, in some cases, didn't display the correct diagram after refreshing the page.

• Fixed an issue in our nested layer diagram where coloring was not saved correctly in reports. 

• Fixed a loophole in the landscape diagram where business mapping elements could be selected as content, which leads to data inconsistency and errors in LUY.

4. Important information

We’ve introduced some changes, which require your attention.

We've updated our hibernate search library. For the "search" functionality in LUY to work, administrators must initially recreate the search index after the update (go to Administration > System > Recreate index).

• There are changes in the REST API session authentication, see our updated documentation under REST API.

• The default role for LDAP authentication is now optional. The property ldap.roles.defaultrole is not mandatory anymore.

If you need any further assistance with your use of LUY, feel free to contact our customer support or our sales department.

August 2022

The version LUY 7.3.4 is a service release, in which we focused on fixing reported issues and bugs.

We fixed:

• Drastically improved the user login time

• Fixed an issue with coloring in diagrams where business mapping filtering was being ignored

• Fixed an issue where wrong entries are shown in the global filter, and it was not saved correctly

• Fixed an issue in the masterplan diagram where the start/end date would be displayed at random with no fixed start/end date

• Fixed an issue in the masterplan diagram where date intervals were not always shown in-line

• Fixed an issue in the single element view where the information flow section was not visible for users with read only permission(s)

• Fixed an issue where the copy logs button did not work for large logs in the PluginAPI

• Fixed an issue with the History API where a call to GET /history/{type}/{id} was not returned correctly

• Improved the overall German translation in the UI

March 2022

The version LUY 7.3.2 is a service release, in which we fixed some bugs from version 7.3.1.

What we fixed:

• Fixed an issue where deleting a user was not possible in certain conditions

• Fixed an issue where a special configuration in the landscape diagram could not render correctly

• Fixed an issue with our filter, so that filtering for attributes and relation attributes works correctly again

• Fixed some issues where customized meta model relation names wouldn't show in certain conditions

• Fixed some issue with our plugin API

• Fixed an issue where changing a color for BBTs wasn't saved to a report

• Fixed some issues with our excel import and export

• Fixed an issue where the partial limits setting was not available when exporting diagrams to Visio

December 2021

We are pleased to introduce LUY 7.3.1. In this hotfix, we have upgraded the Java logging library log4j to its most recent version 2.17.0, in which the known log4j vulnerabilities are fixed according to current information.

We would like to draw your attention once again to our troubleshooting article with detailed information about the log4j vulnerability "log4Shell" and our mitigation measures. For questions, please contact us via our service desk.

The hotfix is available for the following versions of LUY:

November 2021

LUY 7.3.0 is a major release and includes the following new features and improvements:

1. New features 

1.1 Global filter

Instead of the former "personal global filter", now a "global filter" allows filtering all of a user's data in LUY according to individual filter criteria. This may help to reduce the amount of data displayed and loaded in LUY and allow for better focus. A global filter applies to all pages, e.g., diagrams, lists, surveys, single element view. 

• One or multiple global filters can be created, viewed, edited, shared and deleted via a new global filter page in the administration.

• Global filters can be (de)activated via a global filter icon in the header menu.

• While a global filter is activated by a user, the corresponding data elements will be hidden for that user in LUY. Other users without an activated global filter will still see all these data elements.

• There are now two functional permissions for the usage of the global filter:

  1. Use global filters: Users with this permission can (de)activate existing global filters for their individual LUY account. Only users with this permission will see the global filter icon in the header menu.  

  2. Configure global filters: Users with this permission can configure, edit, share and delete one or multiple global filters via a separate page in the administration. Only users with this permission will see the global filter page in the administration.

• Sharing allows to provide configured global filters to particular users, user groups or roles, so that they can easily select and (de)activate a global filter without the need to configure it on their own. This possibility permits LUY admins or experts to support more inexperienced users in their reduction of data complexity and with a better focus on relevant data.  

• Any former "personal global filter" (LUY version <7.3.0) will be automatically migrated to a global filter and activated if the "personal global filter" was activated before. 

For more details, see Global filter in the user guide.

1.2 Meta model administration

A new meta model administration facilitates the overview and editing of all building block types, self-relations and relations of your LUY meta model configuration. 

• A list of all building block types (first tab of the meta model administration) facilitates the overview and selection of all building block types that are (de)activated for the meta model.

• By unselecting ("hiding") a building block type, the building block type list and any building blocks of its type are no longer accessible for any user and cannot be used for any relation or diagram/report configuration in LUY.

• For each building block type and relation, now a singular name can be defined in addition to the plural name. The singular name will be used in multiple places across LUY, e.g., in the configuration menu of diagrams, diagram legend or meta model list. 

As the singular name cannot be empty, the plural names defined in your previous version of LUY will be set for the new "singular" fields of building block types and relations by default. Some manual action will be required if you wish to define the correct singular form for building block types and relations.

• The functional permission "edit meta model" is required to see and access the meta model administration.

• Each building block type can be edited (second tab of the meta model administration), to review and modify the singular and plural names, persistent names, abbreviations, descriptions and translations of the type, its possible relations and self-relations.

• An edited meta model administration will be applied globally after saving all changes.

For more details, see Meta model in the user guide.

2. Improvements

2.1 Diagram configuration

The diagram configuration has been adapted for a more consistent and intuitive usage 

• The two formerly separated dropdowns for the selection of a building block type/relation/self-relation and of an attribute type are now combined in one dropdown. Building block types, relations, self-relations and attributes are listed below each other. 

• In the diagram tool area, a new configuration button opens an identical configuration menu to the one available when creating a new diagram, in order to facilitate diagram editing. The button replaces the former dropdown selection.

• For the configuration of most diagrams, you can now freely select from the required fields (e.g., content, columns and rows for the landscape diagram) in an individual order; other options will automatically adapt by showing all remaining possibilities. Previously, you had to follow the order of the fields from top to bottom. 

For more details, see the information about each diagram in the user guide.

2.1 Diagram legend

The new look & feel of the diagram legend facilitates the interpretation of diagram configurations, ensuring that a visualization will be understood at one glance by the creators as well as any diagram consumers. 

• The report name and description provide important context about the diagram.

• The new formatting of the legend shifts the focus to the configurations applied (e.g., filters, sorting, coloring) and data hierarchies.

• In case a partial limit has been set to restrict the data displayed in the diagram for performance improvements with big data, a hint in the legend will inform diagram consumers that not all existing elements are currently being displayed.

• The export includes the new diagram legend design.

For more details, see the information about each diagram in the user guide.

2.2 Notifications

For a better overview of incoming notifications on changes to data by other users, you can now clean up the notifications dropdown with a few clicks and keep only those notifications in “read notifications” that are relevant to you.

• You may manually dismiss single notifications using the delete icon “x” or delete all notifications at once via a “clear all” button.

• All read notifications will be auto-deleted after 30 days, and unread notifications will be auto-deleted after 90 days.  

• Deleting notifications improves the overview of notifications, speeds up loading times and improves scrolling the notification dropdown menu.

For more details, see notifications in the user guide.

2.3 Hierarchy level aggregation

We have made some adjustments to the aggregation of hierarchical elements in the landscape and cluster diagram. 

• Some corrections for displaying aggregated elements have been made.

  The slider handle in the row editors of the cluster diagram, and in the display menu of the landscape diagram has been slightly adjusted.

• In the cluster diagram, aggregated attribute values can be sorted (ascending/descending) and filtered (by row attribute filter).

• Default system attributes of a building block (e.g., id, position, hierarchy level) are not aggregated since they are always assigned to a specific building block and cannot be "inherited" by another.

• The colors of relation attribute values are not aggregated, i.e., not inherited from/to an aggregated relation. Relation attributes always show their own assigned color. 

Some of your saved Cluster or Landscape diagram configurations with an activated hierarchy level aggregation might have slightly changed to correctly show the aggregated elements. 

Please note that the position of an element will change according to the aggregation to a higher/lower hierarchy level, but the color of the element will not change in the same way. 

2.4 Some more highlights

• Reports that users are not entitled to open are shown as semi-transparent entries in the user’s list of all reports
  For users that do not have at least a "read" permission on all building block types used in a report, this report will be shown as a semi-transparent entry in their list of all reports, in order to visualize that those users cannot open the report.

•  Report permission changes during editing
  When another user has shared a report with you and changes your permission for the shared report or deletes the report while you are working on it, an info message will inform you about the changes and ask you to reload the report.

• "Select all" button for building block types and relations on the attribute edit page
  You can now select all building block types or relations for an attribute at once on the attribute edit page.

• Highlight one information system and its directly related information flows and information systems in the information flow diagram
  By clicking on one information system (node), all information flows (edges) and information systems directly related to this information system will be highlighted. The highlighted view can be exported, too.

3. Fixed bugs

• Fixed an issue when copying a building block with a responsibility attribute assigned.

• Fixed an issue where no plugin API logs were written in some scripts.

• Fixed an issue that displayed an incorrect error message for missing permissions.

• Fixed an issue that in some cases, a relation column could not be added to lists in the query console.

4. Important information

• An automatic session timeout after five minutes of inactivity has been applied as a default. This ensures continuous performance across various usage and security scenarios of LUY. 

• Please note that when using the user authentication LDAP or iTurm, re-authentication with the user's credentials is required if the browser is closed and only reopened after the session timeout expired.

• As of this version, the "Beta" feature diagram builder is no longer available in LUY.

• As of this version, Java 8 is no longer supported.

• This is the last full version of LUY supporting the Microsoft Edge Legacy browser. As of version 7.4.0, only Google Chrome, Microsoft Edge (=Chromium-based) and Mozilla Firefox will be supported in their respective stable release versions.

• This is the last full version of LUY supporting the current custom dashboard.

• If you need any further assistance with your use of LUY, feel free to contact our customer support or our sales department.

July 2021

The version LUY 7.2.2 is a service release for customers with special infrastructure setups.

What we fixed:

• Fixed an issue, so that multiple shared visualizations can be loaded simultaneously.

• Fixed an issue, so that log files will be created on a daily basis.

• Fixed an issue where a high number of users in the database slowed down login and the creation/update of a data element.  

• Fixed an issue with the loading time of the data element history in the case of a lot of change entries. To speed up loading in this case, you may use the new property max.history.elements in the LUY config file luy.properties to limit the number of history entries to be loaded. Please be aware that this property does not apply to history exports, which by default will export the entire history. 

• Fixed an issue with the data transfer when using MS Azure.

• Fixed an issue with saving a diagram/list report with an empty description when using an Oracle database.

May 2021

The version LUY 7.2.1 is a service release, in which we fixed some bugs in version 7.2.0 to further enhance the LUY experience for you.

What we fixed:

• Fixed an issue where multi mode might lead to endless loading when subscribing to elements or building blocks.

• Fixed the server time in the docker for script execution (now UTC).

• Fixed an issue with applying the data filter option "without" in nested layer, nested cluster and hotspot diagrams.

• Fixed an issue where sometimes, technical metamodel names were displayed in the UI.

• Fixed an issue with the Excel export/import that might appear when changing the user's application language settings.

• Fixed an issue where a large number of incoming in-app notifications could impact the performance of LUY for specific users.

• Fixed an issue with saving the filtering option "with ascendants" or "with descendants" in reports.

• Fixed an issue where for numeric attributes, cleared lower/upper bounds were not permanently saved.

February 2021

LUY 7.2.0 is a major release and includes the following new features and improvements:

1. New features 

1.1 New nested layer diagram

• The nested layer diagram is an evolution of the current nested cluster diagram. Using it you can visualize more interdependencies, from business architecture down to infrastructure in one single diagram! We recommend upgrading old diagrams to the new format. For further details see nested layer diagram in user documentation.

• Configure up to 7 diagram layers using building block types or attributes

• Supports relation attributes

• Migration of nested cluster diagram reports to the nested layer diagram is possible:

  • Nested cluster diagram reports can be opened and saved as nested layer diagram

  • Some settings might not be identically applied. Please review your diagram settings after the migration as some settings differ between the two diagram types.

• New functional permission for the Nested Cluster Diagram, to customize whether both diagrams or only the new one should be used 

  • Permission is required to see and use the nested cluster diagram

  • Data migration: All existing roles, currently able to see and use the nested cluster diagram also have permission for the new nested layer diagram

1.2 New general attribute "hierarchy level"

• Based on the parent/child structure

• Non-editable

• Use it in building block type lists:

  • Add hierarchy level attribute as a column in order to see the respective hierarchy level for each building block type

  • Filter building block types by hierarchy level

• Use it in diagrams:

  • "Color by" hierarchy level

  • Add hierarchy level as attribute type (not as edge line type) for most diagram types

• Use this attribute: $$hierarchy_level$$ for building block types in plugin API scripts, IteraQl or public APIs

• The attribute is shown in export for a building block type, but will be ignored in import

1.3 External sharing of building block type lists

• Building block type lists can now be shared with other users, as already possible for diagrams

  • Via a new share button in the menu of building block type lists, or

  • Via a share button in the list of all saved reports (shared list reports are indicated as such using different icons in the first column) 

•  Lists can be shared internally or externally

• Formats: JSON and CSV (additional option: CSV with Confluence-based syntax)

1.4 New "aggregate hierarchy level" feature in diagrams

• Replaces the hierarchy filter level dialog in diagrams

• You can still apply the previous feature "distrigation" (optional distribution and aggregation in the hierarchy filter level dialog) by using the new "aggregate hierarchy level" feature as well as the new hierarchy level attribute in the filter 

• Cluster and landscape diagram reports are migrated to the new functionality; the reports are backward compatible

• Important: If you used an information system in a diagram, selected the filter option "include information systems connected over information flows" and filtered by hierarchy level, the data and flow changed:

  • Before:

    • The filter configuration was applied (not including a hierarchy level filtering)

    • According to the filtered elements, every connected information system over information flow was added to the filtered list in addition

    • Based on the first and second step, the number of elements was filtered according to the hierarchy level

  • Now:

    • The filter configuration contains the filtering of elements according to their hierarchy level

    • Based on the filtered elements, connected information systems over information flows are added to the filtered list in addition

1.5 NEW button replaces RESET button in custom dashboard and query console 

1.6 Partial limits added for Edge legacy

1.7 New functional permission "export diagrams and lists"

• For lists, diagrams or print functionality on a single element view page

• Data migration: Existing roles have this permission by default, except if "list view features" > "export" was unselected

1.8 Color by relation attributes in cluster diagram and masterplan diagram

• The cluster and masterplan diagrams now support coloring by relation attributes, additionally to coloring by building block type attributes

• In the cluster diagram, rows can be colored based on the relation between row and header

• In the masterplan diagram, elements can be colored based on the relation between level 2 or 3 and the previous level 

1.9 Enumeration attributes can be copied

• You can now copy an enumeration attribute in the attributes list in administration > attributes via a new copy button in the action column

• Copying an enumeration attribute opens the configuration page of a new enumeration attribute with the name, description, attribute value and attribute group of the copied attribute

• For more information, see the attributes section in the user documentation.

2. Improvements

2.1 LUY header

• The selected page is better highlighted

• Hovering over a report name in the header now shows a peek info of the report

2.2 Reports saving

• A click on the save button always opens the save dialog with report name, description and tags

• You can either save the changes and thereby overwrite the report, or save a copy of the report

• If a diagram, query console or custom dashboard report has not yet been saved or contains unsaved changes, the "unsaved changes" indicator is permanently shown in the header. This does not apply to list reports.

• Reset the custom dashboard and query console page to default with click on the new button, either directly or after saving changes (reset button is removed)

2.3 Diagrams

• Diagram types are now sorted alphabetically in diagram lists and dropdowns for diagram selection 

• Coloring by stripes is improved for multi-relations 

• Diagrams are only listed in the menu "go to diagram" in the list view if you have permission for this diagram type

• Customizing the number format based on the diagram can now be used in all diagrams

• In the portfolio diagram, attributes with an unassigned value now have a smaller bubble size than attributes with an assigned value in addition to the striped border in order to highlight the difference

• New structure for the attribute selection on the start page of diagrams and in the "coloring by" menu:

  • The dropdown selection is grouped and sorted in this order: 

    • General attributes (system variables)

    • Top level attribute groups

    • Normal attribute groups

    • Relation attributes

  • Within each group, general attributes and relation attributes are sorted by name, top level and normal attribute groups are sorted by position.

• In the information flow diagram, edges are now counted within partial limits

  • If the partial limit is reached, elements are added in this order:

    • All parent nodes that are aggregated (not displayed as separate nodes)

    • Children nodes of already added parent nodes

    • Edges to/from parent nodes and child nodes

• Diagram tool area:

  • Checkboxes for a clearer status of selected/unselected display options

  • Improved usability of the menus in the tool area for better readability and handling

2.4 Single element view page

• The element ID is shown next to last modification user and time

• Copy the URL link to the clipboard with a click on the copy button in the toolbar

2.5 User settings

• If you open a report, e.g., the masterplan diagram, and leave the report without any changes, the report and not the saved user settings are loaded as soon as you return to the report (here masterplan diagram). Now, if another user changes the report in the meantime, you directly see the changes of the other user and not your previous state of the report. 

• User settings are saved before logout

2.6 Plugin API improvements

• New function api.http.execute() that contains not only the body of the response, but also the headers and status code. The old function api.http.performRequest() is deprecated

• New function api.http.reset() to reset the parameters saved in api.http

• New function api.survey.create(string surveyName, string surveyDescription, string savedQueryUuid, string responsibilityAttributePersistentName, numeric authorId). The recent function without authorId is deprecated. This way, the author is starting the script independently of the user. This function can also be used in scheduled scripts

2.7 Graphics reactor

• Publishing of a reactor directory is possible, including the content of up to two sub-directories. As the publishing configuration references a directory in the output field, execution of the related xslt script is omitted.

  • Rational: Publishing a reactor directory enables customers to deploy user interface extensions (e.g., single page applications accessing LUY context via REST API from within a user's LUY security context). As there is a high probability that these extensions collect required data by rest-API, omitting the script execution is tolerable.

• Add content type (MIME-Type) to published file

2.8 Small general improvements

• In the permission configuration, you can select all building block types at once

• Adding values for enumeration and responsibility attribute now via a dialog

  • Dialog opens with a click on the create button above the list of attribute values

  • Selection option "create another" (checkbox in the dialog) enables directly adding further attribute values after creating the current value

• If you re-log in after an enforced logout, you are redirected to the previously opened page instead of the LUY start page

• Default sorting of data history now shows the latest changes on top

• "Edit data" toolbar group name improved across LUY

• If the client and server version are inconsistent with one another, an info toast is shown to inform you that you should clear your cache and login is not possible

• Performance issue with enumerations improved 

• Functional permission for external report sharing split into two functional permissions

  • one for diagrams

  • one for building block type lists

• Error handling improved for REST resources

• SAML added to installation status check

• Upgraded to log4j2. Customized logging configurations must be changed to the new format. The configuration is now saved in thelog4j2.xml. For the files, please see the code blocks to the right.

    <RollingFile name="logfile"
                 fileName="../logs/luy_local/luy-7.2.log"
                 filePattern="../logs/luy_local/luy-7.2.log.%d{yyyy-MM-dd}">
      <PatternLayout pattern="[%-5p] %d{dd-MMM-yyyy HH:mm:ss} [%-c{3}] %m%n"/>
      <Policies>
        <SizeBasedTriggeringPolicy size="100MB"/>
        <TimeBasedTriggeringPolicy interval="24"/>
      </Policies>
    </RollingFile>

###############################################################
#FileAppender "logfile"
###############################################################
log4j.appender.logfile=org.apache.log4j.DailyRollingFileAppender
log4j.appender.logfile.File=../logs/luy_local/luy-7.2.log
log4j.appender.logfile.encoding=UTF-8
log4j.appender.logfile.DatePattern='.'yyyy-MM-dd
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout
log4j.appender.logfile.layout.ConversionPattern=[%-5p] [%d{yyyy-MM-dd HH:mm:ss}] (%c{3}) %m%n

<Logger name="org.springframework" level="warn"/>

log4j.logger.org.springframework=WARN

3. Dropped functionality

3.1 "Menu and tile position" removed from standard configuration in customizing page

• The default "centered" position is now permanent

4. Fixed bugs

• When externally sharing a diagram via SVG, the SVG contains URLs to LUY. The URL now uses the "urlbuilder.application.address" instead of "urlbuilder.sharedqueries.address" from luy.properties. 

• A filter configured for a navigator report was not applied correctly when opening the report in a list via "show in list" 

• "Unsaved changes" hint was mistakenly shown when opening an unchanged, saved diagram 

• Unsuccessful database migration because of error (in version 7.1.3) 

• Corrupt JSON when attribute description contained HTML tags

• Withdrawing permissions from attribute/attribute groups might have caused endless reloading

• License upload page did not open

• Directly executed plugin API scripts now have all permissions and no longer depend on user roles and permissions

• Personal global filter configuration with self-relations didn't filter data correctly

• Entering business mappings in the Query Console returned empty list instead of error message

• Graphics reactor now works with SAML2.

• Graphics reactor can now be accessed only with the functional permission "Use graphics reactor". Before, also the functional permission "Edit roles and grant permissions" was necessary

5. Additional notes for 7.2 (important!)

• With LUY 7.2, Internet Explorer 11 is officially no longer supported.

• With LUY 7.2, Information Security Management is officially no longer supported.

6. Announcements (important!)

• LUY will no longer support Java 8 as of version 7.3.0

• The diagram builder (beta version) test feature will be removed for version 7.3.0. Thank you for your feedback on this test feature.