Default Dial Plan Event Triggers
--------------------------------

In VOSS-4-UC 10.x/11.5(x), you can use one of the default, pre-defined dial plan
events to trigger a custom workflow as part of your dial plan schema group.

.. note::

   The associateLboGateway and unassociateLboGateway events are available only
   if you are using VOSS-4-UC 10.6(2) or later.   

The default events are located in VOSS-4-UC 10.x/11.5(x) under the Custom Workflow tab
at Dial Plan > Dial Plan Schema Group.

Default Dial Plan Event Triggers for Custom Workflows

+-----------------+---------------+------------------------------+
| Dial Plan Event | When          | Notes                        |
|                 | Triggered     |                              |
+=================+===============+==============================+
| preAddSite      | When a new    | For Type 1 to Type 4         |
|                 | site dial     | schemas, this triggers a     |
|                 | plan is       | Cisco Unified                |
|                 | deployed,     | Communications Manager       |
|                 | before the    | (CUCM) bootstrap workflow    |
|                 | Add Dial Plan | that:                        |
|                 | workflow is   |                              |
|                 | executed      | * Updates the CUCM           |
|                 |               |   clusterwide "Local Route   |
|                 |               |   Group for Redirected       |
|                 |               |   Calls" service parameter   |
|                 |               |   to the value "Local route  |
|                 |               |   group of calling party"    |
|                 |               |                              |
|                 |               | * Provisions the             |
|                 |               |   following clusterwide      |
|                 |               |   default local route        |
|                 |               |   group names to the         |
|                 |               |   CUC: SLRG-Emer, SLRG-FPHN, |
|                 |               |   SLRG-Intl, SLRG-Local,     |
|                 |               |   SLRG-Mobl, SLRG-Natl,      |
|                 |               |   SLRG-Oper, SLRG-PCSN,      |
|                 |               |   SLRG-PRSN, SLRG-Serv,      |
|                 |               |   SLRG-SRSN                  |
|                 |               |                              |
|                 |               | Items in the workflow are    |
|                 |               | executed at the hierarchy    |
|                 |               | node on which the target     |
+-----------------+---------------+------------------------------+
|                 |               | CUCM cluster is added to the |
|                 |               | VOSS-4-UC system.            |
|                 |               |                              |
|                 |               | Subsequent sites that are    |
|                 |               | added trigger this           |
|                 |               | workflow, but result in an   |
|                 |               | operation that does nothing  |
|                 |               | if these items have already  |
|                 |               | been applied to the target   |
|                 |               | CUCM cluster.                |
|                 |               |                              |
|                 |               | The target cluster for this  |
|                 |               | workflow is determined by    |
|                 |               | the CUCM instance that is    |
|                 |               | contained in the Network     |
+-----------------+---------------+------------------------------+
|                 |               | Device List Reference (NDLR) |
|                 |               | for the site on which this   |
|                 |               | event was triggered.         |
+-----------------+---------------+------------------------------+


+------------------------------------------+---------------+--------------------------------+
| Dial Plan Event                          | When          | Notes                          |
|                                          | Triggered     |                                |
+==========================================+===============+================================+
| addSite                                  | After the Add | For Type 1 to Type 4           |
|                                          | Site Dial     | schemas, this triggers a       |
|                                          | Plan workflow | workflow that adds a           |
|                                          | is executed   | default location, region,      |
|                                          | and the       | and device pool at the site    |
|                                          | context of    | hierarchy node on which        |
|                                          | the new site  | this event is triggered.       |
|                                          | dial plan is  |                                |
|                                          | passed        | The target cluster for this    |
|                                          |               | workflow is determined by      |
|                                          |               | the Cisco Unified              |
|                                          |               | Communications Manager (CUCM)  |
|                                          |               | instance that is contained     |
|                                          |               | in the NDLR for the site on    |
|                                          |               | which this event was           |
|                                          |               | triggered.                     |
+------------------------------------------+---------------+--------------------------------+
| removeSite                               | Before the    | For Type 1 to Type 4           |
|                                          | Delete Site   | schemas, this triggers a       |
|                                          | dial plan     | workflow that removes the      |
|                                          | workflow is   | default location, region,      |
|                                          | executed and  | and device pool at the site    |
|                                          | the context   | hierarchy node on which        |
|                                          | of the site   | this event is triggered.       |
|                                          | dial plan is  |                                |
|                                          | passed        | The target cluster for this    |
|                                          |               | workflow is determined by      |
|                                          |               | the CUCM instance that is      |
|                                          |               | contained in the NDLR for the  |
|                                          |               | site on which this event was   |
|                                          |               | triggered.                     |
+------------------------------------------+---------------+--------------------------------+


