Customers#
Overview#
Customers exist as a node in VOSS Automate’s hierarchical structure. Typically, the structure has the following order (from highest level to lowest level).
Provider
Reseller
Customer
Site
Optional intermediary nodes can also be created.
Note
VOSS Automate employs hierarchies (organization levels), user roles, and access profiles to control and secure access to resources in the system. You can find out more about hierarchies at Introduction to Hierarchies in the Core Feature Guide.
In the hierarchical structure, sites (locations) can only be created under a customer. However, you will need to set up the customer-level configuration before adding sites. The complete on-boarding of a customer is done at the Provider hierarchy. You can find the customer on-boarding details in the Customer On-boarding Quick Start Guide in the Core Feature Guide.
Related Topics
Add and Update Customers#
This procedure adds a new customer, and updates an existing customer.
Note
If required, you can disable number management for the customer.
Log in as Provider or Reseller administrator (depending on which organization manages the customer).
Note
Log in using the Provider or Reseller admin’s email address (case-sensitive). You can find this email address via (default menus) User Management > Admins. Click on the admin’s name to view the email address.
Choose the hierarchy.
Note
If logged in as Provider and the Customer is to be added under a Reseller, set the hierarchy path to the Reseller.
Go to (default menus) Customer Management > Customers.
On the Customers page:
To add a new customer, click the Plus icon (+) to open the configuration screen.
To update an existing customer, click on the customer name to open the configuration screen.
Note
To switch the page layout from panels to tabs or from tabs to panels, you can click the Switch to Tab/Panel Layout toolbar icon.
Fill out or update the fields on the page (Customer Details and Contact Information tabs/panels):
Customer Details (see field descriptions below)
Contact Information - fill out the customer address and contact details (email address and telephone number)
Important
Additional custom string and boolean fields may be exposed via field display policies for the Customers configuration form. For details, see Add Custom Fields to Customer Configuration Screens
Customer Details |
Description |
|---|---|
Customer Name |
Mandatory. The name of the customer. Note that when Create Local Admin is selected, any spaces in the customer name are converted to underscores in the Customer local administrator name and email. |
Description |
Customer description |
Extended Name (Provider) |
Descriptive name for the customer, used by external clients to correlate their own customer records with customer records stored in HCS. |
External Customer ID (Provider) |
External customer ID used by the Service Inventory service, and included as a column in the customer record of the service inventory report. Specify an External Customer ID in this field that matches the customer ID used by the external inventory tool that receives the Service Inventory reports. If the Service Inventory service is not being used, this field is not required. However, it can be used to correlate customer records in external systems with customer records in HCS. |
Domain Name |
Customer domain. This field is used to create email addresses for:
If the customer domain is omitted, the provider domain (or reseller domain, if the customer is under a reseller in the hierarchy and the reseller domain was provided) is used instead. |
Account ID |
The Account ID is used by external clients to correlate their own customer records with the customer records stored in HCS. This Account ID value is synced to the Customer record in the Shared Data Repository. |
Deal IDs |
Deal IDs are used by the Hosted License Manager (HLM) service. HLM supports Point of Sales (POS) report generation. The report includes all customers on the system with aggregate license consumption at customer level. The optional Deal ID field associated with the customer is included in the report. Each customer can have zero or more Deal IDs. The Deal ID field is free text format and each deal ID is separated by a comma. |
Customer Details |
Description |
|---|---|
Shared UC Applications |
Indicates whether the customer can use Shared UC Apps. If selected, the customer sites can use Network Device Lists that contain Shared UC Apps. Shared UC Apps are UC Apps that are defined above the Customer hierarchy level. |
Disable Number Management |
Enable or disable Number Management for this customer.
|
Public Sector |
Set the Customer as a Public Sector customer. Used for License Reporting. |
Inactive Billing |
Exclude customer from billing (for testing). Used for License Reporting. |
Customer Details |
Description |
|---|---|
Create Local Admin |
Defines whether a default local administrator is created for the customer. |
Cloned Admin Role |
The Provider or Reseller role used to create a new role prefixed with the customer name. The created customer role, shown in the Default Admin Role field, is assigned to the default local administrator user. This field appears only if the Create Local Admin checkbox is selected. |
Default Admin Role |
The created customer role that is assigned to the default local administrator. This field is read-only, and appears only if the Create Local Admin checkbox is selected. |
Default Admin Password |
The password to assign to the default local administrator. This field appears and is mandatory only if the Create Local Admin checkbox is selected. |
Repeat Default Admin Password |
Confirm the default local administrator password. This field appears and is mandatory only if the Create Local Admin checkbox is selected. |
If you enable Number Management for a customer after it was disabled, run the DN Audit Tool. See Audit Number Inventory.
Click Save.
Note
When deleting a customer, remove any entities associated with the customer, such as LDAP, SSO providers, Devices, and NDLs.
Add Custom Fields to Customer Configuration Screens#
VOSS Automate allows you to add up to ten custom string fields and up to 10 custom boolean fields to the field display policy you apply to the Customer data model (relation/HcsCustomerREL). This provides flexibility to add additional details for a customer, if required.
The summary attributes in the Customers list view always display three Boolean fields and three String fields, regardless whether they’ve been included in the FDP. If you wish to change the title of these fields in the summary attributes you can add a field override entry in the FDP.
When configuring a customer (add or update), you may specify field values or use named macros to populate values for these fields.
Macros for custom string fields for relation/HcsCustomerREL:
macro.HcsVossCustomerDAT_custom_string_1
macro.HcsVossCustomerDAT_custom_string_2
macro.HcsVossCustomerDAT_custom_string_3
macro.HcsVossCustomerDAT_custom_string_4
macro.HcsVossCustomerDAT_custom_string_5
macro.HcsVossCustomerDAT_custom_string_6
macro.HcsVossCustomerDAT_custom_string_7
macro.HcsVossCustomerDAT_custom_string_8
macro.HcsVossCustomerDAT_custom_string_9
macro.HcsVossCustomerDAT_custom_string_10
Macros for custom boolean fields for relation/HcsCustomerREL:
macro.HcsVossCustomerDAT_custom_boolean_1
macro.HcsVossCustomerDAT_custom_boolean_2
macro.HcsVossCustomerDAT_custom_boolean_3
macro.HcsVossCustomerDAT_custom_boolean_4
macro.HcsVossCustomerDAT_custom_boolean_5
macro.HcsVossCustomerDAT_custom_boolean_6
macro.HcsVossCustomerDAT_custom_boolean_7
macro.HcsVossCustomerDAT_custom_boolean_8
macro.HcsVossCustomerDAT_custom_boolean_9
macro.HcsVossCustomerDAT_custom_boolean_10
The macros can be applied in workflows and configuration templates to reference the custom field values. For example, executing macro.HcsVossCustomerDAT_custom_string_1 will return the value in the field where the macro is used.
To expose custom fields for relation/HcsCustomerREL
Log in to VOSS Automate as Provider admin or higher.
Create or update the Customers data model field display policy:
Go to (default menus) Customization > Field Display Policies, and locate the entry for target model type relation/HcsCustomerREL.
Click on the default field display policy (FDP) for the model (the FDP named default).
Clone (copy) the default FDP for the model, and give the clone a new name.
Note
You cannot modify default FDPs that ship with the system. This allows you to refer to or revert to a system default at any time, if required.
Modify the new FDP (the clone).
Note
You can add a new group of fields containing only the new custom fields, or add fields to existing field groups.
You can also create field overrides, which allow you to define that a custom field value will be referenced in place of an existing field.
Save your changes.
Update the menu layout to apply the field display policy:
Go to (default menus) Role Management > Menu Layouts, and locate the Provider admin menu layout (HcsProviderMenu).
Click on HcsProviderMenu, and create a clone with a new name.
Note
You cannot modify default menu layouts that ship with the system. This allows you to refer to or revert to a system default menu layout at any time, if required.
Modify the clone (copy) of HcsProviderMenu:
Expand the Customer Management menu.
At Customers, click in the Field Display Policy cell, and choose the FDP you configured to add the custom fields.
Save your changes.
Log out, then log in again as Provider admin.
This allows the role-based access profile changes to refresh so that you can view the updated menu layouts and field display policies you applied, including new custom fields.