TP-10738

Every endpoint of client requests in the Horizzon Server backend that somehow utilizes an offset and limit to return a smaller amount of data for performance considerations now has a pagination limit of 100 by default (provided that the client does not send any value for the limit). This also applies to the Bizzdesign OpenAPI. The Open API specification has been updated with this change.

For the latest version of the Bizzdesign Open API specification, please refer to Bizzdesign Open API.

TP-14715

The Horizzon audit log now also includes the following data:

• When data blocks and data block definitions are updated, deleted, or inserted using the Bizzdesign Open API, the remote address of the clients is now logged.
• There is a new log event "OpenApi Token Request" that shows the remote address, client ID, and grant type of the client that has attempted to obtain a token.
  
  
  

See also Horizzon audit log.

TP-14774

Sharing views from sites with all Horizzon users is no longer required before they can be shared outside Horizzon (embedding). Sharing them with one or more groups (instead of "All users") is now sufficient to enable embedding.

For more information, please refer to Sharing Horizzon views outside Horizzon.

TP-12708

Support for configuring user synchronization and authentication with a SAML 2.0-based identity provider has improved. Horizzon now includes a SAML metadata XML file, which can be used to automatically import the metadata in SAML identity providers to ease the integration process. This file can help customers who are newly configuring or moving from another identity provider to a SAML-based identity provider.

TP-14224

Following the introduction of version 3.2 of the ArchiMate Standard, the ArchiMate metamodel definition no longer provides specific relation role names. Enterprise Studio no longer shows the features of using these roles because they no longer serve any purpose. This means the option to switch between general and specific roles (check box Show general relation roles) is no longer available in the following places:

• Navigator pane
• Derive relations via relations command (Advanced ribbon tab)
• All dialogs for generating view filters (color view, label view, etc.)

Also, the optional "general roles" parameter of the fromRole and toRole script functions will no longer have any effect (general roles will always be returned).

TP-14630

The Deprecated Relations check (in the Check group on the ArchiMate ribbon tab) has been updated to check for relations across the entire model package that are no longer allowed according to the latest ArchiMate standard version (currently version 3.2).

TP-14093

In addition to SVG, creating posters of site views in PDF format is now possible. Like SVG, the PDF format supports generated color views and label views.  The PDF download is currently only available for diagrams and views originating from Enterprise Studio, not for Horizzon BPMN diagrams.

See also Creating a poster of a Horizzon view.

TP-14651

To optimize the overall performance in several aspects of Horizzon, creating sites based on projects is no longer possible if none of your Horizzon users have created sites for projects so far. If you have created sites for projects before, the change has the following effect:

• Existing sites for projects are not affected; they remain as they are. You can keep using them.
• Creating new sites for a project that does not have any sites yet is now disabled by default. To create sites for such a project, you must enable it on the project manage page. This can be done by Lead Designer users. 
• Creating new sites for a project that already has sites remains possible. It is enabled for this project. If you disable it for a project, all existing sites for that project will be deleted.

TP-14777

The scope tree for setting a site's scope now has a clearer separation between what is selected, indirectly selected, and not selected (three states) and what is in scope or not (two states). The objects and views on a selected level are in the scope and will be available in the site once created.

Example:

TP-14696

Bizzdesign introduces an improved site search capability designed to improve the site search experience within Horizzon. With the aim of making it easier and more efficient for users to find views, objects, and data, this feature includes a filter functionality that enables you to quickly narrow your search results based on specific criteria. By releasing this beta feature, Bizzdesign aims to gather your feedback and insights that will guide the future development efforts.

Bizzdesign offers you early access to try out the feature. It can be enabled by selecting the Site search filter check box in Early access features in the general Horizzon settings (System Administrator rights required). Once activated, the new search filter will be available in your Horizzon sites. If desired, the feature can be deactivated anytime.

For more information, please refer to Searching through a site.

TP-14749

The following shortcuts for performing operations have been added to improve the user experience in Horizzon.

