Available Converter Values

As part of Configuring Grids in DPE Web Applications, the Converter key converts metadata into usable values. For example, "MsToDuration" transforms a time in ms to a time format determined in the ConverterParameter. Please see a list of converter values below.

Converter

Description

DateToString

This converter is used to display a specific date/time field

Requires a suitable ConverterParameter configuration

OffsetDateToStringConverter Converts a DateTimeOffset to the format specified in ConverterParameters.

FileSizeConverter

Translates a byte size into KB, MB, GB, etc.

1024 bytes are treated as 1 KB, 1024 KB are treated as 1 MB, ...

IntToCheckedConverter

A value 0 will be converted to a string containing a space, A value 1 will be converted to a string checked='checked'. Can be used together with checkbox controls.

MsToDuration

Converts milliseconds into the configured time format (e.g. 70000 ms into 1:10 minutes)

Requires a suitable ConverterParameter configuration

DurationToMsConverter Converts duration into milliseconds

IntToStringConverter

For an integer input value N the Nth string element in a comma-separated list is returned. The string list is specified in ConverterParameter.

Example for ConverterParameter:

CODE

Zero,One,Two,Three

Conversion Result:

Input	Output
0	Zero
1	One
2	Two
3	Three
4	4

In addition this converter maps boolean input values to 0 (false) and 1 (true) and their respective converted output value:

Input	Output
false	Zero
true	One

StringToStringConverter

For a string input value the matching mapping to another string value is returned. String mappings are specified in ConverterParameter.

Example for ConverterParameter:

CODE

Existing=,Recording=red,Virtual=yellow

Conversion Result:

Input	Output
Existing
Recording	red
Virtual	yellow
Other values	Keep their value

Using the pseudo-value $default$ it is also possible to specify a default value:

CODE

Existing=,Recording=red,Virtual=yellow,$default$=green

Conversion Result:

Input	Output
Existing
Recording	red
Virtual	yellow
Other values	green

Another option is to redefine the special characters which are used to structure the mapping: = and ,

Redefine the = and , characters by preceding your ConverterParameter string with a text like $$$,=$$$

CODE

$$$|_$$$Existing_|Recording_red|Virtual_yellow

ProgressConverter

Displays a progress bar additionally to the usual status in percentage (%)

Requires a suitable Cell Template configuration.

SafModuleStateConverter

Shows background color for SAF module state. Requires a Cell Template Content configuration.

At the moment it is not configurable. By default the values are: Started = green, Scheduled = orange, Failed = red, Cancelled = grey

SafServerStateConverter

Shows background color for SAF server state.

Requires a Cell Template Content configuration.

WorkflowStateConverter

Shows background color for workflow server state.

Requires a Cell Template Content configuration.

AutoFormatConverter

FormatToSdHdConverter

StringToUrlConverter

Can convert a comma separated list of values to URL's. If titles are available in ConverterParameter's, Markdown links are created.

Example:

Input:

TEXT

OK,Duration,EpMissing,NMissing,EpDoubled,NDoubled

ConverterParameter:

TEXT

Path=CustomData/resources/ConsistencyCheck/,
Extension=.gif?w=25&h=25&x=2&y=2,
Title_OK=EPS is consistent,
Title_Duration=Elements have differing duration,
Title_EpMissing=Not all endpoints are assigned,
Title_NMissing=No neutral element is assigned,
Title_EpDoubled=Doubled endpoint is assigned,
Title_NDoubled=Doubled neutral element is assigned

Output:

TEXT

[EPS is consistent]CustomData/resources/ConsistencyCheck/OK.gif?w=25&h=25&x=2&y=2,[Elements have differing duration]CustomData/resources/ConsistencyCheck/Duration.gif?w=25&h=25&x=2&y=2, ...