Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can customize how values appear on your widgets and dashboards to make data easier to read or format according to your preference.

What's in this article:    

Table of Contents
 

Note

This procedure works only when the Business Type of the Dataset Column Display is set to Number.
business type numberImage Added


How

...

to customize values in your widget

  1. Navigate to Widgetson the MSPbots app. 
  2. Find the widget for customization in the My Widgets tab and open it using any of the following ways:
    • Click the widget. 
      My WidgetsImage Added

    • Click the ellipsis Image Added button and select Edit.  
      edit widgetImage Added

      Alternatively, you can also click the ellipsis Image Added button on the widget on your dashboard and select Edit
      edit widgetImage Added 
  3. When the Widget Builder window appears, go to Dataset, click the ellipsis Image Addedbutton, and select Edit
    edit widgetImage Added 
  4. When the Dataset window appears, find the column name for customization and select the corresponding Image Added icon. 
    customize formattingImage Added 
    Note

    Ensure that you are customizing the column with Number as the selected Business Type, else the customization will not succeed. 


  5. Click Custom on the Format pop-up. 
    custom formatImage Added

  6. Type your preferred format in the Custom field. Be guided by the formatting options below. 
    For example

Prerequisites

If you set the Business Type to "Number" when setting up the Dataset for the Widget.

Image Removed

Main Section

  1. Click Image Removed and switch to Custom.
    Image Removed
  2. Type the desired format in the Custom bar, referring to the tables below for formatting guidelines.For instance, if you want 10000 to be displayed as 10,000.0000, input "enter 0,0.0000" into  into the Custom field.
    custom formatImage Added
  3. Click Save on the Format pop-up.
  4. Click Save on the Dataset window to keep your customizations.

Formatting Guide for Numerals

