Bericht zu Funktionsfeldern

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer
  • Während reguläre Felder einen Wert in der Datenbank speichern, zeigt ein Funktionsfeld die Ergebnisse einer Datenbankabfrage an. Das Funktionsfeld generiert den Wert basierend auf Berechnungen anderer Felder und Konstanten. Sie können diese Felder in Berichten und Datenvisualisierungen wie andere Felder verwenden.

    Die Verantwortung für das Erstellen, Bearbeiten und Deaktivieren von Funktionsfeldern gehört dem Anwender mit der Rolle „function_field_admin“. Beim Upgrade hat kein Anwender diese Rolle. Ein Administrator muss diese Rolle einem nicht-Administratoranwender zuweisen. Siehe Erstellen Sie eine Rolle .

    Weitere Informationen zu Funktionsfeldern finden Sie hier: Funktionsfeld .

    Funktionsfeldvorgänge

    Funktionsfelder können die folgenden Vorgänge mit ausführen Glidefunktion: <operation> Syntax.
    Hinweis:
    Geben Sie Konstanten in einfachen oder doppelten Anführungszeichen an. Die Beispiele für Concat() , wochentag() , Position () , Und Teilzeichenfolge() Vorgänge zeigen die Verwendung von Konstanten in Funktionsfeldern an.
    Tabelle : 1. FunktionsfeldvorgängeDie Tabelle „Funktionsfeldvorgänge“ enthält Spalten für die Namen von Funktionsfeldvorgängen, eine detaillierte Beschreibung der Funktion des Vorgangs und ein Beispiel, das sowohl Code als auch das enthält, was der Code zurückgibt.
    Vorgang Beschreibung Beispiel
    add() Verwendet zwei Zahlenfelder als Eingabe, addiert sie und gibt die Ergebnisse als Feldwert zurück.

    Diese Funktion verwendet auch numerische Werte für beide Eingaben. Platzieren Sie numerische Werte in einfache oder doppelte Anführungszeichen.

    Glidefunktion:add(Child_Incidents, parent_Incident)

    Gibt 6 zurück, wenn der Incident fünf untergeordnete Incidents und einen übergeordneten Incident hat.

    Mögliche Rückgabetypen: Dezimalzahl, Gleitkommazahl, große ganze Zahl, ganze Zahl

    subtract() Verwendet zwei Zahlenfelder als Eingabe, subtrahiert das zweite vom ersten und gibt das Ergebnis als Feldwert zurück.

    Diese Funktion verwendet auch numerische Werte für beide Eingaben. Platzieren Sie numerische Werte in einfache oder doppelte Anführungszeichen.

    Glidefunktion:subtrahieren (u_num1, u_num2)

    Gibt 2 zurück, wenn numerische 1 = 8 und num_2 = 6.

    Mögliche Rückgabetypen: Dezimalzahl, Gleitkommazahl, große ganze Zahl, ganze Zahl

    multiply() Verwendet zwei Zahlenfelder als Eingabe, führt die Multiplikation aus und gibt die Ergebnisse als Feldwert zurück.

    Diese Funktion verwendet auch numerische Werte für beide Eingaben. Platzieren Sie numerische Werte in einfache oder doppelte Anführungszeichen.

    Glidefunktion:Multiply(u_num1, u_num2)

    Gibt 48 zurück, wenn Zahl 1 = 8 und num_2 = 6.

    Mögliche Rückgabetypen: Dezimalzahl, Gleitkommazahl, große ganze Zahl, ganze Zahl

    divide() Verwendet zwei Zahlenfelder als Eingabe, dividiert das erste durch das zweite und gibt das Ergebnis als Feldwert zurück.

    Diese Funktion verwendet auch numerische Werte für beide Eingaben. Platzieren Sie numerische Werte in einfache oder doppelte Anführungszeichen.

    Glidefunktion:Divide(u_num2,u_num1)

    Gibt 5 zurück, wenn Zahl 2 = 10 und Zahl 1 = 2.

    Mögliche Rückgabetypen: Dezimalzahl, Gleitkommazahl, große ganze Zahl, ganze Zahl

    concat() Verwendet eine beliebige Anzahl kommagetrennter Felder und Konstanten als Eingabe, verkettet die Eingabe und gibt eine einzige Zeichenfolge als Feldwert zurück. Glidefunktion:concat(Incident_number, „/“, short_description)

    Gibt „INC0001/mein Client benötigt einen neuen Laptop“ zurück. Wenn der Wert des Zahlenfelds „INC0001“ ist und die Kurzbeschreibung „mein Kunde benötigt einen neuen Laptop“ lautet.

    Rückgabetyp: Text

    datediff() Verwendet zwei Datum/Uhrzeit-Felder als Eingabe, berechnet die Differenz zwischen den Datumsangaben in Tagen, Minuten und Sekunden und gibt die Ergebnisse als Wert für das Feld „Dauer“ zurück. Glidefunktion:datediff(closed_at, sys_created_on)

    Gibt die Dauer eines Incidents vom Erstellungsdatum bis zum Abschlussdatum zurück. Beispielergebnis: 10 Tage, 8 Stunden 23 Minuten 11 Sekunden

    Rückgabetyp: Dauer

    dayofweek() Verwendet zwei Argumente: Ein Datumsfeld und eine Konstante von beiden „1“ (Woche beginnt am Sonntag) oder „2“ (Woche beginnt am Montag). Gibt die Ergebnisse als Ganzzahlwert zurück, der den Wochentag darstellt.

    Die wochentag() Die Funktion verwendet UTC-Daten, passt aber Vergleichswerte basierend auf der Zeitzone der Instanz an.

    Glidefunktion:dayofweek(Resolved_at, '1') .

    Wenn „Resolved_at“ an einem Mittwoch auftritt, gibt „4“ zurück, wenn die Ganzzahl 1 ist, und gibt „3“ zurück, wenn die Ganzzahl 2 ist.

    Rückgabetyp: Ganze Zahl

    length() Verwendet ein Zeichenfolgenfeld als Eingabe, berechnet die Feldlänge in Zeichen und gibt die Ergebnisse als Feldwert zurück. Glidefunktion:length(short_description)

    Gibt 37 zurück, wenn „short_description“ = „diese Anwendung führt einen Test durch“.

    Rückgabetyp: Ganze Zahl

    Zusammenfügen() Verwendet eine beliebige Anzahl von kommagetrennten Feldern als Eingabe und gibt den ersten nicht leeren Wert zurück. Glidefunktion:Coalesce(closed_at, Resolved_at, sys_updated_on)

    Wenn der Wert von closed_at leer ist, gibt die Funktion den Wert von Resolved_at zurück. Wenn der Wert von „Resolved_at“ ebenfalls leer ist, gibt die Funktion den Wert „sys_updated_on“ zurück.

    Rückgabetyp: Text

    Position () Verwendet zwei Textfelder oder zwei Textfelder und eine ganze Zahl als Eingabe. Eines oder beide der Textfelder können auch Zeichenfolgen sein.
    1. Gibt die Position des ersten Vorkommens der Zeichenfolge des ersten Textfelds in der zweiten zurück.
    2. Wenn eine ganze Zahl angegeben ist, gibt diese Funktion die Position des zweiten Textfelds nach der Position der ganzen Zahl zurück.

    Gibt 0 zurück, wenn das erste Textfeld in der zweiten nicht vorhanden ist (nach der Position der ganzen Zahl, falls angegeben).

    • Glidefunktion:Position('e',short_description)

      Wenn der Wert des Felds „short_description“ lautet „dieser Computer führt ein Upgrade durch“, wird 12 zurückgegeben.

    • Glidefunktion:Position('e',short_description,'14')

      Wenn der Wert des Felds „short_description“ lautet „dieser Computer führt ein Upgrade durch“, wird 19 zurückgegeben.

    Rückgabetyp: Ganze Zahl

    Teilzeichenfolge() Verwendet ein Textfeld und zwei ganze Zahlen als Eingabe. Gibt die erste Instanz einer Zeichenfolge zurück, die an der Position der ersten ganzen Zahl beginnt und die Länge der zweiten ist. Glidefunktion:substring(short_description, '7', '2')

    Wenn der Wert des Felds „short_description“ „Wir gehen zum Store“ ist, wird „Go“ zurückgegeben.

    Rückgabetyp: Text