Enduser Setup und Firmen

Wozu dient das

Die Endbenutzer-Einrichtung ist für Umgebungen gedacht, in denen ein externes Werkzeug, etwa ein Serviceportal, Telefonie bestellt. Das Werkzeug sendet über die Public API einen Auftrag mit Firma, Standort und Benutzer. EasyUC sucht dazu die passende Konfiguration und legt im CUCM an, was dort hinterlegt ist: Tischtelefon, Jabber-Clients, Geräteprofil, Single Number Reach, Sprachbox und Translation Pattern. Löschaufträge entfernen die Objekte wieder.

Dafür ordnen Sie zwei Dinge zu. Firmen (Manage Companies) sind die Mandanten, die das externe Werkzeug mit einem Code anspricht. Unter Config Clusters verbinden Sie einen CUCM-Cluster mit Firmen und bilden jeden Standortnamen des externen Werkzeugs auf einen EasyUC-Standort mit Paket und Nummernbereichen ab. Die Rufnummer nimmt EasyUC selbstständig aus den hinterlegten Bereichen.

Im Unterschied zur automatischen Bereitstellung wartet EasyUC hier auf einen Auftrag von außen und sucht nicht selbst nach neuen Benutzern.

Voraussetzungen

Rolle ROLE_APP_ADMIN. Nur mit dieser Rolle zeigt die Oberfläche das Menü Verwaltung.
Das Modul cucm ist freigeschaltet. Ohne dieses Modul sperrt die Oberfläche die Seite.
Ein API-Zugang für das externe Werkzeug unter Verwaltung → Integrationen & Kommunikation → API-Zugänge.
Die EasyUC-Standorte haben Pakete und Nummernbereiche. Die Standortauswahl zeigt nur Standorte mit Paket.
Die Pakete enthalten Vorlagen für alle Gerätearten, die bestellt werden können.
Firmenname und Firmencode sind mit dem Betreiber des externen Werkzeugs abgestimmt, ebenso die Standortnamen, die es sendet.

Schritt für Schritt: Firma anlegen

Wählen Sie in der Kopfzeile den Arbeitsbereich EasyUC Cisco.
Öffnen Sie Verwaltung → CUCM & Bereitstellung → Endbenutzer-Einrichtung → Manage Companies. Die Seite heißt Firmen.
Klicken Sie auf Firma hinzufügen. Der Dialog Firma anlegen öffnet sich.
Tragen Sie Company Name und Company Code ein.
Klicken Sie auf Erstellen.

Schritt für Schritt: Cluster und Standorte konfigurieren

Öffnen Sie Verwaltung → CUCM & Bereitstellung → Endbenutzer-Einrichtung → Config Clusters. Die Seite heißt Endbenutzer-Einrichtung.
Klicken Sie auf Cluster konfigurieren. Der Dialog Endbenutzer-Einrichtung anlegen öffnet sich.
Wählen Sie unter CUCM Cluster die CUCM-Verbindung.
Wählen Sie unter Select companies die Firmen, die dieser Cluster bedient.
Klicken Sie im Abschnitt Zuordnung und Konfiguration auf neuen Standort konfigurieren.
Tragen Sie unter Associated API Location den Standortnamen ein, den das externe Werkzeug sendet.
Wählen Sie unter EasyUC Location den EasyUC-Standort und danach das Paket.
Wählen Sie unter Number Ranges for auto assignment die Nummernbereiche für die automatische Vergabe.
Legen Sie bei mehreren Bereichen unter Konfiguration des Nummernbereichs fest, ob EasyUC die Bereiche der Reihe nach füllt (Reihenfolge der Nummernbereiche festlegen) oder abwechselnd nutzt (Round Robin), und vergeben Sie je Bereich den Index.
Klicken Sie auf Speichern und weiter. Der nächste Dialog zeigt die Konfiguration des Standorts.
Legen Sie fest, was eine Bestellung anlegt: Endbenutzer-Vorlage, IP-Telefon (Modell und Vorlage), Softphones, Geräteprofil, Single Number Reach, Translation Pattern, Anrufbeantworter, Besetzt-Steuerung und E-Mails nach Abschluss des Jobs senden.
Prüfen Sie unter Einstellungen die Option Dieselbe Telefonnummer verwenden, wenn bereits eine Leitung vorhanden ist.
Klicken Sie auf Speichern.
Die Konfiguration steht danach in der Liste. Den Zustand Konfiguration aktiviert oder Konfiguration deaktiviert schalten Sie über Konfigurationsaktion → Konfiguration aktivieren bzw. Konfiguration deaktivieren.

