.. _menu-layout-best-practices:

Best Practices Menus
--------------------

.. _20.1.1|VOSS-618:

In addition to a default set of menus, VOSS Automate also provides best practice menus
for provider and customer administrators, including the associated access profiles and
landing pages.

These menus have a more business-oriented structure and include additional options based
on best practice adaptations that may also be included in VOSS Automate. 

The best practice menus have the following features:

* A menu order, nesting and naming convention according to common business use.

  The top-down order of the menus follow the logical order of tasks and system hierarchies
  that are used to carry out these tasks. 
  
  For example, for provider administrators, the **Cisco UC App Management** menu provides menus only for these Cisco devices, 
  while SMTP server and other settings carried out by providers are arranged under **Provider Configuration**.
  Similarly, the **Cisco Subscriber Services** menu has sub-menus for all the functionality associated 
  with these subscribers in VOSS Automate.
* Where a menu is for a *form view* (input or edit), the first word in the menu name is in capitals, for example **ADD Internal Number Inventory**.
  Note that this does not apply to menu names that start with abbreviations and acronyms like E164, HCS, LDAP and so on.
  In this case, the capital rule will apply to the next word in the menu item name.
* Menus for URLs:

  * Menus are provided for VOSS Automate portals so that is easy to launch into another portal.

  .. important::

     In the case of menus that use URLs, you need to update the URLs to match your configuration.

To modify and to assign your modification of a best practice menu to a user role, consider the following:

* Managing menu layouts - see: :ref:`create_a_menu_layout`. Also consider using the 
  Menu Diff Tool to easily modify menus - see the Advanced Configuration Guide for details.
* Field Display Policies associated with menu items are available. For further configuration, see: :ref:`add-edit-field-display-policy`.
* Configuration Templates associated with menu items are available. For further configuration, see: :ref:`workflow_for_creating_configuration_templates`.
* Access Profiles for the best practices menus are provided - see the list under the **Access Profiles** menu.
  If any access profiles need to be modified to align with a modified menu, see: :ref:`access-profile-operations`.
* Landing Pages for the best practices menus are provided - see the list under the **Landing Pages** menu.


The menus for specific adaptations are listed below. Note that an adaptation may not necessarily 
be on your system.

.. tabularcolumns:: |p{3cm}|p{4cm}|p{4cm}|p{4cm}|

+------------+----------------+----------------------------+----------------------------------+
| Menu       | Sub-Menu       | 3rd level menu             | Adaptation                       |
+============+================+============================+==================================+
| VOSS Phone | VOSS Phone     |                            | VOSS Phone Server                |
| Server     | Server         |                            |                                  |
| Management |                |                            |                                  |
|            | VOSS Phone     |                            |                                  |
|            | Adaptive Dial  |                            |                                  |
|            | Plan           |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+
| Customer   | Contact        | * CC Users                 | ContactCentre-VoiceRecording     |
| Management | Centre         |                            | User                             |
|            | Services       | * CC User Preferences      |                                  |
|            |                |                            |                                  |
|            |                | * CC User CFTs (with       |                                  |
|            |                |   GS_CCUser filter)        |                                  |
+------------+----------------+----------------------------+----------------------------------+
| HCS Dial   | HCS Dialplan   | * Dialplan Additions       | Dialplan Additions               |
| Plan       | Additions      |                            |                                  |
| Management |                | * Dialplan Addition        |                                  |
|            |                |   Templates                |                                  |
|            |                |                            |                                  |
|            |                | * Dialplan Additions       |                                  |
|            |                |   CFTs                     |                                  |
|            |                |   (GS_DialplanAdditions    |                                  |
|            |                |   filter)                  |                                  |
|            |                |                            |                                  |
|            |                | * Dialplan Additions       |                                  |
|            |                |   CFTs (``ENT_`` Filter)   |                                  |
|            |                |                            |                                  |
|            |                | * CustSCode-PT             |                                  |
|            |                |   Translation Patterns     |                                  |
|            |                |                            |                                  |
|            | HCS Group CLI  | * External Group CLI       | Group CLI                        |
|            |                |   Inventory                |                                  |
|            |                | * External Group CLI       |                                  |
|            |                |   Association              |                                  |
|            |                | * Internal Group CLI       |                                  |
|            |                |   Inventory                |                                  |
|            |                | * Internal Group CLI       |                                  |
|            |                |   Association              |                                  |
|            |                | * ExternalGroupCLI-PT      |                                  |
|            |                |   Calling Party Transforms |                                  |
+------------+----------------+----------------------------+----------------------------------+
| Site       | Advanced       | SameDialplanOB 8XData      | Overbuild Same Dialplan          |
| Management | Site           |                            | AddSite                          |
|            | Functions      |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+
| Number     | (N to 1) DN    |                            | N to 1 E164 Association          |
| Management | to E164        |                            | Update Support                   |
|            | Associations   |                            |                                  |
|            | with Update    |                            |                                  |
|            |                |                            |                                  |
|            |                |                            |                                  |
|            |                |                            |                                  |
|            |                |                            |                                  |
|            |                |                            |                                  |
|            |                |                            |                                  |
|            |                |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+
| Number     | ADD            |                            | Number Inventory Mgmt -          |
| Management | Multi-step     |                            | Multi-Step                       |
|            | Number         |                            |                                  |
|            | Inventory      |                            |                                  |
|            |                |                            |                                  |
|            |                |                            |                                  |
|            |                |                            |                                  |
|            |                |                            |                                  |
|            |                |                            |                                  |
|            |                |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+
| Cisco      | Add Lines to   |                            | Pickup Group Membership          |
| Subscriber | Pickup Group   |                            |                                  |
| Services   |                |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+
| Cisco      | * Change Line  |                            | Change Line                      |
| Subscriber |                |                            |                                  |
| Services   | * Change Line  |                            |                                  |
|            |   Profiles     |                            |                                  |
|            |                |                            |                                  |
|            | * Change Line  |                            |                                  |
|            |   Instance     |                            |                                  |
|            |   Profiles     |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+
| Cisco      | Line           |                            | Line Recording                   |
| Subscriber | Recording      |                            |                                  |
| Services   |                |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+


.. tabularcolumns:: |p{3cm}|p{4cm}|p{4cm}|p{4cm}|

+------------+----------------+----------------------------+----------------------------------+
| Menu       | Sub-Menu       | 3rd level menu             | Adaptation                       |
+============+================+============================+==================================+
| Cisco      | * FAC Code     |                            | Enhanced ForceAuthenticationCode |
| MACD       |   Management   |                            | Support                          |
| Functions  | * Sync FAC     |                            |                                  |
|            |   Codes Across |                            |                                  |
|            |   Clusters     |                            |                                  |
|            |                |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+
| Multi-     | VOSS Phones    |                            | VOSS Phone Server                |
| Vendor     |                |                            |                                  |
| Services   |                |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+
| Audit      | VOSS Day 2     |                            | Audit Tool                       |
| Tools      | Customer       |                            |                                  |
|            | Audit Tool     |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+
| Overbuild  | RUN EM-User    |                            | Audit Tool                       |
| Tools      | Overbuild      |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+
| Overbuild  | E164 TPs AND   |                            | DN Overbuild                     |
| Tools      | TRANSFORM      |                            |                                  |
|            | Move Tool      |                            |                                  |
+------------+----------------+----------------------------+----------------------------------+