************** Web interface ************** The XiVO Centralized Interface (XCI) is managed through a web interface. In the following sections, we will highlight the main features of the system. Definitions ============ XCI uses a few concepts that are important to understand in order to use the interface correctly. **XiVO** The XiVOs servers that are managed by XCI. XCI will automatically retrieve the entities and the users from them and apply the configuration to them. **Entity** Entities, also called Contexts, are the parts of the dialplan. Users are attached to them. **Line template** Line templates are used to quickly create users : they define a few default options (ringing time, voice mail, etc.) that will be applied to the new user. **A line template is required to create a user**. **User** Actual users that are associated with a phone number **Administrators** Users that are able to connect to the XCI and manage the XiVOs. Dashboard ========= .. image:: screenshots/dashboard.png :width: 50% :align: center The dashboard provides you some insights about your XiVO systems. The left sidebar, displayed in every page of the application, gives you access to the various actions you can perform. The list of the configured XiVOs and their entities is shown to give a quick access to the one you want to manage. XiVO ==== Create XiVO ------------ .. image:: screenshots/xivo_create.png :width: 50% :align: center This page allows you to add a new XiVO that will be managed by XCI. The first step is to add the displayed SSH key to the authorized keys of your XiVO server. This will allow XCI to connect and configure the XiVO server. You could do this kind of command : .. code-block:: bash echo 'ssh-rsa TheVeryLongSSHKeyYouCopied toto@someserver' | ssh root@xivoIp 'cat >> .ssh/authorized_keys' Then, you have to provide the following informations : * **Name** : name of the XiVO server that will be displayed in XCI * **Hostname** : hostname or IP address of the XiVO server You then have two options : * **Create the XiVO and configure it now** : XCI will save the informations, try to connect to the XiVO server and perform the configuration. XiVO services will be unavailable during the operation. .. warning:: The configuration takes a while. Relax, go drink a coffee, XCI is doing the legwork for you :) * **Create the XiVO without configuring it** : XCI will only save the informations. View XiVO ------------ .. image:: screenshots/xivo_view.png :width: 50% :align: center On the sidebar, each XiVO has its own **View XiVO** link. This page allows you to : * **Add a new entity** to this XiVO by clicking on the green button * See the entities associated to this XiVO and perform some operations to them : * **Edit one** by clicking on the yellow button with the wrench icon * **Delete one** by clicking on the red button with the trash icon Entity ====== Create entity -------------- .. image:: screenshots/entity_create.png :width: 50% :align: center This page allows you to add a new entity to a XiVO. You have to provide the following informations : * **Name** : name that will be used by the XiVO server * **Display name** : name that will be displayed on XCI * **Caller ID** : phone number that will be displayed on outgoing call from this entity * **Intervals** : ranges of phone numbers that will be available to this entity. For each one, provide : * **Start** * **End** *The system will return an error if the intervals overlap with other entities* View entity -------------- .. image:: screenshots/entity_view.png :width: 50% :align: center On the sidebar, each entity has its own link. This page allows you to : * **Add a new user** to this entity by clicking on the green button * **Edit the entity** by clicking on the yellow button with the wrench icon * See the users associated to this entity and perform some operations to them : * **Edit one** by clicking on the yellow button with the wrench icon * **Delete one** by clicking on the red button with the trash icon. *At first click, the icon turns into a question mark. You have 5 seconds to click again to launch user deletion. This process prevents you from accidentally delete users.* Edit entity -------------- .. image:: screenshots/entity_edit.png :width: 50% :align: center This page allow you to modify an entity. Please refer to the `Create entity`_ section for fields details. Line templates ============== List templates -------------- .. image:: screenshots/template_list.png :width: 50% :align: center On the sidebar, **Line template** has its own link. This page allows you to : * **Add a new line template** by clicking on the green button * See all the line templates and perform some operations to them : * **Edit one** by clicking on the yellow button with the wrench icon * **Delete one** by clicking on the red button with the trash icon Create template ---------------- .. image:: screenshots/template_create.png :width: 50% :align: center This page allows you to add a new line template. You have to provide the following informations : * **Name** : name that will be be displayed on XCI * **XiVO** : select the XiVOs for which this template will be available * **Entity** : select the entities for which this template will be available. *Only entities of the selected XiVOs are displayed* * **SIP peer name** : *Auto* or *Model* * **Ringing time** : number of seconds before incoming call is rejected * **Routed** : * The text field allows you to provide the SDA prefix to call the phone * Uncheck the checkbox if you don't want the phone to be called from the outside * **Outgoing caller id** : specify what number is displayed on outgoing call. Possible values are : * External number prefix * Anonymous * Customized : a text field appears to provide the custom number * **Voicemail** : * **Activate voicemail** : enable or not the voicemail * **Voicemail number** : specify what number is used to call the voice mail. Possible values are : * **Short line number** : use the default short number * **Customized** : a text field appear to provide the custom number * **Voice to mail** : whether or not to send an email when a new message is left Edit template -------------- .. image:: screenshots/template_edit.png :width: 50% :align: center This page allows you to modify a template. Please refer to the `Create template`_ section for fields details. User ==== Create user -------------- .. image:: screenshots/user_create.png :width: 50% :align: center This page allows you to add a new user to an entity. You have to provide the following informations : * **Template** : line template to use as a template to create the user. *The main options of the template are displayed below* * **First name** * **Last name** * **Internal number** : number that will be used to internally call the user. *Only the available numbers are displayed* * **CTI credentials** : provide a login and a password to allow the user to connect through CTI interfaces Edit user -------------- .. image:: screenshots/user_edit.png :width: 50% :align: center This page allows you to modify a user. Please refer to the `Create user`_ section for fields details. Administrators ============== List administrators ------------------- .. image:: screenshots/administrator_list.png :width: 50% :align: center On the sidebar, **Administrators** has its own link. This page allows you to : * **Add a new administrator** by clicking on the green button * See all the administrators and perform some operations to them : * **Edit one** by clicking on the yellow button with the wrench icon * **Delete one** by clicking on the red button with the trash icon Create administrator -------------------- .. image:: screenshots/administrator_create.png :width: 50% :align: center This page allows you to add a new administrator. You have to provide the following informations : * **Login** : login used by the administrator to connect to XCI * **Name** : name that will be displayed on XCI * **LDAP** : if checked, the LDAP authentication configured in ``application.conf`` will be used * **Password** : password used by the administrator to connect to XCI. *Shown only if LDAP disabled* * **Superadmin** : whether or not this administrator is a super-administrator. Super-administrators can manage everything in XCI * **Entities** : select the entities this administrator will be able to manage *Shown only if Superadmin disabled* Edit administrator ------------------- .. image:: screenshots/administrator_edit.png :width: 50% :align: center This page allows you to modify an administrator. Please refer to the `Create administrator`_ section for fields details.