Naming rules for lines

Purpose

Every line in the CUCM carries several names: the display name that the called party sees, the alerting name during ringing, the line text label on the line key and a description for administration. EasyUC fills these fields from the templates in this dialog when it creates a line.

A template consists of fixed text and placeholders in double curly braces. EasyUC replaces them with the data of the user and the device. For the ASCII variants, EasyUC converts umlauts and special characters into ASCII characters. The CUCM uses these variants for phones and remote parties that cannot display special characters.

Saving does not change existing lines. The rules take effect when EasyUC creates a line. If CUCM Changes is switched on, EasyUC also sets the names again as soon as the data of a user changes in the CUCM.

Prerequisites

License with the cucm module and the provisioning feature. Without provisioning, the entry is missing from the Actions menu.
EasyUC account with the ROLE_APP_ADMIN role. Only administrators see the Administration menu.
The CUCM connection has been created and enabled. For a disabled connection, Actions shows only Enable Connection.
The user data in the CUCM (first name, last name, department) is maintained. Empty fields result in empty parts of the name.

Step by step

In the header, select the EasyUC Cisco workspace.
In the menu, open Administration → CUCM & Provisioning → CUCM Connections. The Manage CUCM Connections page lists all connections.
In the row of the connection you want, click Actions. The Menu popover opens.
Click Line Naming. The Line naming dialog opens.
Read the list of placeholders in the information box at the top.
Under Display Name and ASCII Display Name, enter the template for the name that the remote party sees.
Under Alerting Name and ASCII Alerting Name, enter the template for the name during ringing.
Under Line Text Label, enter the label of the line key.
Under Description, enter the template for the line description.
If certain words in the result are to be replaced, click Add in the Replace Naming Values area and fill in Text To Replace and Text To Replace With.
Click Save (top right or at the bottom of the dialog). The dialog closes and EasyUC shows a success message (“Success”). Cancel closes the dialog without changes.
Create a phone for a test user and check the line in the CUCM.

Fields and options

Fields and options
Field / action	Meaning and use
Display Name	Display name of the line. Default: `{{firstName}} {{lastName}}`. Shortened to 30 characters. Required.
ASCII Display Name	ASCII display name. Default: `{{firstName}} {{lastName}}`. Umlauts and special characters are transliterated. Shortened to 30 characters. Required.
Alerting Name	Name during ringing. Default: `{{firstName}} {{lastName}}, {{department}}`. Shortened to 50 characters. Required.
ASCII Alerting Name	ASCII alerting name. Default: `{{firstName}} {{lastName}}, {{department}}`. Umlauts and special characters are transliterated. Shortened to 30 characters. Required.
Line Text Label	Label of the line key on the phone. Default: `{{firstName}} {{lastName}}`. Shortened to 30 characters. Required.
Description	Description of the line in the CUCM. Default: `{{firstName}} {{lastName}}, {{department}} - {{deviceType}}`. Shortened to 50 characters. Required.
Replace Naming Values	List of replacements. Add creates a row, remove deletes it. The list applies to device names and line names alike. Both dialogs (Device Naming and Line Naming) edit the same list.
Text To Replace	Text that is searched for in the finished name. EasyUC replaces whole words only and ignores case. Required in every row.
Text To Replace With	Text that is inserted instead. Required in every row.

Placeholders

Placeholders
Field / action	Meaning and use
`{{firstName}}`	First name of the user.
`{{1FirstLetterFirstName}}`, `{{2FirstLetterFirstName}}`, `{{3FirstLetterFirstName}}`	The first one, two or three letters of the first name.
`{{lastName}}`	Last name of the user.
`{{userID}}`	User ID in the CUCM.
`{{department}}`	Department of the user.
`{{title}}`	Title of the user.
`{{displayName}}`	Display name of the user.
`{{deviceType}}`	Phone type, for example “Cisco 8811”.
`{{deviceTypeShort}}`	Short form of the phone type. “Cisco ” is cut off (`8811`), softphones become `TCT`, `BOT`, `CSF` or `TAB`.
`{{deviceName}}`	Device name in the CUCM, for example `SEP…` or `BOT…`.
`{{phoneNumber}}`	Phone number. Only digits and the plus sign are used.
`{{location}}`	Location of the user.
Dynamic Custom User Fields	If the CUCM has its own user attributes (Custom User Fields), the dialog lists them as well. The placeholder is the attribute name in double curly braces.

Check the result and narrow down errors

Success: A newly created line shows the expected values in the CUCM. For Eva Beispiel from the Sales department, {{firstName}} {{lastName}}, {{department}} becomes “Eva Beispiel, Sales”.
Message “This value should not be blank.”: All six templates are required. Every replacement row also needs both values.
A name is cut off: EasyUC shortens to the length stated above. Shorten the template, for example with {{1FirstLetterFirstName}}. instead of {{firstName}}.
The ASCII name contains “ae” instead of “ä”: This is the transliteration for the ASCII fields.
Existing lines remain unchanged: Saving does not rename anything. Check the rules on a newly created line.