Configuring RightFax Sync Module – Modifying the Number of Digits used for Route Code

Welcome to the RightFax Resource Center. Today I will be showing you how to configure the RightFax Sync module to modify the number of digits used for routing.  This can be useful for organizations that have many fax numbers and there is a possibility of having duplicate values in the last 4 digits. To change the number of digits from the default of 4 to 7, we are going to need to update the Sync Module transform file. Just a quick cautionary note, the transform file is an xml file that must remain “well structured.” This means that if there are any issues with the tagging, it will not work. Always make a backup of the file before editing and be careful not to accidentally delete or modify any of the tags. To begin, let’s start in Enterprise Fax Manager directly on the RightFax Application Server. (If you try to open it remotely you will get an error.)

1. Go to Services and right-click on the RightFax Sync Module
2. Select Configure Service
3. Highlight the Mapping that you would like to update
4. Select Edit to open the Sync Mapping window
5. Locate “Transform File” entry in the middle of the screen
6. Select Edit…
   • If your system does not have a default editor for XSL files, use Notepad
7. From here, search for the word “facsimileTelephoneNumber”
   • This is the Active Directory or Exchange Attribute that will be used to assign each users Route Code.
8. Notice that the Value transformation code here is rather complicated, so let’s take it one step at a time.
   • First, we have a comment that explains what this transformation is doing.
   • The next line cleans the input, removing spaces, periods, dashes, and parentheses and assigns it to the variable “cleanNumber”.
   • The next line determines which part of the cleanNumber will be used as the routing code, (the default is to take the last 4 digits).
     • Let’s take a concrete example and walk through the logic:
       • Let’s say the assigned fax number is (212) 555-1212
       • First step is to remove all the special characters leaving 2125551212
       • Next step is to calculate the starting point for our routing code:
         1. Get the number of characters in the fax number= 10
         2. Then subtract 3, leaving 7 as our starting point (10 – 3 = 7)
       • Finally, we need to define how many characters we want the routing code to be, in this case 4
       • The final bit of code checks the route code to make sure it is a number. If not, then the default routing code of 100 is used.
9. To change from 4 digits to 7 digits, we need to make 2 changes to the transformation file:
   • First, our starting point will be the length of the cleanNumber minus 6
     1. 10 – 6 = 4
   • Second, the length will be 7 characters
     1. In our example the route code will now be 5551212

Now, anytime the sync module runs, it is going to change the digits in the route code from 4 to 7 digits for all synced users.