---
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


---

# GlideDBFunctionCaseBuilder -- Global

# GlideDBFunctionCaseBuilder -- Global {#ariaid-title1}

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

Die GlideDBFall-StatementBuilder Mit der API können Sie SQL-FALLANWEISUNGEN erstellen und Werte basierend auf einer Reihe von Bedingungen zurückgeben.

Sie können diese API als Teil der Definition von verwenden [GlideElement -- Global](https://servicenow-prod.fluidtopics.net/w8rLS36_UDshFdpicsXYmg#c_GlideElementAPI "Die GlideElement Die API bietet eine Reihe praktischer Skriptmethoden für den Umgang mit Feldern und ihren Werten. GlideElement Methoden sind für die Felder des aktuellen Glide-Datensatzes verfügbar.")API oder beim Abfragen einer Tabelle. Um zu erstellen `FALL `Anweisung, beginnen Sie mit der Instanziierung des GlideDBFunctionCaseBuilder-Objekts mit seinem Konstruktor, GlideDBFunctionCaseBuilder() . Definieren Sie dann einen oder mehrere Fälle mithilfe einer Reihe von Wenn() Und Dann() Anrufe gefolgt von einem einzelnen, optional Andernfalls() Rufen Sie an. Rufen Sie zuletzt an Build() Methode zum Finalisieren des Generators und Erstellen der abgeschlossenen Fallanweisung für die Datenbankfunktion. Diese Anweisung kann dann direkt oder als Teil anderer Glide-Funktionsdefinitionen verwendet werden.

Erforderliche Rollen: Administrator, function_field_admin.

## GlideDBFunctionCaseBuilder -- GlideDBFunctionCaseBuilder() {#ariaid-title2}

Instanziiert ein GlideDBFunctionCaseBuilder-Objekt.
{#GlideDBFCB_O__table_zxm_3td_svb__entry__3}

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

{#GlideDBFCB_O__table_zxm_3td_svb}  
In diesem Beispiel wird ein GlideDBFunctionCaseBuilder-Objekt instanziiert.

    var caseBuilder = new GlideDBFunctionCaseBuilder();

## GlideDBFunctionCaseBuilder -- Build() {#ariaid-title3}

Schließt die Liste der Bedingungen ab und erstellt die endgültige FALLANWEISUNG.
{#GlideDBFCB-build__table_y1r_4ch_jbb__entry__3}

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

{#GlideDBFCB-build__table_y1r_4ch_jbb} {#GlideDBFCB-build__table_z1r_4ch_jbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die abgeschlossene Fallanweisung. |
[Tabelle : 3. Rückgaben]

{#GlideDBFCB-build__table_z1r_4ch_jbb}  
Das folgende Beispiel zeigt, wie Sie eine einfache Fallanweisung definieren und erstellen. Abhängig vom numerischen Wert des Auswirkungsfelds wird eine von vier verschiedenen Zeichenfolgen ausgegeben.

    const caseStatement = new GlideDBFunctionCaseBuilder()
        .whenCompare("impact", "'='", "'1'").then("'CRITICAL'")
        .whenCompare("impact", "'='", "'2'").then("'URGENT'")
        .whenCompare("impact", "'='", "'3'").then("'IMPORTANT'")
        .otherwise("'NOT IMPORTANT'")
        .build();

    const gr_incident = new GlideRecord("incident");
    gr_incident.addFunction(caseStatement);
    gr_incident.setLimit(10);
    gr_incident.query();
    while(gr_incident.next())  {
        gs.info("impact: {0}  case: {1}",
                [gr_incident.impact, gr_incident.getValue(caseStatement)]);
    }

Ausgabe:

    *** Script: impact: 2  case: URGENT
    *** Script: impact: 2  case: URGENT
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 2  case: URGENT
    *** Script: impact: 2  case: URGENT
    *** Script: impact: 3  case: IMPORTANT
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 3  case: IMPORTANT
    *** Script: impact: 3  case: IMPORTANT

## GlideDBFunctionCaseBuilder -- sonst(Zeichenfolge exp) {#ariaid-title4}

Optional. Nach mindestens einem Aufrufpaar an „When" und „dann" können Sie mit dem Aufruf „otherwise()" einen Wert angeben, der ausgegeben werden soll, wenn keiner der when-Ausdrücke erfüllt ist.
{#GDBFCB-otherwise_exp__table_nd4_ngf_xwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| verwendbar bis | Zeichenfolge | Auszugebender Wert. Kann eine Konstante, ein Verweis auf ein Feld oder eine andere Glide-Funktion sein. |
[Tabelle : 4. Parameter]

{#GDBFCB-otherwise_exp__table_nd4_ngf_xwb} {#GDBFCB-otherwise_exp__table_od4_ngf_xwb__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideDBFunctionCaseBuilder | Das Fluent-Generator-Objekt, um mit der Erstellung der Anweisung fortzufahren. |
[Tabelle : 5. Rückgaben]

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

    const caseStatement = new GlideDBCaseFunctionBuilder()
        .whenEqual("impact", "'1'").then("'CRITICAL'") 
        .whenEqual("impact", "'2'").then("category")
        .whenEqual("impact", "'3'").then("length(short_description)")
        .otherwise("'NOT IMPORTANT'")
        .build();

    const gr_incident = new GlideRecord("incident");
    gr_incident.addFunction(caseStatement);
    gr_incident.setLimit(10);
    gr_incident.query();
    while(gr_incident.next())  {
          gs.info("impact: {0}  case: {1}",
                  [gr_incident.impact, gr_incident.getValue(caseStatement)]);
    }

Ausgabe:

    *** Script: impact: 2  case: inquiry
    *** Script: impact: 2  case: Hardware
    *** Script: impact: 1  case:  CRITICAL
    *** Script: impact: 2  case: database
    *** Script: impact: 2  case: inquiry
    *** Script: impact: 3  case: 28
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 3  case: 17
    *** Script: impact: 3  case: 29

## GlideDBFunctionCaseBuilder -- then(String Exp) {#ariaid-title5}

Folgt einem Wenn() Methode, Dann() Ermöglicht Ihnen die Angabe eines auszugebenden Werts, wenn Wenn() Ausdruck ist zufrieden.
{#GDBFCB-then_exp__table_xmq_42f_xwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| verwendbar bis | Zeichenfolge | Auszugebender Wert. Kann eine Konstante, ein Verweis auf ein Feld oder eine andere Glide-Funktion sein. |
[Tabelle : 6. Parameter]

{#GDBFCB-then_exp__table_xmq_42f_xwb} {#GDBFCB-then_exp__table_ymq_42f_xwb__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideDBFunctionCaseBuilder | Das Fluent-Generator-Objekt, um mit der Erstellung der Anweisung fortzufahren. |
[Tabelle : 7. Rückgaben]

{#GDBFCB-then_exp__table_ymq_42f_xwb}  
Das folgende Beispiel zeigt, wie Sie eine einfache Fallanweisung definieren und erstellen. In diesem Fall wird Dann() Ausdrücke zeigen, wie Sie nicht nur Zeichenfolgen, sondern auch die Ergebnisse anderer Glide-Funktionen wie ausgeben können `Länge (short_description) `.

    const caseStatement = new GlideDBCaseFunctionBuilder()
        .whenEqual("impact", "'1'").then("'CRITICAL'") 
        .whenEqual("impact", "'2'").then("category")
        .whenEqual("impact", "'3'").then("length(short_description)")
        .otherwise("'NOT IMPORTANT'")
        .build();

    const gr_incident = new GlideRecord("incident");
    gr_incident.addFunction(caseStatement);
    gr_incident.setLimit(10);
    gr_incident.query();
    while(gr_incident.next())  {
          gs.info("impact: {0}  case: {1}",
                  [gr_incident.impact, gr_incident.getValue(caseStatement)]);
    }

Ausgabe:

    *** Script: impact: 2  case: inquiry
    *** Script: impact: 2  case: Hardware
    *** Script: impact: 1  case:  CRITICAL
    *** Script: impact: 2  case: database
    *** Script: impact: 2  case: inquiry
    *** Script: impact: 3  case: 28
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 3  case: 17
    *** Script: impact: 3  case: 29

## GlideDBFunctionCaseBuilder -- when(String Func) {#ariaid-title6}

Der vielseitigste der unterstützten „wenn"-Ausdrücke, der Wenn() Mit der Methode können Sie jede Glide-Funktion mit booleschem Wert als zu erfüllende Bedingung angeben.
{#GDBFCB-whenFunc__table_dmg_sy2_xwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| funktion | Zeichenfolge | Eine Glide-Funktion, die bei der Auswertung zu einem Ergebnis mit booleschen Werten führt. Mögliche Werte: * Glidefunktion:Vergleichen * Glidefunktion:und * Glidefunktion:oder {#GDBFCB-whenFunc__ul_zc1_zy2_xwb} |
[Tabelle : 8. Parameter]

{#GDBFCB-whenFunc__table_dmg_sy2_xwb} {#GDBFCB-whenFunc__table_emg_sy2_xwb__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideDBFunctionCaseBuilder | Das Objekt, um mit der Erstellung der Anweisung fortzufahren. |
[Tabelle : 9. Rückgaben]

{#GDBFCB-whenFunc__table_emg_sy2_xwb}  
Das folgende Beispiel zeigt, wie Sie eine einfache Fallanweisung definieren und erstellen. In diesem Fall wird Wenn() Die Methode wird verwendet, um komplexere Vergleichsausdrücke anzugeben. Wenn der Ausdruck als „wahr" ausgewertet wird, wird die entsprechende Zeichenfolge zurückgegeben.

    const caseStatement = new GlideDBFunctionCaseBuilder() 
        // if impact == 1 AND category == 'Software' then output "CRITICAL SOFTWARE" 
        .when("and(compare(impact, '=', '1'), compare(category, '=',  
    'Software')") 
            .then("'CRITICAL SOFTWARE'") 
        // if impact == 1 then output "CRITICAL OTHER" 
        .when("compare(impact, '=', '1')") 
            .then("'CRITICAL OTHER'") 
        // if impact == 2 OR category == 'Software' then output "URGENT" 
        .when("or(compare(impact, '=', '2'), compare(category, '=', 'Software')") 
            .then("'URGENT'") 
        // If none of the above expressions are true, output "NOT IMPORTANT" 
        .otherwise("'NOT IMPORTANT'") 
        .build(); 
     
    const gr_incident = new GlideRecord("incident");
    gr_incident.addFunction(caseStatement); 
    gr_incident.setLimit(20); 
    gr_incident.query(); 
    while(gr_incident.next())  { 
          gs.info("impact: {0}  category: {1}  case: {2}", 
                [gr_incident.impact, gr_incident.category, gr_incident.getValue(caseStatement)]); 
    }

Ausgabe:

    impact: 2  category: inquiry  case: URGENT
    impact: 2  category: Hardware  case: URGENT
    impact: 1  category: inquiry  case:  CRITICAL OTHER
    impact: 2  category: database  case: URGENT
    impact: 2  category: inquiry  case: URGENT
    impact: 3  category: software  case: URGENT
    impact: 1  category: inquiry  case: CRITICAL OTHER
    impact: 1  category: inquiry  case: CRITICAL OTHER
    impact: 3  category: inquiry  case: NOT IMPORTANT
    impact: 3  category: inquiry  case: NOT IMPORTANT
    impact: 3  category: hardware  case: NOT IMPORTANT
    impact: 3  category: inquiry  case: NOT IMPORTANT
    impact: 3  category: hardware  case: NOT IMPORTANT
    impact: 3  category: inquiry  case: NOT IMPORTANT
    impact: 1  category: inquiry  case: CRITICAL OTHER
    impact: 1  category: software  case: CRITICAL SOFTWARE
    impact: 3  category: inquiry  case: NOT IMPORTANT
    impact: 3  category: inquiry  case: NOT IMPORTANT
    impact: 2  category: software  case: URGENT
    impact: 1  category: software  case: CRITICAL SOFTWARE

## GlideDBFunctionCaseBuilder -- WhatCompare(Zeichenfolge exp1, Zeichenfolge op, Zeichenfolge exp2) {#ariaid-title7}

Startet eine Vergleichsfallbedingung.
{#GlideDBFCB-whenCompare_S_S_S__table_jj1_2q2_xwb__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 | Vergleichsoperator, umgeben von Anführungszeichen. Gültige Werte: * "'='" * "'\<'" * "'\>'" * "'\<='" * "'\>='" {#GlideDBFCB-whenCompare_S_S_S__ul_gpp_br2_xwb} |
| exp2 | Zeichenfolge | Rechter Vergleichsausdruck. Kann eine Konstante, ein Verweis auf ein Feld oder eine andere Glide-Funktion sein. |
[Tabelle : 10. Parameter]

{#GlideDBFCB-whenCompare_S_S_S__table_jj1_2q2_xwb} {#GlideDBFCB-whenCompare_S_S_S__table_kj1_2q2_xwb__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideDBFunctionCaseBuilder | Das Funktionsgeneratorobjekt zum Fortsetzen der Erstellung der Anweisung. |
[Tabelle : 11. Rückgaben]

{#GlideDBFCB-whenCompare_S_S_S__table_kj1_2q2_xwb}  
Das folgende Beispiel zeigt, wie Sie eine einfache Fallanweisung definieren und erstellen. In diesem Fall wird Who Vergleichen() Die Methode wird verwendet, um den Wert des Auswirkungsfelds mit einer Zahl zu vergleichen und eine angegebene Zeichenfolge auszugeben, wenn sie übereinstimmen.

    const caseStatement = new GlideDBFunctionCaseBuilder()
        .whenCompare("impact", "'='", "'1'").then("'CRITICAL'")
        .whenCompare("impact", "'='", "'2'").then("URGENT")
        .whenCompare("impact", "'='", "'3'").then("IMPORTANT")
        .otherwise("'NOT IMPORTANT'")
        .build();

    const gr_incident = new GlideRecord("incident");
    gr_incident.addFunction(caseStatement);
    gr_incident.setLimit(10);
    gr_incident.query();
    while(gr_incident.next()) {
        gs.info("impact: {0} case: {1}",
                [gr_incident.impact, gr_incident.getValue(caseStatement)]);
    }

Ausgabe:

    *** Script: impact: 2  case: URGENT
    *** Script: impact: 2  case: URGENT
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 2  case: URGENT
    *** Script: impact: 2  case: URGENT
    *** Script: impact: 3  case: IMPORTANT
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 3  case: IMPORTANT
    *** Script: impact: 3  case: IMPORTANT

## GlideDBFunctionCaseBuilder -- WhiEqual(Zeichenfolge exp1, Zeichenfolge exp2) {#ariaid-title8}

Ähnlich Who Vergleichen() , Wehengleich() Ist eine praktische Methode zum Überprüfen der Gleichheit. Entspricht Who Compare(leftExpression, „=", rightExpression) .
{#GDBCFB-whenEqual__table_hcb_2w2_xwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| exp1 | Zeichenfolge | Linker Vergleichsausdruck. Kann eine Konstante, ein Verweis auf ein Feld oder eine andere Glide-Funktion sein. |
| exp2 | Zeichenfolge | Rechter Vergleichsausdruck. Kann eine Konstante, ein Verweis auf ein Feld oder eine andere Glide-Funktion sein. |
[Tabelle : 12. Parameter]

{#GDBCFB-whenEqual__table_hcb_2w2_xwb} {#GDBCFB-whenEqual__table_icb_2w2_xwb__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideDBFunctionCaseBuilder | Das Funktionsgeneratorobjekt zum Fortsetzen der Erstellung der Anweisung. |
[Tabelle : 13. Rückgaben]

{#GDBCFB-whenEqual__table_icb_2w2_xwb}  
Das folgende Beispiel zeigt, wie Sie eine einfache Fallanweisung definieren und erstellen. In diesem Fall wird Wehengleich() Die Methode wird verwendet, um den Wert des Auswirkungsfelds mit einer Zahl zu vergleichen und eine angegebene Zeichenfolge auszugeben, wenn sie übereinstimmen.

    const caseStatement = new GlideDBFunctionCaseBuilder()
        .whenEqual("impact", "'1'").then("'CRITICAL'")
        .whenEqual("impact", "'2'").then("'URGENT'")
        .whenEqual("impact", "'3'").then("'IMPORTANT'")
        .otherwise("'NOT IMPORTANT'")
        .build();

    const gr_incident = new GlideRecord("incident");
    gr_incident.addFunction(caseStatement);
    gr_incident.setLimit(10);
    gr_incident.query();
    while(gr_incident.next())  {
        gs.info("impact: {0}  case: {1}",
                [gr_incident.impact, gr_incident.getValue(caseStatement)]);
    }

Ausgabe:

    *** Script: impact: 2  case: URGENT
    *** Script: impact: 2  case: URGENT
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 2  case: URGENT
    *** Script: impact: 2  case: URGENT
    *** Script: impact: 3  case: IMPORTANT
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 1  case: CRITICAL
    *** Script: impact: 3  case: IMPORTANT
    *** Script: impact: 3  case: IMPORTANT


