IQDoc
ITIQPro Docs Maintenance Connection Everywhere (MCe) · EAM/CMMS manuals
SQL Administrator Tool
Getting in and basic use

For support reasons sometimes we ask you to run some SQL. To get to our SQL Administrator tool (often called SQL tool for short)

Getting to the SQL Administrator tool

The Access manager requires that you have rights to the "Access Manager" license. YOU decide what permissions it needs, not us, that is discussed elsewhere.) The Access Manager is on the Configuration page

Start by opening the main menu

Start by clicking on the main menu button on the left panel, top left portion.

Shows clicking on the Main Menu button

If the menu button isn't visible, you are likely on a screen too narrow to see everything, press on the left pointing gold button to take you so you can see the menu button.

Shows the gold button to get to the panel containing the main menu button

Once the menu is up, the exact location of the configuration button depends on how wide your window is and how many options you have access to. On most it will be at the top of the 2nd or 3rd column of the menu but on a cell phone or narrow window, it will be down partway in the first column.

Shows how to get to the configuration

Then from there you choose the Access Manager, or what we call the funny green key

Shows the Configuration menu SQL Administrator button

You can also click on the right hand V button in the main menu (if you don't already have it open), noting if you do it this way, you can directly pick the Access Manager tool that you want to go into.

Shows the SQL Administrator tool directly from the main menu
What if the SQL Administrator tool isn't on the menu?

You have to give yourself access or get someone with 'Access Manager' rights to give you access, or get someone else to run the SQL for you.

How to get to preferences

The Access manager requires that you have rights to the "Access Manager" license. YOU decide what permissions it needs, not us, that is discussed elsewhere.) The Access Manager is on the Configuration page

Start by opening the main menu

Start by clicking on the main menu button on the left panel, top left portion.

Shows clicking on the Main Menu button

If the menu button isn't visible, you are likely on a screen too narrow to see everything, press on the left pointing gold button to take you so you can see the menu button.

Shows the gold button to get to the panel containing the main menu button

Once the menu is up, the exact location of the configuration button depends on how wide your window is and how many options you have access to. On most it will be at the top of the 2nd or 3rd column of the menu but on a cell phone or narrow window, it will be down partway in the first column.

Shows how to get to the configuration

Then from there you choose the Access Manager, or what we call the funny green key

Shows the Configuration menu Access Manager button

You can also click on the right hand V button in the main menu (if you don't already have it open), noting if you do it this way, you can directly pick the Access Manager tool that you want to go into.

Shows the Access manager directly from the main menu

Now press the Preferences button

Getting to Preferences button from the Access Manager menuGetting to Preferences button from the main menu

To give you/someone access to the SQL Administrator tool:

1. Pick who should (usually for this tool it should be by access group and/or individuals)

Shows preference for SQL Administrator tool

2. Make sure it shows a checkmark, not the "this is set at a higher level" box. In the image below the checkbox with the circle around it shows that, at this level it is checked - turned on whereas the checkbox with the square around it shows that 'this is set at a higher level', at the company level in this case. So the one with the square is saying that it is not being overridden by the Access Group we picked, rather it will be whatever the Company/Organization level has it set at, and it will change when the Company/Organization level value changes.

Shows the this is set at a higher level box

3. Hit save.

If this was done in your browser, you should have permission immediately.

Shows the save button position

4. If someone else did the above steps, you'll need to wait a few minutes for it to sync, or speed it up by running a complete manual sync 'now'.

Shows how to  force running a complete manual sync now

In the SQL Administrator tool

On the SQL Admin tool screen, the Query tab is where you paste the SQL you were given. Then typically hit the "Execute" button, which in many cases will show you some results below it.

If you are expecting more than 20 rows in your results, you may want to set the Max rows to Return higher. The max is set in case you enter some SQL that takes a very long time per row to return so it doesn't 'kill' the server with overload or bog down your internet connection too long.

Shows where to enter SQL to run as requested

Getting the results out of the tool

One you get some results, you can copy or save the results somewhere.

Shows the Actions button and the Copy and Save choices it pulls up

You can copy to the clipboard in several formats: JSON or CSV are usually the most useful formats - decide depending on your preference or what you were asked to do.

Shows how to pick the formats to copy to clipboard

Or you can save it to a file you can open or email. In general XLXS for most purposes is highly convenient and we do some default column widths based on data type that give you a good starting point for viewing the data.

Shows the Save As options you can save the file to

Getting Access to the SQL Admin Tool:

If you don't see the SQL Administrator tool, it is because you have not been given permission to see it. Permission can be set by anyone your organization has given rights to the Access Manger license:

Shows where the Access to SQL Administrator tool setting is

To get to change the preferences you have to have access to the "Access Manager"

Shows where the UI Configuration button is in the Access Manager in Configuration.

Getting access to the Access Manager license so that you can get access to the SQL Admin tool

Shows where the Access Manager license is

The default OOB (Out of Box) is 'all' but your system probably has it shut down to an access group or two or a handful of users. We (and you) can't see who if you don't have access to this screen, but your IT or EAM administrator should know who.

Shows the out of the box permission for the Access Manager license