• Holding down the Ctrl key while clicking a collapsed object on a view selects the object and opens its Properties panel. (Only clicking the object will show the contents of the collapsed object in a new view). Clicking the object again while holding down the Ctrl key unselects it and closes the Properties panel. Note: this does not apply to collapsed objects in Horizzon BPMN diagrams.
  
  
• Holding down the Ctrl key while clicking a refined ArchiMate object on a view opens the BPMN diagram of the refined object in a new view.
  
  
• Pressing the Escape key closes the Properties panel of a selected object or relation on a view.

For more information, please refer to Horizzon keyboard shortcuts.

TP-14391

The Bizzdesign Open API version 2.0 now supports creating links between entities and creating links between an entity and an object. The POST link operations for creating a link in a collection and creating a link in a container have been updated for this.

For the latest API specification, please refer to Bizzdesign Open API.

TP-14587

The presence of data blocks in standard indexes for OpenSearch Dashboards, which had been introduced in the 23 January 2023 release and temporarily disabled on 1 February 2023, has been restored. Data blocks are now available again in the standard indexes.

For more information, please refer to the original release note.

TP-14542

Diagrams and views created in Enterprise Studio can be shared outside Horizzon in Confluence and SharePoint by embedding them. If they contain collapsed content, they cannot be embedded on their own, but they can now be accessed via their parent diagram or view that is embedded. Clicking the collapsed object in the embedded diagram or view will show its content. Clicking in the diagram or view with the collapsed content will close it and return to the parent diagram or view. See also Sharing Horizzon views outside Horizzon.

TP-14661

All dates in Horizzon now have a tooltip showing the exact date and time. Moving the mouse pointer over a specific date or general date indication will show the exact date and time. Example:

TP-14450, TP-14633

The modeling tasks for updating BPMN diagrams are now included in the weekly tasks summary e-mail. Modeling tasks are indicated with .

TP-14546

If your organization has custom Help or information pages to support your users in working with Horizzon, you can now include its link in the Horizzon Resource Center to make it easily accessible to the users. In the Horizzon general settings, in Resource Center link, add the URL.

The custom link will be available in the Horizzon Resource Center using the display name of your Horizzon environment (The display name is also set in the Horizzon general settings). Clicking the link will open the page in a new browser tab. Please note that the Resource Center can only be used in the cloud solution.

For more information, please refer to Including custom help in your Horizzon environment.

TP-13071

It is now possible to define data policies on model level. The model-level policies replace the default policies on object level. On model level, data policies can be set per object type and per data block available on that type. A model-level data policy for a data block will apply to all objects of a specific type that do not have their own policy for that data block. A data policy set for a data block of a specific object will override the model-level policy.

Please note that setting up model-level policies is only possible for ArchiMate objects (created in Enterprise Studio, Horizzon, or via the Open API). For other metamodels, like BPMN and UML, data policies can only be defined on object level: per data block of a specific object.

Model-level policies:

Object-level policies:

What happens to your existing data policies?

Data policies set on an object's individual data blocks are still on that object's data blocks. Editors and/or readers assigned to the default policy of an object are now actively assigned to all individual data blocks of that object that did not have their own policy before. Any model-level policies you want to start using on ArchiMate objects still need to be defined by you. For more information, please refer to Moving from object-level-only to object- and model-level data policies.

How do the changes affect the Bizzdesign Open API? 

If you use the Bizzdesign Open API for setting data policies, please read the next release note, "Open API version 2.0 available". It contains important information.

TP-13977, TP-13071

Version 2.0 of the Bizzdesign Open API specification is available. The new version includes the following additions and changes.

Changes in calls related to data policies

Following the changes in the data policies, the Open API now supports retrieving, assigning, updating, and deleting editors and readers on model level. The following new operations are available.

Editors:

Readers:

The operations for editors and readers for an object have been removed in Open API version 2.0.

New operations for bulk deletion of entities and links

The Open API now supports the bulk deletion of entities and links from a collection. It can be done using the following new operations:

