Skip to main content
Skip table of contents

LUY 8.2.0

LUY 8.2.0

August 2025

With version 8.2.0-1 we are taking a major step forward by migrating from XWiki to Markdown, ensuring modern and consistent text formatting across LUY. We have also added a new predefined “Version – built-in” attribute to give you more control when working with versions of information systems and technical components. In addition, case-insensitive lookup in the Plugin API improves consistency and reduces the need of manual workarounds.

As always, this release also includes several performance optimizations and bug fixes to keep LUY reliable platform for your enterprise architecture management.

Please ensure a backup of your current LUY Data before updating to version 8.2.0-1. Especially considering our transition from XWiki formatted text to Markdown (see 1.1 below).


Improvements

1.1 Migration of LUY’s text formatting syntax from XWiki to Markdown

All multiline text fields, including descriptions and multiline attributes, in LUY are now stored in Markdown instead of XWiki syntax. This change ensures better interoperability with external tools, simpler formatting, and improved content rendering in the new frontend.

We have implemented markdown in such a way so that it is compatible with our LUY Classic frontend: The backend automatically converts Markdown to HTML for seamless rendering in the old UI. In order to use formatted text in LUY Classic, you will now need to use markdown formatting syntax.

Error handling & logging: Any failed XWiki-to-Markdown conversions are logged while preserving the original text.

The most frequently used formatting options work very similar in XWiki and in Markdown syntax. Some advanced XWiki syntax may not convert perfectly—review after migration. Markdown focuses on simplicity and readability, so some custom stylings are not supported. (see our Markdown vs. XWiki comparison in the expand below.)

With LUY now expecting Markdown formatting, please ensure that your Plugin and REST API integrations are using markdown formatting instead of XWiki.

Text input using XWiki syntax will be technically accepted, but won’t look good in LUY Classic since XWiki syntax is not translated into formatted text anymore.

XWiki and Markdown format comparison

The following table contains a general comparison of XWiki 2.0 and Markdown syntax. Rows highlighted in yellow indicate lack of the support for the given XWiki feature. Markdown focuses on simplicity and readability, so some custom stylings are not supported.

Feature

XWiki 2.0 syntax

Markdown syntax

Bold text

**text**

**text**

Italic text

//text//

*text*

Striked out text

--text--

~~text~~

Monospace text

##text##

`text`

Underline text

__text__

Not supported, will be migrated as italic text.

Subscript text

,,subscript,,

Not supported, will be migrated as ,,text,,.

Superscript text

^^superscript^^

Not supported, will be migrated as ^^text^^.

Custom styling

(% style="color:blue" %) text

Not supported, will be migrated as regular text.

Headings (levels 1-6)

= text =
== text ==
=== text ===
==== text ====
===== text =====
====== text ======

# text
## text
### text
#### text
##### text
###### text

Horizontal line

----

---

Bullet list

TEXT
* item 1
** item 2
*** item 3
* item 4
TEXT
* item 1
  * item 2
    * item 3
* item 4

Numbered list

TEXT
1. item 1
11. item 2
111. item 3
1. item 4
TEXT
1. item 1
  1. item 2
    1. item 3
1. item 4

Mixed list

TEXT
1. item 1
1*. item 2
1**. item 3
1. item 4

or

* item 1
*1. item 2
*11. item 3
* item 4

Not supported, nested lists will be migrated with the type of the top-level list.

TEXT
1. item 1
  1. item 2
      1. item 3
1. item 4

or

* item 1
  * item 2
    * item 3
* item 4

Styled lists (with custom bullet icon)

TEXT
(% style="list-style-type: square" %)
* item 1
** item 2
* item 3

Not supported, will be migrated as bullet list:

TEXT
* item 1
    * item 2
* item 3

Definition lists

CODE
; term
: definition

Not supported, will be migrated as term: definition text.

Line breaks

First line\\Second line

In Markdown line break is marked by 2 subsequent whitespace characters “ “ followed by a new line.

CODE
First line  
Second line

Direct link

