1. Advanced Control Services Help
  2. Value Formatting Types

22 Value Formatting Types

Any notification template can have any number of variable parts, configured using the Notification Variable screen. Each variable part can have one of several configuration options, depending on the field/ profile tag selected as the source of the variable part. See Notification Template Editor for more information about notification templates.

Notes:

  • Each of the variable parts may have extra fields to choose from in the top panel. For example, when you choose a Balance source group, you get a combo-box to choose which balance type you want. When you select Profile, you get the standard combo-boxes to choose a profile tag.

  • Some of the variable parts let you choose Server to determine in the formatting panel. This means use the formatting specified for that type of data in another part of the system, see Defined Definitions for examples.

The available format types for variable parts are:

Defined Definitions

These are examples of definitions defined elsewhere in the system. This is not an exhaustive list, just a sample.

Definitions on the Wallet Management > Balance Type Translations tab for balance formatting:

  • Balance / Value

  • Charge / Value

  • Recharge / Value

Definitions on the Wallet Management > Balance Type Translations tab for balance expiry formatting for:

  • Balance / Expiry

  • Recharge / Expiry

Definition on the Wallet Management > Wallet Name Translation tab for:

  • Wallet / Expiry

Boolean Format Type

Follow these steps to designate location and formating for a boolean variable part.

  1. In the Variable Source frame, select the variable part source from the Field drop down list.

    Warning: The Source Group drop down list shows the variable part type associated with the icon selected in the Notification Template screen and should be not be changed.

  2. Select the Balance Type from the drop down list.

    Note: The field balance type matches the Field selected.

  3. Enter a Default Value that is used when there is no content or problem with the source location.

  4. Configure the Value Formatting (..) frame, appropriate to the variable source. See:

Related topic

Value Formatting Types

Date/Time Format Type

Follow these steps to designate location and formating for a date/time variable part.

  1. In the Variable Source frame, select the variable part source from the Field drop down list.

    Warning: The Source Group drop down list shows the variable part type associated with the icon selected in the Notification Template screen and should be not be changed.

  2. Enter a Default Value that is used when there is no content or problem with the source location.

  3. Configure the Value Formatting (..) frame, appropriate to the variable source. See:

Related topic

Value Formatting Types

Integer Format Type

Follow these steps to designate location and formatting for an integer variable part.

  1. In the Variable Source frame, select the variable part source from the Field drop down list

    Warning: The Source Group drop down list shows the variable part type associated with the icon selected in the Notification Template screen and should be not be changed.

  2. Select the source Balance Type from the drop down list.

    Note: The field balance type matches the Field selected.

  3. Enter a Default Value that is used when there is no content or problem with the source location.

  4. Configure the Value Formatting (..) frame, appropriate to the variable source. See:

Related topic

Value Formatting Types

Prefix Tree Format Type

Follow these steps to designate profile location and formating for a variable part.

  1. In the Variable Source frame, leave the Source Group and Field with their default profile and empty values.

    Warning: The Source Group drop down list shows the variable part type associated with the icon selected in the Notification Template screen and should be not be changed.

  2. Select the source location using the Data Type, Location and Field drop down lists.

  3. Enter a Default Value that is used when there is no content or problem with the source location.

  4. Configure the Value Formatting (..) frame, appropriate to the variable source. See:

Note: The list of data types is fixed at installation time for each feature node or screen.

