Skip to content

Property Shapes¤

Property Shapes are resources of type shacl:PropertyShape. They are used to specify constraints and UI options that need to be met in the context of a Node Shape.

The following Property Shape properties are supported:

Naming and Presentation¤

Info

In this group, presentation and naming properties are collected. Most of the properties are straight forward to use, other properties provide more complex features, such as table reports.

Name¤

This name will be shown to the user.

Used Path: shacl:name

Description¤

This text will be shown to the user in a tooltip. You can use new and blank lines for basic text structuring.

Used Path: shacl:description

Order¤

Specifies the order of the property in the UI. Ordering is separate for each group.

Used Path: shacl:order

Group¤

Group to which the property belongs to.

Used Path: shacl:group

Show always¤

Default is false. A value of true let optional properties (min count = 0) show up by default.

Used Path: shui:showAlways

Read only¤

Default is false. A value of true means the properties are not editable by the user. Useful for displaying system properties.

Used Path: shui:readOnly

Chart Visualization (deprecated)¤

Integrates a chart visualization in the property shape area. Shapes with an integrated chart are ALWAYS shown in read mode and NEVER shown in edit mode. This Property is deprecated - please use a Widget Integration instead.

Used Path: shui:provideChartVisualization

Provide Workflow Trigger (deprecated)¤

Integrates a workflow trigger button in order to execute workflows from or with this resource. Shapes with an integrated workflow trigger are ALWAYS shown in read mode and NEVER shown in edit mode.

This property is deprecated - use a Widget Integration instead.

Used Path: shui:provideWorkflowTrigger

Vocabulary¤

Info

In this group, property paths as well cardinality restrictions are managed.

Property of¤

The node shape this property shape belongs to.

Used Path: shacl:property

Path¤

The datatype or object property used in this shape. This path will be ignored if there is a table report defined for the property shape. However, in the Business Knowledge Editor, this path can always be used for exploration.

Used Path: shacl:path

Query: Path Builder¤

Use this property to define a dynamic set of target resources or literals using a custom SPARQL query. This allows for advanced selection logic, including filtering, transitive relationships, or specific path sequences as well as the definition of a result set order.

The values bound to the first variable in the query’s projection will be treated as directly connected via the sh:path specified in this property shape. This enables simple backward-chaining inference. Note that the infererred connections are not (yet) included in SHACL validation.

The following placeholder can be used in the query text of the SPARQL query:

  • {{shuiGraph}} - the currently used graph
  • {{shuiResource}} - refers to the resource which is rendered in the node shape where this property shape is used (maybe a sub-shape)
  • {{shuiAccount}} - the account IRI of the active user, this includes the username (use a SUBSTR() function if you need the name only)
  • {{shuiAccountName}} - the user name/ID of the active user account
  • {{shuiMainResource}} - refers to the main resource rendered in the start node shape of the currently displayed node shape tree (only relevant in case of sub-shape usage)

Note that for a proper usage of this feature, you additionally need to have the projection variables ?graph or ?_graph (the graph IRI where the relation statement is saved resp. in the context of which it was inferred) in your query.

If the connected property value is a resource, the variables in the projection of this query will be used to populate the columns in the complex widget and the advanced editor.

Used Path: shui:valueQuery

Node kind¤

The type of the linked nodes. In the Business Knowledge Editor, if these nodes are literals, they cannot be explored, but will be shown as metadata.

Used Path: shacl:nodeKind

Min count¤

Min cardinality, 0 will show this property under optionals unless ‘Show always = true’

Used Path: shacl:minCount

Max count¤

Max cardinality

Used Path: shacl:maxCount

Datatype Property Specific¤

Info

In this group, all shape properties are managed, which only have effects on datatype properties.

Datatype¤

The datatype of the property.

Used Path: shacl:datatype

Use textarea¤

Default is false. A value of true enables multiline editing capabilities for Literals via a textarea widget.

Used Path: shui:textarea

Regex Pattern¤

A XPath regular expression (Perl like) that all literal strings need to match.

Used Path: shacl:pattern

Regex Flags¤

An optional string of flags for the regular expression pattern (e.g. ‘i’ for case-insensitive mode)

Used Path: shacl:flags

Languages allowed¤

This limits the given Literals to a list of languages. This property works only in combination with the datatype rdf:langString. Note that the expression for this property only allows for ‘2 Char ISO-639-1-Codes’ only (no sub-tags).

Used Path: shui:languageIn

Languages Unique¤

Default is false. A value of true enforces that no pair of Literals may use the same language tag.

Used Path: shacl:uniqueLang

Object Property Specific¤

Info

In this group, all shape properties are managed, which only have effects on object properties.

Class¤

Class of the connected IRI if its nodeKind is sh:IRI. In the Business Knowledge Editor, any new node that a user creates by means of this property shape, will be an instance this class.

