---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Workflow -- bereichsbezogen

# Workflow -- bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die bereichsbezogene Workflow -API stellt Methoden bereit, die in einem Aktivitätsdefinitionsskript verwendet werden können.

Es gibt keine Konstruktoren zum Erstellen einer Instanz eines bereichsbezogenen Workflow-Objekts. Verwenden Sie stattdessen das globale Objekt workflow, das in Aktivitätsskripts verfügbar ist. Dieses Workflow-Objekt ist an einem beliebigen Ort innerhalb eines Workflows verfügbar.

## Scoped Workflow -- debug(String message, Object args) {#ariaid-title2}

Fügt dem Protokoll eine Debug-Meldung hinzu.
{#r_SWF-debug_S_O__table_q3h_rqz_lt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Die dem Protokoll hinzuzufügende Nachricht. |
| args | Objekt | Die der Nachricht hinzuzufügenden Argumente. |
[Tabelle : 1. Parameter]

{#r_SWF-debug_S_O__table_q3h_rqz_lt} {#r_SWF-debug_S_O__table_r3h_rqz_lt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die dem Protokoll hinzugefügte Nachricht. |
[Tabelle : 2. Ergebnisse]

{#r_SWF-debug_S_O__table_r3h_rqz_lt}  

    var loggedMessage = workflow.debug("All is well");

## Scoped Workflow -- error(String message, Object args) {#ariaid-title3}

Fügt dem Protokoll eine Fehlermeldung hinzu.
{#r_SWF-error_S_O__table_ttc_2rz_lt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Die dem Protokoll hinzuzufügende Nachricht. |
| args | Objekt | Die der Nachricht hinzuzufügenden Argumente. |
[Tabelle : 3. Parameter]

{#r_SWF-error_S_O__table_ttc_2rz_lt} {#r_SWF-error_S_O__table_utc_2rz_lt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die protokollierte Meldung |
[Tabelle : 4. Ergebnisse]

{#r_SWF-error_S_O__table_utc_2rz_lt}  

    var loggedMessage = workflow.error("An error has occurred. ");

## Scoped Workflow -- getVariable(String name) {#ariaid-title4}

Gibt den Wert der angegebenen Variablen zurück.
{#r_SWF-getVariable_S__table_rsb_psz_lt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Der Name der Variable. |
[Tabelle : 5. Parameter]

{#r_SWF-getVariable_S__table_rsb_psz_lt} {#r_SWF-getVariable_S__table_ssb_psz_lt__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Der Wert der Variablen |
[Tabelle : 6. Ergebnisse]

{#r_SWF-getVariable_S__table_ssb_psz_lt}  

    var value = workflow.getVariable("task");

## Scoped Workflow -- info(String message, Object args) {#ariaid-title5}

Fügt dem Protokoll eine Informationsnachricht hinzu.
{#r_SWF-info_S_O__table_rz5_1qz_lt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Die dem Protokoll hinzuzufügende Nachricht. |
| args | Objekt | Die der Nachricht hinzuzufügenden Argumente. |
[Tabelle : 7. Parameter]

{#r_SWF-info_S_O__table_rz5_1qz_lt} {#r_SWF-info_S_O__table_sz5_1qz_lt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die Nachricht, die protokolliert wird. |
[Tabelle : 8. Ergebnisse]

{#r_SWF-info_S_O__table_sz5_1qz_lt}  

    var loggedMessage = workflow.info("All is well");

## Bereichsbezogener Workflow -- Eingaben {#ariaid-title6}

Objekt, das die Workflow-Variablen enthält.
Dies ist keine Methode, sondern eine Möglichkeit, auf die Variablen in einem Workflow-Objekt, z. B. den Benutzer, zu verweisen. Workflow-Variablen werden in den Eigenschaften des Workflows oder durch geskriptete Aktivitäten definiert.
{#SWF-inputs__table_ry3_4h1_qfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| inputs | Objekt | Workflow-Variablen als Name-Wert-Paare. Die Variablen eines Workflow-Objekts sind an die Implementierung eines Integrators angepasst. |
[Tabelle : 9. Feld]

{#SWF-inputs__table_ry3_4h1_qfb}  

    var user = workflow.inputs.u_user;

## Scoped Workflow -- name() {#ariaid-title7}

Gibt den Workflow-Namen zurück.
{#r_SWF-name__table_wm2_spz_lt__entry__3}

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

{#r_SWF-name__table_wm2_spz_lt} {#r_SWF-name__table_xm2_spz_lt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Workflow-Name |
[Tabelle : 11. Ergebnisse]

{#r_SWF-name__table_xm2_spz_lt}  

    var name = workflow.name();

## Scoped Workflow -- removeVariable(String name) {#ariaid-title8}

Entfernt die angegebene Variable aus dem Workflow.
{#r_SWF-removeVariable_S__table_d2r_ysz_lt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Der Name der Variable. |
[Tabelle : 12. Parameter]

{#r_SWF-removeVariable_S__table_d2r_ysz_lt} {#r_SWF-removeVariable_S__table_e2r_ysz_lt__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 13. Ergebnisse]

{#r_SWF-removeVariable_S__table_e2r_ysz_lt}  

    var value = workflow.removeVariable("task");

## Bereichsbezogener Workflow -- Ergebnis {#ariaid-title9}

Element des Workflow-Objekts, das die Workflow-Ergebnisse enthält.
Dies ist keine Methode, sondern das Element im Workflow-Objekt, das die Ergebnisse eines Workflows enthält.
{#SWF-result__table_grb_p31_qfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| result | Zeichenfolge | Workflow-Ergebnisse. |
[Tabelle : 14. Feld]

{#SWF-result__table_grb_p31_qfb}  

    var wfResult = workflow.result;

## Scoped Workflow -- scratchpad() {#ariaid-title10}

Gibt das Notizblock-Objekt des Workflows zurück.
{#r_SWF-scratchpad__table_tfn_hpz_lt__entry__3}

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

{#r_SWF-scratchpad__table_tfn_hpz_lt} {#r_SWF-scratchpad__table_ufn_hpz_lt__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Das Notizblock-Objekt. |
[Tabelle : 16. Ergebnisse]

{#r_SWF-scratchpad__table_ufn_hpz_lt}  

    var scratchpad = workflow.scratchpad();

## Scoped Workflow -- setResult(String result) {#ariaid-title11}

Legt das Ergebnis des Workflows fest.
{#r_SWF-setResult_S__table_zvp_stz_lt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| result | Zeichenfolge | Das Ergebnis des Workflows |
[Tabelle : 17. Parameter]

{#r_SWF-setResult_S__table_zvp_stz_lt} {#r_SWF-setResult_S__table_awp_stz_lt__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 18. Ergebnisse]

{#r_SWF-setResult_S__table_awp_stz_lt}  

    workflow.setResult("Success");

## Scoped Workflow -- setVariable(String name, Object value) {#ariaid-title12}

Setzt die angegebene Variable auf den angegebenen Wert.
{#r_SWF-setVariable_S_O__table_spj_2sz_lt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Der Name der Variable. |
| Wert | Objekt | Der Wert, der der Variablen zugewiesen werden soll. |
[Tabelle : 19. Parameter]

{#r_SWF-setVariable_S_O__table_spj_2sz_lt} {#r_SWF-setVariable_S_O__table_tpj_2sz_lt__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 20. Ergebnisse]

{#r_SWF-setVariable_S_O__table_tpj_2sz_lt}  

    workflow.setVariable("task", "terrible");

## Scoped Workflow -- warn(String message, Object args) {#ariaid-title13}

Fügt dem Protokoll eine Warnmeldung hinzu.
{#r_SWF-warn_S_O__table_gxm_qrz_lt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Die dem Protokoll hinzuzufügende Nachricht. |
| args | Objekt | Die der Nachricht hinzuzufügenden Argumente. |
[Tabelle : 21. Parameter]

{#r_SWF-warn_S_O__table_gxm_qrz_lt} {#r_SWF-warn_S_O__table_hxm_qrz_lt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die protokollierte Meldung |
[Tabelle : 22. Ergebnisse]

{#r_SWF-warn_S_O__table_hxm_qrz_lt}  

    var loggedMessage = workflow.warn("Check your permissions.");