.. _nextgen-dialplan-input-data: Dial Plan Input Data and Macros ------------------------------- .. _18.1-Patch-Bundle-3|EKB-673: Overview ........ The input forms from the **Dial Plan Input Data** simplifies the update of dial plan data by exposing a set of values that can be provided to and then easily applied by lower level administrators. No values are mandatory, and Field Display Policies can be used to hide unused fields if needed (for example, **Secondary SIP Trunk Destination IP** and **Secondary SIP Trunk Destination Port**. In addition, a set of custom values can be added and macros are available so that these can be referenced in dial plan elements. (A Field Display Policy can then be used to rename the input field label if needed.) Two types of dial plan input data can be defined, each corresponding to a dial plan type: * **Global Data**: applies to Global dial plan type (customer) * **Site level Data**: applies to Site dial plan type Input data may be used in combinations to build patterns dynamically, because the pattern itself is a macro. For example, site level translation patterns for 7 or 10 digit dialing can use the Customer Level macro for PSTN access (or External Breakout Number), then followed by a "." , then the macro for Area Code or Exchange: :: {{ macro.DP_Global_PSTNAccess }}.{{ macro.DP_AreaCode }}XXXXXXX when applied, could be inserted to Call Manager as ``9.214XXXXXXX`` for 10 digit dialing. :: {{ macro.DP_Global_PSTNAccess }}.{{ macro.DP_Exchange }}XXXX when applied, could be inserted to Call Manager as ``9.256XXX`` for 7 digit dialing. Global Dial Plan Data Single Instance ..................................... |Global-Dial-Plan-Data-Single-Instance| Data from the provided fields may be referenced with the provided macros: * Custom Customer ID: ``{{ macro.DP_Global_CustomCustID }}`` * External Breakout Number: ``{{ macro.DP_Global_PSTNAccess }}`` * Published Number: ``{{ macro.DP_Global_PNum }}`` * Emergency Call Back Number: ``{{ macro.DP_Global_ENum }}`` * Area Code: ``{{ macro.DP_AreaCode }}`` * Exchange: ``{{ macro.DP_Exchange }}`` Global Aggregation SIP Input Data Tab ..................................... |Global-Aggregation-SIP-Input-Data-Tab| Data from the provided fields may be referenced with the provided macros: * Primary SIP Trunk Destination IP: ``{{ macro.DP_Global_PrimarySIPAddr }}`` * Primary SIP Trunk Destination Port: ``{{ macro.DP_Global_PrimarySIPPort }}`` * Secondary SIP Trunk Destination IP: ``{{ macro.DP_Global_SecondarySIPAddr }}`` * Secondary SIP Trunk Destination Port: ``{{ macro.DP_Global_SecondarySIPPort }}`` Global Custom Dial Plan Data Tab ................................ |Global-Custom-Dial-Plan-Data-Tab| Data from the provided fields may be referenced with the provided macros: * Dial Plan Custom Value 1: ``{{ macro.DP_Global_CVal01 }}`` * Dial Plan Custom Value 2: ``{{ macro.DP_Global_CVal02 }}`` * Dial Plan Custom Value 3: ``{{ macro.DP_Global_CVal03 }}`` * Dial Plan Custom Value 4: ``{{ macro.DP_Global_CVal04 }}`` * Dial Plan Custom Value 5: ``{{ macro.DP_Global_CVal05 }}`` * Dial Plan Custom Value 6: ``{{ macro.DP_Global_CVal06 }}`` * Dial Plan Custom Value 7: ``{{ macro.DP_Global_CVal07 }}`` * Dial Plan Custom Value 8: ``{{ macro.DP_Global_CVal08 }}`` * Dial Plan Custom Value 9: ``{{ macro.DP_Global_CVal09 }}`` * Dial Plan Custom Value 10: ``{{ macro.DP_Global_CVal10 }}`` Site Dial Plan Data Single Instance ................................... |Site-Dial-Plan-Data-Single-Instance| Data from the provided fields may be referenced with the provided macros: * Custom Site ID: ``{{ macro.DP_Site_ID }}`` * External Breakout Number: ``{{ macro.DP_Site_PSTNAccess }}`` * Site Location Code: ``{{ macro.DP_Site_SLC }}`` * Published Number: ``{{ macro.DP_Site_PNum }}`` * Emergency Call Back Number: ``{{ macro.DP_Site_ENum }}`` * Area Code: ``{{ macro.DP_AreaCode }}`` * Exchange: ``{{ macro.DP_Exchange }}`` Site Aggregation SIP Input Data ............................... |Site-Aggregation-SIP-Input-Data| Data from the provided fields may be referenced with the provided macros: * Primary SIP Trunk Destination IP: ``{{ macro.DP_Site_PrimarySIPAddr }}`` * Primary SIP Trunk Destination Port: ``{{ macro.DP_Site_PrimarySIPPort }}`` * Secondary SIP Trunk Destination IP: ``{{ macro.DP_Site_SecondarySIPAddr }}`` * Secondary SIP Trunk Destination Port: ``{{ macro.DP_Site_SecondarySIPPort }}`` Site Custom Dial Plan Data Tab .............................. |Site-Custom-Dial-Plan-Data-Tab| Data from the provided fields may be referenced with the provided macros: * Dial Plan Custom Value 1: ``{{ macro.DP_Site_CVal01 }}`` * Dial Plan Custom Value 2: ``{{ macro.DP_Site_CVal02 }}`` * Dial Plan Custom Value 3: ``{{ macro.DP_Site_CVal03 }}`` * Dial Plan Custom Value 4: ``{{ macro.DP_Site_CVal04 }}`` * Dial Plan Custom Value 5: ``{{ macro.DP_Site_CVal05 }}`` * Dial Plan Custom Value 6: ``{{ macro.DP_Site_CVal06 }}`` * Dial Plan Custom Value 7: ``{{ macro.DP_Site_CVal07 }}`` * Dial Plan Custom Value 8: ``{{ macro.DP_Site_CVal08 }}`` * Dial Plan Custom Value 9: ``{{ macro.DP_Site_CVal09 }}`` * Dial Plan Custom Value 10: ``{{ macro.DP_Site_CVal10 }}`` Diagram Example ............... The diagram below provides an example of the use of a macro in a Global (customer) level dial plan element: **Route Patterns**. |nextgen-dial-plan-DialPlanInputData-flow| .. |nextgen-dial-plan-DialPlanInputData-flow| image:: /src/images/nextgen-dial-plan-DialPlanInputData-flow.png .. |Global-Dial-Plan-Data-Single-Instance| image:: /src/images/Global-Dial-Plan-Data-Single-Instance.png .. |Global-Aggregation-SIP-Input-Data-Tab| image:: /src/images/Global-Aggregation-SIP-Input-Data-Tab.png .. |Global-Custom-Dial-Plan-Data-Tab| image:: /src/images/Global-Custom-Dial-Plan-Data-Tab.png .. |Site-Dial-Plan-Data-Single-Instance| image:: /src/images/Site-Dial-Plan-Data-Single-Instance.png .. |Site-Aggregation-SIP-Input-Data| image:: /src/images/Site-Aggregation-SIP-Input-Data.png .. |Site-Custom-Dial-Plan-Data-Tab| image:: /src/images/Site-Custom-Dial-Plan-Data-Tab.png