Property Groups and Properties

Control Types

As an administrator you can choose one of the following types:

Name

XML - Type

Description

Screenshot

Available Filter Operators

Single Line Text

SingleLineText

Short single line text with a maximum of 2000 characters.

Image displaying example for single line text

Equals

Not Equals

Like

Not Like

Note: When using the Like, or Not Like operator, "*" is used as wildcard.

Short Text

ShortText

Short multiline text with a maximum of 2000 characters. You can click the icon to open a pop-up with a larger text box.

Image displaying example for short text

Equals

Not Equals

Like

Not Like

Note: When defining filters in custom views, a single line text box is displayed to users for entering the filter value.

When using the Like or Not Like operator, "*" is used as wildcard.

Long Text

LongText

Long multiline text with an unlimited number of characters. You can click the icon to open a pop-up with a larger text box. (Stored in a CLOB field in the database)

Image displaying example for long text

Equals

Not Equals

Like

Not Like

Note: When defining filters in custom views, a single line text box is displayed to users for entering the filter value.

When using the Like or Not Like operator, "*" is used as wildcard.

Single Choice

SingleChoice

Users can select one of the predefined options. The options are displayed in alphabetical order.

Image displaying example for single choice

Equals

Not Equals

Note: When defining filters in custom views, a drop-down list is displayed to users for entering the filter value. The drop-down list contains all possible values of type versions combined for the property name.

Multi Choice

MultiChoice

Users can select more than one option by clicking the shift key. The options are displayed in alphabetical order.

Image displaying example for multi choice

Contains

Not Contains

Note: When defining filters in custom views, a drop-down box is displayed to users for entering the filter value. The drop-down box contains all possible values of type versions combined for the property name.

Integer

Integer

Only integer values are allowed.

Image displaying example for integer

=

>

>=

<

<=

Note: When defining filters in custom views users may only enter integers in the value text box.

Float

Float

Only float values are allowed.

Image displaying example for float

=

>

>=

<

<=

Note: When defining filters in custom views users may only enter floats in the value text box.

Date

Date

Users can select a date via a date picker.

Image displaying example for date

=

>

>=

<

<=

Note: When defining filters in custom views a date picker is displayed.

Date and Time

DateTime

Users can select a date and time via a date/time picker.

Image displaying example for date and time

=

>

>=

<

<=

Note: When defining filters in custom views a date/time picker is displayed.

Checkbox

Checkbox

Users can check or clear the control.

Image displaying example for checkbox

Equals

Not Equals

Note: When defining filters in custom views a checkbox is displayed.

E-Mail

Email

The title or email address is shown as a link in the sidebar. If you click the link the mail client opens. To insert a title and email address click the edit icon after the link.

Click the remove icon (x) to clear the field.

 

Equals

Not Equals

Like

Not Like

Note: When defining filters in custom views, a single line text box is displayed to users for entering the filter value.

When using the Like or Not Like operator, "*" is used as wildcard.

The search is always only related to the value of the title and not to the email address itself.

Grids always display the title. If you click the email address, the email program is launched depending on your system settings.

Link

Link

The title or url is shown as link in the sidebar. If you click the link a new browser window opens the defined url. To define a title and url click the edit icon after the link.

Click the remove icon (x) to clear the field.

 

Equals

Not Equals

Like

Not Like

Note: When defining filters in custom views, a single line text box is displayed to users for entering the filter value.

When using the Like or Not Like operator, "*" is used as wildcard.

The search is always only related to the value of the title and not to the address itself.

Grids always display the title. If you click it, the url opens in a new window.

File

File

The title or file is shown as a link in the sidebar. If you click the link you can choose between downloading or opening the file (standard browser action).

Click the edit icon, after the link, to open a pop-up for file selection and editing the title. Click Select to select a file to upload.

Click Upload to upload the file. A progress indicator shows the upload progress.

Click the remove icon (x) after the link to delete the attached file.

The file is stored in the database.

 

Equals

Not Equals

Like

Not Like