+------------------------------------------+---------------+--------------------------------+
| Dial Plan Event                          | When          | Notes                          |
|                                          | Triggered     |                                |
+==========================================+===============+================================+
| addVoiceMailPilotNumber                  | When a new    | For Type 1 to Type 4           |
|                                          | voice mail    | schemas, this triggers a       |
|                                          | pilot number  | Cisco Unified                  |
|                                          | is added for  | Communications Manager (CUCM)  |
|                                          | a customer    | bootstrap workflow that        |
|                                          |               |                                |
|                                          |               | * Creates the voice mail       |
|                                          |               |   pilot on the target          |
|                                          |               |   CUCM cluster                 |
|                                          |               |                                |
|                                          |               | * Creates a voice mail         |
|                                          |               |   profile on the target        |
|                                          |               |   CUCM cluster                 |
|                                          |               |                                |
|                                          |               | * Deploys a custom Cisco       |
|                                          |               |   Unity Connection schema      |
|                                          |               |   to provision the             |
|                                          |               |   following on Cisco           |
|                                          |               |   Unity Connection:            |
|                                          |               |                                |
|                                          |               |   * Direct routing rule and    |
|                                          |               |     forward routing rules      |
|                                          |               |     based on the new pilot     |
|                                          |               |     number                     |
|                                          |               |                                |
|                                          |               |   * The target Cisco Unity     |
|                                          |               |     Connection cluster for     |
|                                          |               |     this workflow is           |
|                                          |               |     determined by the Cisco    |
|                                          |               |     Unity Connection instance  |
|                                          |               |     contained in the NDLR for  |
|                                          |               |     the site on which this     |
|                                          |               |     event was triggered        |
|                                          |               |                                |
|                                          |               | The target cluster for this    |
|                                          |               | workflow is determined by      |
|                                          |               | the CUCM instance that is      |
|                                          |               | contanied in the NDLR for the  |
|                                          |               | site on which this event was   |
|                                          |               | triggered.                     |
+------------------------------------------+---------------+--------------------------------+
| removeVoiceMailPilotNumber               | When a voice  | The target cluster for this    |
|                                          | mail pilot    | workflow is determined by      |
|                                          | number is     | the CUCM and Cisco Unity       |
|                                          | a customer    | Connection instances that are  |
|                                          |               | contained in the NDLR for      |
|                                          |               | the site on which this         |
|                                          |               | event was triggered.           |
|                                          |               |                                |
|                                          |               | For Type 1 to Type 4           |
|                                          |               | schemas, this triggers a       |
|                                          |               | workflow that                  |
|                                          |               |                                |
|                                          |               | * Removes the voice mail       |
|                                          |               |   profile and pilot            |
|                                          |               |   number from CUCM             |
|                                          |               |                                |
|                                          |               | * Undeploys direct and         |
|                                          |               |   forward routing rules        |
|                                          |               |   on Cisco Unity               |
|                                          |               |   Connection                   |
+------------------------------------------+---------------+--------------------------------+