Schritt für Schritt: weitere Standorte, Firmen, E-Mails und Protokolle

Klicken Sie bei einer aktivierten Konfiguration auf Konfigurationsaktion → Neuen Standort konfigurieren, um einen weiteren API-Standort abzubilden. Der Dialog enthält zusätzlich Default Language.
Klicken Sie auf Konfigurationsaktion → Firmen aktualisieren, um die Firmenzuordnung zu ändern.
Klicken Sie auf Konfigurationsaktion → E-Mail-Benachrichtigungen. Setzen Sie Aktivieren, tragen Sie Empfänger ein und pflegen Sie E-mail Betreff und E-mail Inhalt getrennt für Anlegen und Löschen. Mit Vorschau des E-Mail-Inhalts prüfen Sie das Ergebnis.
Die Karte eines Standorts bietet Symbole für Konfigurationen, Jobs, Anfrage-Logs und Standortkonfiguration entfernen.
Klicken Sie oben auf Anfrage-Logs, um alle eingegangenen Aufträge mit Gesendet am, Statuscode, Anfrage und Antwort zu sehen.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Company Name / Company Code	Name und Kürzel der Firma. Über den Code ordnet EasyUC einen Auftrag der Firma zu. Beide Felder sind englisch beschriftet.
CUCM Cluster	CUCM-Verbindung, auf der die Aufträge dieser Firmen ausgeführt werden.
Associated API Location	Standortname, wie ihn das externe Werkzeug im Auftrag sendet.
EasyUC Location / Paket	EasyUC-Standort und Paket, deren Vorlagen und Vorgaben gelten.
Number Ranges for auto assignment	Nummernbereiche des Standorts, aus denen EasyUC die Rufnummer vergibt.
Reihenfolge der Nummernbereiche festlegen	Sind alle Nummern aus Bereich 1 belegt, verwendet EasyUC Bereich 2 und so weiter.
Round Robin	Die erste Nummer kommt aus Bereich 1, die nächste Anforderung erhält ihre Nummer aus Bereich 2 und so weiter.
Default Language	Sprache, die EasyUC setzt, wenn der Auftrag keine nennt.
Dieselbe Telefonnummer verwenden, wenn bereits eine Leitung vorhanden ist	Hat der Benutzer schon eine Leitung, verwendet EasyUC deren Rufnummer für neue Geräte. Der Nummernbereich wird dann ignoriert.
E-Mail-Benachrichtigung an den Endbenutzer senden, für den die Aufgabe ausgeführt wurde	Sendet die Benachrichtigung zusätzlich an den betroffenen Benutzer.
Platzhalter in E-Mails	Unter anderem `{{firstName}}`, `{{lastName}}`, `{{userID}}`, `{{location}}`, `{{phoneNumber}}`, `{{companyName}}`, `{{companyCode}}` sowie Ja/Nein-Werte wie `{{ipPhoneCreated}}`, `{{windowsCreated}}`, `{{vmCreated}}` und beim Löschen `{{ipPhoneDeleted}}`. Die vollständige Liste steht im Dialog.

Ergebnis prüfen und Fehler eingrenzen

Die Liste zeigt je Cluster den Zustand, die Firmen mit Code und je Standort eine Karte mit EasyUC-Standort, Paket und Nummernbereiche.
Ein Testauftrag erscheint unter Anfrage-Logs mit Statuscode und Antwort. Der zugehörige Job steht unter Jobs an der Standortkarte.
Im Anfrage-Log steht Endbenutzer nicht gefunden: Die Benutzer-ID aus dem Auftrag existiert auf diesem Cluster nicht.
Ein Auftrag wird keiner Konfiguration zugeordnet: Company Code oder Associated API Location stimmen nicht mit dem überein, was das externe Werkzeug sendet.
Die Menüpunkte im Aktionsmenü fehlen: Die Konfiguration ist deaktiviert. Dann stehen nur Aktivieren und Löschen zur Verfügung.
Zur Fehlersuche in Echtzeit dient das Live-Log, siehe Kapitel „Endbenutzer-Einrichtung: Live-Log und Sync ans externe Tool“.