[Index]

Model: data/ReassignServicesProfile

Reassign User Services

To access the latest documentation, go to Documentation and Resources at: https://voss.portalshape.com

Reassign Services simplifies and automates the transfer of existing Subscriber services from a Source User to a Target User.

This utility is for example useful when an employee left the company and a new employee now starts the same role. Therefore, instead removing the old subscriber and configuring a new subscriber with the same settings and standards, the services and settings can be moved from the old subscriber to the new subscriber.

These services can include:

Note

Webex (Meetings and Teams) and CCX services are not currently supported by this feature.

Custom settings can be applied to these services during the reassignment. A Reassign Services Profile setting is available to choose the configuration templates that will be used to update services during reassignment. These allow you to customize most settings on any of the above devices, including Line Alerting Name, Line Label, DisplayASCII values, and so on.

Example templates are provided that contain macro variables for fields that are likely to differ between subscribers. The field values then resolve with input from existing target user details. In this way the templates are not limited by for example a Site and Phone Model.

When reassigning services from existing source users to existing target users, the latter are moved to the same site as the source user, if these differ.

An option is also available to create a new target user as part of the Reassign Services process, instead of selecting an existing user without services. This user will be created at the same site as the source user.

Other features included are:

Related Topics

Reassign Services Profile

The Reassign Services Profile input form allows for a set of configuration settings and additional settings to apply when the Reassign Services functionality is used. The configuration templates (CFTs) that are selected in the profile determine how many of the detailed settings of the various services are updated as part of the reassign. This is essentially to allow you to re-align settings to your baseline service deployment logic and update any settings that incorporate the user's name - for example descriptions, alerting/display names, labels, and so on.

If no CFT is defined for a service, it is still moved to the new user. However, existing settings will be left in place. There are a few cases where the feature will make updates to specific service settings regardless of the CFT (i.e. when these settings are required to associate the user and service - owner of a phone, associated devices on the UCM user, etc). If the source user does not have a given service (e.g voicemail) then any CFT in the profile is ignored as the feature does not add new services that did not exist on the source user.

There is a set of example CFTs in the system by default - prefixed RS - that provides some examples of common settings and logic that might be used.

This profile and templates for configuration settings can be maintained per hierarchy as needed. The context for the reassign services feature is fairly similar to Quick Add Subscriber and this is to allow the reuse of macros/logic from your quick add group CFTs in the reassign services profiles. In many cases you could even use the same CFT to ease maintaining multiple sets of CFTs that define the baseline user and service configuration.

Note

At least one Reassign Services Profile must be created in order to use the feature.