OrderField Value (
raw format
Raw FormatFormattingOutputDescription
110000       0,0.000010,000.0000
  1. Adds separators in the whole number
where appropriate and
  1. as needed
  2. Appends four digits after the decimal point
.
210000.230,010,000
  1. Adds separators in the whole number
where appropriate and rounds to
  1. as needed
  2. Rounds off to the nearest whole number
.
310000.23+0,0+10,000
  1. Rounds off to the nearest whole number
, adds separators where appropriate, and displays
  1. Adds separators as needed
  2. Displays positive or negative notations where it is appropriate
.
4-100000,0.0-10,000.0
  1. Adds separators in the whole number
where appropriate and
  1. as needed
  2. Adds one digit after the decimal point
and displays
  1. Displays positive or negative notations where it is appropriate
.

510000.12340.00010000.123
  1. Rounds off to three decimal places
and rounds to  the nearest  number.
  1. Rounds off to the nearest number
6100.12340000000100
  1. Rounds off to the nearest whole number
and keeps
  1. Keeps five digits in the integer part
.
71000.1234000000,0001,000
  1. Rounds off to the nearest whole number
and  adds
  1. Adds separators in the whole number
where appropriate and keeps
  1. as needed
  2. Keeps six digits in the integer part
.
810000.00010.00
  1. Adds two digits after the decimal point
and keeps
  1. Keeps three digits in the integer part
.
910000.12340[.]0000010000.12340
  1. Adds five digits after the decimal point
and if
  1. Displays the whole number if there is no decimal
, displays whole number.
10-10000(0,0.0000)(10,000.0000)
  1. Adds four digits after the decimal point
and
  1. Adds separators in the whole number
where appropriate. If
  1. as needed
  2. Shows the number inside parentheses if it is negative
, it appears in parenthesis.
11-0.23.00-.23
  1. Strips off the whole number
and displays
  1. Displays only the decimals up to two digits after the decimal
.
  1. point
12-0.23(.00)(.23)
  1. Strips off the whole number
and displays
  1. Displays only the decimals up to two digits after the decimal
.If
  1. point
  2. Shows the number
is negative, it appears in parenthesis.
  1. inside parentheses if it is negative 
130.230.000000.23000

Adds five digits after the decimal point and displays the whole number

.

140.230.0[0000]0.23
  1. Displays one digit after the decimal
with
  1. but has an allowance for up to five
total, if appropriate, and displays the whole number.
  1. decimal places if these are needed
  2. Displays the whole number 
1512309740.0a1.2m
  1. Rounds off to the nearest thousandth
and adds
  1. value
  2. Adds one digit after the decimal point
and displays
  1. Displays a letter for the magnitude change, with a space between the magnitude symbol and the
number.  
  1. number  
1614600 a1 k
  1. Rounds off to the nearest thousandth
and displays
  1. value
  2. Displays a letter for the magnitude change
.
17-1040000a-104k
  1. Rounds off to the nearest thousandth
and displays
  1. Displays a letter for the magnitude change
.
1810o1st
  1. Adds
ordinal letters
  1. suffixes after the ordinal number
, rounds to the nearest whole number (
  1. (for example: 1st, 2nd, 3rd, 4th
...).
  1. , and so on)
  2. Rounds to the nearest whole number 
191000o100th
  1. Adds
ordinal letters
  1. suffixes after the ordinal number
, rounds to the nearest whole number (
  1. (for example: 1st, 2nd, 3rd, 4th
...).

Currency

...

  1. , and so on)
  2. Rounds to the nearest whole number 

Formatting Guide for Currency

The symbol for local currency in the widgets is based on your account language settings. You can use the dollar $ sign in the formatting,

...

however, the output will

...

show your local currency

...

($,

...

£,

...

or € ). 

OrderField Value (
raw format
Raw FormatFormattingOutputDescription
11000.234$0,0.00$1,000.23
  1. Adds separators in the whole number where appropriate
and rounds
  1. Takes the two digits after the decimal point
 and
  1. and rounds
to 
  1. it off to the
nearest 
  1. nearest number
and adds
  1. Adds the local currency symbol before the number
.
21000.20,0[.]00 $1,000.20 $
  1. Adds separators in the whole number where appropriate
and rounds
  1. Takes the two digits after the decimal point
 and
  1. and rounds it off to the
nearest 
  1. nearest number
and adds
  1. Adds the local currency symbol after the number
and if
  1. If there is no decimal,
displays
  1. the whole number is displayed.
31001$ 0,0[.]00$ 1,001
  1. Adds separators in the whole number where appropriate
and rounds
  1. Takes the two digits after the decimal point
 and
  1. and rounds it off to the
nearest 
  1. nearest number
and adds
  1. Adds the local currency symbol
before
  1. after the number
and if
  1. If there is no decimal,
displays
  1. the whole number is displayed.
4-1000.234($0,0)($1,000)
  1. Adds separators in the whole number where appropriate
, rounds
  1. Rounds off to the nearest whole number
, and adds
  1. Adds the local currency symbol before the number
. If the number is negative, it shows in parenthesis
  1. Negative numbers are in parentheses.
5-1000.234$0.00-$1000.23
  1. Adds two
digits
  1. decimal numbers after the decimal point
, rounds
  1. Rounds off to the nearest number
, and adds
  1. Adds the local currency symbol before the
number.
  1. number 
61230974($ 0.00 a)$ 1.23 m
  1. Displays the nearest thousandth with two
digits
  1. decimal numbers after the decimal
,
  1. point
  2. Adds a letter for the magnitude change
, and
  1. Adds the local currency symbol before the number
.If the number is negative, it shows in parenthesis.

...


  1. Negative numbers are in parentheses.

Formatting Guide for Bytes 

OrderField Value (
raw format
Raw FormatFormattingOutputDescription
11000b100B

Adds "B" after the number

.

210240b1KB
Divided
  1. Divides by 1000 and rounds off to the nearest whole number
and add 'KB'
  1. Adds "KB" after the number
.
320480 ib2 KiB
Divided
  1. Divides by 1024 and rounds off to the nearest whole number
and add 'KiB'
  1. Adds "KB" after the number.
430720.0 b3.1 KB
Divided
  1. Divides by 1000 and adds one
digit
  1. decimal number after the decimal point
and rounds
  1. Rounds off to the nearest number
and add 'KB'
  1. Adds "KB" after the number
.

578844862130.00b7.88GB
  1. Displays the nearest thousandth with two
digits
  1. decimal numbers after the decimal
and add 'GB'
  1. point
  2. Adds "GB" after the number
.
634674796827870.000 ib3.154 TiB
  1. Displays the nearest thousandth with three
digits
  1. decimal numbers after the decimal
and add 'TiB'
  1. point
  2. Adds "TiB" after the number
.

Formatting Guide for Percentages

OrderField Value (
raw format
Raw FormatFormattingOutputDescription
110%100%

Multiplies the value by 100 and adds a percent sign

.

20.9748782340.000%97.488%
  1. Multiplies the value by 100 and adds three
digits
  1. decimal numbers after the decimal point
and rounds
  1. Rounds off to the nearest number
and adds
  1. Adds a percent sign
.
3-0.430 %-43 %

Multiplies the value by 100 and adds a percent sign

.

40.43(0.000 %)43.000 %
Multiply
  1. Multiplies the value by 100 and adds three
digits
  1. decimal numbers after the decimal point
and rounds
  1. Rounds off to the nearest number and adds a percent sign
.If the number is negative, it shows in parenthesis.
  1. Negative numbers are in parentheses.

Formatting Guide for Time

OrderField Value (
raw format
Raw FormatFormattingOutputDescription
12500:00:000:00:25
Seconds:
Numbers less than 60 are displayed in the
seconds  position
seconds section.
223800:00:000:03:58

For numbers greater than or equal to 60

and

but less than

3600:
  • Minutes: Divide by 60 to get the integer part.
  • 3600:

    1. To show minutes, divide the input by 60 and use the integer part.
      Example: 238 / 60 = 3.966666
      Take the whole number 3 to have 0:03:00.
    2. To show seconds, take the quotient of the example above and multiply it by 60 and round it off to the whole number.
      Example:  .966666 x 60 = 57.9999, rounded off to 58

    Hence, the output is 0:03:58

    Seconds: Multiply the decimal part of the result from dividing by 60 by 60 to get the seconds

    .

    36384600:00:0017:44:06

    For numbers greater than or equal to

    3600:
    • Hours: Divide by 3600 to get the integer part.
    • Minutes: Multiply the decimal part of the result from dividing by 3600 by 60 to get the integer part.
    • Seconds: Multiply the decimal part of the result from dividing by 3600 by 60 to get the decimal part, then multiply the result by 60 to get the seconds. 

    3600: 

    1. To show hours, divide the input by 3600 and use the integer part. 
      Example: 63846 / 3600 = 17.735 
      Take the whole number 17 to have 17:00:00.
    2. To show minutes, take the decimal numbers in the quotient and multiply them by 60. 
      Example:  .735 x 60 = 44.1
      Apply the whole number to have 17:44:00
    3. To show seconds. take the decimal numbers in the product and multiply them by 60. Example: .1 x 60 = 6 

    Hence, the output is 17:44:06.

    Formatting Guide for Exponential

    OrderField Value (
    raw format
    Raw FormatFormattingOutputDescription
    111234567890,0e+01e+9
    1. Displays the nearest thousandth with the whole number
    and add 'e', and
    1. Adds "e" and a
     add
    1. 10-based exponent when the exponent is positive
    2. If the exponent is negative,  subtract when the exponent is negative.
    212398734.2020.00e+01.24e+7
    1. Displays the nearest thousandth with two
    digits
    1. decimal numbers after the decimal
    and add 'e' and add
    1. point
    2. Adds "e" and a 10-based exponent when the exponent is positive
    , subtract
    1. Subtracts when the exponent is negative
    .
    30.0001239870.000e+01.240e-4
    1. Displays the nearest thousandth with three
    digits
    1. decimal numbers after the decimal
    and add 'e'
    1. point
    2. Adds "e" and add10-based exponent when the exponent is positive
    , subtract
    1. Subtracts when the exponent is negative
    .