+-------------------------------------------+---------------+---------------------------------+
| Dial Plan Event                           | When          | Notes                           |
|                                           | Triggered     |                                 |
+===========================================+===============+=================================+
| associateVoiceMailServiceToCu stomer      | When voice    | The target Cisco Unified        |
|                                           | mail service  | Communications Manager (CUCM)   |
|                                           | is associated | and Cisco Unity Connection      |
|                                           | to a customer | clusters for this workflow      |
|                                           |               | are determined by the CUCM and  |
|                                           |               | Cisco Unity Connection          |
|                                           |               | instances that are contained    |
|                                           |               | in the NDLR for the site on     |
|                                           |               | which this event was triggered. |
+-------------------------------------------+---------------+---------------------------------+
|                                           |               |                                 |
|                                           |               | For Type 1 to Type 4            |
|                                           |               | schemas, this triggers a        |
|                                           |               | workflow that                   |
|                                           |               |                                 |
|                                           |               | * Deploys a SIP trunk to        |
|                                           |               |   CUCM if voice mail service    |
|                                           |               |   is partitioned or dedicated   |
|                                           |               | * Reset the SIP trunk           |
|                                           |               | * Deploys a route group         |
|                                           |               |   to CUCM if voice mail service |
|                                           |               |   is partitioned or             |
|                                           |               |   dedicated that contains       |
|                                           |               |   the SIP trunk created         |
|                                           |               |   in the previous step          |
|                                           |               | * Deploys a custom Cisco        |
|                                           |               |   Unity Connection schema       |
|                                           |               |   to provision the port         |
|                                           |               |   group, ports, route           |
|                                           |               |   partition, calling            |
|                                           |               |   search space (CSS), and       |
|                                           |               |   the user template for         |
|                                           |               |   voice mail service on         |
|                                           |               |   the Cisco Unity               |
|                                           |               |   Connection                    |
+-------------------------------------------+---------------+---------------------------------+
| disassociateVoiceMailServiceFr omCustomer | When voice    | The target CUCM and Cisco       |
|                                           | is            | Unity Connection clusters for   |
|                                           | disassociated | this workflow are determined    |
|                                           | from a        | by the CUCM and Cisco Unity     |
|                                           |               | Connection instances that       |
|                                           |               | are contained in the NDLR       |
|                                           |               | for the site on which this      |
|                                           |               | event was triggered.            |
|                                           |               |                                 |
|                                           |               | For Type 1 to Type 4            |
|                                           |               | schemas, this triggers a        |
|                                           |               | workflow that                   |
|                                           |               |                                 |
|                                           |               | * On CUCM, removes Voice Mail   |
|                                           |               |   service route group and       |
|                                           |               |   SIP trunk if dedicated        |
|                                           |               |   or partitioned voice          |
|                                           |               |   mail service                  |
|                                           |               | * On Cisco Unity Connection,    |
|                                           |               |   deletes customer-specific     |
|                                           |               |   route partition, css, user    |
|                                           |               |   template, ports, and port     |
|                                           |               |   group.                        |
+-------------------------------------------+---------------+---------------------------------+



+-----------------+---------------+---------------------------------+
| Dial Plan Event | When          | Notes                           |
|                 | Triggered     |                                 |
+=================+===============+=================================+
| addCustomer     | When a        | The target Cisco Unified        |
|                 | customer dial | Communications Manager and      |
|                 | plan is added | Cisco Unity Connection          |
|                 |               | clusters for this workflow      |
|                 |               | are determined by the Cisco     |
|                 |               | Unified Communications          |
|                 |               | Manager and Cisco Unity         |
|                 |               | Connection instances that       |
|                 |               | are contained in the NDLR       |
|                 |               | for the site on which this      |
|                 |               | event was triggered.            |
|                 |               |                                 |
|                 |               | Currently not used for Type     |
|                 |               |  to Type 4 schemas              |
+-----------------+---------------+---------------------------------+
| removeCustomer  | When a        | The target Cisco Unified        |
|                 | customer dial | Communications Manager (CUCM)   |
|                 | plan is       | and Cisco Unity Connection      |
|                 | removed       | clusters for this workflow      |
|                 |               | are determined by the CUCM and  |
|                 |               | Cisco Unity Connection          |
|                 |               | instances that are contained    |
|                 |               | in the NDLR for the site on     |
|                 |               | which this event was triggered. |
|                 |               |                                 |
|                 |               | Currently not used for Type     |
|                 |               | 1 to Type 4 schemas             |
+-----------------+---------------+---------------------------------+
| updateCustomer  | When a        | The target Cisco Unified        |
|                 | customer dial | Communications Manager (CUCM)   |
|                 | plan is       | and Cisco Unity Connection      |
|                 | updated       | clusters for this workflow      |
|                 |               | are determined by the CUCM and  |
|                 |               | Cisco Unity Connection          |
|                 |               | instrances that are contained   |
|                 |               | in the NDLR for the site on     |
|                 |               | which this event was triggered. |
|                 |               |                                 |
|                 |               | Currently not supported         |
|                 |               | because customer dial plan      |
|                 |               | updating is not supported       |
+-----------------+---------------+---------------------------------+
| updateSite      | When a site   | The target Cisco Unified        |
|                 | dial plan is  | Communications Manager (CUCM)   |
|                 | updated       | and Cisco Unity Connection      |
|                 |               | clusters for this workflow      |
|                 |               | are determined by the CUCM and  |
|                 |               | Cisco Unity Connection          |
|                 |               | instances that are contained    |
|                 |               | in the NDLR for the site on     |
|                 |               | which this event was triggered. |
|                 |               |                                 |
|                 |               | Add the updateSite event        |
|                 |               | with the                        |
|                 |               | HcsDpUpdateSiteAreaCodesPWF     |
|                 |               | workflow to update the site     |
|                 |               | dial plan.                      |
|                 |               |                                 |
|                 |               | Currently not supported         |
|                 |               | because site dial plan          |
|                 |               | updating is not supported       |
+-----------------+---------------+---------------------------------+


