String formatting

1. Make a backup of the contents of Switch (CC) DDE Lookup formatting. Typically, this script contains only one line of code: include @initial_formatting. You're going to use that script as a debugger and development tool, and when you are done, you can just restore the backup.

2. Make a screenshot of General environment variables, and manually type the following into Notepad:

   define string @landcode='45'

   define string @landcode_prefix ='+'

   define int @internal_length = 7

   define string @external_prefix='0'

3. Make a screenshot of Switch Environment vars, and manually type the following intoNotepad, after the code from the previous step

   define string @internalsiptrunk = 'newTrunk'

   define string @externalsiptrunk = 'newTrunk'

   define string @internalprefix = ''

   define string @externalprefix = ''

4. Copy the code from Notepad into Switch (CC) DDE Lookup formatting, so that the original content that you backed up is replaced.

5. Double-click the Tscript editor window title bar to maximize the window

You can now override all the variables that ZyDesk gets from the Administration Portal, without the need to make changes in the Administration Portal, and without the need to restart ZyDesk for the changes to take effect.

Now that you can edit all the variables imported from the Administration Portal, without opening the portal and without the need to restart ZyDesk, you can make a copy of the active code lines within the macros in Environment Scripts

1. Open Environment Scripts

2. Make a copy of the Tscript code, and paste the code into Notepad.

3. Remove the lines that define the macros, and the outermost set of { and } that refers to each macro definition.

   For example: 

   • Remove the line: define macro @initial_formatting

   • Remove the { immediately after the define macro @initial_formatting command

   • Remove the } immediately before the next macro definition (or the end of the file)

   • Remove the line: define macro @set_prefixes

   • Remove the { immediately after the define macro @set_prefixes

   • Remove the } at the very bottom of the file.

4. Now, go to Switch (CC) DDE Lookup formatting and insert that code from Notepad after the eight lines that contain the variable definitions.

   For the default scripts for the Service Center 6.0 profile, it should look like this:

   define string @landcode='45' define string @landcode_prefix ='+' define int @internal_length = 7 define string @external_prefix='0'   define string @internalsiptrunk = 'newTrunk' define string @externalsiptrunk = 'newTrunk' define string @internalprefix = '' define string @externalprefix = ''   remove all ' ' replace begin '(??)' with concat @landcode_prefix '??' using '?' replace begin '(+??)' with concat @landcode_prefix '??' using '?' replace begin '(00??)' with concat @landcode_prefix '??' using '?' replace begin '+' with @landcode_prefix replace begin '00' with @landcode_prefix remove all '(' remove all ')'   if is number { if length greater than @internal_length { // begins with '000' if begins with concat @external_prefix @landcode_prefix { // remove first '0' replace begin @external_prefix with '' } // not '00' if begins not with @landcode_prefix { // '0' if begins with @external_prefix { replace begin @external_prefix with '' } prefix @landcode prefix @landcode_prefix } } }

Now you can use Tscript editor as a debugger, for example:

• In Test, you can enter the number to test, and you can view the normalized number.
• To work on one line of code at a time, simply add // to the beginning of all lines except the one that you want to work on. (// indicates a comment.) You can work through the predefined macros, one line at a time, to understand the purpose of each line.
• You can change variable values directly in the Tscript editor, without the need to go through cycles of Administration Portal changes and ZyDesk restarts.

M1) Script includes macro 1: include @initial_formatting

M2) Script includes macro 2: include @set_prefixes

This Tscript assigns numberplan settings from the Zylinc Administration Portal to global Tscript variables.

You can’t make changes to this script, but you can change your numberplan settings, or overwrite the variables locally within any other Tscript.

To view or change numberplan settings in the Administration Portal:

1. In the Administration Portal menu, select SYSTEM > User Directory

2. In the Numberplan Settings section, you can view or change the following settings:

If you need to use other values than those defined in the Administration Portal, you can overwrite the variables.

To overwrite the variables, insert some or all of the following lines in the top of any string formatting script, and replace the variable values with the values that you need to overwrite.

define string @landcode='358'

define string @landcode_prefix ='00'

