The Microsoft Quick Add Subscriber feature provides provides a simple interface for allocating supported Microsoft UC services to users that have been added to Microsoft Active Directory and synchronized into VOSS-4-UC from Microsoft Lync / Skype for Business.

The interface is for service additions and the detailed configuration is hidden from administrators delegated to perform these operations. The detailed configuration is typically managed by a customer administrator or above using the Configuration Templates specified in Microsoft Quick Add Groups.

The VOSS-4-UC user interface will disable the option of adding Microsoft Lync / Skype for Business if the user already has Microsoft Lync / Skype for Business.

Microsoft Quick Add Subscriber Workflow

The workflow supports adding the following Microsoft UC services:

If the required AD User is not in the dropdown list:

Create a user in Microsoft Active Directory

If the Skype for Business check box is selected:

Enable a user in Microsoft Lync or Skype for Business
Grant the user each of the applicable policies.
Set the Lync / Skype for Business user settings according to the user input and selected telephony options.

If the Voicemail check box is selected:

Create a mailbox for the user in Microsoft Exchange using the email address of the AD user and with options specified in the Microsoft Exchange Mailbox template in the Microsoft Defaults / Microsoft Quick Add Group.
Enable the mailbox of the user for Unified Messaging using the extension specified.

If the Office 365 check box is checked:

Below see the workflow for provisioning online services.

NOTE: If the workflow is rolled back for whatever reason and the creation of a Mailbox is reversed by disabling the mailbox then it has the effect of the AD user's email address being blanked out, which is comes from disabling the mailbox.

Microsoft Quick Add Subscriber Online

The following conditions apply when adding services to a Subscriber enabled for MS Online Services:

If the Subscriber has Voicemail or Skype for business the following options will be disabled : * Voicemail * SFB Enabled

If the Subscriber does not have Voicemail and/or Skype for Business you can choose to enable the subscriber by just checking the voicemail and/or SfB Enable check boxes. This will enable the Subscriber with on-prem services.

If the voicemail checkbox is checked and the Online Mailbox/Voicemail checkbox is checked, the Subscriber will be provisioned for online mailbox and Ummailbox services.

If the SfB Enabled checkbox and the Online Skype for Business checkbox is checked the Skype for Business service will be provisioned online.

NOTE: The Microsoft Quick Add Group selected needs to contain the MS Online Licenses required for the options selected.

Microsoft Quick Add Subscriber Online Provisioning Workflow

The workflow supports adding the following Microsoft Online Services in a hybrid deployment:

If the Online Skype for Business check box is selected:

Enable a user in Microsoft Lync or Skype for Business (on premises)
Persist a MS Online Provisioning request (to be processed as specified below).

Processing Online Provisioning Requests:

Synchronize MS Online Users into VOSS (and move them to the site where the AD user exists).
If the MS Online User has been dir synced to MS online then modify the MS online user as follows:
- Set the usage location to the usage location configured in the Quick Add Group or (if not specified in the Quick Add Group) the MS Defaults.
- License the user according to the licenses specified in the Quick Add Group.
If the Online Skype for Business option had been checked when doing Quick Add Subscriber then:
- Move the on-prem Skype for Business user online.
- Update the Skype for business online user properties (which will grant the policies configured in the Skype for Business template of the Quick Add Group).
- Set the Lync / Skype for Business user settings according to the user input and selected telephony options.
If the Online Mailbox/Voicemail option had been checked when doing Quick Add Subscriber then:
- Add an online Exchange Mailbox according the configuration template in the Quick Add Group.
- Enable the Exchange Mailbox for Unified Messaging (UM) according the configuration template in the Quick Add Group.
Update VOSS view of the data in on Active Directory user and the Skype for Business Online and Onprem users, since these would have been updated with execution of above steps.

Model Details

An asterisk * in the title indicates the field is mandatory.
If a field has a default value, it is shown in the Description column.
If the field type is an array, the Field Name has a .[n] suffix, where n is the array index placeholder.
Object and array field names are listed to provide context. If a field belongs to an object or an array, the full field name is shown in dot separated notation.

Title

Description

Details

Username *

Field Name: username
Type: String

First Name

Field Name: firstname
Type: String

Last Name *

Field Name: lastname
Type: String

Email Address *

Field Name: email
Type: String
Pattern: ^([^.@]+)(\.[^.@]+)*@([^.@]+\.)+([^.@]+)$
Format: email

Password

The corresponding CUCM, CUC and WebEx user password will be set with this password

Field Name: password
Type: String
Is Password: True

