Contact search from an external source

What it is for

When assigning the buttons of a phone, you can take a destination number from a directory instead of typing it. With this action you link an external source (for example an LDAP directory) to the CUCM connection for this purpose and define what is searched and which fields supply the numbers.

EasyUC stores the mapping on the connection. If it exists, the dialog for the button assignment of a phone shows a search field for contacts. The search queries the source directly and checks whether the search text is contained in one of the search attributes. The setting changes nothing in the CUCM or in the source. If you switch off Enable and save, EasyUC deletes the mapping.

Prerequisites

• License with provisioning (provisioning). Without it, the entry is missing from the Actions menu.
• Sign-in as an administrator. In the menu definition, the Administration menu is assigned only to the role ROLE_APP_ADMIN.
• The CUCM connection is enabled. For a disabled connection, Actions shows only Enable Connection.
• A source has been created under Administration → Integrations & Communication → External Sources and can be reached. Alternatively, you create it directly from the Source field.
• You know the attribute names of the source for name, phone number and mobile number.

Step by step

1. In the header, select the EasyUC Cisco workspace.
2. In the menu, open Administration → CUCM & Provisioning → CUCM Connections. The page is titled Manage CUCM Connections.
3. In the row of the connection you want, click Actions. The Menu popover opens.
4. Click Contacts. The Contact search dialog opens.
5. Switch on Enable. The Source field appears.
6. In Source, select the external source. The attribute fields then appear.
7. In Search By, select the attributes that are searched, for example sn, givenName and displayName. You can type in attributes that are missing.
8. In How the label will be formed, select the attributes from which the display of a hit is built.
9. In Phone Number, select the attribute with the landline number, for example telephoneNumber.
10. In Mobile Number, select the attribute with the mobile number, for example mobile.
11. Click Save (top right or at the bottom of the dialog). After a successful save, the dialog closes and the message Success appears. Cancel discards your entries.
12. Open a phone, switch to the button assignment and search for a known contact.

Fields and options

Checking the result and narrowing down errors

• Success: in the list of external sources, the source carries the contact search badge, and the contact search appears in the button assignment of a phone.
• Field error “This value should not be blank.”: with the contact search switched on, all five fields are required.
• The search returns nothing: check whether the search text occurs in one of the Search By attributes and whether the source can be reached under External Sources.
• Hits without a number: the attribute selected under Phone Number or Mobile Number is empty for the contact or mapped incorrectly.
• The search field is still missing: reload the page. The interface reads the mapping together with the connection data.