Erstellen von Anwendungen im Quellcode

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 4 Minuten Lesedauer

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

    Übersicht

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

    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 ServiceNowkö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.

    Vergleich von ServiceNow IDE und ServiceNow

    Funktion ServiceNow IDE ServiceNow
    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 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.

    		 Volle Unterstützung
    Anwendungskonvertierung Unterstützt nur bereichsbezogene Anwendungen, die mit ServiceNow IDE oder ServiceNowerstellt wurden.

    Konvertierte Anwendungen werden im ServiceNow IDEnicht unterstützt.

    		 Unterstützung für die Konvertierung vorhandener bereichsbezogener Anwendungen, die nicht mit ServiceNow IDE oder ServiceNowerstellt wurden.
    ServiceNow Fluent Volle Unterstützung Volle Unterstützung
    JavaScript-Module und Bibliotheken von Drittparteien Volle Unterstützung Volle Unterstützung

    Anwendungsstruktur

    Anwenderdefinierte bereichsbezogene Anwendungen, die mit ServiceNow IDE oder ServiceNow 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.

    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. Dieses Verzeichnis ist nur mit ServiceNowverfügbar.
    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.
    Quelle
    Verzeichnis mit dem Quellcode Ihrer Anwendung, einschließlich Beispieldateien. Dieses Verzeichnis enthält die folgenden Unterverzeichnisse:
    • fließend: Verzeichnis mit den Quellcodedateien zum Definieren von Anwendungsmetadaten (.now.ts). Das generierte Unterverzeichnis enthält die mit ServiceNow Fluentgenerierten Anwendungsdateien.
    • server: Verzeichnis mit JavaScript-Modulcode (.js oder .ts) zur Verwendung mit serverseitigen Skripts.
    Ziel
    Verzeichnis, das ein bereitstellbares Paket zum Hochladen in eine Instanz enthält. Dieses Verzeichnis ist nur mit ServiceNowverfügbar.
    .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. Beispiel: 
    {
  "scope": "x_snc_example_app",
  "scopeId": "2f8400eb07426110f736e28f69d3017a",
  "metadataDir": "metadata",
  "appOutputDir": "dist/app",
  "sourceDir": "src",
  "fluentDir": "src/fluent",
  "serverModulesDir": "src/server", 
  "packOutputDir": "target",
  "transpiledSourceDir": "dist/modules",
  "maxInlineScriptLines": 15,
  "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. Dieses Verzeichnis ist nur mit ServiceNowverfügbar.

    Standard: dist/app
    Quellverzeichnis Verzeichnis mit dem Quellcode der Anwendung.

    Standard: src
    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
    packOutputDir Verzeichnis für die Ausgabe der ZIP-Datei, die beim Erstellen der Anwendung in eine Instanz hochgeladen werden soll. Dieses Verzeichnis ist nur mit ServiceNowverfügbar.

    Standard: target
    transpiledSourceDir Verzeichnis, das transilierte JavaScript-Dateien enthält.

    Standard: Der Wert des Parameters sourceDir

    maxInlineScriptLines Maximale Anzahl der Zeilen in einem Inline-Skript, die im Quellcode mit dem Skript -Tag definiert sind, bevor das Skript automatisch in eine separate Datei verschoben wird. Die Skriptdatei wird von der Skripteigenschaft im Quellcode referenziert.

    Standard: 10
    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 ServiceNowverfü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.

    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.