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


---

# Skript-Debugger-API

# Skript-Debugger-API {#ariaid-title1}

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

Die Skript-Debugger Die API stellt Endpunkte zum Debuggen von Zeilen von serverseitigem JavaScript-Code bereit, z. B. Business-Regeln und Skripteinbindungen.
Weitere Informationen zum Skript-Debugger finden Sie unter [Skript-Debugger und Sitzungsprotokoll](https://www.servicenow.com/docs/access?context=script-debugger&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US).

Diese API ist standardmäßig verfügbar.

## Skript-Debugger -- /js/debugpoints/script/{tableName}/{sysId}/{fieldName} ABRUFEN {#ariaid-title2}

Ruft eine Liste von Haltepunkten oder Protokollierungspunkten in einem serverseitigen Skript ab, z. B. einer Business-Regel oder Skripteinbindung.

### URL-Format

Standard-URL: /api/now/js/debugpoints/script/{tableName}/{sysId}/{fieldName}

### Unterstützte Anforderungsparameter

{#scriptdebugger-GET-debugpoints__entry__2}

| Name | Beschreibung |
|-|-|
| tableName | Name der Tabelle, die das serverseitige Skript enthält, z. B. sys_script oder sys_script_include. Datentyp: Zeichenfolge |
| Sys-ID | SYS_ID für das serverseitige Skript. Datentyp: Zeichenfolge |
| fieldName | Name des Felds, das den serverseitigen Skriptinhalt enthält. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#scriptdebugger-GET-debugpoints__entry__10}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Abfrageparameter]

{#scriptdebugger-GET-debugpoints__entry__14}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#scriptdebugger-GET-debugpoints__entry__18}{#scriptdebugger-GET-debugpoints__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

{#scriptdebugger-GET-debugpoints__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#scriptdebugger-GET-debugpoints__entry__26}{#scriptdebugger-GET-debugpoints__entry-200-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 403 | Anwender nicht autorisiert. Der Anwender, der die Anforderung ausgeführt hat, hat keine Berechtigung zum Zugriff auf Haltepunkt- oder Protokollpunktinformationen für den angegebenen Datensatz. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#scriptdebugger-GET-debugpoints__entry__32}

| Name | Beschreibung |
|-|-|
| canWrite | Kennzeichnung, die angibt, ob der derzeit angemeldete Anwender Haltepunkte für das Skript festlegen oder ändern kann. Mögliche Werte: * Wahr: Sie können Haltepunkte festlegen oder ändern. * Falsch: Haltepunkte können nicht festgelegt oder geändert werden. {#scriptdebugger-GET-debugpoints__ul_slg_d55_j4b} Datentyp: Boolescher Wert |
| Debugpunkte | Liste aller Haltepunkte und Protokollpunkte im Skript. "debugpoints": { "breakpoint": {Object} "logpoint": {Object} } Datentyp: Objekt |
| debugpoints.breakpoint | Liste aller Haltepunkte im Skript, dargestellt als Schlüssel-Wert-Paare. Der Schlüssel ist die Zeilennummer für den Haltepunkt. Der Wert ist ein Objekt, das die sys_ID und den Text des Haltepunkts enthält. "breakpoint": { <line_number>: {Object} } Datentyp: Objekt |
| debugpoints.breakpoint.\<line_number\> | Zeilennummer für den Haltepunkt. <line_number>: { "evaluationString": "String" "sysId": "String" } Datentyp: Objekt |
| debugpoints.breakpoint.\<line_number\>.evaluationZeichenfolge | Text des Haltepunkts. Wenn der Haltepunkt bedingt ist, enthält die evaluationString den Bedingungstext. Wenn der Haltepunkt nicht bedingt ist, ist die evaluationString eine leere Zeichenfolge. Datentyp: Zeichenfolge |
| debugpoints.breakpoint.\<line_number\>.sysId | SYS_ID des Haltepunkts. Datentyp: Zeichenfolge |
| Debugpoints.Protokollpunkt | Liste aller Protokollpunkte im Skript, dargestellt als Schlüssel-Wert-Paare. Der Schlüssel ist die Zeilennummer für den Protokollpunkt. Der Wert ist ein Objekt, das die sys_ID und den Text des Protokollpunkts enthält. "logpoint": { <line_number>: {Object} } Datentyp: Objekt |
| Debugpoints.Protokollpunkt.\<line_number\> | Zeilennummer für den Protokollierungspunkt. <line_number>: { "evaluationString": "String" "sysId": "String" } Datentyp: Objekt |
| Debugpoints.logpoint.\<line_number\>.evaluationZeichenfolge | Text des Protokollierungspunkts. Enthält die protokollierte Nachricht. Datentyp: Zeichenfolge |
| Debugpoints.logpoint.\<line_number\>.sysId | SYS_ID des Protokollpunkts. Datentyp: Zeichenfolge |
| key | Objekt, das Details zum Debugging-Skript bereitstellt. "key": { "scriptField": "String" "scriptId": "String" "scriptType": "String" "value": "String" } Datentyp: Objekt |
| Key.scriptFeld | Name des Felds, das das Skript enthält. Datentyp: Zeichenfolge |
| Key.scriptId | SYS_ID des Skripts. Datentyp: Zeichenfolge |
| Key.scriptType | Name der Tabelle, die das Skript enthält. Datentyp: Zeichenfolge |
| Schlüssel.Wert | Die Pfadparameter, die zum Erstellen der Anforderung verwendet werden. In der folgenden Reihenfolge aufgeführt. * tableName * Sys-ID * fieldName {#scriptdebugger-GET-debugpoints__ul_vhk_5w5_j4b} Datentyp: Zeichenfolge |
| name | Name des Skripts. Datentyp: Zeichenfolge |
| Skript | Text, der den Code des Skripts anzeigt. Datentyp: Zeichenfolge |
[ ]

### Beispiel für eine Curl-Anforderung {#scriptdebugger-GET-debugpoints__section_vb2_yny_jlb}

### Curl-Anforderung

Ruft eine Liste von Protokollierungspunkten und Haltepunkten für ein serverseitiges Skript ab. Dieses Skript hat einen Protokollpunkt in Zeile 2, einen Haltepunkt in Zeile 11 und einen bedingten Haltepunkt in Zeile 18.

    curl "https://instance.servicenow.com/api/now/js/debugpoints/script/sys_script_include/d65f78c40a0a0b6900196656f35913d3/script" \
    --request GET \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --user 'username':'password'

    {
      "result": {
        "canWrite": true,
        "debugpoints": {
          "LOGPOINT": {
            "2": {
              "evaluationString": "A log message",
              "sysId": "ba28b0fa739310101c233096fbf6a75e"
            }
          },
          "BREAKPOINT": {
            "11": {
              "evaluationString": "",
              "sysId": "dc5f5bf341256010f877587fbdf5ec1d"
            },
            "18": {
              "evaluationString": "a == true",
              "sysId": "3d4f5bf341256010f877587bdf5ecf6"
            }
          }
        },
        "script": "// script code",
        "name": "AbstractAjaxProcessor",
        "key": {
          "scriptType": "sys_script_include",
          "scriptId": "d65f78c40a0a0b6900196656f35913d3",
          "scriptField": "script",
          "value": "sys_script_include.d65f78c40a0a0b6900196656f35913d3.script"
        }
      }
    }

## Skript-Debugger -- POST js/Debugpoints/Process {#ariaid-title3}

Fügen Sie Haltepunkte oder Protokollpunkte in einem serverseitigen Skript hinzu, aktualisieren oder entfernen Sie sie, z. B. eine Business-Regel oder eine Skripteinbindung. Verarbeiten Sie mehrere Haltepunkte oder Protokollpunkte gleichzeitig.

### URL-Format

Standard-URL: /api/now/js/debugpoints/Process

### Unterstützte Anforderungsparameter

{#scriptdebugger-POST-debugpoints__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Pfad-Parameter]

{#scriptdebugger-POST-debugpoints__entry__6}

| Name | Beschreibung |
|-|-|
| FetchAll | Bei „wahr" wird eine Liste aller Haltepunkte oder Protokollpunkte zurückgegeben, die vom Anwender hinzugefügt oder aktualisiert wurden. Datentyp: Boolescher Wert Standard: Falsch |
| Ruft AllFilter ab | Gibt eine gefilterte Liste aller Haltepunkte oder Protokollpunkte zurück, die vom Anwender hinzugefügt oder aktualisiert wurden. Gültige Werte: * DebugpointType. Legen Sie entweder auf Haltepunkt oder Protokollierungspunkt fest. * SkriptId. Legen Sie die sys_ID des Skripts fest, in dem nach Debug-Punkten gesucht werden soll. * Umfang. Legen Sie den Namen des Bereichs fest, in dem nach Debug-Punkten gesucht werden soll. {#scriptdebugger-POST-debugpoints__ul_mly_xng_l4b} Verwenden Sie das Caret-Symbol (\^) als Trennzeichen für mehrere Eigenschaften. Beispiel: `FetchAllFilter=debugpointType=logpoint^scope=MyApp ` Datentyp: Zeichenfolge |
[Tabelle : 8. Abfrageparameter]

{#scriptdebugger-POST-debugpoints__entry__12}

| Name | Beschreibung |
|-|-|
| DebugpointType | Erforderlich. Typ des Debug-Punkts, der hinzugefügt, gelöscht oder aktualisiert werden soll. Gültige Werte: * Haltepunkt * Protokollierungspunkt {#scriptdebugger-POST-debugpoints__ul_jgf_rpg_l4b} Datentyp: Zeichenfolge |
| EvaluationZeichenfolge | Text für einen Protokollpunkt oder bedingten Haltepunkt. Für einen Protokollierungspunkt: evaluationStringIst die Protokollnachricht. Für einen bedingten Haltepunkt evaluationStringIst die Bedingung. Wenn Sie beispielsweise eine Liste von Anwender-IDs durchlaufen und den Debugger nur anhalten möchten, wenn die Anwender-ID 38493 lautet, können Sie einen bedingten Haltepunkt innerhalb der Schleife mit hinzufügen `Anwender-ID == 38493 `Als Bedingung. Der Debugger wird nur an diesem Haltepunkt angehalten, wenn die Bedingung „wahr" ist. Wenn der Haltepunkt kein bedingter Haltepunkt ist, wird evaluationStringIst eine leere Zeichenfolge. Datentyp: Zeichenfolge |
| fieldName | Erforderlich. Name des Felds, das den serverseitigen Skriptinhalt enthält. Datentyp: Zeichenfolge |
| Zeilennummer | Zeilennummer im serverseitigen Skript, die angibt, wo der Haltepunkt oder Protokollpunkt hinzugefügt, gelöscht oder aktualisiert werden soll. Datentyp: Zahl |
| operation | Erforderlich. Vorgang, der für den Haltepunkt oder Protokollpunkt ausgeführt werden soll. Gültige Werte: * Hinzufügen * löschen * Aktualisieren {#scriptdebugger-POST-debugpoints__ul_yrc_qrg_l4b} Datentyp: Zeichenfolge |
| SkriptId | Erforderlich. SYS_ID für das serverseitige Skript. Datentyp: Zeichenfolge |
| tableName | Erforderlich. Name der Tabelle, die das serverseitige Skript enthält, z. B. sys_script oder sys_script_include. Datentyp: Zeichenfolge |
[Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#scriptdebugger-POST-debugpoints__entry__28}{#scriptdebugger-POST-debugpoints__accept-RESTAPI}{#scriptdebugger-POST-debugpoints__content_type-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen.]

{#scriptdebugger-POST-debugpoints__entry__34}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#scriptdebugger-POST-debugpoints__entry__38}{#scriptdebugger-POST-debugpoints__entry-200-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#scriptdebugger-POST-debugpoints__entry__42}

| Name | Beschreibung |
|-|-|
| AngefordertDebugpoints | Liste der angeforderten Haltepunkte und Protokollpunkte. Wird als Array von Objekten angezeigt. "requestedDebugpoints": [ { "scriptId": "String", "evaluationString": "String", "operation": "String", "tableName": "String", "fieldName": "String", "status": "String", "lineNumber": Number, "debugpointType": "String" } ] Datentyp: Array |
| AnfordertDebugpoints.SkriptId | SYS_ID für das serverseitige Skript. Datentyp: Zeichenfolge |
| AnfordertDebugpoints.evaluationZeichenfolge | Text für einen Protokollpunkt oder bedingten Haltepunkt hinzugefügt. Für einen Protokollierungspunkt: evaluationStringIst die Protokollnachricht. Für einen bedingten Haltepunkt evaluationStringIst die Bedingung. Datentyp: Zeichenfolge |
| AnfordertDebugpoints.Vorgang | Vorgang, der für den Haltepunkt oder Protokollpunkt ausgeführt wird. Mögliche Werte: * Hinzufügen * löschen * Aktualisieren {#scriptdebugger-POST-debugpoints__ul_gb4_nhl_l4b} Datentyp: Zeichenfolge |
| AnfordertDebugpoints.tableName | Name der Tabelle, die das serverseitige Skript enthält, z. B. sys_script oder sys_script_include. Datentyp: Zeichenfolge |
| AnfordertDebugpoints.fieldName | Name des Felds, das den serverseitigen Skriptinhalt enthält. Datentyp: Zeichenfolge |
| AnfordertDebugpoints.Status | Ergebnis der Anweisung zum Hinzufügen, Löschen oder Aktualisieren eines bestimmten Haltepunkts oder Protokollpunkts. Mögliche Werte: * Fehler * ignored * Erfolg {#scriptdebugger-POST-debugpoints__ul_env_phl_l4b} Eine Anforderung zum Hinzufügen, Löschen oder Aktualisieren eines Debug-Punkts wird in den folgenden Situationen ignoriert: * Fordert das Löschen eines Haltepunkts oder Protokollierungspunkts an, der nicht vorhanden ist. * Fordert das Hinzufügen eines Haltepunkts oder Protokollierungspunkts an, der mit einem bereits vorhandenen Haltepunkt identisch ist. {#scriptdebugger-POST-debugpoints__ul_zyq_cjx_r4b} Datentyp: Zeichenfolge |
| AnfordertDebugpoints.lineNumber | Zeilennummer im serverseitigen Skript, die angibt, wo der Haltepunkt oder Protokollpunkt hinzugefügt, gelöscht oder aktualisiert wurde. Datentyp: Zahl |
| requestedDebugpoints.debugpointType | Typ des hinzugefügten, gelöschten oder aktualisierten Debug-Punkts. Mögliche Werte: * Haltepunkt * Protokollierungspunkt {#scriptdebugger-POST-debugpoints__ul_j3x_33l_l4b} Datentyp: Zeichenfolge |
| Status | Ergebnis der Gesamtaktion. Der Statuscode für den HTTP-Aufruf. Datentyp: Zahl |
[ ]

### Curl-Anforderung

In diesem Beispiel wird ein bedingter Haltepunkt in Zeile 12 im Skript hinzugefügt.

    curl "https://instance.servicenow.com/api/now/js/debugpoints/process" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "[
    {
    \"tableName\": \"sys_script_include\",
    \"scriptId\": \"d65f78c40a0a0b6900196656f35913d3\",
    \"fieldname\": \"script\",
    \"lineNumber\": 12,
    \"evaluationString\": \"a == false\",
    \"debugpointType\": \"breakpoint\",
    \"operation\": \"add\"
    }
    ]" \
    --user 'username':'password'

    {
      "result": {
        "requestedDebugpoints": [
          {
            "scriptId": "d65f78c40a0a0b6900196656f35913d3",
            "evaluationString": "a == false",
            "operation": "add",
            "tableName": "sys_script_include",
            "fieldName": "script",
            "status": "success",
            "lineNumber": 12,
            "debugpointType": "breakpoint"
          }
        ],
        "status": 200
      }
    }


