Introduction
Ce document décrit comment les macros sont utilisées pour renvoyer les données d'un système dans différents formats. Ils testent non seulement les conditions et mappent les données de l'interface utilisateur graphique ou de l'entrée du chargeur en masse à divers éléments du système (en conjonction avec les modèles de configuration), mais ils sont également utilisés pour accéder aux données dans les étapes du workflow et de l'assistant.
Conditions préalables
Conditions requises
Aucune spécification déterminée n'est requise pour ce document.
Components Used
Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :
- Cisco Unified Communications Domain Manager (Unified CDM) 10.6.X
- Cisco Unified Communications Managers (CUCM) 10.5.2 ou version ultérieure
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.
Quel modèle prend en charge les macros ?
En général, tous les modèles Cisco Unified CDM utilisent des macros dans leurs workflows. Tout modèle de configuration (CFT), la politique d'affichage des fonctionnalités (FDP), etc. déjà disponible dans le compte d'administration de Cisco Hosted Collaboration Solution (HCS) ou le compte d'administration du fournisseur peuvent être modifiés dans le système de production, ce qui inclut l'utilisation de macros dans ces FDP/CFT. Les CFT peuvent être clonés de sys à sys.hcs.Provider et modifiés afin de répondre aux besoins du client.Toute modification effectuée sans création de clone dans la hiérarchie inférieure est perdue lors d'une mise à niveau.
Tous les modèles n'acceptent pas l'entrée des macros par le biais de feuilles de chargement en bloc/API, sauf si la valeur de CFT est spécifiée sous fn.evaluation, alors que CFT évalue la macro et utilise la valeur. En outre, un client peut mettre en oeuvre une macro avec ou sans évaluation afin de répondre aux exigences du client
Exemple de configuration : Champ CFT sans champ Macro Evaluation
- Se connecter en tant qu'utilisateur hcsadmin
- Pain croisé à la hiérarchie de votre fournisseur
- Comme l'illustre l'image, accédez à Gestionnaire de rôles > Modèle de configuration puis recherchez un modèle CFT qui doit être personnalisé
- Comme l'illustre l'image, sélectionnez le CFT et clonez-le pour l'afficher au niveau du fournisseur
- Ouvrir le nouveau CFT
- Maintenant, comme l'illustre l'image, ajoutez votre macro sans évaluation. Dans l'exemple, une macro dans le nom du répertoire Ldap est appliquée
Dans ce scénario, le champ est simplement évalué sur la base du contenu de la macro. Par exemple, le nom du répertoire Ldap dans le modèle d'utilisateur Cisco Unified Communications Manager (CUCM) CFT : {{ macro.HcsDpCustomerName }}-LDAP, il prend le champ CustomerName à partir du tuple BaseCustomerDAT approprié (HcsDpCustomerName) et tack -LDAP sur celui-ci indépendamment de ce qui est transmis dans le contexte d'entrée (à partir de l'API/chargement en masse) pour ce champ.
Exemple de configuration : Champ CFT avec le champ Macro Evaluation
L'évaluation des macros est saisie par le biais des feuilles de chargement en bloc/API, elle est prise en charge par certains champs dans le CFT le plus élevé. En outre, cette évaluation n'est prise en charge que si l'attribut CFT inclut fn.evaluation incorporé dans le contexte d'entrée.
Par exemple, le champ Description de HcsCucPartitionCFT de la liste xls compilée prend en charge l'évaluation lorsque la commande fn.evaluation est passée dans le test d'entrée.
Dans ce cas, un appelant d'API remplit ce champ avec une macro incorporée telle que : Description pour {{ input.PartitionItem.description }}; résultant en une valeur de Description pour ThisExamplePartitionItem supposant PartitionItem.description == « ThisExamplePartitionName ».
Sans l'élément fn.evaluation incorporé (l'élément crucial pour la prise en charge des macros incorporées), le champ valeur se résout simplement comme vu à l'origine — Description pour {{ input.PartitionItem.description }}.
Dans l'exemple précédent, si l'on veut activer l'évaluation dans le champ Nom, il sera nécessaire de modifier la macro dans {{ fn.evaluation input.PartitionName.Data }}.
Cette image montre la liste des CFT et les attributs avec la macro d'évaluation déjà activée.
Comment vérifier correctement la fonction Macro ?
- Connectez-vous en tant que sysadmin
- Lancer l'évaluateur de macro
L'évaluateur de macro peut être utilisé pour évaluer les macros lors de l'exécution de la macro dans la hiérarchie correcte. Par exemple, la macro du téléphone au niveau du site affiche les téléphones provisionnés dans le site, comme le montre l'image.