---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideDBFunctionBuilder: Bereichsbezogen, global

# GlideDBFunctionBuilder: Bereichsbezogen, global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 12 Minuten Lesedauer

Die GlideDBFunctionBuilder Die API bietet Methoden zum Erstellen von Funktionen zum Ausführen von SQL-Vorgängen in der Datenbank.

Diese Methoden bieten eine Möglichkeit, Funktionen des relationalen Datenbankverwaltungssystems (RDBMS) zu erstellen, um SQL-Vorgänge für Datensatzdaten auszuführen. Sie können diese Methoden sowohl in bereichsbezogenen als auch globalen Serverskripts verwenden.  
So verwenden Sie Plattformfunktionen:

* Erstellen Sie eine Funktion mit dem GlideDBFunctionBuilder-Konstruktor und zugehörigen Methoden.
* Nach dem Erstellen einer Funktion wenden Sie die Funktion mithilfe von auf den aktuellen Datensatz an AddFunction() Methode von GlideRecord Klasse.
* Fügen Sie die Funktion einer Abfrage mit hinzu AddQuery() Methode von GlideRecord Klasse.
* Rufen Sie die Ergebnisse der Funktion mithilfe der vorhandenen ab GlideRecord API-Methoden wie GetValue() Und GetElement() .
{#GlideDBFunctionBuilderScopedAPI__ul_bmr_mqg_jbb}

Zum Beispiel:

    var functionBuilder = new GlideDBFunctionBuilder();
    var dbFunction = functionBuilder.position();
    dbFunction = functionBuilder.constant('my'); // search_term: Text to search for in the specified table column.
    dbFunction = functionBuilder.field('short_description');  // column: Name of the table column to search.
    dbFunction = functionBuilder.build();

    gs.log(dbFunction);

    var gr_incident = new GlideRecord('incident'); // Table containing the column to search
    gr_incident.addFunction(dbFunction);
    gr_incident.addQuery("short_description", "CONTAINS", "my");
    gr_incident.setLimit(20);
    gr_incident.query();
    while(gr_incident.next()) {
      gs.info(gr_incident.short_description + "\n position('my', short_description): " + gr_incident.getValue(dbFunction));
    }

Weitere Informationen zu Funktionsfeldern finden Sie unter [Function field](https://www.servicenow.com/docs/access?context=platform-support-functions&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

## Bereichsbezogener GlideDBFunctionBuilder -- GlideDBFunctionBuilder() {#ariaid-title2}

Instanziiert ein GlideDBFunctionBuilder-Objekt.
{#GlideDBFBScoped-GlideDBFB__table_u1c_tsg_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#GlideDBFBScoped-GlideDBFB__table_u1c_tsg_jbb}  

    var builder = new GlideDBFunctionBuilder();

## Bereichsbezogener GlideDBFunctionBuilder -- andFunc(expr1, expr2, ...) {#ariaid-title3}

Startet einen neuen UND-Ausdruck, der nur dann „wahr" zurückgibt, wenn alle ihm als Parameter bereitgestellten Ausdrücke „wahr" sind. Mindestens ein boolescher Ausdruck muss als Parameter angegeben werden.
{#GlideDBFBScoped-andfunc_S__table_emi_ssf_xwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ausdruck | GlideFunction-Ausdruck mit booleschem Wert | Derzeit umfassen Glide-Funktionen, die diese Kriterien erfüllen Und() , Oder() , Und Vergleichen() . |
[Tabelle : 2. Parameter]

{#GlideDBFBScoped-andfunc_S__table_emi_ssf_xwb} {#GlideDBFBScoped-andfunc_S__table_jkl_ssf_xwb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der resultierende GlideFunction-Ausdruck. |
[Tabelle : 3. Rückgaben]

{#GlideDBFBScoped-andfunc_S__table_jkl_ssf_xwb}  
Das folgende Beispiel zeigt, wie Sie eine einfache Fallanweisung definieren und erstellen.

    var expr = new GlideDBFunctionBuilder() 
        .andFunc() 
            .compare().field('first_name').constant('=').constant('John').endfunc() 
            .compare().field('active').constant('=').constant(1).endfunc() 
        .endfunc() 
        .build(); 
    gs.info("Expression: " + expr);

Ausgabe:

    Expression: glidefunction:and(compare(first_name,'=','John'),compare(active,'=','1'))

## Bereichsbezogener GlideDBFunctionBuilder -- add() {#ariaid-title4}

Fügt die Werte von mindestens zwei Ganzzahlfeldern hinzu.
Verwenden Sie Feld (Zeichenfolgenfeld) Methode zum Definieren von Feldern, für die der Vorgang ausgeführt wird.
{#GlideDBFBScoped-add__table_kjb_h5g_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 4. Parameter]

{#GlideDBFBScoped-add__table_kjb_h5g_jbb} {#GlideDBFBScoped-add__table_ljb_h5g_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 5. Rückgaben]

{#GlideDBFBScoped-add__table_ljb_h5g_jbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var myAddingFunction = functionBuilder.add();
    myAddingFunction = functionBuilder.field('order');
    myAddingFunction = functionBuilder.field('priority');
    myAddingFunction = functionBuilder.build();

## Bereichsbezogener GlideDBFunctionBuilder -- Build() {#ariaid-title5}

Erstellt die Datenbankfunktion, die durch das GlideDBFunctionBuilder-Objekt definiert ist.
{#GlideDBFBScoped-build__table_y1r_4ch_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 6. Parameter]

{#GlideDBFBScoped-build__table_y1r_4ch_jbb} {#GlideDBFBScoped-build__table_z1r_4ch_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 7. Rückgaben]

{#GlideDBFBScoped-build__table_z1r_4ch_jbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var myAddingFunction = functionBuilder.add();
    myAddingFunction = functionBuilder.field('order');
    myAddingFunction = functionBuilder.field('priority');
    myAddingFunction = functionBuilder.build();
    gs.info(myAddingFunction);

Ausgabe:

    *** Script: glidefunction:add(order,priority)

## Bereichsbezogener GlideDBFunctionBuilder -- coalesce() {#ariaid-title6}

Verwendet eine beliebige Anzahl von kommagetrennten Feldern als Eingabe und gibt den ersten nicht leeren Wert zurück.
{#GlideDBFBScoped-coalesce__table_nnr_pdt_gyb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Argument | Zeichenfolge | Eine Liste, die einen konstanten Wert (Zeichenfolgen, Objekte, boolesche Werte) oder ein Feld enthält. Akzeptiertes Format: `Glidefunktion:Coalesce(<Zeichenfolge, Zeichenfolge, Zeichenfolge usw.>) `. Ein Argument kann eine beliebige Anzahl von Parametern haben, es muss jedoch mindestens ein Parameter definiert sein. |
[Tabelle : 8. Parameter]

{#GlideDBFBScoped-coalesce__table_nnr_pdt_gyb} {#GlideDBFBScoped-coalesce__table_onr_pdt_gyb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der erste Wert in der Argumentliste, der nicht null ist. Wenn keine Werte ungleich Null sind, wird Null zurückgegeben. Wenn bei der Erstellung des Funktionsobjekts keine Argumente angegeben werden, wird „ungültige Funktion" als Zeichenfolge zurückgegeben. |
[Tabelle : 9. Rückgaben]

{#GlideDBFBScoped-coalesce__table_onr_pdt_gyb}  
Die folgende Beispielanforderung demonstriert, wie die Zusammenfügungsleitfadenfunktion so geformt wird, dass Nullwerte gemäß den Feldern „closed_at", „Resolved_at" und „sys_updated_on" zurückgegeben werden.

    var gr = new GlideRecord('incident');
    var func = "glidefunction:coalesce(closed_at, resolved_at,sys_updated_on)";
    gr.addFunction(func);
    gr.query(); 
    while(gr.next())
    gs.info(gr.getValue(func));

Das Skript gibt für jeden Incident-Datensatz in der Incident-Tabelle den ersten nicht-Null-Wert aus einem Feld aus dieser Liste zurück: \[Closed_at, Resolved_at, sys_updated_on\] und gibt sie mit aus `gs.info `.

    2016-12-14 02:46:44
    2018-01-09 22:55:16
    2018-01-07 22:54:55
    2018-01-13 23:02:54
    2018-01-09 23:12:02

## Bereichsbezogener GlideDBFunctionBuilder -- compare(exp1, op, exp2) {#ariaid-title7}

Startet einen neuen VERGLEICHSAUSDRUCK, der einen Vergleich zwischen zwei Ausdrücken durchführt.
{#GlideDBFBScoped-compare_S_S_S__table_a5r_px1_mxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| exp1 | Zeichenfolge | Linker Vergleichsausdruck. Kann eine Konstante, ein Verweis auf ein Feld oder eine andere Glide-Funktion sein. |
| op | Zeichenfolge | Ein Vergleichsoperator, umgeben von Anführungszeichen. Akzeptierte Werte: * "'='" * "'\<'" * "'\>'" * "'\<='" * "'\>='" {#GlideDBFBScoped-compare_S_S_S__ul_nmh_yx1_mxb} |
| exp2 | Zeichenfolge | Rechter Vergleichsausdruck. Kann eine Konstante, ein Verweis auf ein Feld oder eine andere Glide-Funktion sein. |
[Tabelle : 10. Parameter]

{#GlideDBFBScoped-compare_S_S_S__table_a5r_px1_mxb} {#GlideDBFBScoped-compare_S_S_S__table_b5r_px1_mxb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der resultierende GlideFunction-Ausdruck. |
[Tabelle : 11. Rückgaben]

{#GlideDBFBScoped-compare_S_S_S__table_b5r_px1_mxb}  
Das folgende Beispiel zeigt, wie ein Glidefunktionsausdruck mit dem Vorgang „compare()" erstellt wird. Nach dem Anruf Vergleichen() , Es müssen drei zusätzliche Aufrufe erfolgen, um jeden der drei erforderlichen Parameter anzugeben, die dann durch einen einzelnen Aufruf an abgeschlossen werden Endfun() . Unten erstellen wir zwei separate Vergleichen() Ausdrücke und geben Sie sie als Parameter für an Oder() Ausdruck.

    var expr = new GlideDBFunctionBuilder() 
        .orFunc() 
            .compare().field('first_name').constant('=').constant('John').endfunc() 
            .compare().field('active').constant('=').constant(1).endfunc() 
        .endfunc() 
        .build();

Ausgabe:

    Expression: glidefunction:or(compare(first_name,'=','John'),compare(active,'=','1'))

## Bereichsbezogener GlideDBFunctionBuilder -- concat() {#ariaid-title8}

Verkettet die Werte von mindestens zwei Feldern.
Verwenden Sie Feld (Zeichenfolgenfeld) Methode zum Definieren von Feldern, für die der Vorgang ausgeführt wird.
{#GlideDBFBScoped-concat__table_tsn_ckh_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 12. Parameter]

{#GlideDBFBScoped-concat__table_tsn_ckh_jbb} {#GlideDBFBScoped-concat__table_usn_ckh_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 13. Rückgaben]

{#GlideDBFBScoped-concat__table_usn_ckh_jbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var myConcatFunction = functionBuilder.concat();
    myConcatFunction = functionBuilder.field('short_description');
    myConcatFunction = functionBuilder.field('caller_id.name');
    myConcatFunction = functionBuilder.build();

## Bereichsbezogener GlideDBFunctionBuilder -- Konstante(Zeichenfolgenkonstante) {#ariaid-title9}

Definiert einen konstanten Wert, der in der Funktion verwendet werden soll. Bei Verwendung mit wochentag() Methode: Die Zeichenfolge definiert, ob Sonntag oder Montag als erster Wochentag verwendet werden soll.
{#GlideDBFBScoped-constant_S__table_lww_s2h_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| constant | Zeichenfolge | Ein konstanter Wert, der in einer Funktion verwendet wird. Bei Verwendung mit wochentag() Methode: Der Wert definiert, ob die Woche an einem Sonntag oder Montag beginnt. * 1 : Woche beginnt am Sonntag. * 2 : Woche beginnt am Montag. {#GlideDBFBScoped-constant_S__ul_wz5_5bk_kbb} Diese Definition aktiviert wochentag() Methode zum Zurückgeben des richtigen Wochentags ab einem bestimmten Datum. Wenn ein anderer Wert als 1 oder 2 angegeben wird, wird wochentag() Bei der Methode wird Sonntag als erster Wochentag verwendet. |
[Tabelle : 14. Parameter]

{#GlideDBFBScoped-constant_S__table_lww_s2h_jbb} {#GlideDBFBScoped-constant_S__table_mww_s2h_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 15. Rückgaben]

{#GlideDBFBScoped-constant_S__table_mww_s2h_jbb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var functionBuilder = new GlideDBFunctionBuilder();
    var dbFunction = functionBuilder.position();
    dbFunction = functionBuilder.constant('my');
    dbFunction = functionBuilder.field('short_description');
    dbFunction = functionBuilder.build();

    gs.log(dbFunction);

    var g = new GlideRecord('incident');
    g.addFunction(dbFunction);
    g.addQuery("short_description", "CONTAINS", "my");
    g.setLimit(20);
    g.query();
    while(g.next()) {
      gs.info(g.short_description + "\n position('my', short_description): " + g.getValue(dbFunction));
    }

## Bereichsbezogener GlideDBFunctionBuilder -- datediff() {#ariaid-title10}

Bestimmt die Dauer anhand eines bestimmten Startdatums/einer bestimmten Startzeit und eines Enddatums/einer bestimmten Endzeit.
Verwenden Sie Feld (Zeichenfolgenfeld) Methode zum Definieren von Start- und Enddatum/-Uhrzeit-Feldern.
{#GlideDBFBScoped-datediff__table_scn_bnh_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 16. Parameter]

{#GlideDBFBScoped-datediff__table_scn_bnh_jbb} {#GlideDBFBScoped-datediff__table_tcn_bnh_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 17. Rückgaben]

{#GlideDBFBScoped-datediff__table_tcn_bnh_jbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var myDateDiffFunction = functionBuilder.datediff();
    myDateDiffFunction = functionBuilder.field('sys_updated_on');
    myDateDiffFunction = functionBuilder.field('opened_at');
    myDateDiffFunction = functionBuilder.build();

## Bereichsbezogener GlideDBFunctionBuilder -- dayofweek() {#ariaid-title11}

Gibt eine Ganzzahl zurück, die den Wochentag für ein bestimmtes Datum darstellt.
Verwenden Sie Feld (Zeichenfolgenfeld) Methode zum Definieren des angegebenen Datums/der angegebenen Uhrzeit. Verwenden Sie Konstante (Zeichenfolgenkonstante) Methode zum Definieren, ob die Woche an einem Sonntag oder Montag beginnt.

Diese Methode kann nur mit MySQL-, Oracle- und Microsoft SQL Server-Datenbanken verwendet werden. Bei Verwendung einer Oracle-Datenbank muss die Einstellung „NLS_TERRITORY" auf ein Gebiet festgelegt werden, dessen Sonntag der erste Tag der Woche ist.
{#GlideDBFBScoped-dayofweek__table_od2_dnh_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 18. Parameter]

{#GlideDBFBScoped-dayofweek__table_od2_dnh_jbb} {#GlideDBFBScoped-dayofweek__table_pd2_dnh_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ganzzahl | Wenn der erste Wochentag in auf Sonntag festgelegt ist Konstante (Zeichenfolgenkonstante) Methode, Rückgabewerte sind den folgenden Wochentagen zugeordnet: * 1 : Sonntag * 2 : Montag * 3 : Dienstag * 4 : Mittwoch * 5 : Donnerstag * 6 : Freitag * 7 : Samstag {#GlideDBFBScoped-dayofweek__ul_ufc_yck_kbb} Wenn der erste Wochentag auf Montag festgelegt ist: * 1 : Montag * 2 : Dienstag * 3 : Mittwoch * 4 : Donnerstag * 5 : Freitag * 6 : Samstag * 7 : Sonntag {#GlideDBFBScoped-dayofweek__ul_at2_gdk_kbb} Wenn ein anderer Wert als 1 oder 2 in angegeben ist Konstante (Zeichenfolgenkonstante) Methode, die wochentag() Bei der Methode wird Sonntag als erster Wochentag verwendet. |
[Tabelle : 19. Rückgaben]

{#GlideDBFBScoped-dayofweek__table_pd2_dnh_jbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var dayOfWeekFunction = functionBuilder.dayofweek();
    dayOfWeekFunction = functionBuilder.field('opened_at');
    dayOfWeekFunction = functionBuilder.constant('2');
    dayOfWeekFunction = functionBuilder.build();

    var now_GR = new GlideRecord('incident');
    now_GR.addFunction(dayOfWeekFunction);
    now_GR.query();
    while(now_GR.next())
    gs.log(now_GR.getValue(dayOfWeekFunction));

## Bereichsbezogener GlideDBFunctionBuilder -- divide() {#ariaid-title12}

Teilt den Wert eines Ganzzahlfelds durch ein anderes.
Verwenden Sie Feld (Zeichenfolgenfeld) Methode zum Definieren von Feldern, für die der Vorgang ausgeführt wird.
{#GlideDBFBScoped-divide__table_hsj_ymh_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 20. Parameter]

{#GlideDBFBScoped-divide__table_hsj_ymh_jbb} {#GlideDBFBScoped-divide__table_isj_ymh_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 21. Rückgaben]

{#GlideDBFBScoped-divide__table_isj_ymh_jbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var myDivideFunction = functionBuilder.divide();
    myDivideFunction = functionBuilder.field('order');
    myDivideFunction = functionBuilder.field('priority');
    myDivideFunction = functionBuilder.build();

## Bereichsbezogener GlideDBFunctionBuilder -- Feld (Zeichenfolgenfeld) {#ariaid-title13}

Definiert ein Feld, für das ein SQL-Vorgang ausgeführt wird.
{#GlideDBFBScoped-field_S__table_tbm_rmh_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ausstehend | Zeichenfolge | Das Feld, für das Sie den SQL-Vorgang ausführen. |
[Tabelle : 22. Parameter]

{#GlideDBFBScoped-field_S__table_tbm_rmh_jbb} {#GlideDBFBScoped-field_S__table_ubm_rmh_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 23. Rückgaben]

{#GlideDBFBScoped-field_S__table_ubm_rmh_jbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var myAddingFunction = functionBuilder.add();
    myAddingFunction = functionBuilder.field('order');
    myAddingFunction = functionBuilder.field('priority');
    myAddingFunction = functionBuilder.build();

## Bereichsbezogener GlideDBFunctionBuilder -- length() {#ariaid-title14}

Bestimmt die Anzahl der Codeeinheiten in einem Feld.
Verwenden Sie Feld (Zeichenfolgenfeld) Methode zum Definieren von Feldern, für die der Vorgang ausgeführt wird.
{#GlideDBFBScoped-length__table_wl5_tmh_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 24. Parameter]

{#GlideDBFBScoped-length__table_wl5_tmh_jbb} {#GlideDBFBScoped-length__table_xl5_tmh_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 25. Rückgaben]

{#GlideDBFBScoped-length__table_xl5_tmh_jbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var myLengthFunction = functionBuilder.length();
    myLengthFunction = functionBuilder.field('short_description');
    myLengthFunction = functionBuilder.build();

## Bereichsbezogener GlideDBFunctionBuilder -- multiply() {#ariaid-title15}

Multipliziert die Werte von zwei Ganzzahlfeldern.
Verwenden Sie Feld (Zeichenfolgenfeld) Methode zum Definieren von Feldern, für die der Vorgang ausgeführt wird.
{#GlideDBFBScoped-multiply__table_hsj_ymh_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 26. Parameter]

{#GlideDBFBScoped-multiply__table_hsj_ymh_jbb} {#GlideDBFBScoped-multiply__table_isj_ymh_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 27. Rückgaben]

{#GlideDBFBScoped-multiply__table_isj_ymh_jbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var myMultiplyFunction = functionBuilder.multiply();
    myMultiplyFunction = functionBuilder.field('order');
    myMultiplyFunction = functionBuilder.field('priority');
    myMultiplyFunction = functionBuilder.build();

## Bereichsbezogener GlideDBFunctionBuilder -- orFunc(Ausdruck) {#ariaid-title16}

Startet einen neuen ODER-Ausdruck, der „wahr" zurückgibt, wenn mindestens einer der für ihn als Parameter bereitgestellten Ausdrücke „wahr" ist.
Mindestens ein boolescher Ausdruck muss als Parameter angegeben werden.
{#GlideDBFBScoped-orFunc_B__table_qjb_hw1_mxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ausdruck | GlideFunction-Ausdruck mit booleschem Wert | Derzeit umfassen Glide-Funktionen, die diese Kriterien erfüllen, und(), oder() und compare(). |
[Tabelle : 28. Parameter]

{#GlideDBFBScoped-orFunc_B__table_qjb_hw1_mxb} {#GlideDBFBScoped-orFunc_B__table_rjb_hw1_mxb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der resultierende GlideFunction-Ausdruck. |
[Tabelle : 29. Rückgaben]

{#GlideDBFBScoped-orFunc_B__table_rjb_hw1_mxb}  
Das folgende Beispiel zeigt, wie ein Glidefunktionsausdruck mit dem Vorgang oder() erstellt wird. Der Ausdruck gibt „wahr" zurück, wenn entweder „wahr" first_nameFeld ist „John" oder activeFeld ist „wahr". Die resultierende Ausdruckszeichenfolge kann dann überall verwendet werden, wo Glidefunktionsausdrücke akzeptiert werden.

    var expr = new GlideDBFunctionBuilder() 
        .orFunc() 
            .compare().field('first_name').constant('=').constant('John').endfunc() 
            .compare().field('active').constant('=').constant(1).endfunc() 
        .endfunc() 
        .build(); 
    gs.info("Expression: " + expr);

Ausgabe:

    Expression: glidefunction:or(compare(first_name,'=','John'),compare(active,'=','1'))

## Bereichsbezogener GlideDBFunctionBuilder -- Position() {#ariaid-title17}

Gibt das erste Vorkommen einer angegebenen Zeichenfolge innerhalb einer Spalte einer Tabelle zurück.
Optional können Sie einen Standort innerhalb der Zeichenfolge angeben, um die Suche zu starten. Diese Methode entspricht `LOCATE (Teilzeichenfolge, str, Position) `In MySQL.

Sie können diese Methode verwenden, um interessante Datenpunkte oder anwenderdefinierte Berichte von Datenanalysten zu finden. Normalerweise verwenden Sie diese Methode für das Data Warehousing oder zum Extrahieren, Transformieren und Laden von Daten (ETL) in weniger flexible Systeme.

Um diese Methode in Wörterbuchdatensätzen zu verwenden, verwenden Sie `Glidefunktion:Position (<serarch_term>,<column>) `.  
Hinweis:  
Die in der folgenden Tabelle angegebenen Parameter werden nicht mit dem Methodenaufruf übergeben, sondern im GlideDBFunctionBuilder()-Objekt festgelegt.
{#GlideDBFBScoped-position__table_h5j_hy1_rwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| search_term | Zeichenfolge | Text, nach dem in der angegebenen Tabellenspalte gesucht werden soll. |
| Spalte | Zeichenfolge | Name der zu suchenden Tabellenspalte. Die Tabelle wird im zugehörigen GlideRecord-Objekt angegeben. |
| Start_Position | Nummer | Optional. Speicherort im Spaltentext, um die Suche zu starten. Standard: 1 |
[Tabelle : 30. Parameter]

{#GlideDBFBScoped-position__table_h5j_hy1_rwb} {#GlideDBFBScoped-position__table_i5j_hy1_rwb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine | Position des ersten Vorkommens des angegebenen Suchbegriffs. Gibt Zurück 0 Wenn der Suchbegriff im zugehörigen Text nicht gefunden wird. Gibt Zurück NULL Wenn ein erforderliches Argument Null ist. |
[Tabelle : 31. Rückgaben]

{#GlideDBFBScoped-position__table_i5j_hy1_rwb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var functionBuilder = new GlideDBFunctionBuilder();
    var dbFunction = functionBuilder.position();
    dbFunction = functionBuilder.constant('my'); // search_term: Text to search for in the specified table column.
    dbFunction = functionBuilder.field('short_description');  // column: Name of the table column to search.
    dbFunction = functionBuilder.build();

    gs.log(dbFunction);

    var gr_incident = new GlideRecord('incident'); // Table containing the column to search
    gr_incident.addFunction(dbFunction);
    gr_incident.addQuery("short_description", "CONTAINS", "my");
    gr_incident.setLimit(20);
    gr_incident.query();
    while(gr_incident.next()) {
      gs.info(gr_incident.short_description + "\n position('my', short_description): " + gr_incident.getValue(dbFunction));
    }

Ausgabe:

    *** Script: glidefunction:position('my',short_description)
    *** Script: Wireless access is down in my area
     position('my', short_description): 28
    *** Script: Printer in my office is out of toner
     position('my', short_description): 12
    *** Script: Reset my password
     position('my', short_description): 7
    *** Script: I can't launch my VPN client since the last software update
     position('my', short_description): 16
    *** Script: Missing my home directory
     position('my', short_description): 9
    *** Script: Seem to have an issue with my hard drive...
     position('my', short_description): 28
    *** Script: Please remove the latest hotfix from my PC
     position('my', short_description): 38
    *** Script: I can't get my weather report
     position('my', short_description): 13
    *** Script: Reset my password
     position('my', short_description): 7
    *** Script: my PDF docs are all locked from editing
     position('my', short_description): 1
    *** Script: My desk phone does not work
     position('my', short_description): 1
    *** Script: Can't log into SAP from my laptop today
     position('my', short_description): 25
    *** Script: My computer is not detecting the headphone device
     position('my', short_description): 1
    *** Script: My disk is still having issues. Can't delete a file
     position('my', short_description): 1
    *** Script: The USB port on my PC stopped working
     position('my', short_description): 17

## Bereichsbezogener GlideDBFunctionBuilder -- substring() {#ariaid-title18}

Gibt eine Teilzeichenfolge aus einer angegebenen Spalte einer Tabelle zurück, die an einem angegebenen Speicherort beginnt.
Optional können Sie auch einen Speicherort innerhalb der Zeichenfolge angeben, an dem die Textextraktion gestoppt werden soll. Diese Methode entspricht `LOCATE (Teilzeichenfolge, str, Position) `In MySQL.

Diese Methode funktioniert genau auf Datenbankebene ähnlich wie JavaScript. Sie können diese Methode verwenden, um interessante Datenpunkte oder anwenderdefinierte Berichte für Datenanalysten zu finden. Normalerweise verwenden Sie diese Methode für das Data Warehousing oder zum Extrahieren, Transformieren und Laden von Daten (ETL) in weniger flexible Systeme.

Um diese Methode in Wörterbuchdatensätzen zu verwenden, verwenden Sie `Glidefunktion:substring(<field>,<start_position>,<end_position>) `  
Hinweis:  
Die in der folgenden Tabelle angegebenen Parameter werden nicht mit dem Methodenaufruf übergeben, sondern im GlideDBFunctionBuilder()-Objekt festgelegt.
{#GlideDBFBScoped-substring__table_oc5_hgb_rwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ausstehend | Zeichenfolge | Name der Spalte in der Tabelle, aus der der Text abgerufen werden soll. Die Tabelle wird im zugehörigen GlideRecord-Objekt angegeben. |
| Start_Position | Nummer | Position im Spaltentext, um mit der Extraktion von Text zu beginnen. |
| End_Position | Nummer | Optional. Position im Spaltentext, um das Extrahieren von Text zu beenden. Standard: Textende in der angegebenen Spalte. |
[Tabelle : 32. Parameter]

{#GlideDBFBScoped-substring__table_oc5_hgb_rwb} {#GlideDBFBScoped-substring__table_pc5_hgb_rwb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Text, der aus der angegebenen Tabellenspalte extrahiert wurde. |
[Tabelle : 33. Rückgaben]

{#GlideDBFBScoped-substring__table_pc5_hgb_rwb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var functionBuilder = new GlideDBFunctionBuilder();
    var dbFunction = functionBuilder.substring();
    dbFunction = functionBuilder.field('short_description');  // field: Column within the table to obtain the substring
    dbFunction = functionBuilder.constant(0); // start_position: Location in the column text to start extracting text
    dbFunction = functionBuilder.constant(20); // end_position: Location in the column text to stop extracting text.
    dbFunction = functionBuilder.build();

    gs.log(dbFunction);

    var gr_incident = new GlideRecord('incident'); // Table containing the column from which to extract the text
    gr_incident.addFunction(dbFunction);
    gr_incident.addQuery("short_description", "CONTAINS", "my");
    gr_incident.setLimit(20);
    gr_incident.query();
    while(gr_incident.next()) {
      gs.info(gr_incident.short_description + "\n substring(short_description, 0, 20): " + gr_incident.getValue(dbFunction));
    }

Ausgabe:

    *** Script: glidefunction:substring(short_description,'0','20')
    *** Script: Wireless access is down in my area
     substring(short_description, 0, 20): Wireless access is 
    *** Script: Printer in my office is out of toner
     substring(short_description, 0, 20): Printer in my offic
    *** Script: Reset my password
     substring(short_description, 0, 20): Reset my password
    *** Script: I can't launch my VPN client since the last software update
     substring(short_description, 0, 20): I can't launch my V
    *** Script: Missing my home directory
     substring(short_description, 0, 20): Missing my home dir
    *** Script: Seem to have an issue with my hard drive...
     substring(short_description, 0, 20): Seem to have an iss
    *** Script: Please remove the latest hotfix from my PC
     substring(short_description, 0, 20): Please remove the l
    *** Script: I can't get my weather report
     substring(short_description, 0, 20): I can't get my weat
    *** Script: Reset my password
     substring(short_description, 0, 20): Reset my password
    *** Script: my PDF docs are all locked from editing
     substring(short_description, 0, 20): my PDF docs are all
    *** Script: My desk phone does not work
     substring(short_description, 0, 20): My desk phone does 
    *** Script: Can't log into SAP from my laptop today
     substring(short_description, 0, 20): Can't log into SAP 
    *** Script: My computer is not detecting the headphone device
     substring(short_description, 0, 20): My computer is not 
    *** Script: My disk is still having issues. Can't delete a file
     substring(short_description, 0, 20): My disk is still ha
    *** Script: The USB port on my PC stopped working
     substring(short_description, 0, 20): The USB port on my 

## Bereichsbezogener GlideDBFunctionBuilder -- subtract() {#ariaid-title19}

Subtrahiert den Wert eines ganzzahligen Felds von einem anderen.
Verwenden Sie Feld (Zeichenfolgenfeld) Methode zum Definieren von Feldern, für die der Vorgang ausgeführt wird.
{#GlideDBFBScoped-subtract__table_yph_wmh_jbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 34. Parameter]

{#GlideDBFBScoped-subtract__table_yph_wmh_jbb} {#GlideDBFBScoped-subtract__table_zph_wmh_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 35. Rückgaben]

{#GlideDBFBScoped-subtract__table_zph_wmh_jbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var mySubtractFunction = functionBuilder.subtract();
    mySubtractFunction = functionBuilder.field('order');
    mySubtractFunction = functionBuilder.field('priority');
    mySubtractFunction = functionBuilder.build();


