.. _webex-bulk-actions:

Webex bulk update tool
------------------------

.. _21.4-PB4|VOSS-1295|EKB-16709:
.. _21.4-PB5|EKB-18796:
.. _25.1|EKB-19152:


.. tip:: 

   :ref:`use-action-search-to-navigate-automate`


Overview 
.........

VOSS's Webex **Bulk Update Tool** supports bulk operations on schedules and phone devices. 

*Add* (to replicate across selected Webex locations) is valid only for schedules. *Add* cannot be used for 
devices since each device requires a user or workspace. *Modify* and *delete* is supported for both schedules and devices. 


Webex bulk update schedules
.................................

Using Webex **Bulk Update Tool** you can replicate operations from a source reference to selected 
target Webex locations for schedules.

This procedure performs operations (add, modify, or delete) on selected Webex locations. 


.. rubric:: Before you begin

* Create a reference schedule via ``relation/WebexSchedules``. Ensure the reference schedule has a unique 
  name and is easy to find. 
* Clone the reference configuration template, ``WebexBulkActionSchedules-Customizable``, 
  to the required hierarchy, and modify the macro for the schedule name to ensure that a unique 
  name is generated. For example: 

  ::

     {{pwf.referenceScheduleData.name}}-{{pwf.locationName}}

  Supported target hierarchies for the clone operation are: 
  
  * Customer
  * IntermediateNode 
  * Site 
  * LinkedSite

  This macro ensures a unique schedule name that is a combination of the
  source schedule name and the specific Webex location name.

.. note:: 

   When the selected model is *schedule*, a reference schedule serves as the source to carry out the operation 
   (add, modify, delete) on selected Webex locations.



.. rubric:: To perform bulk actions on selected Webex locations: 

1. In the Admin Portal, go to **Bulk Update Tool**.  
2. At **Model**, select **schedules**. 
3. At **Operation**, choose an option, either of the following (for add, modify, or delete):

   .. note:: 

      The operation you choose displays/hides additional fields on the page, and determines the 
      next steps to complete.

   * **Add schedules**: 
   
     * Select **add (Replicate across chosen Webex Locations)**. 
     * Select the reference schedule to apply to the selected Webex locations. 
     * Select the configuration template. 

       .. note:: 

          The configuration template allows an admin to make structural naming changes to schedules 
          created at Webex locations. 

     * At the **Target Webex Locations** transfer boxes, select Webex locations to which the *add* action should 
       apply. 
     * Save your changes. 

       Schedules will be added to all selected locations, with schedule names defined with the applied 
       configuration template.

   * **Modify schedules**:

     * Select operation, **modify specific schedules**. 
     * Select an updated reference schedule to apply to the selected Webex locations. 
     
       .. note:: 
         
          The reference schedule should have been updated to change the values in events or to add a new event. 

     * At the **Target Webex Locations** transfer boxes, select Webex locations to which the action 
       should apply.
     * Save your changes. 

       Selected Webex locations are modified in accordance with the modified reference configuration template.

   * **Delete schedules**: 

     * Select operation, **delete**. 
     * At the **Delete Schedules** transfer boxes, select Webex locations to which the action should apply.
     * Click **Save**. 

       Selected Webex locations are deleted. 




Webex bulk update on devices
...............................

This procedure uses the Webex bulk actions tool to bulk update or deletes the parameters of one or more, 
pre-existing MPP, ATA, and WiFi devices in the device inventory, allowing bulk configuration of Webex devices. 

.. note:: 

   Only modify and delete is supported. *Add* is not supported since each devices requires a user or workspace.  

.. rubric:: To perform bulk actions on Webex phone and WiFi devices:

1. In the Admin Portal, go to **Webex Bulk Actions**.  
2. At **Model**, select **devices**. 
3. Select the device type. Options are: 

   * All devices 
   * ATA 
   * MPP 
   * WiFi 

3. At **Operation**, choose an option: 

   * Delete: 

     * At **Operation**, select **delete**. 
     * At the **Target Webex Devices** transfer boxes, select from the available devices and move these to the 
       **Selected** field. 
     * Save your changes. 

       The device and its configuration is deleted (purged), and the Automate refreshes the workspace or 
       user that was associated to the device.  

   * Modify specific devices: 

     * At **Operation**, select **modify specific devices**. 
     * At **Configuration Template**, select the relevant configuration template, which will allow you to 
       make bulk configuration changes to the selected devices.
     * At the **Target Webex Devices** transfer boxes, select from the available devices and move these to the 
       **Selected** field. 
     * Save your changes. 

     Configuration changes are copied to the target devices.