For the latest API specification, please refer to Bizzdesign Open API.

TP-14275

If an object has policies attached (object, data, or diagram policies), they can now be accessed directly from the object in the site. Clicking will navigate you to the model package Policies page, where you can see the policies set for the object.

The button is available on the object's Properties panel and Inspect page only if you have the Lead Designer role and have been invited to the model package on which the object's site is based. The button is not available on diagrams and views with data policies.

TP-14514, TP-14535

More user experience improvements have been made to Horizzon. Some highlights:

Last updated info on objects and views

The "Last updated" date of an object or view on the Horizzon homepage is now also updated if a data block associated with the object or view gets updated or when a BPMN diagram associated with the object gets updated.

Different colors for buttons on view page

Buttons on a site's view page are now gray-colored if they are on-page actions. Buttons that navigate to other pages remain blue.

Inspect function in context of view, default page for objects

The Inspect function is now shown in the context of the view. Clicking the button will open a sub-page showing the inspected content of the view. This is also reflected in the breadcrumb of the sub-page. Clicking will close the sub-page again and bring you back to the view. For objects, the Inspect page is now the object's default page to show when accessing an object via the Browse tab on the Horizzon homepage or via the site's Browse page.

Explore function in context of object or view

The Explore function is now shown in the context of the object or view. Clicking the button will open a sub-page showing the explored content of the object or view. The context is also reflected in the breadcrumb of the sub-page. Clicking will close the sub-page again and bring you back to the view or object page.

Content of collapsed element shown in context of parent view

View pages that are part of another view via collapsed elements ("nested" views), e.g., a collapsed BPMN sub-process, are now shown in the context of their parent view. Clicking a collapsed element in a view will open a sub-page containing the object's content. Clicking or will close the sub-page again and bring you back to the page with the parent view.

TP-14522

Creating posters (in SVG format) of published Horizzon BPMN diagrams is now possible. To do this, open the BPMN diagram page and click Download.

For more information, please refer to Creating a poster of a Horizzon view.

TP-14580

Logging of the communication between Enterprise Studio and the Activity Console has been improved by adding more information about the Activity Console API calls.

TP-14394

Performance improvements have decreased the chance of the Enterprise Studio user interface freezing.

TP-10778

Hyperlinks can now be imported and exported using an Excel connection. This applies to weblinks, file links, and e-mail links included in the default object property "references" and in custom properties of type "link". Before, using hyperlink properties in the connection was not supported.

TP-14327

Performance improvements have been made to the export using a ServiceNow connection, including a setting to use the ServiceNow batch API. If the setting Use Batch API for export is activated in the ServiceNow connection properties, the ServiceNow batch API is used when performing an export. The setting is activated by default, it can be deactivated if needed.

TP-14360

Documentation fields are now included in the response of the GET objects operation in the Bizzdesign Open API. To retrieve the documentation, the includeProfiles parameter in the operation needs to be set to true.

TP-14378

When working with the Bizzdesign Open API, it is possible to enhance security by limiting access to the Open API to only authorized IP addresses. Previously, specifying the IP allowlist needed to be requested by contacting Bizzdesign Support. This is no longer needed. You can now specify the IP allowlist in the general Horizzon settings. Accessing the settings requires the System Administrator role.

The setting is only available if the Open API is available in your Horizzon license (see Horizzon settings > License). When available, the setting is disabled by default. However, if you already had IP allowlisting for the Open API configured by Bizzdesign Support, it is enabled, including the allowlist IP ranges.

For more information, please refer to Bizzdesign Open API.

TP-14396

The object types in the selection list when creating new objects in Horizzon are now alphabetically ordered.

TP-14481

The performance of uploading data block values via the Bizzdesign Open API has been improved. One of the improvements includes only uploading values that have changed.

TP-14160, TP-14400, TP-14408, TP-14414, TP-14433, TP-14475, TP-14507

Several user experience improvements have been made to Horizzon. These include:

Icons for model package, project, and API client items

