Custom

The Parse Pattern property specifies the regular expression that determines which input values are considered valid.

• Only values that match this pattern will be accepted.
• You can define named groups (e.g., (?<GroupName>...)) to extract specific parts of the input for use in the 'Custom Format' property.
• Use anchors at the beginning and end of your pattern (e.g., ^ and $) to ensure the entire input matches the pattern.
• Use standard .NET regular expression syntax.

> [!TIP] > Write patterns that match the full expected input. For more information, see the .NET documentation on regular expressions.

A combination of the following flags:

The Options property controls how the parse pattern is applied to input values.

• Common options include IgnoreCase (case-insensitive matching) and Multiline (treats input as multiple lines).
• Adjust these settings to match your data source and parsing requirements.

> [!NOTE] > Changing options can affect which values are considered valid matches.

The Custom Format property specifies how to construct the output value using the named groups captured by the parse pattern.

• Use curly braces to reference group names, e.g., {GroupName}.
• If left blank, the original input value is used as output.

Sample Formatting Scenarios

> [!TIP] > Use named groups in your parse pattern to enable flexible output formatting.

The Type Name property allows you to specify a custom, user-friendly name for this storage type.
This name appears in validation messages and user interface elements, making it easier for users to
understand what kind of value is expected.

• If left blank, the default type name is used.
• Use a descriptive name that clearly communicates the purpose or format of the data (e.g., "Invoice Number", "Routing Code").
• The name must start with a letter or underscore and contain only letters, numbers, and underscores.

> [!TIP] > Setting a clear type name helps users quickly identify validation errors and understand configuration requirements.

The Hint property provides supplementary instructions or examples to assist users in entering valid data.
This guidance is displayed in validation notes and user interfaces where the storage type is used.

• Use this property to clarify the expected input format, such as required patterns, delimiters, or value examples.
• Hints can include sample values, formatting tips, or brief explanations of the data requirements.
• Combine with the 'Parse Pattern' and 'Custom Format' properties to give users a complete understanding of input expectations.

Example

Enter a value in the format: ABC-1234 (e.g., INV-5678)

> [!NOTE] > Providing a helpful hint can reduce user errors and improve the overall configuration experience.

Can be one of the following values:

The 'Processing Mode' determines which operations are performed on values:

• Format: Values are reformatted, but not filtered.
• Filter: Values are filtered, but not reformatted.
• Both: Values are both filtered and reformatted.
• Validate: Values are only validated.

Choose the mode that best fits your data extraction and validation requirements.

The Value Delimiter property enables a Data Field to store and process multiple values as an array, rather than a single value.

• When set, the field will accept and return multiple values, separated by the specified delimiter.
• Common delimiters include , (comma), ; (semicolon), or custom strings such as | or ~~.
• Choose a delimiter that does not appear in your data values to avoid parsing errors.

Usage

• To allow a field to store multiple entries (such as a list of codes or dates), set the 'Value Delimiter' to the desired character or string.
• When the delimiter is set, the field is treated as an array, and parsing/formatting operations will split and join values using this delimiter.
• If left blank, the field will only accept a single value.

Example:
If the delimiter is ;, a value like A;B;C will be interpreted as three separate entries: A, B, and C.

The Maximum Length property controls the maximum number of characters permitted for a string value.

• Set to 0 to allow unlimited length.
• If a value exceeds this limit, it will be truncated or rejected, depending on the context.