As a Contributor user you have access to data blocks in Horizzon sites that have been shared with you. You can edit the data blocks in two places in Horizzon: in the Properties panel of elements in sites and on the Contribute page of a model. Editing data blocks via the Contribute page is only possible if you are an assigned editor for the data block, which is set in the data block's data policies.

If you edit a data block in one place, its values will automatically be processed in the other places where the same data block is available, as long as it is located within the same model package.

Required roles

Contributor


On this page:


Data entry locations

Properties panel in site

As a Contributor user you can edit data blocks in the Properties panel of elements in sites you have access to, unless the following situations apply:

  • If the data block has a data policy and you are not an assigned editor for this data block, you can only view the data block.
  • If the data policy of the data block has assigned readers and you are not one of them, you cannot view the data block.
  • If the data block does not have a data policy, but a strict writing access has been set for all data blocks in the model package the data block belongs to, you can only view the data block.


Data block fields that you set as a favorite will appear in the Favorites section of the Properties panel. There, the data block fields are always read-only. If you want to change their value, it can only be done in the data block sections of the Properties panel. The changed values will automatically be updated at the favorites.


Data block sections below the Properties section of an object

Contribute page in model

If a data block has a data policy and you are an assigned editor in this policy, you can edit the data block on the Contribute page of the model the element with the data block belongs to. The Contribute page shows all elements with data blocks in the model you have editing permissions for. Here you can edit all data blocks in a model in one place without needing site access.

The elements on the page may be part of a data task that is awaiting your action. In that case, it will be indicated on the element. The task will also be shown in your tasks overview.


Data tab of the Contribute page showing all elements with data blocks that can be edited


The elements are shown with a maximum of 20 per page. If there are more, navigation controls will be available at the top of the list. The elements are presented in the default language of the model package they are in. The default language is set in the model package in Enterprise Studio. The list can be sorted on element name or on open tasks. The elements can be searched on their element name.

Data block field types

Fields in data blocks can be of different types. The following field types can be available:


Field typeAllowed value 
String

Plain text, multiple lines allowed.


Text

Formatted text, multiple lines allowed.


Boolean

Value is  true  or  false .


Real

Numerical value with decimal points.


Integer

Whole numerical value (no decimal points).


Date

Date value.


Money

Money value.


Enumeration

Closed list of values of which one value can be selected.

Not to be confused with a data block field that is a list field. If a data block field of type enumeration is a list field, multiple values can be selected from the closed list of values.


Reference

Closed list of existing model objects of a particular type. Can be more than one type. 

Not to be confused with a data block field that is a list field. If a data block field of type reference is a list field, multiple values can be selected from the list of available objects.



When selecting a model object, there is an info control available next to the object name in the selection list. Moving your mouse pointer over it will show in which model the object is located and in which layer or container within the model.

Objects that are outside the scope of the site cannot be selected. If an existing selected object gets outside the scope of the site at some point, it will be indicated in the data block field.

Calculated fields

Fields of type real, integer, money, and enumeration can be a calculated field. A calculated field is a read-only field. Its value is automatically calculated based on values from other fields within the same data block. The way the value is calculated is defined in the data block definition. The other fields can be regular fields in which you can enter a value, but they can also be calculated fields in itself, getting their value from other fields within the data block. In the example figure below, the top field ("Overall risk value") is a calculated field. Its value is the calculated (and converted) average of the other three fields in the data block.


List fields

All data block field types, except the types Text and Boolean, can be defined as a list. If a data block field is a list, it will be possible to add multiple values instead of a single value to the data block field in Horizzon. Added list items can be sorted in the field and the list can also be emptied. A data block can be defined as a list in the data block definition. Below is an example of an object reference list field with multiple values.


Accessing data blocks

Via the site

In a site, the the data block sections are located directly below the Properties section in the Properties panel of an element in the site. The element can be a diagram, view, object, or relation.

To access the data block of an object or relation, click the element in the diagram or view and check the Properties panel for the data block, or go the Inspect page of the element by clicking at the top of the Properties panel.

To access the data block of a diagram or view, scroll down the page containing the diagram or view. Below the diagram or view, you can see the Properties section and data block section. You can also go to the Inspect page of the diagram or view by clicking Inspect at the top of the view.


The following access options are only applicable if a data block has a data policy.

Via the Objects overview on the Horizzon homepage

You can access data blocks on the Contribute page via the Contribute - Objects overview on your Horizzon homepage. The overview shows all elements with data blocks you have editing permissions for. They can be elements of multiple models. If an element is part of a data task, it will be indicated on the element. Clicking an element will directly send you to the Data tab of the Contribute page where you can edit the data blocks of the selected element.

 

Objects overview on Horizzon homepage showing elements with data blocks editable by the user


The elements in the Objects overview are shown including the name of the model package they are in. They are shown with a maximum of 20 elements per page. If there are more, navigation controls are available at the top of the list. The elements are shown in the default language of the model package they are in. If elements from different model packages are present, it is possible that they are shown in different languages, depending on their model package's default language.

The list can be sorted on element name, the date they have last been updated, the name of the model package they are in, or on the open tasks. The elements can be searched on their element name or model package name.

Via the tasks overview

If there are tasks for editing data blocks, they will be shown on the My tasks page. Clicking an open task on that page will directly send you to the data block on the Contribute page.

Via the Models overview on the homepage

Another way to access the data blocks on the Contribute page is via the Models overview on your Horizzon homepage. The overview shows all models you have editing permissions in. It can be permissions to create objects, but also to edit data blocks. They can be models from different model packages. If a model has tasks mentioned, it contains elements with data blocks awaiting your action.

Clicking a model will open its Contribute page showing the Object tab. This is the tab for creating objects. Select an element on the left and click the Data tab to access its data blocks.

Via the model package

Finally, data blocks on the Contribute page can also be accessed via the model package:

  1. In the sidebar menu, click Packages, and on the Model packages page, click the model package in which you want to edit data blocks.

  2. In the sidebar menu, click Models, and on the Models page, click the model in which the elements with the data blocks are.

Editing a data block

Editing a data block works identical in a site (left image) and on the Contribute page of a model (right image). You can use the Tab key to navigate through the data block fields.

  1. Next to an attribute field, click or click in the field to directly edit it.



  2. Enter a value in the field. The way a value can be added depends on the type of field. To remove an existing value from a field, empty the field.



    If a field is of type list, it is possible to add multiple values. Click Add new field to add an additional value.



  3. Click next to the field or press Enter to save the changes. If you leave the field directly after editing and click in another field or somewhere next to the data block, changes will also automatically be saved.

    To cancel the operation, click  or press Esc. Any changes will be discarded.

    To remove an existing value, empty the field and click . Emptying the field is not possible in a field of type Boolean, or with a closed list (enumeration or reference).


If you are updating data block values for a data task, click Complete task at the bottom of the data block to complete the task, and then click Complete to confirm.