Note: When defining filters in custom views, a single line text box is displayed to users for entering the filter value. When using the Like or Not Like operator, "*" is used as wildcard.

The search is always only related to the value of the title and not to the file itself.

Identity

Identity

Useful when importing data from external systems. You can retain information about the origin of your entities using this type to save the external IDs.

The value of the property has to be unique across all entities with the same main type.

Image displaying example for identity

Equals

Not Equals

Like

Not Like

Note: When using the Like or Not Like operator, "*" is used as wildcard.

Protected

Protected

Can be used for passwords. Values are encrypted before being stored in the database and cannot be exported, queried for, or used in custom views. Its value never shows up in cleartext in any log or history record. The password is only unencrypted when referenced from a dynamic property during a deployment. It can be up to 2000 characters long.

Image displaying example for protected


Reference Reference

Allows you to reference other entities of the following main types:

  • Package
  • Environment
  • Deployment Target
  • Application
  • User / Usergroup (= Member, displayed as "User / Group")
  • Login
  • Workflow

 

Equals

Not Equals

Like

Not Like

Note: When defining filters in custom views, a single line text box is displayed to users for entering the filter value.

When using the Like or Not Like operator, "*" is used as wildcard.

The search is only related to the name of the entity.

Grids always display the name. If you click the name, the entity is opened.

Property Definitions and Property Groups are created and linked to types via the commands described in Administration Interface using the property definition schema (see: Property (Group) Definition Schema). The following restrictions apply when a set of property groups and properties is created out of the XML property definition file (in addition to schema validation):

Panel Group Definition

The following XML snippet shows the panel group definition:

<xs:element name="Group">
	<xs:complexType>
		<xs:sequence>
		<!-- Property Definition-->
		</xs:sequence>
		<xs:attribute name="name" type="bondstringtype"/>
		<xs:attribute name="displayName" type="bondstringtype" use="optional"/>
	</xs:complexType>
</xs:element>

Mode

Description

name

The name of the property group

displayName

The display name of the property group which is used for labeling the property group in the user interface. It does not have to be unique. If no display name is given, the name is used as the display name on import.

Panel Properties Definition

The following XML snippet shows the panel properties definition:

<xs:element name="Group">
	<xs:complexType>
		<xs:sequence>
			<xs:element name="Property" maxOccurs="unbounded">
				<xs:complexType>
				    <xs:sequence>
					<xs:element name="Defaultvalue" type="xs:string" minOccurs="0"/>
				        <xs:element name="List" type="bondlist" minOccurs="0">
			                <xs:element name="Description" type="xs:string" minOccurs="0" maxOccurs="1"/>
			            </xs:sequence>
					<xs:attribute name="name" type="bondstringtype" use="required"/>
					<xs:attribute name="displayName" type="bondstringtype" use="optional"/>
					<xs:attribute name="type" type="bondproptype" use="required"/>
					<xs:attribute name="mode" type="bondpropertymode" use="required"/>
				</xs:complexType>
			</xs:element>
		</xs:sequence>
		<!-- Panel Group Definition -->
	</xs:complexType>
</xs:element>

 

Attribute

Description

name

The name of the property. It must be unique within the entity definition.

displayName

The display name of the property which is used for labeling the property in the user interface. It does not have to be unique. If no display name is given, the name is used as the display name on import.

type

The type of the property.

mode

The edit mode of the property. (See table below for possible values)

Mode

Description

editable

The group or property should be editable.

hidden

The group or property should be invisible (but can still be edited via API calls)

readonly

The group or property should be visible but read only.

mandatory

The property (or all properties in the group) are mandatory.

Element

Description

Defaultvalue

The default value of the property. If it cannot be converted to the target property type, an exception is thrown. Dates have to be entered in the format "YYYY-MM-DD hh:mm:ss".

List

A comma-separated list of list values for properties of that type. List items are trimmed (not possible to have blanks in the beginning or end of list items)

Description

Description of the property (displayed as a tooltip on the Web UI)