+-----------------------+---------------+---------------------------------+
| Dial Plan Event       | When          | Notes                           |
|                       | Triggered     |                                 |
+=======================+===============+=================================+
| addDnInventory        | When an       | The target Cisco Unified        |
|                       | administrator | Communications Manager (CUCM)   |
|                       | provisions    | cluster for this workflow       |
|                       | additional    | is determined by the CUCM       |
|                       | specific site | instance that are contained in  |
|                       |               | the NDLR for the site on        |
|                       |               | which this event was triggered. |
|                       |               |                                 |
|                       |               | If a Type 1 or Type 3 dial      |
|                       |               | plan is provisioned, this       |
|                       |               | executes a workflow that        |
|                       |               | creates directory numbers       |
|                       |               | (DNs) where the extension       |
|                       |               | is prefixed with the Site       |
|                       |               | Location Code of the site       |
|                       |               | on which the event was          |
|                       |               | triggered.                      |
|                       |               |                                 |
|                       |               | If a Type 2 dial plan is        |
|                       |               | provisioned, this executes      |
|                       |               | a workflow that creates DNs     |
|                       |               | where the extension is          |
|                       |               | prefixed with the Intersite     |
|                       |               | Prefix + Site Location Code     |
|                       |               | of the site on which the        |
|                       |               | event was triggered.            |
|                       |               |                                 |
|                       |               | If a Type 4 dial plan is        |
|                       |               | provisioned, this executes      |
|                       |               | one of the following            |
|                       |               | workflows:                      |
|                       |               |                                 |
|                       |               | * Creates DNs where the         |
|                       |               |   extension is prefixed         |
|                       |               |   with *\+* if the              |
|                       |               |   extension entered by          |
|                       |               |   the administrator is          |
|                       |               |   prefixed with *+* on          |
|                       |               |   the site on which the         |
|                       |               |   event is triggered, OR        |
|                       |               | * Creates DN with no            |
|                       |               |   prefix; the extension         |
|                       |               |   on the site on which          |
|                       |               |   the event was triggered       |
|                       |               |   is used to create the DNs.    |
+-----------------------+---------------+---------------------------------+
| associateLboGateway   | When a local  | See associateLboGateway         |
|                       | gateway is    | Custom Workflow for             |
|                       | associated    | detailed information.           |
|                       | with a site.  |                                 |
+-----------------------+---------------+---------------------------------+
| unassociateLboGateway | When a local  | See unassociateLboGateway       |
|                       | gateway is    | Custom Workflow for             |
|                       | disassociated | detailed information.           |
|                       | from a site.  |                                 |
+-----------------------+---------------+---------------------------------+