Bericht über Funktionsfelder

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 3 Minuten Lesedauer

    • Während normale 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 Anwender diese Rolle. Ein Administrator muss diese Rolle einem Nicht-Administrator zuweisen. Weitere Informationen finden Sie unter „Rollen erstellen“.

    Erfahren Sie hier mehr über Funktionsfelder: Funktionsfeld.

    Funktionsfeldvorgänge

    Funktionsfelder können mit der Glide-Funktion die folgenden Vorgänge ausführen: <operation> Syntax.
    Hinweis:
    Geben Sie Konstanten in einfachen oder doppelten Anführungszeichen an. Die Beispiele für die Vorgänge „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 des Vorgangs und ein Beispiel, das Code und die Rückgabewerte 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. Platzieren Sie numerische Werte in einfachen oder doppelten Anführungszeichen.

    		 glidefunction:add(child_incidents, parent_incident)

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

    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. Platzieren Sie numerische Werte in einfachen oder doppelten Anführungszeichen.

    		 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, führt die Multiplikation durch und gibt die Ergebnisse als Feldwert zurück.

    Diese Funktion akzeptiert auch numerische Werte für beide Eingaben. Platzieren Sie numerische Werte in einfachen oder doppelten Anführungszeichen.

    		 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. Platzieren Sie numerische Werte in einfachen oder doppelten Anführungszeichen.

    		 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“ und die 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 und 11 Sekunden

    Rückgabetyp: Dauer
    dayofweek() Verwendet 2 Argumente: Ein Datumsfeld und entweder die Konstante „1“ (Woche beginnt Sonntag) oder „2“ (Woche beginnt 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 resolved_at an einem Mittwoch auftritt, wird 4 zurückgegeben, wenn die Ganzzahl 1 ist, und 3 zurückgegeben, wenn die Ganzzahl 2 ist.

    Rückgabetyp: Ganzzahl
    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: Ganzzahl
    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, 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 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 wird aktualisiert“ lautet, wird 12 zurückgegeben.

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

      Wenn der Wert des Felds short_description „Dieser Computer wird aktualisiert“ lautet, wird 19 zurückgegeben.

    Rückgabetyp: Ganzzahl
    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 Store“ ist, wird „go“ zurückgegeben.

    Rückgabetyp: Text