The abbreviations in model package, project, and API client items have been replaced with icons.

Centered toolbars in the BPMN modeling canvas

New icons for Inspect, Explore, and View BPMN

Zoom controls updated and aligned throughout Horizzon

Updated sharing and embedding of a site

Searching objects and models on homepage Design tab

The Design tab of the Horizzon homepage now also has a search field for finding objects (in Objects) and models (in Models). Type (part) of the name and press Enter to find objects or models. The Design tab is only available if a user has the Designer or Lead Designer role.

For more information, please refer to Searching on Horizzon list pages.

Thumbnails in list and overview pages

A thumbnail shows the BPMN diagram of an object refinement or the start view of a site. Clicking it will open the page with the diagram or view.

Direct access to Inspect and Explore page

A control is available on elements to directly access the Inspect page of a view or the Explore page of an object.

Navigate from container element to location in model

When browsing a site, click on a container element to find its location in the model.

Task notification improvements

The task notification pop-up window now shows the total number of tasks of the user, not only the open tasks but also the tasks in progress. Please note that the tasks shown on the list items on the homepage are only open tasks. Depending on availability, the number of tasks in the notification window includes data tasks (Contribute) and modeling tasks (Design). When clicking the tasks in the notification window, the user's My tasks page is opened. What will initially be shown on this page depends on where the user left the page the last time. That is remembered by Horizzon.

TP-14488

BPMN diagrams created in Horizzon can now be shared outside Horizzon in Confluence and SharePoint (embedding).

Any collapsed content in an embedded diagram can be accessed by clicking the collapsed object in the diagram.

The conditions for sharing a Horizzon BPMN diagram outside Horizzon are identical to the diagrams and views created in Enterprise Studio:

• The user is a Lead Designer.
• The user is invited to the model package or project the site containing the view (or diagram) is based on, or they are the site's creator.
• Embedding is enabled for the site.

For more information, please refer to Sharing Horizzon views outside Horizzon.

TP-14378

Previously, enabling embedded views in Horizzon could be activated by contacting Bizzdesign Support. This is no longer needed. You can now enable embedded views in the general Horizzon settings, including IP allowlisting to enhance the security of your data. Accessing the settings requires the System Administrator role.

Embedded views are disabled by default, but if your organization already had it activated by Bizzdesign Support, it is enabled, including any requested allowlist IP ranges.

For more information, please refer to Sharing Horizzon views outside Horizzon.

TP-13802

Performance improvements on chart populations have been made to keep loading model packages and refreshing charts up to speed.

TP-14480

The script methods objectsWithRole and relationsWithRole now take an optional second parameter <filter> that can be used to specify which type(s) the relation's end object may have.

For more information, please refer to objectsWithRole method and relationsWithRole method.

TP-13048

Various improvements have been made to the way Enterprise Studio logs unusual situations.

TP-14273

Following the update to ArchiMate version 3.2, two new standard viewpoints have been added:

• ArchiMate standard box view: All concepts are represented by a rectangle with an icon in the right-upper corner.
  
  
  
  
• ArchiMate standard icon view: All concepts are represented by an icon shape only. In general, the label is placed outside of the shape at the bottom unless it fits inside the icon shape.
  
  

The viewpoints can be found in the ArchiMate model context menu via New > ArchiMate.

TP-14344

The ArchiMate Stakeholder view now supports creating Groupings (composite elements) and relation junctions.

TP-12617

The Bizzdesign Open API now supports retrieving (custom) profile and metric data. The GET objects operation has been extended with query parameters to include profiles/metrics data of the returned objects.

For the updated Open API specification, please refer to  Bizzdesign Open API .

TP-14073, TP-14362

Following the 4 November 2022 release introducing the table view for editing data blocks, the table view now allows editing data block values directly in the table. This applies to all data block fields except those of type Reference and Text (markdown) and list fields (in which multiple values can be added). Clicking data cells of these types will open the quick view that slides in for editing values.

For more information, please refer to Editing data blocks using the table view.

TP-14055

