API für Skripteinbindung – ServiceNow Fluent

Die Skripteinbindungs-API definiert Skripteinbindungen [sys_script_include], die JavaScript-Funktionen und -Klassen zur Verwendung durch serverseitige Skripts speichern.

Hinweis:

Verwenden Sie für neue Skripts nach Möglichkeit JavaScript-Module anstelle von Skripteinbindungen, um die Wiederverwendung von Code und die Verwendung von Drittanbieterbibliotheken innerhalb einer bereichsbezogenen Anwendung zu unterstützen. Weitere Informationen zur Unterstützung und Einschränkungen des JavaScript-Moduls finden Sie unter JavaScript-Module und Drittanbieterbibliotheken.

Allgemeine Informationen zu Skripteinbindungen finden Sie unter Script includes.

Zugehörige Konzepte

• ServiceNow Fluent

SkriptInclude-Objekt

Erstellen Sie eine Skripteinbindung [sys_script_include], um ein serverseitiges Skript zu definieren, das ausgeführt wird, wenn es von anderen Skripts aufgerufen 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. Der Name der Skripteinbindung. Wenn Sie eine Klasse definieren, muss der Name mit dem Namen der Klasse, des Prototyps und des Typs übereinstimmen. Wenn Sie eine klassenlose Skripteinbindung (bei Bedarf) verwenden, muss der Name mit dem Funktionsnamen übereinstimmen.
Skript	Skript	Erforderlich. Ein serverseitiges Skript, das von anderen Skripts aufgerufen werden soll. Das Skript muss eine einzelne JavaScript-Klasse oder eine globale Funktion definieren. Der Klassen- oder Funktionsname muss mit übereinstimmen Name Eigenschaft. Diese Eigenschaft unterstützt Inline-JavaScript oder einen Verweis auf eine andere Datei in der Anwendung, die ein Skript enthält. 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“ .
ApiName	Zeichenfolge	Ein interner Name für die Skripteinbindung, der verwendet wird, um die Skripteinbindung aus Anwendungen außerhalb des Umfangs aufzurufen. Standard: <scope>.<name>
Beschreibung	Zeichenfolge	Eine Beschreibung des Zwecks und der Funktion der Skripteinbindung.
Clientaufrufbar	Boolean	Kennzeichnung, die angibt, ob clientseitige Skripts die Skripteinbindung mit GlideAjax aufrufen können. Die Skripteinbindung ist für Client-Skripts, Listen-/Berichtsfilter, Referenzqualifizierer oder wenn als Teil der URL angegeben. Vom Client aufrufbare Skripteinbindungen werden von aufgerufen GlideAjax Und fordern Anwender auf, eine ACL zu erfüllen, die der Skripteinbindung zugeordnet ist. Gültige Werte: Wahr: Die Skripteinbindung ist für clientseitige Skripts verfügbar. Falsch: Die Skripteinbindung ist für clientseitige Skripts nicht verfügbar. Standardwert: false
MobileCallable	Boolean	Kennzeichnung, die angibt, ob die Skripteinbindung für Client-Skripts verfügbar ist, die von Mobilgeräten aufgerufen werden. Gültige Werte: Wahr: Die Skripteinbindung ist für Client-Skripts verfügbar, die von Mobilgeräten aufgerufen werden. Falsch: Die Skripteinbindung ist für Client-Skripts nicht verfügbar, die von Mobilgeräten aufgerufen werden. Standardwert: false
SandboxCallable	Boolean	Kennzeichnung, die angibt, ob die Skripteinbindung für Skripts verfügbar ist, die aus der Skript-Sandbox aufgerufen werden, z. B. eine Abfragebedingung. Wichtig: Skripteinbindungen sollten der Skript-Sandbox nur bei Bedarf zur Verfügung gestellt werden. Gültige Werte: Wahr: Die Skripteinbindung ist für Skripts verfügbar, die aus der Skript-Sandbox aufgerufen werden. Falsch: Die Skripteinbindung ist für Skripts nicht verfügbar, die aus der Skript-Sandbox aufgerufen werden. Standardwert: false
Anruferzugriff	Zeichenfolge	Eine Option, mit der festgelegt wird, wie bereichsübergreifender Zugriff auf die Skripteinbindung zulässig ist. Weitere Informationen finden Sie unter Einstellungen für eingeschränkte Anruferzugriffsberechtigungen. Gültige Werte: Einschränkung: Aufrufe der Skripteinbindung müssen manuell genehmigt werden. Zugriffsanforderungen werden in der Tabelle für eingeschränkten Aufruferzugriff mit dem Status Angefordert verfolgt. Nachverfolgung: Aufrufe der Skripteinbindung werden automatisch genehmigt. Aufrufe werden in der Tabelle für eingeschränkten Aufruferzugriff mit dem Status Zulässig verfolgt.
Zugänglich von	Zeichenfolge	Gibt an, welche Anwendungen auf die Skripteinbindung zugreifen können. Gültige Werte: Öffentlich: Alle Anwendungsbereiche können die Skripteinbindung aufrufen. Package_privat: Die Skripteinbindung kann nur aus dem Anwendungsbereich aufgerufen werden, in dem sie sich befindet. Standard: Package_private
aktiv	Boolean	Kennzeichnung, die angibt, ob die Skripteinbindung aktiviert ist. Gültige Werte: Wahr: Die Skripteinbindung ist aufrufbar. Falsch: Die Skripteinbindung ist nicht aufrufbar. Standardwert: wahr
$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.

Im folgenden Beispiel verwendet die Skripteinbindung ein Skript aus SampleClass.server.js Datei.

import { ScriptInclude } from '@servicenow/sdk/core';

ScriptInclude({
    $id: Now.ID['sample-script-include'],
    name: 'SampleScriptInclude',
    script: Now.include("./SampleClass.server.js"),
    description: 'some description',
    apiName: 'x_scope.SampleScriptInclude',
    callerAccess: 'tracking',
    clientCallable: true,
    mobileCallable: true,
    sandboxCallable: true,
    accessibleFrom: 'public',
    active: true,
})