The corresponding CUCM and CUC user PIN will be set with this PIN

Field Name: pin
Type: String
Is Password: True

Manager

Field Name: manager
Type: String

Department

Field Name: department
Type: String

Telephone Number

Field Name: telephoneNumber
Type: String

Title

Field Name: title
Type: String

Home Number

Field Name: homeNumber
Type: String

User's Mobile Number

Field Name: mobileNumber
Type: String

Usage Location *

MS Licensing Usage Location

Field Name: usage_location
Type: String
Target: data/LyncDefaults

Directory URI

Field Name: directoryUri
Type: String

Quick Add Group *

Default: default

Field Name: qagroup_name
Type: String
Target: data/LyncQuickAddGroups-Teams
Target attr: group_name
Default: default
Format: uri

Existing Services

Field Name: existing
Type: Object

Phones

Field Name: existing.phones
Type: String

Extension Mobility Profiles

Field Name: existing.ext_mobilities
Type: String

Voicemail Extension

Field Name: existing.voicemail
Type: String

WebEx

Field Name: existing.webex
Type: String

SfB Id

Field Name: existing.lync_id
Type: String

Exchange UM ID

Field Name: existing.ExchangeUM_id
Type: Integer

SIP Address

Field Name: existing.sip_address
Type: String

Single Number Reach

Field Name: existing.snr
Type: String

User status

Field Name: user_status
Type: String

Lines

Field Name: lines.[n]
Type: Array

Directory Number

Field Name: lines.[n].directory_number
Type: String

Voice

Field Name: voice
Type: Boolean

Phones

Field Name: phones.[n]
Type: Array

Phone Name

Name of phone to provision for e.g. SEPABCDEFABCDEF

Field Name: phones.[n].phone_name
Type: String
Target: device/cucm/Phone
Target attr: name
Format: uri

Extension Mobility

Field Name: mobility
Type: Boolean

Voicemail

Field Name: voicemail
Type: Boolean

Online Mailbox/Voicemail

Field Name: online_voicemail
Type: Boolean

WebEx

Field Name: webex
Type: Boolean

SfB Enabled

Field Name: lync
Type: Boolean

Online Skype for Business

Field Name: online_sfb
Type: Boolean

lync_details

Field Name: lync_details
Type: Object

SIP Address

Field Name: lync_details.sip_address
Type: String

Phone Number

Field Name: lync_details.phone_number
Type: String

Extension

Field Name: lync_details.ext
Type: String

Field Name: lync_details.id
Type: String

Office365 Enabled

Field Name: office365
Type: Boolean

Microsoft Teams

Field Name: ms_teams
Type: Boolean

Single Number Reach

Field Name: snr
Type: Boolean

SNR Mobile Number

Field Name: mobile_number
Type: String

Jabber Device

When adding a Jabber device also specify a line to be associated. The first line specified will be used for any Jabber device added here.

Field Name: jabber
Type: Boolean

Jabber Agent

Field Name: jabber_agent
Type: String
Choices: ["Android", "CSF", "iPad", "iPhone"]

Jabber Devices

Field Name: jabber_devices.[n]
Type: Array

Jabber Agent

Field Name: jabber_devices.[n].jabber_agent
Type: String
Choices: ["Android", "CSF", "iPad", "iPhone"]

Device Name

Field Name: jabber_devices.[n].device_name
Type: String

Mobile Identity

Field Name: jabber_devices.[n].mobile_identity
Type: Boolean

Destination

Field Name: jabber_devices.[n].mobile_identity_destination
Type: String

Enable Self Provisioning

Field Name: self_service_id
Type: Boolean

Self Provisioning User Profile

Field Name: self_provisioning_profile
Type: String
Target: device/cucm/UserProfileProvision
Target attr: name
Format: uri

LDAP User

Field Name: ldap_user
Type: String

Normalized User

Field Name: normalized_user
Type: String

CUCM User

Field Name: cucm_user
Type: String

CUCM User LDAP Directory Name

Field Name: cucm_user_ldapDirectoryName
Type: String

Phone Template

Field Name: phone_template
Type: String

Phone Type

Field Name: phone_type
Type: String

Phone Protocol

Field Name: phone_protocol
Type: String

Model: view/TeamsQuickSubscriber

Multi-vendor Quick Add Subscriber

Microsoft Quick Add Subscriber Workflow

Microsoft Quick Add Subscriber Online

Microsoft Hybrid 2-stage provisioning

Microsoft Quick Add Subscriber Online Provisioning Workflow

Model Details