Further reference:

  • For information about profile blocks (data type, location, and field) and how to use them, see Profile Blocks and Tags.

  • The primary tag lists are configured in the SMS > Services > ACS Service > Configuration >Profile Tag Details and Profile Tag Mapping tabs (see ACS User's Guide, Profile Tag Details for more information).

Related topic

Value Formatting Types

String format type

Follow these steps to designate string location and formating for a variable part.

  1. In the Variable Source frame, select the variable part source from the Field drop down list.

    Warning: The Source Group drop down list shows the variable part type associated with the icon selected in the Notification Template screen and should be not be changed.

  2. Enter a Default Value that is used when there is no content or problem with the source location.

  3. Configure the Value Formatting (..) frame, appropriate to the variable source. See:

Related topic

Value Formatting Types

Setting Boolean Configuration

Follow these steps to set boolean formating.

  1. In the Value Formatting (Boolean) section of the Notification Variable screen, select the options for setting the boolean values.

  2. To use a predefined format, select Use predefined format, then select the format from the drop down list.

  3. To specify a format, select Use these terms, then enter what text will be displayed for true and false values.

  4. To save the changes, click Save.

    To exit without saving anything, click Cancel.

    To remove the variable part from the notification, click Delete.

Related topic

Value Formatting Types

Setting DateTime Configuration

Follow these steps to format a date/time variable part.

  1. In the Value Formatting (Date/Time) section of the Notification Variable screen, select the options for setting the date and time values.

  2. To use a definite date and time, select Absolute date, then select the predefined date and time format from the drop down list.

    For date and time format descriptions see Date formats and Time formats.

  3. To insert the amount of time between now and the date/time being formatted, select Elapsed time, then select the check boxes as required.

    Examples:

    • Select Months,and Days for "x months, y days"

    • Select Weeks, Days, Hours for "x weeks, y days, z hours"

    Note: Change the joiner value to make grammatically correct messages, for example replace , with and for the Days row would change the example to "x weeks, y days and z hours"

  4. To save the changes, click Save.

    To exit without saving anything, click Cancel.

    To remove the variable part from the notification, click Delete.

Related topic

Value Formatting Types

Date Formats

This table list the date formats and their examples.

Format Format Example
d/MM/yyyy 10/07/2009
MM/d/yyyy 07/10/2009
dddd, d MMMM yyyy Friday, 10 July 2009
d MMMM yyyy 10 July 2009
d/MM/yy 10/07/09
MM/d/yy 07/10/09
yyyy-MM-dd 2009-07-10
d-MMM-yy 10-Jul-09
d.MM.yyyy 10.07.2009
d MMM. yy 10 Jul. 09
d MMMM yyyy 10 July 2009
MMMM yy July 09
MMM-yy Jul-09

Date Format Key

This table describes the symbols used in the date formats.

Symbol Description
d Day of month
dd Two-digit day of month
dddd Name of day of week
MM Two-digit month
MMM Abbreviated month name
MMMM Full month name
yy Two-digit year
yyyy Four-digit year

Time Formats

This table lists the time formats and their examples.

Format Format Example
h:mm am/pm 4:03 pm
h:mm:ss am/pm 4:03:54 pm
hh:mm am/pm 04:03 pm
hh:mm:ss am/pm 04:03:54 pm
HH:mm 16:03
HH:mm:ss 16:03:54

Time Format Key

This table describes the symbols used in the time formats.

Symbol Description
h Hour, 0-12
hh Two-digit hour, 0-12
HH Hour, 0-23
mm Two-digit minute
ss Two-digit second
am/pm am/pm indicator

Setting Integer Configuration

Follow these steps to format an integer variable part.

  1. In the Value Formatting (Integer) section of the Notification Variable screen, select the option for setting the integer value.

  2. To use a predefined format, select Use predefined format and then select the format from the drop down list.

  3. To specify a format, select Use this format and then enter the values as relevant.

    • Divide by – The number to divide by to convert the output value from small units to large units. This specifies how to interpret the number being presented.

    • Digits (whole part) – The number of digits before an assumed decimal point, this is the minimum space allocated width of the whole part of the number. May cause padding to the left.

    • Digits (fractional part) – The number of digits after the decimal point.

    • Decimal place separator – The character that signifies the decimal point, this will be skipped if there is no fractional part.

    • Prefix characters – Characters to add to the front of the number.

    • Suffix characters – Characters to add after the number, this will be skipped if there is no fractional part.

    For example:

    Received number to be formatted: 12345

    • Divide by: 100

    • Digits (whole part): 4

    • Digits (fractional part): 2

    • Decimal place separator: ,

    • Prefix characters: $

    • Suffix characters: c

    Output: $ 123,45c

  4. To save the changes, click Save.

    To exit without saving anything, click Cancel.

    To remove the variable part from the notification, click Delete.

Related topic

Value Formatting Types

Setting Prefix Tree Configuration

Follow these steps to format a prefix tree variable part.

  1. In the Value Formatting (Prefix Tree) section of the Notification Variable screen, select the option for setting the prefix tree values.

  2. Enter the prefix tree field Separator to use in the notification. The prefix tree will be presented as a list of items separated by the text in this box.

  3. To save the changes, click Save.

    To exit without saving anything, click Cancel.

    To remove the variable part from the notification, click Delete.

    Note: The list of data types is fixed at installation time for each feature node or screen.

Further reference:

  • For information about profile blocks (data type, location, and field) and how to use them, see Profile Blocks and Tags.

  • The primary tag lists are configured in the SMS > Services > ACS Service > Configuration >Profile Tag Details and Profile Tag Mapping tabs (see ACS User's Guide, Profile Tag Details for more information).

Related topic

Value Formatting Types

Setting String Configuration

Follow these steps to format a string variable part.

  1. In the Value Formatting (String) section of the Notification Variable screen, select the options for setting the string values.

  2. Select the Format and trim as follows option as required:

    • as-is – Whatever the profile or default content is already saved as.

    • UPPER CASE – Source is changed to all upper case characters.

    • lower case – Source is changed to all lower case characters.

    • Title Case – Source is changed to upper case characters for start of each word.

  3. Optionally, select the Trim to max length check box, then entry the maximum length allowed.

    Note: The source string will be truncated to this value by removing characters from the end of the string.

  4. To save the changes, click Save.

    To exit without saving anything, click Cancel.

    To remove the variable part from the notification, click Delete.

Related topic

Value Formatting Types