.. configure-phone-move-customizations:

Configure phone move customizations
-----------------------------------

:bdg-info-line:`hcs-admin`

If you have added customized models to VOSS Automate, you can configure the
customizations to move with phones between sites. The default customizations will be applied 
when a phone move is executed.

.. note::
 
   You can configure only one move-phone customization per hierarchy.


1. Log in to the Admin Portal as ``hcsadmin``.
2. Go to **Default Move Phone Customizations**.
3. Enter a name (required) and description for the customizations.
4. Add one or more customizations for each group of lines that moves with a phone from one site to another: 

   Displayed fields depend on the customization type selected. The table describes 
   customization options:

   .. tabularcolumns:: |p{4cm}|p{11cm}|
   
   +---------------------+----------------------------------------------------+
   | Field               | Description                                        |
   +=====================+====================================================+
   |                     | * Move/Execute Before Group - choose to move the   |
   | Customization       |   customization before the corresponding group.    |
   | Operation           | * Move/Execute After Group - choose to move the    |
   |                     |   customization after the corresponding group.     |
   |                     | * Update After Move - choose to apply the chosen   |
   |                     |   configuration templates to the chosen data       |
   |                     |   models after all the moves in that group finish. |
   +---------------------+----------------------------------------------------+
   |                     | Choose the customization type.                     |
   |                     |                                                    |
   |                     | You can move the following customization types:    |
   |                     |                                                    |
   |                     | * DataModel                                        |
   |                     | * DomainModel                                      |
   |                     | * Device                                           |
   |                     | * Relation                                         |
   | Customization Type  |                                                    |
   |                     | You can execute the following customization type:  |
   |                     |                                                    |
   |                     | * ProvisioningWorkflow                             |
   |                     |                                                    |
   |                     | Note:                                              |
   |                     |                                                    |
   |                     | For any group, if **Update After Move is** selected|
   |                     | as the Customization Operation, selecting Relation |
   |                     | or Provisioning Workflow as the Customization Type |
   |                     | is not allowed. A note appears prompting you to    |
   |                     | choose another model type.                         |
   +---------------------+----------------------------------------------------+
   | Customization Name  | Choose the instance of the Customization Type you  |
   |                     | selected.                                          |
   +---------------------+----------------------------------------------------+
   | Customization Field | Choose the field to link to existing context       |
   |                     | models.                                            |
   +---------------------+----------------------------------------------------+
   | Context Model       | Choose one of the following existing context       |
   |                     | models to link the new model to:                   |
   |                     |                                                    |
   |                     | * relation/LineRelation                            |
   |                     | * data/InternalNumberInventory                     |
   |                     | * device/cucm/Phone                                |
   |                     | * device/cucm/Line                                 |
   +---------------------+----------------------------------------------------+
   | Context Field       | Choose the field of the existing context model     |
   |                     | that is linked to the Customization Field.         |
   +---------------------+----------------------------------------------------+
   | Configuration       | Choose the Configuration Template to apply to the  |
   | Template            | chosen model.                                      |
   +---------------------+----------------------------------------------------+

5. Choose another customization for the same group, or select a customization for
   another group.
   
   .. note:: 
      
      If you select multiple customizations with the same Customization Operation for the same group, 
      those items are moved in the order you specify them here. 
      Use the up and down buttons to reorder your customizations.

6. When you have chosen all the customizations for the phone move, click **Save**.