Field Description
Profile Name Name for the Profile - recommended to make it meaningful to the user's that will be using the feature if you need more than one profile.
Profile Description Description for the profile
Remove Source User If selected the feature will fully remove the source user after moving all the services. If not selected then the base user and subscriber will be left when the feature completes however no services will be enabled.
User CFT This CFT defines VOSS User settings to apply to the target user - e.g. role
CUCM User CFT This CFT defines the UCM User settings to apply for the target user - e.g Department, Service Profile, etc.
Line CFT This CFT defines the UCM Line settings to apply for the target user - e.g. Description, Alerting Name, Pickup Group, Call Forwarding, etc
Phone CFT This CFT defines the Phone settings to apply to the devices being moved - e.g. Line Label, display name, device pool, CSS, etc. This same CFT applies to all phones (hardphones, soft-clients, etc) so typically relate to line appearance settings or other non-phone type specific settings. ownerID, mobility user (for soft clients) as set via the workflow irrespective of the CFT.
Device Profile CFT This CFT defines the Device Profile (extension mobility) service for the user - e.g Line label, display name, etc. As with the Phone this is typically for line appearance settings on the device profile.
Remote Destination Profile CFT This CFT defines the Remote Destination Profile (Single Number Reach - SNR) settings to apply to the service being moved - e.g line label, display name, CSSs, etc. Again typically for updating line appearance settings but can also edit other base RDP settings.
CUC User CFT This CFT defines the CUC User (Voicemail) settings to apply when setting up voicemail for the user.
Add CUC User Alternate Extension This setting determines if the feature will add a voicemail alternate extension for the user if voicemail exists on the source user. This can be used to add a standard alternate extension (e.g short extension version of the user's number) if needed as part of your standard deployment.
Field Description
CUC Alternate Extension CFT This setting is visible if the add alternate extension setting above is true. This CFT determines the settings for the alternate extension that will be added. This is where you would define the alternate extension to be added as standard.
Update CUC User Message Handler (Action) This setting determines if the feature will configure the message handler settings for voicemail (form of single inbox).
CUC Message Handler (Action) CFT This setting is visible if the message handler setting above is true. This CFT determines the settings that will be configured for the message handler. So this will need to include the email address for example of the user as well as the message actions.
Update shared lines (for unassociated Phones, Device profiles, RDP)

This setting determines if the feature will update line appearances of the source user's lines on other user's devices. This can be used to update the display names or labels for instance on those remote devices to reflect the new user's details.

These CFTs only apply to line appearance settings on those devices (not general phone settings) and only for the line appearances that are shared with the source user. Other line appearances on the devices will not be updated. For example, the other user's phone had 3 lines, only 1 of which was shared with the source user. Only that 1 line appearance will be updated and the other 2 will be left untouched.

Shared Line (unassociated Phone) CFT This setting is visible if the Update Shared Line setting is true. This CFT determines the settings on the other users' Phones that have the line appearance.
Shared Line (unassociated Profile) CFT This setting is visible if the Update Shared Line setting is true. This CFT determines the settings on the other users' Device Profiles that have the line appearance.
Shared Line (unassociated RDP) CFT This setting is visible if the Update Shared Line setting is true. This CFT determines the settings on the other users' RDP that have the line appearance.

Typically, Configuration Templates similar to your current Quick Add Subscriber templates can be used. Example Configuration Templates are also available for each drop-down, with naming convention RS Example <service> CFT. The templates shown on the Configuration Templates menu can be cloned, renamed and modified per hierarchy as required.

Configuration examples:

Additional optional settings available:

doc

Model Details: data/ReassignServicesProfile

Title Description Details
Profile Name *
  • Field Name: profileName
  • Type: String
Profile Description
  • Field Name: profileDescription
  • Type: String
Remove Source User Remove Source User
  • Field Name: removeSourceUser
  • Type: Boolean
User CFT The Configuration Template to apply during User move/update or add.
  • Field Name: UserCFT
  • Type: String
CUCM User CFT The Configuration Template to apply during CUCM User move.
  • Field Name: CUCMUserCFT
  • Type: String
Line CFT The Configuration Template to apply during Line move.
  • Field Name: lineCFT
  • Type: String
Phone CFT The Configuration Template to apply during Phone move.
  • Field Name: PhoneCFT
  • Type: String
Device Profile CFT The Configuration Template to apply during Device Profile move.
  • Field Name: DPCFT
  • Type: String
Remote Destination Profile CFT The Configuration Template to apply during Remote Destination Profile move.
  • Field Name: RDPCFT
  • Type: String
CUC User CFT The Configuration Template to apply during CUC User Add.
  • Field Name: CUCCFT
  • Type: String
Add CUC User Alternate Extension Add CUC User Alternate Extension
  • Field Name: CUCAltExtAdd
  • Type: Boolean
CUC Alternate Extension CFT The Configuration Template to apply during CUC Alternate Extension update.
  • Field Name: CUCAltExtCFT
  • Type: String
Update CUC User Message Handler (Action) Update CUC User Message Handler Device
  • Field Name: CUCMsgHandlerUpdate
  • Type: Boolean
CUC Message Handler (Action) CFT The Configuration Template to apply during CUC Message Handler update.
  • Field Name: CUCMsgHandlerCFT
  • Type: String
Update shared lines (for unassociated Phones, Device profiles, RDP) Update shared lines for unassociated phones, device profiles and RDP
  • Field Name: SharedLineUnassocUpdate
  • Type: Boolean
Shared Line (unassociated Phone) CFT The Configuration Template to apply during Phone shared lines (unassociated) update.
  • Field Name: SharedPhoneLineUnassocCFT
  • Type: String
Shared Line (unassociated Profile) CFT The Configuration Template to apply during Profile shared lines (unassociated) update.
  • Field Name: SharedDPLineUnassocCFT
  • Type: String
Shared Line (unassociated RDP) CFT The Configuration Template to apply during SNR shared lines (unassociated) update.
  • Field Name: SharedRDPLineUnassocCFT
  • Type: String