Erstellen von Anwendungen im Quellcode

Erstellen und entwickeln Sie anwenderdefinierte Anwendungen im Quellcode mit vertrauten Entwicklungstools und -prozessen.

Übersicht über die Erstellung von im Quellcode

Sie können bereichsbezogene Anwendungen im Code mit ServiceNow IDE auf dem Now Platform oder lokal im Visual Studio Code -Desktop mit dem ServiceNow SDKerstellen.

In beiden Entwicklungsumgebungen verwenden Sie ServiceNow Fluent, eine domänenspezifische Programmiersprache, um die Metadaten zu definieren, aus denen Anwendungen bestehen. ServiceNow Fluent enthält APIs zum Definieren der verschiedenen Arten von Metadaten.

Mit ServiceNow IDE oder ServiceNow SDKkönnen Sie auch JavaScript-Module erstellen und Bibliotheken von Drittparteien in Ihrer Anwendung verwenden, um die Wiederverwendung von Code in Skripts innerhalb einer bereichsbezogenen Anwendung zu optimieren.

Durch die Entwicklung und Wartung von Anwendungen im Quellcode können Sie in vertrauten Entwicklungsumgebungen arbeiten, komplexe Anwendungen erstellen und ändern, Code in der Quellcodeverwaltung einfacher verwalten und Fehler bei der Erstellung erkennen.

ServiceNow IDEEntwickeln Sie Anwendungen im Code in einer IDE auf der Now Platform.

ServiceNow SDKEntwickeln Sie Anwendungen lokal im Code, und laden Sie Änderungen in eine Instanz hoch.

Vergleich von ServiceNow IDE und ServiceNow SDK

Funktion	ServiceNow IDE	ServiceNow SDK
Entwicklungsumgebung	Online-Instanz ServiceNow.	Lokale Entwicklung und die Möglichkeit, offline zu arbeiten
Anwenderoberfläche	IDE basierend auf Visual Studio Code für das Web	Visual Studio Code Desktop
Zusammenarbeit	Zeigen Sie die Änderungen eines Anwenders in Echtzeit im Code oder in eingebetteten Now Platform -Anwenderoberflächen an. Arbeiten Sie mit anderen Entwicklern an Anwendungen in der Quellcodeverwaltung.	Rufen Sie Changes an einer Instanz mithilfe der ServiceNow SDK CLI ab, und stellen Sie sie bereit, um mit anderen Benutzern zusammenzuarbeiten. Arbeiten Sie mit anderen Entwicklern an Anwendungen in der Quellcodeverwaltung.
Quellcodeverwaltung	Unterstützt die gängigsten Git-Funktionen und die Integration mit einem Git-Anbieter Ihrer Wahl. Eine gleichzeitige Verzweigung pro Repository pro Instanz.	Vollständige Unterstützung
Anwendungskonvertierung	Unterstützung für die Konvertierung vorhandener bereichsbezogener Anwendungen, die nicht mit ServiceNow IDE oder ServiceNow SDKerstellt wurden.	Unterstützung für die Konvertierung vorhandener bereichsbezogener Anwendungen, die nicht mit ServiceNow IDE oder ServiceNow SDKerstellt wurden.
ServiceNow Fluent	Vollständige Unterstützung	Vollständige Unterstützung
JavaScript-Module und Bibliotheken von Drittparteien	Vollständige Unterstützung.	Vollständige Unterstützung

Anwendungsstruktur

Anwenderdefinierte bereichsbezogene Anwendungen, die mit ServiceNow IDE oder ServiceNow SDK erstellt wurden, umfassen Quellcodedateien und XML-Metadatendateien. Die Dateien „package.json“ und „now.config.json“ definieren die Anwendungsstruktur, die der von Node.js-Anwendungen oder Node Package Manager-Paketen (npm) ähnelt.

Abbildung : 1. Standardstruktur einer in erstellten Anwendung ServiceNow IDE

Standardmäßig enthalten Anwendungen die folgenden Verzeichnisse und Dateien. Sie können bestimmte Aspekte der Anwendungsstruktur in der Datei now.config.json an Ihre Anforderungen anpassen.

.now

Verzeichnis, das Caching- und Metrikinformationen für die Build- und Bereitstellungsprozesse enthält.

dist/app

Verzeichnis, das die Build-Artefakte für die Paketierung enthält.

Metadaten

Verzeichnis mit Anwendungsmetadaten (XML) der Anwendung, z. B. Tabellenschemata und Business-Regeln, organisiert in derselben Verzeichnisstruktur wie vorhandene ServiceNow -Anwendungen.

Hinweis:

Anwendungsmetadaten dürfen nicht in den XML-Dateien bearbeitet werden. Bearbeiten Sie die Anwendungsmetadaten im Quellcode oder unter Now Platform.

