|Desktop Application . XML/SOAP web service interface . Help|
|Magrathea Interface - Help page|
This page provides help for setting up and using the Magrathea Interface application. It runs on Microsoft Windows, and requires version 2 of the .Net Framework, which can be downloaded here.
To install, run the Setup.msi file by double clicking it, or right click and select Install.
Two files are installed, the executable - MagratheaInterface.exe - and the settings file - Magrathea.Settings. In addition, shortcuts are added to the Windows desktop and Start bar.
Launch the application by clicking Start | Programs | Magrathea Interface, or by double clicking the icon on your desktop.
Before using the application to manage phone numbers, the connection properties must be set, as shown below.
|2. Getting connected|
All connection details are entered in the Options window. To open the options window, go to the menu at the top of the application and select Tools, then Options.
Set the connection details as above, specifying your Magrathea account in Username, and password in Password. Please use capitalization as shown above. Everything apart from MagratheaXmlService should be lower case.
2.2 Entering or importing phone numbers
In the options window, select the numbers field, and a small button will appear on the right hand side (as shown above). Clicking it will open a window where phone numbers can be pasted or entered manually.
2.3 Backing up your settings
Go to the installation folder (by default C:\Program Files\Magrathea Interface), and copy the Magrathea.Settings file to another location. In the unlikely event that the settings file becomes corrupted, it can then be replaced by the last good backup. The settings file should be backed up after every change.
|3. API replacements|
ALTEN is replaced by the upper pane in the allocation window.
ALLO and ACTI are replaced by the lower pane
STAT is performed by clicking on a number in the numbers list in the status window. Once a status is viewed, then the number can be DEACtivated or REACtivated using the status dropdown, then clicking the Update button. Similarly, destinations can be SET by entering the destination and selecting the correct type from the target dropdowns, then clicking update. To clear a destination, remove the text from the relevant textbox and click Update. INFO can be entered against a number using the Set Info button.
SPIN, FEAT and ORDE functions are currently unavailable.
|4. How to|
4.1 Adding phone numbers to your account
Click on Allocate numbers in the leftmost pane. The allocation view will appear on the right. At this point, you have two choices, you can search for 10 number ranges, or enter the prefix of the number you would like.
4.1.1 Searching for 10 number ranges
Each time the Look up button is clicked and returns an available range, the details of the lower half of the allocation pane are automatically completed, ready for allocation.
4.1.2 Allocating and activating numbers
Before phone numbers can be assigned to customers, they must be allocated and activated. These two steps are performed together by the application, so no separate allocation is required.
Once a number is allocated, it is automatically added to the numbers list and will be visible in the status view.
4.2 Viewing and changing the status of allocated phone numbers
Click on View or change status or targets in the leftmost pane. The status view will appear on the right.
Select any of the phone numbers from the list by clicking on it, or selecting any number, and moving through the list using the arrow keys. The status, activation and multiple destinations of the number will be displayed on the right.
When setting targets, do not enter the target type in the text box. i.e. select SIP RFC2833 DTMF in the dropdown, and enter the SIP target email@example.com. Do not prefix this with S: as in the telnet interface.
When all information is updated, click the Update button. Doing so will write all of the information back to Magrathea Telecom. No information is written until the button is clicked, so to restore the values that have been edited, click on the number again in the list, and the live settings will be re-entered.
The Set Info button can be used to enter information against the selected number. Unfortunately, it is write only at present and cannot be viewed.
4.3. Resizing the window
All of the vertical and horizontal breaks can be dragged, or selected using the tab key and changed with the up/down or left/right keys. The breaks are shown in red below:
If the application cannot communicate with the web service, an error message of Unable to reach web service, please check your internet connection will be displayed. If the application successfully connects to the web service, but the web service cannot reach Magrathea, a different error message, The web service was unable to reach www.magrathea-telecom.co.uk is displayed. Other error messages are similar to those from the telnet interface.
All successful calls display a smiley - :) - in the status bar.
An error message of Access denied or AUTHorization required first means that your username and/or password are wrong.