Erweiterte Kollegensuche

Das Problem

In größeren Organisationen mit vielen Mitarbeitern kann es sehr nützlich sein, wenn man direkte Ansprechpartner für bestimmte Themen über eine Suchfunktion finden kann. COYO hat in seiner Standard-Konfiguration der Kollegensuche bereits eine Reihe von Attributen wie Jobtitel oder Telefonnummer in den Nutzerprofilen hinterlegt, die über Such- und Filtermöglichkeiten erreicht werden können. Manche Felder, beispielsweise für die konkrete Expertise eines Nutzers, sind jedoch erstmal nicht vorgesehen – und im Admin-Bereich von COYO gibt es keine Parameter, um die Möglichkeiten der Kollegensuche zu beeinflussen.

Die Lösung

Über das REST API von COYO können die Suchmöglichkeiten der Kollegensuche auf unsere Bedürfnisse angepasst werden. Wir können beliebige Attribute ergänzen und über die Konfiguration der Attribute neue Suchfacetten für die Kollegensuche definieren. Dazu brauchen wir ein Tool, mit dem wir das REST API von COYO ansprechen können. Sehr komfortabel geht das mit dem beliebten API Client Postman. Freunde der alten Schule können aber auch das Kommandzeilen-Tool curl verwenden.

Für alle REST API Zugriffe muss zunächst ein Bearer-Token abgerufen werden, der zur Authentifizierung für alle weiteren Zugriffe dient. Dafür muss eine COYO API-Client-ID im Administrationsbereich von COYO angelegt werden. Der Name ist frei wählbar, die ID wird von COYO generiert. Weiterhin ist ein regulärer COYO Nutzeraccount mit Admin-Berechtigung nötig.

COYO organisiert die Profilfelder jeweils in Gruppen. Um ein neues Attribut in der Profilkonfiguration zu ergänzen muss zunächst die Profilfeldgruppe identifiziert werden.

Über einen GET-Zugriff auf https://<coyo-domain>/api/users/profile/groups (Bearer-Token nicht vergessen 😉) kann die bestehende Konfiguration abgerufen werden. Jede Profilgruppe hat ein Attribut „id“:… Diesen Wert brauchen wir später, um eine bestehende Profilfeldgruppe anzupassen.

Möchte man jetzt in der Feldgruppe „work“ ein neues Feld ergänzen, so kopieren wir den JSON Code der betreffenden Gruppe und erweitern sie um unser neues Feld: