概要
このドキュメントでは、マクロを使用してシステムから様々な形式でデータを返す方法について説明します。条件をテストし、GUIまたは一括ローダ入力のデータを(設定テンプレートと組み合わせて)システムのさまざまな要素にマッピングするだけでなく、ワークフローおよびウィザードの手順でデータにアクセスするために使用されます。
前提条件
要件
このドキュメントに特有の要件はありません。
使用するコンポーネント
このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。
- Cisco Unified Communications Domain Manager(Unified CDM)10.6.X
- Cisco Unified Communications Manager(CUCM)10.5.2以降
このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期(デフォルト)設定の状態から起動しています。対象のネットワークが実稼働中である場合には、どのようなコマンドについても、その潜在的な影響について確実に理解しておく必要があります。
マクロをサポートしているモデルはどれですか。
一般に、すべてのCisco Unified CDMモデルはワークフロー内でマクロを使用します。Cisco Hosted Collaboration Solution(HCS)管理者またはプロバイダー管理者アカウントですでに利用可能な構成テンプレート(CFT)、機能表示ポリシー(FDP)などは、生産システムで変更できます。これには、これらのFDP/CFTのマクロの使用が含まれます。CFTは、お客様の要件を満たすためにsysからsys.hcs.Providerにクローニングして、変更できます。下位階層でクローンを作成せずに行った変更は、アップグレード中に失われます。
すべてのモデルがAPI/バルク・ロード・シートを通じてマクロの入力を受け入れるわけではありません。ただし、CFTはマクロを評価し、その値を使用すると、fn.evaluateと指定します。また、顧客は、顧客の要件を満たすために、評価の有無にかかわらずマクロを実行することができる
設定例:CFTフィールド(フィールドマクロ評価なし)
- hcsadminユーザとしてログインします
- プロバイダー階層にパン粉
- 図に示すように、「役割マネージャ」>「構成テンプレート」に移動し、カスタマイズが必要なCFTテンプレートを検索します
- 図に示すように、CFTを選択し、複製してプロバイダ・レベルで表示します
- 新しいCFTを開く
- 図に示すように、マクロを評価せずに追加します。この例では、Ldapディレクトリ名のマクロが適用されます
このシナリオでは、マクロの内容に基づいてフィールドを評価するだけです。たとえば、Cisco Unified Communications Manager(CUCM)ユーザテンプレートのLDAPディレクトリ名はCFTです。{{ macro.HcsDpCustomerName }}-LDAPでは、CustomerNameフィールドを適切なBaseCustomerDATタプル(HcsDpCustomerName)から取得し、そのフィールドの入力コンテキスト(API/一括ロードから)で渡される内容にに関係なく、-LDAPをします。
設定例:CFTフィールドとフィールドマクロ評価
マクロ評価はAPI/バルク・ロード・シートを通じて入力され、CFTの中で特定のフィールドによってサポートされます。また、この評価は、CFT属性に入力コンテキストに埋め込まれたfn.evaluateが含まれている場合のみ、さらにサポートされます。
たとえば、コンパイルされたxlsリストのHcsCucPartitionCFTのDescriptionフィールドは、fn.evaluateコマンドが入力テストで渡される場合の評価をサポートします。
この場合、API呼び出し側は、次のような埋め込みマクロをこのフィールドに入力します。{{ input.PartitionItem.description }};結果として、PartitionItem.description == "ThisExamplePartitionName"と仮定して、ThisExamplePartitionItemの値がDescriptionになります。
埋め込まれたfn.evaluate(埋め込まれたマクロをサポートする上で重要な要素)がなければ、値フィールドは最初に見たように解決されます – {{ input.PartitionItem.description }}の説明。
前の例では、[名前]フィールドの評価を有効にする場合、{{ fn.evaluate input.PartitionName.Data }}のマクロを変更する必要があります。
この図は、CFTのリストと評価がすでに有効なマクロの属性を示しています。
マクロ機能を正しくチェックする方法
- sysadminとしてログインします
- マクロエバリュエーターを起動する
マクロ評価子は、マクロを正しい階層に実行しながらマクロを評価するために使用できます。たとえば、サイトレベルの電話マクロは、図に示すように、サイトでプロビジョニングされた電話を示します。