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


---

# WFActivityHandler -- Global

# WFActivityHandler -- Global {#ariaid-title1}

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

Die WFActivityHandler Die Skripteinbindung ist die Basisklasse für alle Workflow-Aktivitäten.

Als Basisklasse für alle Workflow-Aktivitäten wird dieser Code immer als Teil einer Aktivität ausgeführt.

Wenn Sie Ihre eigenen Workflow-Aktivitäten entwickeln, erstellen Sie Ihr Skriptobjekt, indem Sie von dieser Klasse ableiten und nach Bedarf Methoden überschreiben, um die gewünschte Funktionalität zu erhalten. Client-Code muss die Methode überschreiben OnExecute() Dient zum Durchführen einer sinnvollen Aktivitätsverarbeitung.

## WFActivityHandler -- Debuggen (Zeichenfolgennachricht , Zeichenfolgenargumente ) {#ariaid-title2}

Protokolliert eine Debug-Nachricht.
{#r_WFAH-debug_S_S__table_xdr_nf5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die an das Protokoll gesendet werden soll. |
| args | Zeichenfolge | Zeichenfolge, die an das Protokoll gesendet werden soll |
[Tabelle : 1. Parameter]

{#r_WFAH-debug_S_S__table_xdr_nf5_4t} {#r_WFAH-debug_S_S__table_ydr_nf5_4t__entry__2}

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

{#r_WFAH-debug_S_S__table_ydr_nf5_4t}

## WFActivityHandler -- Debuggen (Zeichenfolgennachricht , Array- Argumente) {#ariaid-title3}

Protokolliert eine Debug-Nachricht.
{#r_WFAH-debug_S_A__table_bv2_sh5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die an das Protokoll gesendet werden soll. |
| args | Array | Array von Werten, die an das Protokoll gesendet werden sollen |
[Tabelle : 3. Parameter]

{#r_WFAH-debug_S_A__table_bv2_sh5_4t} {#r_WFAH-debug_S_A__table_cv2_sh5_4t__entry__2}

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

{#r_WFAH-debug_S_A__table_cv2_sh5_4t}

## WFActivityHandler -- generieren (Zeichenfolge activityId, Zeichenfolgenreihenfolge , GlideDateTime startAtDspValue, boolescher Wert noCreateFlag) {#ariaid-title4}

Generiert Genehmigungen und Aufgaben, bevor die Aktivität ausgeführt wird, um eine Vorschau der bevorstehenden Arbeit zu erhalten.
Aktiviert das Generieren von Objekten zu Beginn eines Workflows in einem Ausstehend status. Weitere Informationen finden Sie unter [Generieren Sie eine Workflow-Aktivität](https://www.servicenow.com/docs/access?context=r_Generate&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US).
{#r_WFAH-generate_S_S_GDT_B__table_dv2_sh5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| activityId | Zeichenfolge | SYS_ID dieser laufenden Aktivität. Tabelle: Workflow-Aktivitäten \[wf_activity\] |
| Reihenfolge | Zeichenfolge | Auftragsnummer, die der Aufgabe oder Genehmigung zugeordnet ist. |
| StartAtDspValue | Zeichenfolge | Startzeit für die Aufgabe oder Genehmigung in [GlideDateTime](https://servicenow-prod.fluidtopics.net/06uArjt1kBC7EBQnhtMPyQ#c_GlideDateTimeAPI "Die GlideDateTime Die Klasse stellt Methoden zum Ausführen von Vorgängen für GlideDateTime-Objekte bereit.")Format. |
| Kennzeichnung für „noCreate" | Boolean | Kennzeichnung, die angibt, ob die Erstellung eines Genehmigungsdatensatzes übersprungen werden soll. Gültige Werte: * Wahr: Erstellen Sie keinen Genehmigungsdatensatz. * Falsch: Erstellen Sie einen Genehmigungsdatensatz. {#r_WFAH-generate_S_S_GDT_B__ul_cbr_ds4_f4b} Standard: Wahr |
[Tabelle : 5. Parameter]

{#r_WFAH-generate_S_S_GDT_B__table_dv2_sh5_4t} {#r_WFAH-generate_S_S_GDT_B__table_ev2_sh5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Vorgenerierungsobjekt im Workflow-Scratchpad gespeichert. Das Objekt kann beispielsweise ein Array von Genehmigungs-IDs sein. Wenn die Aktivität ausführt Bei Ausführung Funktion, kann das Objekt vor der Generierung anfordern, um eine der folgenden Bedingungen zu bestimmen: * Genehmigungen wurden bereits mit einem Status „Ausstehend" erstellt. * Die Aktivität muss die Genehmigungen mit erstellen Bei Ausführung Funktion. {#r_WFAH-generate_S_S_GDT_B__ul_u13_mdp_f4b} |
[Tabelle : 6. Rückgaben]

{#r_WFAH-generate_S_S_GDT_B__table_ev2_sh5_4t}

## WFActivityHandler -- Info (Zeichenfolgennachricht , Zeichenfolgenargumente ) {#ariaid-title5}

Protokolliert eine Informationsnachricht.
{#r_WFAH-info_S_S__table_pdr_nf5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die an das Protokoll gesendet werden soll. |
| args | Zeichenfolge | Zeichenfolge, die an das Protokoll gesendet werden soll. |
[Tabelle : 7. Parameter]

{#r_WFAH-info_S_S__table_pdr_nf5_4t} {#r_WFAH-info_S_S__table_qdr_nf5_4t__entry__2}

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

{#r_WFAH-info_S_S__table_qdr_nf5_4t}

## WFActivityHandler -- Info (Zeichenfolgennachricht , Array- Argumente) {#ariaid-title6}

Protokolliert eine Informationsnachricht.
{#r_WFAH-info_S_A__table_rdr_nf5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die an das Protokoll gesendet werden soll. |
| args | Array | Array von Werten, die an das Protokoll gesendet werden sollen |
[Tabelle : 9. Parameter]

{#r_WFAH-info_S_A__table_rdr_nf5_4t} {#r_WFAH-info_S_A__table_qdr_nf5_4t__entry__2}

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

{#r_WFAH-info_S_A__table_qdr_nf5_4t}

## WFActivityHandler -- js(String str) {#ariaid-title7}

Wertet Aktivitätsvariablen im Skript aus.
Wird verwendet, um Zeichenfolgen auszuwerten, die el enthalten, z. B. `${some script} `Oder Zeichenfolgen, die mit beginnen `javascript: `. Sehen Sie sich fast alle vorhandenen Aktivitäten an, z. B. die Verwendung.
{#r_WFAH-js_S__table_ndr_nf5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| str | Zeichenfolge | Zeichenfolge, die möglicherweise eingebettetes el enthält. |
[Tabelle : 11. Parameter]

{#r_WFAH-js_S__table_ndr_nf5_4t} {#r_WFAH-js_S__table_odr_nf5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die ausgewertete Zeichenfolge. |
[Tabelle : 12. Rückgaben]

{#r_WFAH-js_S__table_odr_nf5_4t}

## WFActivityHandler -- onCancel( ) {#ariaid-title8}

Ereignis-Handler für cancelEreignis.
Die Basisklasse für das Aktivitätsskript legt fest, dass diese Aktivität abgebrochen wird. Abgeleitete Klassen (Aktivitäten) können diese Methode überschreiben, wenn zum Abbrechen dieser Aktivität zusätzliche Verarbeitung erforderlich ist. Aktivität Manual ApprovalsIst ein Beispiel für das Überschreiben dieser Methode, um eine zusätzliche Verarbeitung durchzuführen, um diese Aktivität abzubrechen.
{#r_WFAH-onCancel__table_pqd_1b5_4t__entry__3}

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

{#r_WFAH-onCancel__table_pqd_1b5_4t} {#r_WFAH-onCancel__table_qqd_1b5_4t__entry__2}

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

{#r_WFAH-onCancel__table_qqd_1b5_4t}

## WFActivityHandler -- onExecute( ) {#ariaid-title9}

Virtuelle Methode. Aktivitätsunterklassen müssen diese Methode überschreiben, um Arbeiten auszuführen, die der Aktivität entsprechen.
{#r_WFAH-onExecute__table_nqd_1b5_4t__entry__3}

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

{#r_WFAH-onExecute__table_nqd_1b5_4t} {#r_WFAH-onExecute__table_oqd_1b5_4t__entry__2}

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

{#r_WFAH-onExecute__table_oqd_1b5_4t}

## WFActivityHandler -- Skript ausführen (Zeichenfolgenskript ) {#ariaid-title10}

Ermöglicht Aktivitäten, ein Skript auszuführen, das in einer Aktivitätsvariablen vom Typ „Skript" enthalten ist.
Beispiele für Aktivitäten, die diese Methode verwenden, sind „wenn", Wait for condition, Und Approval - User.
{#r_WFAH-runScript_S__table_rqd_1b5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Skript | Zeichenfolge | Zeichenfolge, die ein gültiges JavaScript enthält. |
[Tabelle : 17. Parameter]

{#r_WFAH-runScript_S__table_rqd_1b5_4t} {#r_WFAH-runScript_S__table_sqd_1b5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Variable | Wenn das Skript die Workflow-Variable festgelegt hat <var class="keyword varname">Antwort </var>Dann wird dieser Wert zurückgegeben. Wenn nicht, wird das Ergebnis der Skriptausführung zurückgegeben. |
[Tabelle : 18. Rückgaben]

{#r_WFAH-runScript_S__table_sqd_1b5_4t}

## WFActivityHandler -- setActivityOutput( ) {#ariaid-title11}

Legt die Aktivitätsausgabeeigenschaft fest.
Siehe Aktivität SOAP Message.
{#r_WFAH-setActivityOutput__table_lqd_1b5_4t__entry__3}

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

{#r_WFAH-setActivityOutput__table_lqd_1b5_4t} {#r_WFAH-setActivityOutput__table_mqd_1b5_4t__entry__2}

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

{#r_WFAH-setActivityOutput__table_mqd_1b5_4t}

## WFActivityHandler -- setResultFailed (Zeichenfolgengrund ) {#ariaid-title12}

Legt das Aktivitätsergebnis mit einer optionalen Ursachenzeichenfolge als fehlgeschlagen fest.
Siehe Aktivität SOAP Message.
{#r_WFAH-setResultFailed_S__table_hqd_1b5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Grund | Zeichenfolge | (Optional) Beschreibung des Grunds für den Fehler bei dieser Aktivität. |
[Tabelle : 21. Parameter]

{#r_WFAH-setResultFailed_S__table_hqd_1b5_4t} {#r_WFAH-setResultFailed_S__table_iqd_1b5_4t__entry__2}

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

{#r_WFAH-setResultFailed_S__table_iqd_1b5_4t}

## WFActivityHandler -- setResultSucceeded( ) {#ariaid-title13}

Legt das Ergebnis dieser Aktivität als erfolgreich fest.
{#r_WFAH-setResultSucceeded__table_jqd_1b5_4t__entry__3}

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

{#r_WFAH-setResultSucceeded__table_jqd_1b5_4t} {#r_WFAH-setResultSucceeded__table_kqd_1b5_4t__entry__2}

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

{#r_WFAH-setResultSucceeded__table_kqd_1b5_4t}

## WFActivityHandler -- Warnung(Zeichenfolgennachricht , Zeichenfolgenargumente ) {#ariaid-title14}

Protokolliert eine Warnmeldung.
{#r_WFAH-warn_S_S__table_tdr_nf5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die an das Protokoll gesendet werden soll. |
| args | Zeichenfolge | Zeichenfolge, die an das Protokoll gesendet werden soll |
[Tabelle : 25. Parameter]

{#r_WFAH-warn_S_S__table_tdr_nf5_4t} {#r_WFAH-warn_S_S__table_udr_nf5_4t__entry__2}

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

{#r_WFAH-warn_S_S__table_udr_nf5_4t}

## WFActivityHandler -- Warnung(Zeichenfolgennachricht , Array- Argumente) {#ariaid-title15}

Protokolliert eine Warnmeldung.
{#r_WFAH-warn_S_A__table_vdr_nf5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die an das Protokoll gesendet werden soll. |
| args | Array | Array von Werten, die an das Protokoll gesendet werden sollen |
[Tabelle : 27. Parameter]

{#r_WFAH-warn_S_A__table_vdr_nf5_4t} {#r_WFAH-warn_S_A__table_udr_nf5_4t__entry__2}

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

{#r_WFAH-warn_S_A__table_udr_nf5_4t}