Used Path: shacl:class

Used Class for Resource Creation¤

Use this property to overrule which class is used when a user creates a new resource inside of this property shape on-the-fly.

Used Path: shui:usedClassForResourceCreation

Disable default sorting of values¤

Per default, related resources are shown ordered by its IRI. This ordering can have a performance impact with large lists. Setting this property to true will disable this default behaviour. In case a path builder query with an order statement is used, this property has no effect.

Used Path: shui:disableDefaultValueSorting

Query: Selectable Resources¤

This query allows for listing selectable resources in the dropdown list for this property shape.

You need to provide the projection variable resource in your query.

The following placeholder can be used in the query text of the SPARQL query:

  • {{shuiGraph}} - the currently used graph
  • {{shuiResource}} - refers to the resource which is rendered in the node shape where this property shape is used (maybe a sub-shape)
  • {{shuiAccount}} - the account IRI of the active user, this includes the username (use a SUBSTR() function if you need the name only)
  • {{shuiAccountName}} - the user name/ID of the active user account
  • {{shuiMainResource}} - refers to the main resource rendered in the start node shape of the currently displayed node shape tree (only relevant in case of sub-shape usage)

Beta Feature: This query will be used as well to populate the selectable resources for the advanced editor and the candidate resources in the Business Knowledge Editor.

Used Path: shui:uiQuery

Inverse Path¤

Default is false. A value of true inverts the expected / created direction of a relation.

Used Path: shui:inversePath

Deny new resources¤

A value of true disables the option to create new resources.

Used Path: shui:denyNewResources

Resource viewer widget¤

Selects default object relation resource viewer widget. (NOTE: shacl2 only)

Used Path: shui:viewResourcesWithWidget

Node shape¤

This shape will be used to create an embedded view of the linked resource.

Used Path: shacl:node

Processing / User Interaction¤

Info

In this group all shape properties are managed, which have an effect on how new or existing resources are processed or created.

Message¤

If there is a message value, then all validation results produced as a result of this shape will have exactly this message.

Used Path: shacl:message

Severity¤

Categorize validation results (:Info, :Warning, :Violation). Defaults to :Violation.

Used Path: shacl:severity

Ignore on clone¤

Disables reusing the value(s) when creating a clone of the resource. Note: This feature was named ‘copy’ before.

Used Path: shui:ignoreOnCopy

Query: On insert update¤

This query is executed when a property value is added or changed.

The following placeholder can be used in the query text of the SPARQL query:

  • {{shuiGraph}} - the currently used graph
  • {{shuiResource}} - refers to the resource which is rendered in the node shape where this property shape is used (maybe a sub-shape)
  • {{shuiAccount}} - the account IRI of the active user, this includes the username (use a SUBSTR() function if you need the name only)
  • {{shuiAccountName}} - the user name/ID of the active user account
  • {{shuiMainResource}} - refers to the main resource rendered in the start node shape of the currently displayed node shape tree (only relevant in case of sub-shape usage)
  • {{shuiObject}} - the object value of the statement matched by the property shape
  • {{shuiProperty}} - the IRI of the property of the statement matched by the property shape

Used Path: shui:onInsertUpdate

Query: On delete update¤

A query which is executed when the statement the property shape applies to gets deleted.

The following placeholder can be used in the query text of the SPARQL query:

  • {{shuiGraph}} - the currently used graph
  • {{shuiResource}} - refers to the resource which is rendered in the node shape where this property shape is used (maybe a sub-shape)
  • {{shuiAccount}} - the account IRI of the active user, this includes the username (use a SUBSTR() function if you need the name only)
  • {{shuiAccountName}} - the user name/ID of the active user account
  • {{shuiMainResource}} - refers to the main resource rendered in the start node shape of the currently displayed node shape tree (only relevant in case of sub-shape usage)
  • {{shuiObject}} - the object value of the statement matched by the property shape
  • {{shuiProperty}} - the IRI of the property of the statement matched by the property shape

Used Path: shui:onDeleteUpdate

Target Graph Template¤

Graph templates can be used to enforce writing statement in specific graphs rather than into the selected graph. Graph templates can be added to node and property shapes. A template on a property shape is used only for overwriting a template on a node shape (without a node shape graph template, they do not have an effect).

Used Path: shui:targetGraphTemplate

Statement Annotation¤

Info

Statement Annotations provide a way to express knowledge about statements. This group is dedicated to properties which configure the Statement Annotation feature.

Enable¤

A value of true enables visualisation and management capabilities of statement annotations (reification) for all statements which are shown via this shape.

Used Path: shui:enableStatementLevelMetadata

Provided Shapes¤

Instead of providing all possible statement annotation node shapes for the creation of new statement annotations, this property will limit the list to the selected shapes only.

Used Path: shui:provideStatementLevelMetadataShapes

Comments