简介
本文档介绍如何使用宏以各种格式从系统返回数据。它们不仅测试条件并将GUI或批量加载程序输入的数据映射到系统中的各种元素(与配置模板一起),还用于访问工作流和向导步骤中的数据。
先决条件
要求
本文档没有任何特定的要求。
使用的组件
本文档中的信息基于以下软件和硬件版本:
- 思科统一通信域管理器(Unified CDM)10.6.X
- 思科统一通信管理器(CUCM)10.5.2或更高版本
本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始(默认)配置。如果您使用的是真实网络,请确保您已经了解所有命令的潜在影响。
哪种型号支持宏?
通常,所有Cisco Unified CDM模型都在其工作流程中使用宏。思科托管协作解决方案(HCS)管理员或提供商管理员帐户中已提供的任何配置模板(CFT)、功能显示策略(FDP)等均可在生产系统中更改,这包括这些FDP/CFT中宏的使用。CFT可以从sys 克隆到sys.hcs.Provider并进行修改,以满足客户要求。在升级期间,如果没有在较低层次上创建克隆,则所做的任何更改都会丢失。
并非每个模型都通过API/批量加载表接受宏的输入,除非CFT的值被指定为fn.evaluate,因为CFT会评估宏并使用该值。此外,客户可以实施有或没有评估的宏,以满足客户需求
配置示例:CFT字段,不带字段宏评估
- 以hcsadmin用户身份登录
- 面包屑到您的提供商层次结构
- 如图所示,导航至“角色管理器”>“配置模板”,然后搜索需要自定义的CFT模板
- 如图所示,选择CFT并克隆它以在提供商级别显示
- 打开新的CFT
- 现在,如图所示,添加宏而不进行评估。在示例中,应用了LDAP目录名称中的宏
在此场景中,仅根据宏内容评估字段。例如,Cisco Unified Communications Manager(CUCM)用户模板CFT中的LDAP目录名称:{{ macro.HcsDpCustomerName }}-LDAP,它从相应的BaseCustomerDAT元组(HcsDpCustomerName)获取CustomerName字段,并在其上添加 — LDAP,而不管该字段的输入上下文中传递了什么(来自API/批量加载)。
配置示例:CFT字段,带字段宏评估
宏评估是通过API/批量加载表输入的,它受最多CFT中的某些字段支持。此外,仅当CFT属性包括输入上下文中的嵌入fn.evaluate时,才进一步支持该评估。
例如,编译的xls列表中的HcsCucPartitionCFT的Description字段支持评估,因为fn.evaluate命令在输入测试中通过。
在这种情况下,API调用程序使用嵌入宏填充此字段,例如:{{ input.PartitionItem.description }}的说明;为ThisExamplePartitionItem生成Description值,假设PartitionItem.description == "ThisExamplePartitionName"。
如果没有嵌入式fn.evaluate(支持嵌入宏的关键部分),则值字段将仅解析为原始可见 — {{ input.PartitionItem.description }}的说明。
在上一个示例中,如果要在“名称”字段中启用评估,则需要修改{{fn.evaluate input.PartitionName.Data }}中的宏。
此图显示已启用评估的宏的CFT列表和属性。
如何正确检查宏功能?
宏计算器可用于在将宏执行到正确层次时计算宏。例如,站点级别的电话宏显示站点中调配的电话,如图所示。