Back to series

This video will show you how to export a list of users from RightFax and then import a changed list using the impuser utility.

We’ve shown you previously how you can use the impuser utility to export a list of users from your RightFax server. Today, I’m going to show you how you can use it to make bulk changes on users.

While this can make changes for any user, if you have users that were created with, or are maintained by the Sync Module, we’d recommend not using this method to make changes to your users.

The first thing we need to do is to export a list of our users. Log into your RightFax server with the service account user that is used to run most of your key RightFax services. Next, open a command prompt and be sure to run it as administrator. Navigate to your RightFax installation directory (the default here is C:\Program Files (x86)\RightFax) and then to the AdminUtils subdirectory. The syntax here will be “impuser -fRIGHTFAXSERVERNAME -u ADMINISTRATOR -o UserList.csv” The user name you specify after the -u needs to be a RightFax Administrator account.

Now, let’s take a look at our file we created. In notepad, you’ll see the fields are separated by commas. We’ll stick with notepad when we do our edits, as reimporting after saving in Excel has issues with the impuser tool. If we open the file in notepad, it’s fairly easy to see what some of the fields are here.

Column 1 is the USERID
Column 2 is the User Name , which is just a descriptive name for the user
Column 3 is the Group that the user belongs to
Column 4 is the Routing Code for the user

For simplicity, I’ve attached a file at the bottom of this page called “impuser export column headers” that will give you the column header names. This may come in handy if you need to identify what’s in the different columns.

I’m going to show you how to make changes and then we’ll re-import these back into RightFax to update our users.

In this scenario, our telephony system has had changes made to it and will now be passing 10 digits to RightFax for routing, where we were previously using 4. In my output, this column contains the users full fax number. If yours does not, you will need to make sure you know the full fax numbers for your users before you can make changes. Since I already have my fax numbers, I’ll just copy from this column here into the column where my routing codes are. Once you are satisfied with your changes, we’ll do a “save as” and change the name to indicate this file is for import. If you made your changes on your computer and not on the RightFax Server directly, remember that you’ll need to copy the file back to the server.

Back to our command prompt now. We’ll use the same syntax as we did previously, changing the -o to a -I and changing the filename (if necessary) and then hit enter. If everything was done correctly, we should see the list of users scroll in our command prompt window as changes are being processed. Once completed, we get a summary that tells us how many records were imported, how many new users (if any) were created and finally, how many users were updated.

If we go back to Enterprise Fax Manager and then back to Users, we see that the routing codes on the users we changed now show they are 10 digits instead of the 4 that they were previously.

You can use this same method to make other bulk changes, such as GROUPS, to your users. Just remember that if you use it to change something that doesn’t yet exist (like a GROUP name) that you’ll need to make sure you create that in Enterprise Fax Manager first before doing your import.

Click to download impuser export column headers