Horizzon sites contain regular model information coming from metamodels and models in Enterprise Studio. The data is read-only and can be viewed and used for analysis goals, like in generated viewpoints, charts and dashboards. 

In addition to the regular read-only information, Horizzon supports model data enrichment with self-defined information. Sites can be enriched with data by defining sets of additional element attributes of which the values can be set and edited in Horizzon. These sets of attributes are defined in data block definitions in Enterprise Studio. After being uploaded to the central data block store, the values can be set and edited in data blocks in Horizzon sites.

Data blocks can be used on diagrams, views, objects, and relations. The definitions are linked to their types. The different types of data can be entered in data block fields in Horizzon, for example, money and date values, Boolean values, formatted text, and closed lists. Some of these field types can be calculated fields. Calculated fields are read-only, their value is automatically calculated based on values entered in other fields within the same data block.

To limit user edit rights on data blocks for Contributor users in Horizzon, editors can be specified in data policies. Data policies can also be used to hide data block information from unauthorized Consumer users by specifying readers in the policies.

Maintenance of the data blocks can be set up by defining data update schedules, which are part of the data policies. Scheduled maintenance is presented in data tasks that can be performed by Contributor users.

On this page:

Defining data block definitions

To enable working with data blocks in Horizzon, data block definitions need to be defined in a shared model package in Enterprise Studio, and then uploaded to the data block store. The data block store is the central storage on the server containing all data block definitions created and uploaded by users. A data block definition consists of a set of attributes linked to one ore more diagrams, views, objects and/or relations.

Once a data block definition has been uploaded to the data block store, the associated data block is available in Horizzon sites that are based on the model package in which the data block definition has been created. They are available in the diagrams, views, objects and/or relations of the types specified in the definition.

Creating a data block definition

Setting up data policies

By default, data blocks are visible in sites that are based on the model package containing the data block definitions. They are located in their own section below the Properties section of the respective diagram, view, object or relation. Data blocks can be edited by all Contributor users. By setting up data policies you can limit data block editing for users and also set up data maintenance for the data blocks.

Data policies also enable Contributor users to edit data blocks on the data entry page of the model package without needing access to the site. Data policies can be set up at element level (diagram, view, object, relation), but also at data block level.

Setting up data policies for data blocks

If you set up data policies at data block level, any other data blocks without data policies remain editable to Contributor users with access to the sites these blocks are in. You can even further limit these edit rights by setting a strict data block write access. With strict access, nobody can edit data blocks that do not have a data policy specified.

Limiting write access for data blocks without data policies

Setting up data maintenance

If you want data block values to be periodically updated by users, you add data update schedules to the data policies of the data blocks. The allowed editors of the data blocks will receive data task notifications for updating the values. Editors are directed from the data task to the data entry page with data blocks that need to be updated.

Setting up data maintenance for data blocks

Working on data tasks for updating data block values

Viewing and editing data blocks in Horizzon

Once data block definitions have been created in a model package in Enterprise Studio and uploaded to the data block store, the associated data blocks are available in shared Horizzon sites based on that model package.

Any Consumer user with access to these sites can view these data blocks. Contributor users that have access to these sites can also edit the data blocks. If data policies have been set up, these edit rights may be limited. With data policies, Contributor users can also edit data blocks via the data entry page of the model package.

Editing data blocks in Horizzon

Using data block values in Enterprise Studio

The values from data blocks in Horizzon can be used again in Enterprise Studio. You can use them for example in color views and charts, just like regular object attribute values. Only data blocks that have at least one value will be shown in Enterprise Studio, data blocks without values will not be shown. 

Data block values are read-only in Enterprise Studio, you cannot edit them. Reason is that data blocks and their values are stored on a server, separate from the model package information that is stored on Horizzon. Data block values are only available in a model package for the duration of an Enterprise Studio session, as long as the model package is open. They do not persist once you close the session, nor will they be included if you would save a model package with data blocks as another copy.

Using data block information from Horizzon in model packages in Enterprise Studio

Automating data enrichment

Instead of or in addition to manually creating, updating and removing data block definitions and filling data block values in Horizzon, the Bizzdesign Open API can be used for this. The API allows an authorized client application to directly create, modify and delete data block definitions in Enterprise Studio and to enter data block values in Horizzon.

Bizzdesign Open API

When you are including externally stored and managed data in your Enterprise Studio models using the Open API, you can even use data blocks to further enrich this data. Data blocks can be available for the entities in the collections of external data.

Including external data in model packages