Skip to main content
Skip table of contents

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

OffsetDateToStringConverterConverts 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

DurationToMsConverterConverts 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:

InputOutput
0Zero
1One
2Two
3Three
44

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

InputOutput
falseZero
trueOne
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:

InputOutput
Existing
Recordingred
Virtualyellow
Other valuesKeep 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:

InputOutput
Existing
Recordingred
Virtualyellow
Other valuesgreen


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, ...





JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.