node_modules

Verzeichnis mit den Node.js-Modulen der Drittpartei, von denen Ihre Anwendung abhängt.

src

Verzeichnis mit dem Quellcode Ihrer Anwendung, einschließlich Beispieldateien. Dieses Verzeichnis enthält die folgenden Unterverzeichnisse:

• fließend: Verzeichnis mit Code ServiceNow Fluent in .now.ts- Dateien. Das generierte Unterverzeichnis enthält die in ServiceNow Fluentkonvertierten Anwendungsdateien.
• server: Verzeichnis mit JavaScript-Modulcode in .js- oder .ts- Dateien.

Ziel

Verzeichnis, das ein bereitstellbares Paket zum Hochladen in eine Instanz enthält.

.eslintrc.json

Datei mit der ESLint-Konfiguration. ESLint hilft beim Erkennen und Beheben von Problemen im Anwendungscode.

.gitignore

Datei mit einer Liste von Verzeichnissen oder Dateien, die Git ignorieren soll. Diese Dateien werden in der Quellcodeverwaltung nicht nachverfolgt.

now.config.json

Datei mit der Anwendungskonfiguration ServiceNow. Die Datei now.config.json muss sich im Basisverzeichnis für eine Anwendung befinden.

Sie können die Verzeichnisstruktur für eine Anwendung konfigurieren, indem Sie die folgenden Parameter hinzufügen. Zum Beispiel:

{
  "scope": "x_snc_example_app",
  "scopeId": "2f8400eb07426110f736e28f69d3017a",
  "name": "ExampleApp"
  "metadataDir": "metadata",
  "appOutputDir": "dist/app",
  "fluentDir": "src/fluent",
  "serverModulesDir": "src/server",
  "modulePaths": {
      "src/server/*.ts": "dist/server/*.js",
    },
  "ignoreTransformTableList": ["ua_table_licensing_config", "sys_embedded_help_role"]
}

Tabelle : 1. Unterstützte Parameter now.config.json

Parameter	Beschreibung
metadataDir	Verzeichnis, das die Metadaten der Anwendung als XML-Dateien enthält. Standard: metadata
appOutputDir	Verzeichnis, in das die Build-Artefakte zum Packen beim Erstellen der Anwendung ausgegeben werden. Standard: dist/app
flowDir	Verzeichnis mit ServiceNow Fluent-Dateien (.now.ts), die Anwendungsmetadaten im Quellcode definieren. Standard: src/fluent
serverModulesDir	Verzeichnis mit den JavaScript- oder TypeScript-Dateien, die in JavaScript-Module zur Verwendung in serverseitigen Skripts integriert werden sollen. Standard: src/server
modulePaths	Eine Zuordnung des Quellverzeichnisses für Module zum Ausgabeverzeichnis für Module. Dieser Parameter wird verwendet, um TypeScript-Quelldateien in JavaScript-Modulen zu kompilieren. Weitere Informationen finden Sie unter TypeScript in JavaScript-Modulen mit verwenden ServiceNow SDK. Dieser Parameter ist nicht erforderlich, wenn Sie den Parameter tsconfigPath verwenden.
tsconfigPath	Ein Pfad zur Datei tsconfig.json der Anwendung, wenn sie sich nicht im Basisverzeichnis befindet. Beispiel: „./src/tsconfig.json“. Dieser Parameter ist nicht erforderlich, wenn Sie den Parameter „modulePaths“ verwenden.
ignorierenTransformTableList	Tabellen, die bei der Transformation von Anwendungsmetadaten in Quellcode ignoriert werden sollen.

Paketsperre.json

Automatisch aktualisierte Datei mit vollständigen Informationen zu Abhängigkeiten und deren Versionen. Diese Datei ist nur mit ServiceNow SDKverfügbar.

Paket.json

Datei mit Informationen über Ihre Anwendung und anwenderdefinierte bzw. Drittpartei-Modulabhängigkeiten Die Datei „package.json“ muss sich im Basisverzeichnis für eine Anwendung befinden. In einer Instanz wird der Pfad „package.json“ im Feld Paket-JSON des Datensatzes für anwenderdefinierte Anwendungen [sys_app] im Format angegeben<scope> /<package-name> /<version> /package.json .

tsconfig.json

Datei mit TypeScript-Konfiguration und -Optionen zum Kompilieren von TypeScript-Dateien in JavaScript-Modulen und für Typdefinitionen.

Zugehörige Anwendungen und Funktionen

JavaScript-APIs

Verwenden Sie JavaScript-APIs in Skripts, die Sie schreiben, um die Funktionalität von Anwendungen zu ändern, oder wenn Sie Anwendungen erstellen.

Zugehörige Konzepte

• ServiceNow Fluent
• JavaScript-Module und Bibliotheken von Drittparteien