[[https://luy.eu]]

<https://luy.eu>

Labeled link

[[LUY>>https://luy.eu]]

[LUY](https://luy.eu)

Link opening in new tab

[[LUY>>https://luy.eu||target="_blank"]]

Not required anymore. All links will open in a new tab by default.

E-mail link

mailto:john@smith.net

<mailto:john@smith.net>

Labeled e-mail link

[[john@smith.net>>mailto:john@smith.net]]

[john@smith.net](mailto:john@smith.net)

Table

CODE
|=Title 1|=Title 2
|Word 1|Word 2

or

!=Title 1!=Title 2
!!Word 1!!Word 2

Multiple table headers are ignored in Markdown and only the 1st row can have a header appearance (in XWiki any row can be marked as header by using |=). If the table didn’t have a header in XWiki, then the first row will become table’s header in Markdown.

CODE
| Title 1 | Title 2 |
| ------- | ------- |
| Word 1  | Word 2  |

Styled tables

CODE
(% style="background-color:red" %)
|=Title 1|=Title 2
|Word 1|Word 2

Not supported. Styled tables will be migrated as regular tables.

Image

image:https://luy.eu/img.png

![https://luy.eu/img.png](https://luy.eu/img.png)

Image with caption

[[Captioned image>>image:https://luy.eu/img.png]]

Captions are not directly supported in Markdown. We migrate captions as regular text appearing right after the image.

![https://luy.eu/img.png](https://luy.eu/img.png) Captioned image

Styled images

[[image:https://luy.eu/img.png||width="25" height="25"]]

Not supported, will be migrated as default image without any parameters.

![https://luy.eu/img.png](https://luy.eu/img.png)

Quotations

CODE
> This is a single quote.

> This is other quote with nesting.
>> This is the nested quote.
CODE
> This is a single quote.

> This is other quote with nesting.
>> This is the nested quote.

Groups

CODE
|=Header 1|=Header 2|=Header 3
|Cell One|(((
= Embedded document =

Some embedded paragraph.

* list item one
* list item two
  ** sub-item 1
  ** sub-item 2
))) | Cell Three

Not supported. In Markdown only inline-styling is allowed inside table, lists or other container elements. Elements specified in the group tag ((( ))) will be converted to Markdown, but all line breaks will be removed. In the frontend this will typically result in seeing unformatted Markdown syntax.

Performance optimization:
  • Database queries related to formerly XWiki, now Markdown rendering have been optimized for faster load times.

  • Improved caching of attributes.

1.2 Introducing the “Version - built-in” attribute

With this release, we are excited to introduce a new predefined LUY attribute called "Version - built-in". Per default it is enabled for information systems and technical components. This provides you with greater flexibility and control when managing version information for these building block types.

What does this mean? In LUY, all characters following a "#" in the name of information systems and technical components are interpreted as the version number of this information system or technical component. This value will now be automatically recorded in the "Version - built-in" attribute.

For example: An information system named "LUY #8.2" will automatically have its
"Version - built-in" attribute set to "8.2".

This attribute is read-only and is automatically updated when changes to the name of its information system or technical component occur.

You have full access to the version values within the following LUY features:

  • Filter in list view

  • Filter in all types of diagrams

  • Query console

  • Part of the Excel export as a separate column

  • Plugin API

  • REST API

To use the attribute in the Query console, Plugin API, or REST API please use the technical name provided on the page Technical names.

This new feature will soon replace the current "Version" filter, which is currently only accessible in the filter. To ensure a seamless transition for future releases, we highly recommend updating your current reports to use this new predefined attribute.

Important:

If you have previously created a custom attribute named "Version - built-in", please rename your custom attribute before the update to avoid conflicts with the new predefined attribute.

Limitations:

  • The "Version - built-in" attribute is available as a column in list reports but it is not visible in the single element view. For cloud customers, the attribute is visible in LUY Nova.

1.3 Case-insensitive lookup is supported in PluginAPI

We improved the behavior of api.datamodel.findByTypeAndName to add an option to search for names specifically case-insensitive. Admins setting up the PluginAPI can now use a new ignoreCase option.

Previously, the method returned no result if the exact case did not match, e.g. searching for “JIRA" did not find an element named “Jira". This behavior was unintuitive and inconsistent for users configuring PluginAPI-based logic.

Now, by explicitly setting the ignoreCase flag to true, you can search in a more user-friendly and predictable way:

CODE
api.datamodel.findByTypeAndName('InformationSystem', 'JIRA', { ignoreCase: true })

Without the ignoreCase flag the method remains case-sensitive to preserve backward compatibility.

Fixed bugs

  • Fixed an issue where relation attributes were incorrectly displayed in the list view.

  • Fixed an issue where surveys could not be created via PluginAPI.

  • Fixed an issue preventing api.metamodel calls in PluginAPI from functioning in reaction scripts. Scripts using metamodel methods now work reliably without the need for a manual workaround.

  • Fixed an issue where setting a custom color for outer/inner type coloring in nested cluster diagrams would cause the other type's coloring to be removed.

  • Fixed an issue where enabling external sharing on a report would inadvertently delete its associated tags.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.