Wo wird das Profilfeld angezeigt?

Wir haben ein Profilfeld hinzugefügt, das an bestimmten Stellen verwendet wird, um die eingestellten Pronomen eines Benutzers anzuzeigen.

Zunächst wird es auf der Profilseite, in der Kollegenübersicht und in der globalen Suche als Suffix zum Anzeigenamen hinzugefügt:

Wie wird das Profilfeld konfiguriert?

Habt ihr euer Haiilo Home nach Version 45.0.90 aufgesetzt, habt ihr das Feld bereits direkt unterhalb des Geburtstagsfeldes bei einem Nutzer.

Falls ihr euer Haiilo Home aber vor Version 45.0.90 aufgesetzt habt, müsst ihr das Profilfeld mit dem Namen "haiilo_pronouns" per REST-API zu einer Profilgruppe hinzufügen, damit ein Nutzer das Profilfeld nutzen kann.

Wie wird das Profilfeld per REST-API hinzugefügt?

Ihr könnt die REST-API Schnittstelle nutzen, um Pronomen als Profilfeld hinzuzufügen. Sobald das Feld vorhanden ist und einen Wert enthält, wird es dann für Nutzer angezeigt.

Hinweis:

Detaillierten Einblick in die technische Dokumentation zur REST-API bekommt ihr hier. Aufgrund des technischen Inhalts sind viele Begriffe und Befehle in diese Artikel weiterhin auf Englisch.

Identifiziert zunächst die ID der Profilfeld Gruppe, in die ihr das Pronomen Profilfeld hinzufügen möchtet, denn Ihr könnt Profilfelder nur hinzufügen, wenn ihr die gesamte Profilgruppe aktualisiert.

Ihr könnt diese Anfrage verwenden, um alle Gruppen abzurufen:

GET {{URL}}/api/users/profile/groups

Und diese Anfrage, um eine einzelne Gruppe anhand ihrer ID abzurufen:

GET {{URL}}/api/users/profile/groups/{ID_OF_YOUR_GROUP}}

Speichert die Antwort auf diese Anfrage, da diese den Namen, die Sortierreihenfolge und die Felder aller Profilfelder der Gruppe für den nächsten Schritt enthält.

Hinweis:

Da eine PUT Anfrage der bestehenden Gruppe nicht nur etwas hinzufügt, sondern sie komplett überschreibt, sendet nicht nur das neue Feld "pronouns", sondern alle Felder, die bereits vorhanden sind.

Verwendet jetzt die gesamte Antwort als Request Body für die kommende PUT-Anfrage und fügt dieses Feld dem fields-array für die haiilo_pronouns hinzu. Großbuchstaben für type sind hier wichtig.

{
"name": "haiilo_pronouns",
"type": "TEXT",
"order": 0
},

Hinweis:

Ihr könnt zusätzlich die Reihenfolge dieses und der anderen Felder anpassen, um die Position auf der Profilseite zu beeinflussen.

Hier ein Beispiel für die vollständige Anfrage (bitte kopiert diese nicht einfach aus dem Artikel):

PUT {{URL}}/api/users/profile/groups/{{YOUR_GROUP_ID}}

{
 "name":"basicInformation",
 "sortOrder":1,
 "fields":[
  {
    "name":"birthday",
    "type":"BIRTHDAY",
    "order":0,
    "overview":false,
    "important":false,
    "userChooser":false,
    "searchAggregation":false
  },
  {
    "name":"haiilo_pronouns",
    "type":"TEXT",
    "order":0
  },
  {
    "name":"languages",
    "type":"TEXT",
    "order":1,
    "overview":false,
    "important":false,
    "userChooser":false,
    "searchAggregation":false
  },
  {
    "name":"homeTown",
    "type":"TEXT",
    "order":2,
    "overview":false,
    "important":false,
    "userChooser":false,
    "searchAggregation":false
  },
  {
    "name":"interests",
    "type":"TEXT",
    "order":3,
    "overview":false,
    "important":false,
    "userChooser":false,
    "searchAggregation":false
  },
  {
    "name":"projects",
    "type":"TEXT",
    "order":3,
    "overview":false,
    "important":false,
    "userChooser":false,
    "searchAggregation":false
  },
  {
    "name":"expertise",
    "type":"TEXT",
    "order":3,
    "overview":false,
    "important":false,
    "userChooser":false,
    "searchAggregation":false
  },
  {
    "name":"about",
    "type":"TEXTAREA",
    "order":3,
    "overview":false,
    "important":false,
    "userChooser":false,
    "searchAggregation":false
  }
 ]
}

Um zu überprüfen, ob es funktioniert hat, geht einfach auf die Profilseite eines Benutzers und bearbeitet die entsprechende Profilgruppe. Hier solltet ihr ein Pronomen-Feld finden.

Falls ihr die Übersetzung des Profilfelds anpassen möchtet, könnt ihr dies über den gewohnten Weg der Sprache vornehmen.