Leitfaden zu benutzerdefinierten Ausdrücken in der Benutzersynchronisation

Zusammenfassung: Benutzerdefinierte Ausdrücke bieten die logische Grundlage hinter Speakaps Benutzersynchronisation. Sie ermöglichen es Ihnen, ausgeklügelte Regeln zum Filtern von Benutzern, Zuweisen von Gruppen und Abbilden dynamischer Profildaten basierend auf spezifischen Bedingungen in Ihrer HR-Quelldatei zu erstellen.

1. Verständnis von Ausdrücken

Ausdrücke sind logische Aussagen, die innerhalb der Spaltenzuordnung, Gruppenzuordnung und Rollenzuordnung verwendet werden, um zu bestimmen, wie Daten interpretiert werden. Durch die Verwendung von Operatoren (wie „gleich“ oder „enthält“) können Sie komplexe organisatorische Anforderungen automatisieren, ohne manuelle Arbeit.

2. Gängige logische Operatoren

Um einen Ausdruck zu erstellen, verwenden Sie standardmäßige logische Symbole, um HR-Datenfelder mit bestimmten Werten zu vergleichen.

3. Erweiterte funktionale Ausdrücke

Manchmal reichen einfache Vergleiche nicht aus. Speakap unterstützt erweiterte Funktionen, um innerhalb von Textzeichenfolgen zu suchen oder numerische Bereiche zu verarbeiten.

• Enthält Wert (includes): wird verwendet, um nach einem bestimmten Wort innerhalb eines größeren Feldes zu suchen.

• Beispiel: includes('Jobtitle', "bedrijfsleider") and Department == "WW"
• Bedeutung: richtet sich an alle in der Abteilung „WW“, deren Berufsbezeichnung das Wort „bedrijfsleider“ enthält.

• Ausschluss (not): wird verwendet, um eine Regel umzukehren.

• Beispiel: Division == "WR" and not(startsWith(externalId, "0004"))
• Bedeutung: richtet sich an alle in der Abteilung „WR“ außer denen, deren Mitarbeiter-ID mit „0004“ beginnt.

• Beginnt mit (startsWith): richtet sich an Benutzer basierend auf den Anfangszeichen einer Zeichenfolge.

• Beispiel: Verwenden Sie dies, um Gruppen von Mitarbeitern nach ID-Präfixen zu filtern (zum Beispiel Saisonarbeiter versus Festangestellte).

4. Umgang mit Bereichen und mehreren Bedingungen

Sie können mehrere logische Prüfungen mit and oder or kombinieren, um präzise Benutzergruppen anzusprechen.

• Numerische Bereiche: um einen bestimmten Block von Kostenstellen oder IDs anzusprechen.

• Beispiel: externalID >= 4000 and externalID <= 4900
• Bedeutung: wählt alle mit einem Abteilungscode zwischen 4000 und 4900 einschließlich aus.

5. Dynamische Datenauswahl (Ternäre Logik)

Ausdrücke können zwischen zwei Datenpunkten wählen, wenn einer fehlt, oder eine Präferenz festlegen, wie beispielsweise E-Mail-Adressen oder Systemsprachen.

• E-Mail-Fallback: stellt sicher, dass einem Benutzer immer eine E-Mail-Adresse zugeordnet ist.

• Ausdruck: 'E-mail work' ? 'E-mail work' : 'E-mail private'
• Bedeutung: Verwenden Sie die Spalte „Arbeits-E-Mail“; wenn diese leer ist, verwenden Sie stattdessen die Spalte „Private E-Mail“.

• Sprachauswahl: legt die Einladungs- und Schnittstellensprache basierend auf der Kostenstelle eines Benutzers dynamisch fest.

• Ausdruck: ('Primary Costcenter' >= 4000 and 'Primary Costcenter' <= 4899) or ('Primary Costcenter' >= 4900 and 'Primary Costcenter' <= 4999) ? "fr-FR" : "en-GB"
• Bedeutung: Benutzer in Kostenstellen 4000-4999 erhalten eine französische Benutzeroberfläche per E-Mail; alle anderen erhalten eine englische.

6. Best Practices für das Erstellen von Ausdrücken

• Anführungszeichen: Textwerte (Strings) immer in doppelte Anführungszeichen setzen (zum Beispiel „Management“).
• Feldnamen: Stellen Sie sicher, dass die Feldnamen in Ihrem Ausdruck genau mit den Spaltenüberschriften in Ihrer HR-Exportdatei übereinstimmen.
• Testen: Verwenden Sie den Trockendurchlauf innerhalb der Zuordnungseinstellungen, um zu überprüfen, ob Ihr Ausdruck der erwarteten Benutzeranzahl entspricht, bevor Sie Änderungen anwenden. Siehe Verwendung des Trockendurchlaufs zur Validierung und Anwendung von Synchronisationsänderungen.

Immer noch Probleme?

Schreiben Sie uns eine E-Mail an technicalimplementations@speakap.nl mit Ihrem Netzwerknamen und dem Ausdruck, den Sie erstellen möchten, und wir helfen Ihnen gerne weiter.