Skriptaktions-API – ServiceNow Fluent

Die Skriptaktions-API definiert Skriptaktionen [sysevent_script_action], die ausgeführt werden, wenn ein Ereignis auftritt.

Allgemeine Informationen zu geplanten Skriptausführungen finden Sie unter Script actions.

Zugehörige Konzepte

• ServiceNow Fluent

ScriptAction-Objekt

Erstellen Sie eine Skriptaktion [sysevent_script_action], die eine Aufgabe ausführt, wenn sie durch ein Ereignis ausgelöst wird.

Tabelle : 1. Eigenschaften

Name	Typ	Beschreibung
$ID	Zeichenfolge oder Zahl	Erforderlich. Eine eindeutige ID für das Metadatenobjekt. Wenn Sie die Anwendung erstellen, wird diese ID in eine eindeutige sys_ID gehasht Weitere Informationen finden Sie unter ServiceNow Fluent Sprachkonstrukte. Format: Now.ID['Zeichenfolge' oder Zahl]
Name	Zeichenfolge	Erforderlich. Ein eindeutiger Name für die Skriptaktion.
Skript	Skript	Erforderlich. Ein serverseitiges Skript, das ausgeführt wird, wenn durch ein Ereignis ausgelöst wird. Diese Eigenschaft unterstützt eine Funktion aus einem JavaScript-Modul, einen Verweis auf eine andere Datei in der Anwendung, die ein Skript enthält, oder Inline-JavaScript. Format: Verwenden Sie für Funktionen den Namen einer Funktion, eines Funktionsausdrucks oder einer Standardfunktion, die aus einem JavaScript-Modul exportiert wurde, und importieren Sie sie in .Jetzt.TS Datei. Informationen zu JavaScript-Modulen finden Sie unter JavaScript-Module und Drittanbieterbibliotheken. Informationen zur Verwendung von Textinhalten aus einer anderen Datei finden Sie in einer Datei in der Anwendung im folgenden Format: Now.include('path/to/file') . Weitere Informationen finden Sie unter ServiceNow Fluent Sprachkonstrukte. Um ein Inline-Skript bereitzustellen, verwenden Sie Zeichenfolgenliterale oder Vorlagenliterale für mehrere Codezeilen: „Skript“ oder „Skript“ .
eventName	Zeichenfolge	Erforderlich. Das Ereignis, das die Ausführung der Skriptaktion auslöst. Informationen zum Erstellen von Ereignissen finden Sie unter Create an event.
aktiv	Boolean	Kennzeichnung, die angibt, ob die Skriptaktion aktiviert ist. Gültige Werte: Wahr: Die Skriptaktion wird ausgeführt, wenn sie durch das Ereignis ausgelöst wird. Falsch: Die Skriptaktion wird nicht ausgeführt. Standardwert: false
Beschreibung	Zeichenfolge	Eine Beschreibung der Funktionalität und des Zwecks der Skriptaktion.
Reihenfolge	Nummer	Eine Zahl, die die Reihenfolge angibt, in der die Skriptaktion ausgeführt werden soll. Wenn für ein bestimmtes Ereignis mehrere Skriptaktionen vorhanden sind, werden die Skriptaktionen in der angegebenen Reihenfolge ausgeführt, vom niedrigsten zum höchsten. Standard: 100
Bedingungsskript	Zeichenfolge	Eine bedingte JavaScript-Anweisung, die die Felder und Werte angibt, die „wahr“ sein müssen, damit das Skript ausgeführt werden kann. Hinweis: Verwenden Sie diese Eigenschaft nicht, wenn Sie die Bedingungsanweisung mit einschließen Skript Eigenschaft. Format: Informationen zur Verwendung von Textinhalten aus einer anderen Datei finden Sie in einer Datei in der Anwendung im folgenden Format: Now.include('path/to/file') . Weitere Informationen finden Sie unter ServiceNow Fluent Sprachkonstrukte. Um ein Inline-Skript bereitzustellen, verwenden Sie Zeichenfolgenliterale oder Vorlagenliterale für mehrere Codezeilen: „Skript“ oder „Skript“ .
$Meta	Objekt	Metadaten für die Anwendungsmetadaten. Mit InstallMethod Eigenschaft können Sie die Anwendungsmetadaten einem Ausgabeverzeichnis zuordnen, das nur unter bestimmten Umständen geladen wird. $meta: {       installMethod: 'String' } Gültige Werte für InstallMethod : Demo: Gibt die Anwendungsmetadaten an aus Metadaten/unload.demo Verzeichnis, das mit der Anwendung installiert werden soll, wenn Demodaten laden Option ist ausgewählt. Erste Installation: Gibt die Anwendungsmetadaten an aus Metadaten/Entladen Verzeichnis, das nur bei der ersten Installation einer Anwendung auf einer Instanz installiert werden soll.

import { ScriptAction } from '@servicenow/sdk/core'
import { insertIncident } from '../server/scripts.js'

ScriptAction({
    $id: Now.ID['sample-script-action'],
    name: 'SampleScriptAction',
    active: true,
    description: 'Insert an incident',
    script: insertIncident,
    eventName: 'sample.event',
    order: 100,
    conditionScript: "gs.hasRole('my_role')"
})

Die Skript Eigenschaft bezieht sich auf eine Funktion aus Skripts.js Modul. Zum Beispiel:

import { GlideRecord } from '@servicenow/glide'

export const insertIncident = () => {
    var gr = new GlideRecord('incident')
    gr.initialize()
    gr.setValue('short_description', 'New incident from event')
    gr.insert()
}