Various changes have been made to the Horizzon homepage to improve its use.

Separate view and object sections for the Browse tab

Before, the Browse tab would show all views and objects together. Now, they have separate sections. Clicking Views or Objects will show them.

Display options Favorites, Popular, Last updated, Refined 

Following the new sections for views and objects, viewing your favorites, the most popular or last updated items can now be done using the new list with display options. A new display option Refined is available for objects. It shows all objects that are refined in a BPMN process. They have a BPMN diagram attached created in Horizzon.

Access to BPMN diagrams attached to objects

If an object in the Objects section of the Browse tab has a BPMN diagram attached, the diagram can be directly accessed by clicking on in the object, as shown in the above figure. The button is only available in the list view. If you use the grid view, the BPMN diagram can be accessed via the more options control on the object.

TP-13162, TP-14240

The ArchiMate metamodel has been updated to version 3.2 of the ArchiMate Specification. The main changes are:

• A derivation rule has been added for the Grouping element (following section B.3.5 of the specification).
  
  
• The restrictions on the derivation rules have been improved (section B.4 of the specification).
  
  
• The icon notation of the Meaning element has changed, and an icon notation has been added to the Work package element.
  
  
  
  
• The default color of the Plateau, Gap, and Location elements has changed.
  
  
  
  
• All concept icons in the model browser now match the colors used in the ArchiMate 3.2 Specification. The following concepts have been updated:
  • Composite elements container
  • Location
  • Gap
  • Work package
  • Meaning
  • Outcome
    
    
    
    
• Composition and Aggregation relations can now be added between Plateau and Outcome elements, and Realization relations can be added between Material and Equipment elements.
  
  
• Relations no longer allowed following the ArchiMate 3.2 Specification have been deprecated. Models with those relations can still be read, but new relations can no longer be created.
  
  
• Although the ArchiMate 3.2 Specification changed the Technology Layer metamodel, making Device, System Software, Facility, and Equipment no longer subtypes of the Node element but of the technology internal active structure element, these are still subtypes of the Node element in Enterprise Studio. If you are querying your model for Nodes, the results will potentially include Devices, etc. Therefore, you should consider adding an additional type filter to those queries to exclude those subtypes.
  
  

• As of this release, Enterprise Studio no longer supports the specific role names for relations. The role names were never part of the standard and have now been completely removed.
  

  If you use scripts that use specific role names, you will need to update them. For more information, please refer to the item under Scripting in these release notes.

  
  

For an overview of all ArchiMate elements, please refer to the ArchiMate 3.2 overview poster.

TP-13205

Data block fields (of all available types) and their values are now available in the standard indexes in OpenSearch. When creating an index pattern for dashboards, the data block fields can be recognized by the prefix datablocks.<namespace>:.

TP-13809

Limited functionality to edit data blocks in Enterprise Studio is now available. The following places in Enterprise Studio now allow setting data block values directly:

Properties pane:

Properties form:

Properties table:

Please note the following:

• The objects with data blocks in Enterprise Studio are checked for data policies.
• Only one object at a time can be edited. The data blocks cannot be edited in bulk or via script.
• Editing data blocks is only possible on objects created in Enterprise Studio.
• Calculated fields are not updated automatically.

For more information, please refer to Editing data blocks in Enterprise Studio.

TP-13926

Few styling changes have been made to Horizzon, including a number of updated icons in the Horizzon sidebar and icons for user manage permissions in packages.

TP-14055, TP-14187

A published BPMN diagram now displays a thumbnail showing the diagram's contents instead of a general image. The thumbnail is available in the Properties slide panel of the object and also on the object's inspect page. Also, a BPMN diagram can no longer be set as a favorite, since this can already be done for the object it belongs to. Example:

TP-14170

Create space

It is now possible to move elements aside to make room for new elements or add space to the diagram. It can also be used to create space within an element. This function is similar to the Make room function in Enterprise Studio.

