Bericht über Funktionsfelder erstellen

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 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 wie andere Felder verwenden.

    Die Verantwortung für das Erstellen, Bearbeiten und Deaktivieren von Funktionsfeldern liegt beim Benutzer mit der Rolle „function_field_admin“. Beim Upgrade hat kein Benutzer diese Rolle. Ein Administrator muss diese Rolle einem Nicht-Admin-Benutzer zuweisen. Weitere Informationen finden Sie unter Rollen erstellen.

    Weitere Informationen zu Funktionsfeldern finden Sie hier: Funktionsfeld.

    Funktionsfeldvorgänge

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

    Diese Funktion akzeptiert auch numerische Werte für beide Eingaben. Numerische Werte in einfache oder doppelte Anführungszeichen setzen.

    		 glidefunction: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 akzeptiert auch numerische Werte für beide Eingaben. Numerische Werte in einfache oder doppelte Anführungszeichen setzen.

    		 glidefunction:subtract(u_num1, u_num2)

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

    Mögliche Rückgabetypen: Dezimalzahl, Gleitkommazahl, große ganze Zahl, ganze Zahl
    multiply() Verwendet zwei Zahlenfelder als Eingabe, multipliziert sie und gibt die Ergebnisse als Feldwert zurück.

    Diese Funktion akzeptiert auch numerische Werte für beide Eingaben. Numerische Werte in einfache oder doppelte Anführungszeichen setzen.

    		 glidefunction:multiply(u_num1, u_num2)

    Gibt 48 zurück, wenn num1 = 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 akzeptiert auch numerische Werte für beide Eingaben. Numerische Werte in einfache oder doppelte Anführungszeichen setzen.

    		 glidefunction:divide(u_num2,u_num1)

    Gibt 5 zurück, wenn num2 = 10 und num1 = 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. glidefunction:concat(incident_number, '/', short_description)

    Gibt „INC0001 / Mein Client benötigt einen neuen Laptop“ zurück. , wenn der Wert des Nummernfelds „INC0001“ lautet und short_description „Mein Client 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. glidefunction:datediff(closed_at, sys_created_on)

    Gibt die Dauer eines Incident 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 die Konstante „1“ (Woche beginnt am Sonntag) oder „2“ (Woche beginnt am Montag). Gibt die Ergebnisse als Ganzzahlwert zurück, der den Wochentag darstellt.

    Die Funktion dayofweek() verwendet UTC-Daten, passt die Vergleichswerte jedoch basierend auf der Zeitzone der Instanz an.

    		 glidefunction:dayofweek(resolved_at, '1').

    Wenn resolve_at an einem Mittwoch auftritt, wird 4 zurückgegeben, wenn die Ganzzahl 1 ist, und 3, 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. glidefunction: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 durch Kommas getrennten Feldern als Eingabe und gibt den ersten nicht leeren Wert zurück. glidefunction:coalesce(closed_at, resolve_at, sys_updated_on)

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

    Rückgabetyp: Text
    Position () Verwendet zwei Textfelder oder zwei Textfelder und eine ganze Zahl als Eingabe. Eines oder beide Textfelder können auch Zeichenfolgen sein.
    1. Gibt die Position des ersten Vorkommens der Zeichenfolge des ersten Textfelds im 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 im zweiten nicht vorhanden ist (nach der Position der ganzen Zahl, falls angegeben).
    • glidefunction:position('e',short_description)

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

    • glidefunction:position('e',short_description,'14')

      Wenn der Wert des Felds short_description „Dieser Computer führt ein Upgrade durch“ lautet, 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 hat. glidefunction:substring(short_description, '7', '2')

    Wenn der Wert des Felds short_description „Wir gehen zum Speicher“ lautet, wird „go“ zurückgegeben.

    Rückgabetyp: Text