######################################################
Upgrade Notes for VOSS Automate 21.3 Patch Bundle 1
######################################################


Upgrade Overview
================

In a new release, there are a number of changes that could relate to exposing new features or capabilities in the system. 
The default out of the box system would expose these. However, on a system where the configuration around the user experience has been applied, 
this might mean some changes to configured menus, display policies, and so on to expose the new features in your setup. 

Where relevant, we have included this information with the feature information to assist in planning for configuration changes as part of the upgrades. 
This setup could vary.

.. important:: 

   * Microsoft support within NBI

     From release 21.3 Patch Bundle 1 onwards, Microsoft support within NBI is not available.
     Contact VOSS Support or your VOSS Account Manager for details.

   * Upgrading MS Teams PowerShell Proxy

     When upgrading to release 21.3-PB1, users of Microsoft apps should update PowerShell Proxy Teams Module
     to ``4.3.0``.

   Refer to the detailed steps in the *Method of Procedure (MOP) for 21.3 Patch Bundle 1 Installation*.


.. _VOSS-1072_upgrade:

VOSS-1072: Update MS Teams Powershell Module Version
====================================================

Introduction
--------------

Microsoft has released 4.x versions of the PowerShell module for Teams. This has resulted in 
the following changes in VOSS Automate:

Model Changes and Notes
------------------------

Any customizations, API calls and Bulk Loaders should be modified to take into consideration the changes below. 

* ``relation/MultiVendorSubscriber`` field name changes:

  * ``Enabled`` -> ``AccountEnabled``
  * ``OnPremLineURI`` -> ``LineURI``
  * ``HostedVoicemail`` and ``HostedVoicemailPolicy`` removed  
  
* ``relation/MicrosoftSubscriber`` field name changes:

  * ``ObjectId`` -> ``UserPrincipalName``

* Subscriber/User/CsOnlineUser

  * ``EnterpriseVoiceEnabled`` setting falls away
  * ``OnLinePremURI`` – dropped, ``LineURI`` in its place
  * Line type – type of number – Direct Routing, Operator Connect, Calling plan
  * ``FeatureTypes`` field added (gives view of Teams capabilities based on MS License)
  * Policies – deprecated policies removed

* Quick Subscriber – updated to reflect changes

  * ``EnterpriseVoiceEnabled`` and ``HostedVoicemail`` – dropped
  * Existing services panel – updated to reflect new settings, etc.

* Subscriber from Profile

  * Existing/New services panel updated to reflect changes
  * Subscriber Profiles – Microsoft section simplified (remove ``EnterpriseVoice`` & ``HostedVoicemail``)

* Site Defaults

  * Deprecated policies dropped

* Subscriber Dashboard (Business Admin Portal)

  * Voicemail service in list view no longer relevant to MS (hosted voicemail setting dropped)
  * Updates to settings shown on cards for MS Teams and MS O365 on the details page

* Number Inventory

  * New type field to tag MS numbers – Direct Routing, Operator Connect, Calling plan
  * Type used in various workflow to determine configuration for user when numbers assigned

* Number Audit/Sync

  * Operator Connect and Calling Plan number inventory in MS Tenant
  * Sync in inventory and update VOSS inventory – add numbers, update, remove, etc – number and type

* Subscriber Data Extract (SDE)

  * New fields, 1 dropped field to reflect new/changed settings

* Syncs

  * Updated workflows and filtering capabilities






Global Settings
--------------------

The following settings have been added to the **Number Inventory Tab**:

* **Include the Number Inventory description in all number dropdowns**
* **Include the Number Inventory vendor in all number dropdowns**


Access Profiles
-----------------

Review the default ProviderAdminAP for permission examples for the following model types:

* ``relation/MicrosoftTenant`` - new action: ``SyncNewUsers``.

Menu Layout
---------------

Review the following items:

* **MS Subscriber Management** menu: **Quick Add Subscriber** renamed to **Quick Subscriber**.

Field Display Policy (FDP)
----------------------------

A number of FDPs have been added or modified. Please review the FDPs
for changes which may need to be incorporated into the customized versions
if the versions have been cloned down and modified.

The FDPs may need to be applied to Menu item as per the Menu Layout section.

* ``default`` for ``relation/MicrosoftSubscriber``
* ``MultiVendor_MS_Only_FDP`` for ``relation/MultiVendorSubscriber``
* ``MultiVendorFDP`` for ``relation/MultiVendorSubscriber``
* ``default`` for ``device/msteamsonline/CsOnlineUser``

Configuration Template (CFT)
-----------------------------

Added and updated several CFTs:

* ``MicrosoftSubscriber_Update`` for ``device/msteamsonline/CsOnlineUser``
* ``IniSetUsedSubscriber`` for ``data/InternalNumberInventory``

Microsoft Teams Online User Template
.....................................

Ensure that the Microsoft Teams Online User Template in use when running Quick Add Subscriber includes:

``"LineURItel": "{{ macro.MS_LineURItel }}",``
``"LineURIType": "{{ macro.MS_LineURIType }}",``

The default template name is **Reference Microsoft Teams Online User Template** and
is applied to ``device/msteamsonline/CsOnlineUser``.