Definieren Sie Qualifizierer für E-Mail-Client-Empfänger

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer

    • Erstellen Sie eine Konfiguration, die die Liste der im E-Mail-Client angezeigten Empfänger für die automatische Vervollständigung steuert.

    Vorbereitungen

    Erforderliche Rolle: Email_Client_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können Empfängerqualifizierer angeben, die zusätzliche Felder anzeigen (aus einem ausgewählten ServiceNow Tabelle) in der Liste der automatischen Vervollständigung. Diese Felder unterscheiden E-Mail-Empfänger, die denselben vor- und Nachnamen haben.
    Verwenden Sie die folgenden Registerkarten im Formular E-Mail-Client-Empfänger-Qualifizierer, um eine Empfängerkonfiguration zu definieren.
    • Anzeigekonfiguration – Richten Sie das Verhalten der automatischen Vervollständigung des E-Mail-Empfängers ein, und wählen Sie optional zusätzliche Felder aus, um Empfänger mit demselben Namen zu unterscheiden. Die zusätzlichen Felder stellen sicher, dass Anwender den richtigen Empfänger für eine E-Mail auswählen.
    • Abfragekonfiguration – Geben Sie eine Bedingung oder ein Skript an, die die ausgewählte Tabelle abfragt und die zurückgegebenen Empfängerergebnisse filtert.
    Sie können verschiedene Empfängerkonfigurationen definieren, die in einer E-Mail-Client-Konfiguration verwendet werden können.

    Prozedur

    1. Navigieren zu E-Mail-Client > E-Mail-Client – Empfängerqualifizierer Und wählen Sie aus Neu .
    2. Füllen Sie die Felder oben im Formular „Empfängerqualifizierer“ aus.
      Feld Beschreibung
      Name Ein eindeutiger Name für diese E-Mail-Client-Empfängerkonfiguration.
      Anwendung Die Art der Bereichsanwendung.
      Tabelle Die ServiceNow Tabelle, die für Empfänger abgefragt werden soll.
      Beschreibung Eine kurze Beschreibung dieser Empfängerkonfiguration.
    3. Füllen Sie die Felder im aus Anzeigekonfiguration Registerkarte zur Steuerung der Anzeige der automatischen Vervollständigung im E-Mail-Client.
      Feld Beschreibung
      E-Mail-Adresse Das Feld in der Tabelle, das die Empfänger-E-Mail-Adresse enthält.
      Anzeigename Das Feld in der Tabelle, das für den angezeigten Empfängernamen verwendet wird.
      Reihenfolge Die Reihenfolge der Ergebnisse, die relativ zu anderen definierten Empfängerqualifizierern zurückgegeben werden.
      Zusätzliche Anzeigefelder Eine Inhaltsliste zum Auswählen zusätzlicher Felder aus der Tabelle, die in der Liste der automatischen Vervollständigung angezeigt werden sollen. Unterscheidet Empfänger, die denselben Namen haben.
      Suche – Zusätzliche Felder Ein Kontrollkästchen zum Aktivieren der Durchsuchung zusätzlicher Felder. Erweitert die in der Liste der automatischen Vervollständigungen zurückgegebenen Empfänger, indem abgefragt (gesucht) wird Zusätzliche Anzeigefelder .
    4. Füllen Sie die Felder auf der Registerkarte Abfragekonfiguration aus.
      Feld Beschreibung
      Präfixsuche Option zum Suchen des gewünschten Empfängers mithilfe des Präfix.
      Hinweis:
      Auswählen von Präfixsuche Option zeigt an Feld „Nachname“ Dropdown-Menü mit Optionen zum Filtern des Empfängernamens.
      Typ Wählen Sie die Methode zum Filtern der in der Liste der automatischen Vervollständigung zurückgegebenen Empfänger aus:
      • Bedingung
      • Skript
      Bedingungen Wenn Sie Bedingung für ausgewählt haben Typ , Verwenden Sie den Bedingungsgenerator, um die Bedingungen anzugeben, die erfüllt sein müssen, um die entsprechenden Empfänger zurückzugeben.
      Skript Wenn Sie Skript für ausgewählt haben Typ , Geben Sie ein Skript ein, das diese Variablen verwendet, um die entsprechenden Empfänger zurückzugeben:
      • Receiver entQuery : GlideRecord für die abzufragende Tabelle.
      • TargetRecord : GlideRecord für den Zieldatensatz, aus dem der E-Mail-Client geöffnet wurde.
      Beispiel: Diese „Receivant entQuery“ ist ein GlideRecord, der die Tabelle „Kundenkontakt“ darstellt. Die Variable targetRecord ist ein Kundenservicefall, aus dem der E-Mail-Client geöffnet wurde. Diese Abfrage beschränkt die Ergebnisse der automatischen Vervollständigung des E-Mail-Clients auf Kontakte, die demselben Account angehören wie der Kundenservicefall.
      (function (recipientQuery, targetRecord) {
	
	 // Limit results to contacts belonging to the account for the case.
	 var account = targetRecord.getValue('account');
	 recipientQuery.addQuery('account', account);

})(recipientQuery, targetRecord);
    5. Wählen Sie Absenden.
      Die Empfängerqualifizierer-Konfiguration wird der Tabelle „Empfängerqualifizierer“ [sys_recipient_Qualifier] hinzugefügt und kann in einer E-Mail-Client-Konfiguration verwendet werden.