• Home
  • Dynatrace API
  • Environment
  • Settings
  • Schemas
  • Summary pattern examples

Settings API - Summary pattern examples schema table

Summary pattern examples (builtin:example.summary.pattern)

This schema shows some possibilities on how to customize the displaying of items using the summary pattern:

  • Markdown to apply formatting

  • ICU for general message formatting and simple logic ICU documentation

  • Pipes to transform values. Checkout SummaryPatternPipes#CORE_PIPE_FACTORIES (for general pipes) and MonitoringSettingsFactory#createPipeRegistry (for cluster-side and custom pipes) to see what pipes are registered and available for usage.

Schema IDSchema groupsScope
builtin:example.summary.pattern-
environment
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:example.summary.pattern
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:example.summary.pattern
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:example.summary.pattern

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyLabelTypeDescriptionRequired
truncatedTruncated textset

This summary shows how to use pipes, in particular the truncate pipe to limit the length of the displayed text to 10 characters

required
truncatedCollectionTruncated collectionset

This summary shows how to use pipes, in particular the truncateCollection pipe to limit the size of the collection to 3 elements and the length of each text item in it to 4 characters

required
non_empty_textNon-empty textset

This summary shows how to use pipes, in particular the valueSet pipe to check if a value is set

required
icu_selectICU selectset

This summary makes use of ICU's select to display some text depending on a boolean flag

required
icu_pluralICU pluralset

This summary makes use of ICU's plural to display some text depending on an integer value

required
icu_number_formattingICU number formattingset

This summary makes use of some of ICU's number formatting capabilities

required

Request body objects

The TruncatedCollection object
PropertyLabelTypeDescriptionRequired
collProperty-set-required
The TruncatedTextItem object
PropertyLabelTypeDescriptionRequired
textPropertyTexttext-optional
The NonEmptyTextItem object
PropertyLabelTypeDescriptionRequired
textPropertyTexttext-optional
The IcuSelectItem object
PropertyLabelTypeDescriptionRequired
booleanPropertyBooleanboolean-required
The IcuPluralItem object
PropertyLabelTypeDescriptionRequired
integerPropertyIntegerinteger-required
The IcuNumberFormattingItem object
PropertyLabelTypeDescriptionRequired
integerPropertyIntegerinteger-required