To use the function, right-click on a space (or on an element) in the modeling canvas and drag toward the direction where you want to create space. Any elements positioned next to where you start dragging will be moved aside into the dragging direction. Example:

Select elements

Elements in the BPMN diagram can be selected by dragging a rectangle around them using the mouse. For an element to be included in the selection area, it now needs to be fully contained by it. Partially contained elements are not included. To select elements within another element using a selection area, hold down Shift and drag a rectangle around them. After selecting the elements, they can easily be moved together by dragging the group.

TP-14186, TP-14253

Select similar elements

It is now possible to select a specific set of elements in the diagram. Select one element and then press Ctrl+E. All other elements of the same type will also be selected. This function is similar to the Select similar  function in Enterprise Studio.

Set the direction of data association relation

It is now possible to set the direction of an association relation by hovering the relation line and clicking . The direction(s) that can be set depends on the used data type (Data input, Data output, or Data object). Also, the positioning of elements connected with a data association has improved.

Connect message flows to pools

Connecting a message flow to a pool has been made easier. Drag the flow to the first border of the pool until it turns green and release the mouse button.

TP-14250

The sidebar of the Horizzon Design page containing the modeling canvas has changed. It now contains the menu items belonging to the model instead of the model package, which is the appropriate context for the diagram. The new context is also visible in the breadcrumb at the top of the page.

TP-14271

It is now possible to undo changes on a BPMN diagram in Horizzon. All unpublished changes to the diagram will be made undone. If the diagram has been published before, it will return to its last published state. If the diagram has not been published yet, it will be emptied.

For more information, please refer to Working on modeling tasks.

TP-14289

Few terminology changes have been made in the context of process modeling, they include:

• The title of the Horizzon page containing the model canvas has changed from "Refinement of..." to "BPMN diagram of ...".
• Modeling tasks are now called Diagram update tasks.

TP-13162

One of the changes in the implementation of ArchiMate Specification version 3.2 is that Enterprise Studio no longer supports the specific role names for relations. The role names were never part of the standard and have now been completely removed.

If you use scripts that use specific role names, you will need to update them. The scripts will not fail, but return unintended or incorrect results and this might go unnoticed. You need to replace specific role names with general role names and optionally add a type filter for the target object. Depending on the contents of your script, other adaptations to the script may be needed to restore its original behavior.

An example is shown below. In the figure, the specific role names are shown on the left, and the general role names are on the right.

The following script is used to find the processes that are triggered by the actor:

forall obj in actor.objectsWithRole("triggers process") {
	output obj;
}

Following the example figure above, the result would be only the process. Now, if the general role name is used:

forall obj in actor.objectsWithRole("triggers") {
	output obj;
}

the result would be the process as well as the service. Since this is not the desired outcome, you need to make another adjustment to the script to get the correct result by adding a type filter "ArchiMate:BusinessProcess":

forall "ArchiMate:BusinessProcess" obj in actor.objectsWithRole("triggers") {
	output obj;
}

TP-14246

The script method getTaggedValues now has an optional boolean parameter "persistent". When "true", only tags are returned that were added as being persistent. When "false", nonpersistent tags are returned. When the parameter is omitted, getTaggedValues returns all tags, as before.

For more information, please refer to getTaggedValue(s), hasTaggedValue, removeTaggedValue, setTaggedValue method.

TP-14077

Performance improvements have been made for opening model packages in Enterprise Studio. Opening a model package will now take less time. The modification also affects ordering the contributions in the model package timeline. The order will now be based on the order of the contributions as they are retrieved from the server instead of when they have been added (committed).

TP-14306

By default, the text labels of a label view in Enterprise Studio are presented as one-line labels. In the case of labels with a long text, it can be useful to have the label text wrapped for readability. It is now possible to wrap the text in the labels of label views generated on objects and relations. To activate text wrapping for label views in Enterprise Studio, select the new option Wrap label view text on the General tab of the Enterprise Studio Options. When activated, the labels are adjusted to the with of their objects (but with a minimum width).

For more information, please refer to Enterprise Studio general options.