Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Page Properties
hiddentrue
idrLANG

Product Version
Report Note
Assignee

Resources & Remarks

(Info) https://wiki.optimal-systems.de/pages/viewpage.action?pageId=57442949    

  • Antje: Cleaning up the Tutorial → moving things to Concepts

Modification History

NameDateProduct VersionAction
Antje08 FEB 20212.4New page properties macro.
Antje28 APR 20212021 SummerInfo added: number of tags per object limited to 50.
Antje21 JUN 20212021 Summer FixResistant Tags added.
Antje24..26 NOV 20212022 Springimprovement, tag name length
Agnieszka09 DEZ 20212022 SpringrLANG



Excerpt

The basic idea for the usage of tags is to describe the state of an object within a process chain. They consist basically They basically consist of a name and a state value and can be assigned to any object.


Section
bordertrue


Column

Table of Contents

Table of Contents
exclude(Table of Contents|Read on|Tagging Objects for Processing|Schema - Defining Object Types|Changing Schema Structures \("Schema Flow"\))


...

  • Tags do NOT belong to the metadata and thus do not need to be defined in the schema.
  • Tags are stored together with the object as value for the property 'system:tags' property similar to metadata.
  • Pure tag operations do NOT lead to the creation of a new object version.
  • Tags can only be attached to the current version of an object, whereas previous versions cannot have tags.
  • For version-specific information, metadata provide the suitable options. They have to be defined in the schema.

...

Behavior during POST metadata updates:

  • If the property system:tags property is specified in the request body,
    • all included tags are assigned to the new object version with the given name and state. The same value as system:lastModificationDate and system:traceId will be set automatically for creationDate and traceId respectively for all of them.
    • each tag that is not included is deleted. The new object version will not have that tag.
  • If the property system:tags is NOT specified in the request body or is set to null, all tags will be deleted. The new object version will not have any tag.

Behavior during PATCH metadata updates:

  • If the property system:tags property is specified in the request body,
    • all included tags are assigned to the new object version.
    • each tag that is not included is deleted. The new object version will not have that tag.
  • If the property system:tags property is NOT specified in the request body, all tags are transferred to the new object version. Their statecreationDate and traceId remain unchanged.
  • If the property system:tags is property is set to null, all tags will be deleted. The new object version will not have any tag.

...

PropertyTypeDescriptionIn a request
nameString

Name of the tag for identification. It has to be unique for the corresponding object.

The tag names are validated during a tag creation or update process. To pass the validation, they have to match the regular expression [a-z](:?[a-z][a-z0-9]*)* and must not be longer than 32 characters (as of 2022 Spring, not no longer than 128 characters).

As of version 2021 Summer, the suffix :resistant triggers a specific behavior of the tag. If a tag name matches the expression [a-z](:?[a-z][a-z0-9]*)*:resistant, the tag will behave like a resistant tag as described below.

required
stateIntegerRepresents the status of the corresponding object in a process chain.required
creationDateStringDate and time of the last modification of the tag. It is set automatically by the system.optional, only available in search queries
traceIdHexadecimal lowercase string with maximum length 16

Process identification of any tag operation. If not specified in the request, a random String value will be set after the tag operation.

In a tag update or delete request, the request parameter traceIdMustMatch can be set to true. The operation will be done only if the traceId of the call matches the current traceId of the requested tag. After such update processes, the traceId of the updated tag will be the same as before.

Per default, traceIdMustMatch is set to false.

optional, specified by means of the HTTP header X-B3-TraceId

In a request, the corresponding properties are included directly in the URL for the call of the endpoint. In contrast, if tags are displayed in a response body, their properties are listed as a part of a JSON structure in the value of the property system:tags property.

Tagging Endpoints

The following endpoints for pure tag operations do not trigger a new version of the corresponding object, but only a new entry in the audit trail:

...

Resistant tags are identified by the suffix :resistant at the end of the string tag name.

Note: The tag name including the suffix must not exceed the length limit of 128 characters.

...