define int @internal_length = 5

define string @external_prefix='0'

This Tscript assigns SIP Trunk Settings from the Zylinc Administration Portal to global Tscript variables.

In the Administration Portal menu, select SYSTEM > SIP Trunks and click SETTINGS

• @internalsiptrunk: Name of the internal/default SIP trunk

• @externalsiptrunk: Name of the external SIP trunk

• @internalprefix: Prefix to add for calls routed via the internal/default SIP trunk

• @external_prefix: Prefix to add for calls routed via the external SIP trunk

You can overwrite the variables in the same way as for General environment variables

define string @internalsiptrunk = 'newTrunk'

define string @externalsiptrunk = 'newTrunk'

define string @internalprefix = ''

define string @externalprefix = ''

This Tscript defines two standard macros that many of the other Tscripts make use of. You can also make your own macros and refer to them from other Tscripts.

Macro @initial_formatting

• Removes all spaces

• May incorrectly format numbers that begin with the character (. For example, (45)12345678 may wrongly be formatted to +4412345678. For more information see Avoid string formatting of numbers that begin with (.

• If number begins with +, replace the + with @landcode_prefix (which is often a +)

• If number begins with 00, replace the 00 with @landcode_prefix (which is often a +)

• Removes all (

• Removes all )

@inital_formatting example 1, prefix=+

Number	@inital_formatting prefix= + output
1	1
12	12
1234	1234
12345678	12345678
1234567890	1234567890
+1	+1
+12	+12
+1234	+1234
+12345678	+12345678
+1234567890	+1234567890
001	+1
0012	+12
0012345678	+12345678
001234567890	+1234567890
00 1 23 (4) 567 890	+1234567890
(98)12345678	+9912345678 See note
(89)12345678	+8812345678 See note
(+98)12345678	+9912345678 See note
(0098)12345678	+9912345678 See note

Note: The second digit is wrongly transformed into the same value as the first digit. You should avoid using or importing any numbers where the first character is a ( and the fourth and sixth characters are a ).

@inital_formatting example 1, prefix=00

Number	@inital_formatting prefix = 00 output
1	1
12	12
1234	1234
12345678	12345678
1234567890	1234567890
+1	001
+12	0012
+1234	001234
+12345678	0012345678
+1234567890	001234567890
+1 23 (4) 567 890	001234567890
001	001
0012	0012
001234	001234
0012345678	0012345678
001234567890	001234567890
00 1 23 (4) 567 890	001234567890
(98)12345678	009912345678 See note
(89)12345678	008812345678 See note
(+98)12345678	009912345678 See note
(0098)12345678	009912345678 See note

Note: The second digit is wrongly transformed into the same value as the first digit. You should avoid using or importing any numbers where the first character is a ( and the fourth and sixth characters are a ).

Macro @set_prefixes

If the number only contains the digits 0...9 and is longer than the specified shortnumber length specified in the Administration Portal numberplan settings, remove one of the leading zeros, and add the prefix and the country code.

@set_prefixes example 1, prefix=+ Shortnumber length=7 default country code=45

Number	@set_prefixes output prefix = + Shortnumber length = 7 Default country code = 45
1	1
12	12
1234567	1234567
12345678	+4512345678
1234567890	+451234567890
01234567	+451234567
00123456	+450123456
00012345	+450012345

@set_prefixes example 2, prefix=00 Shortnumber length=7 default country code=45

Number	@set_prefixes output prefix = 00 Shortnumber length = 7 Default country code = 45
1	1
12	12
1234567	1234567
12345678	004512345678
1234567890	00451234567890
01234567	00451234567
00123456	00123456
00012345	0012345

Formats numbers before database lookup, for example ZyCore ID.

Formats numbers before ZyDesk clients display them for active calls.

Formats numbers before ZyDesk clients display them in the Time overview.

Formats numbers that you enter in the dial field of a ZyDesk client. Useful if you need to add breakout prefixes.

For outgoing calls made in Contact Center, but not in Team Center (previously known as Employee Assistant or Operator). Numbers are formatted before they're dialed.