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

  • References to HCM-F and Shared Data Repository (SDR) are only relevant if installed.

  • In VOSS Automate, if the customer name matches an existing customer previously configured in HCM-F, you can migrate the existing customer.

  • If required, you can disable number management for the customer.

  1. 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.

  2. 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.

  3. Go to (default menus) Customer Management > Customers.

    ../../_images/customers-list-view.png
  4. 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.

    ../../_images/customers-configuration.png

    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.

  5. 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.

(Provider deployment) A customer configured in HCM-F and synced in to VOSS Automate may exist at the sys.hsc hierarchy. If customer name matches this customer, the Migrate from HCM-F to VOSS Automate checkbox is displayed. Click Save to migrate this customer to the current hierarchy. Fields are populated with the values configured in HCM-F. If you don’t want to migrate the customer, enter a different customer name.

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. Extended name value is synced to the customer record in the Shared Data Repository (SDR).

Extended Name is not referenced by other components 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 which can be activated on the Hosted Collaboration Management Fulfillment (HCM-F) server. 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

Prime Collaboration

Prime Collaboration is the application which monitors equipment used by this customer. Available Prime Collaboration applications must first be configured using the HCM-F User Interface. Then HCM-F synchronization must be executed on VOSS Automate. After the HCM-F data syncs into VOSS Automate, available Prime Collaboration applications will appear in this drop-down. Select an available Prime Collaboration application to monitor Unified Communications applications and customer equipment configured for this customer.

To un-associate Prime Collaboration for this customer, choose None.

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.

  • If selected, you cannot add Directory Numbers and E164 Numbers to inventories for this customer.

  • If not selected, you can add Directory Numbers and E164 Numbers to inventories 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.

  1. If you enable Number Management for a customer after it was disabled, run the DN Audit Tool. See Audit Number Inventory.

  2. 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

  1. Log in to VOSS Automate as Provider admin or higher.

  2. 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.

      ../../_images/customers-custom-fields-fdp.png
    • Save your changes.

  3. 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.

  4. 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.