Use the object status if:

• You need to display the semantic status of an object: negative (property: error), critical (property: warning), positive (property: success), or neutral (property: none).
• You need to show that the current object instance is locked by another user.

Use the object number if:

• You want to display the key attribute of an object. In this case, keep the emphasized default setting (property: emphasized).
• You need to display one or more numeric attributes of an object that, for example, you want to compare (property: emphasized set to “false”).

Use the object identifier if:

• You want to indicate the key identifier of the object.

Use the object marker if:

• You want to display the technical state (locked, draft, unsaved changes, favorite, flagged) of an object. If you want to display the status of the object in the business lifecycle, consider using the object status display component instead.

The object status consists of the following:

• A semantically-colored text (property: text)
• An optional icon (property: icon)
• A title that serves as a label (property: title)

It is mainly used with semantically-colored text only.

The object identifier has the following properties:

• A title text (property: title)

• An optional additional descriptive text (property: text)

• The title can be set to active. In this case, it looks like a link and can fire an event (property: titleActive).

• Both texts wrap if the space available is insufficient to fit each of them on one line.

The object number consists of the following:

• A semantically-colored text (property: number), which can be set to non-emphasized when used in the content area (property: emphasized)
• An optional unit (property: unit)

The object marker comes with the following characteristics:

• Icon only (visibility: IconOnly)
• Text only (visibility: TextOnly)
• Icon and text (visibility: IconAndText)
• Interactive
• Non-interactive

The object marker is able to fire an an event when it is pressed (interactive). If the control is interactive and displayed as icon with text, the icon and text are one click area.

• Use semantic text only, and avoid using it with an icon.
• Use the following semantics to indicate the status: negative (property: error), critical (property: warning), positive (property: success), and neutral (property: none).

• Only use icons if they are unambiguous and easily understood (such as a padlock for locked items). If you feel your icon would need a descriptive text to be understood, use text only.
• For locked items, you may also add information about who is currently locking the item.

• Do not use the title of the object status outside the object header. Even though the title and the status text wrap, keep them both as short as possible.

• When used in a table, the object status should be center-aligned.

• The object identifier should be easily readable (preferably the display text and not the ID). If the ID is necessary to distinguish between items that use the same title, it should appear in brackets, such as Product ABC (1234567). The decision to include the ID in the text property can also depend on how long you expect the text to be.
• The object identifier can also be shown as a link. In this case, the event opens the quick view of the object.

Object Number

• Use the following semantics to indicate the status: negative (property: error), critical (property: warning), positive (property: success), and neutral (property: none).

• If the object number is the key attribute of the object inside the content area, the number should be emphasized when it is used as a line item status in a table.

• The object number can also be used to visualize other semantic numeric attributes. In this case, they are not emphasized unless they are the key attribute, such as a sum.

An object might contain multiple technical statuses at the same time. However, the editing statuses are mutually exclusive. As a result, an object can have a maximum of 3 technical status visible on the screen: Flag, Favorite and one Editing Status. The app developer is responsible for the technical statuses.

Every technical status has a default visualization that can be changed by the app developer depending on the usage context. See also “How to display the editing state” in the draft handling article.

Flag and Favorite are usually displayed as icon. The same applies to all screen sizes.

The default behavior for the editing status is as follows: 

On L/M size:

• Locked and Unsaved Changes are displayed as icon and text, while Draft is displayed as text.
• Flag and Favorite are displayed as icons.

On S size:

• Locked and Unsaved Changes are displayed as icon, while Draft is displayed as text.
• Flag and Favorite are displayed as icons.