Anwenderdefinierte Anwendungskonfiguration im Quellcode

Konfigurieren Sie eine anwenderdefinierte Anwendung [sys_App] in Now.config.JSON Datei für eine Anwendung im Quellcode.

Sie können die Anwendungseinstellungen und -Aspekte, die für die Entwicklung der Anwendung spezifisch sind, im Quellcode konfigurieren, z. B. die Verzeichnisstruktur. In Now.config.JSON Datei, fügen Sie die folgenden Parameter hinzu, um die Anwendungseinstellungen zu konfigurieren.

Tabelle : 1. Unterstützte Now.config.JSON-Parameter

Parameter	Typ	Beschreibung
AppOutputdir	Zeichenfolge	Verzeichnis, in das die Build-Artefakte für das Packaging ausgegeben werden sollen. Die Pack- und Installationsbefehle verweisen auf dieses Verzeichnis, um die Artefakte zu paketieren. Standard: verteilung/App
Clientdir	Zeichenfolge	Verzeichnis, das die clientseitigen Dateien für die Entwicklung von Anwenderoberflächen mit React enthält. Standard: src/Client
Abhängigkeiten	Objekt	Die Elemente in einem anderen Anwendungsbereich, von dem Ihre Anwendung abhängt. Sie müssen den Anwendungsbereich und den Abhängigkeitstyp und Namen oder sys_IDs angeben. "dependencies": { "<scope>": { "<type>": ["<sys_id or name>"], ... }, ... } Weitere Informationen finden Sie unter Herunterladen ServiceNow Fluent Anwendungsabhängigkeiten.
Fluentdir	Zeichenfolge	Verzeichnis enthält ServiceNow Fluent Dateien ( .Jetzt.TS ), die Anwendungsmetadaten im Quellcode definieren. Standard: src/Fluent
Generateddir	Zeichenfolge	Verzeichnis mit generiert ServiceNow Fluent Dateien, einschließlich vorhandener Anwendungsmetadaten, die in konvertiert wurden ServiceNow Fluent Code. Dieses Verzeichnis ist relativ zu dem mit definierten Verzeichnis fluentDirParameter. Standard: Generiert
IgnoreTransformTableList	Array	Eine Liste von Tabellen, die beim Umwandeln von Anwendungsmetadaten in Quellcode ignoriert werden sollen.
Metadatadir	Zeichenfolge	Verzeichnis, das die Metadaten der Anwendung als XML-Dateien enthält. Standard: Metadaten
ModulePaths	Objekt	Eine Zuordnung der Modulquelldateien zu den entsprechenden Ausgabedateien, wenn Sie vor dem Erstellen der Anwendung einen anwenderdefinierten Transpilationsschritt verwenden. Weitere Informationen finden Sie unter Verwendung von TypeScript in JavaScript-Modulen mit ServiceNow SDK. Warnung: Sie können diesen Parameter und nicht verwenden TsconfigPath Parameter. Die Konfiguration beider Elemente führt zu einem Fehler.
PaketAusgabeverzeichnis	Zeichenfolge	Verzeichnis zur Ausgabe des installierbaren Pakets ( .Zip Datei) beim Erstellen der Anwendung. Der Installationsbefehl verweist auf dieses Verzeichnis, um das Paket zu installieren. Standard: Ziel
ServerModuleVers	Zeichenfolge	Verzeichnis, das die JavaScript- oder TypeScript-Dateien enthält, die in JavaScript-Module zur Verwendung in serverseitigen Skripts integriert werden sollen. Standard: src/Server
ServerModulesAusschließenMuster	Array	Eine Liste von Dateimustern, die beim Erstellen von JavaScript-Modulen ausgeschlossen werden sollen. Standard: [ "**/*.test.ts", "**/*.test.js", "**/*.d.ts" ]
ServerModulesIncludePatterns	Array	Eine Liste von Dateimustern, die beim Erstellen von JavaScript-Modulen berücksichtigt werden sollen. Standard: [ "**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx", "**/*.cts", "**/*.cjs", "**/*.mts", "**/*.mjs", "**/*.json" ]
StaticContentdir	Zeichenfolge	Verzeichnis zur Ausgabe der statischen Asset-Dateien, die für die Entwicklung von Anwenderoberflächen verwendet werden. Standard: verteilung/statisch
StaticContentPaths	Objekt	Eine Zuordnung der clientseitigen Quelldateien zu den Ausgabepfaden für statische Asset-Dateien.
Standardsprache	Zeichenfolge	Der BCP 47-Code einer Standardsprache für Feldbezeichnungen [sys_documentation] in einer Tabelle oder Spalte. Die Standardsprache wird verwendet, um Feldbezeichnungen mit mehreren Sprachen aufzulösen. Standard: en
TableAusgabeFormat	Zeichenfolge	Der Typ der Build-Artefakte für Tabellenmetadaten, die aus XML generiert wurden ServiceNow Fluent Code. Gültige Werte: Bootstrap: Der Build-Prozess gibt eine Bootstrap-XML-Datei mit aus <database> Stammelement für die Tabelle, Feldbezeichnungs-XML-Dateien [sys_documentation], Lizenzierungskonfigurations-XML-Dateien [ua_table_Licensing_config] und automatische Nummerierung von XML-Dateien [sys_number]. Komponente: Der Build-Prozess gibt XML-Dateien für jede Komponente der Tabellen-API aus. Standard: Bootstrap
Taxonomie	Objekt	Eine Konfiguration zum Organisieren generiert ServiceNow Fluent Dateien, die Tabellennamen Verzeichnissen zuordnen und ein Fallback-Verzeichnis definieren. Die standardmäßige Taxonomiekonfiguration verwendet ServiceNow Hinzuzufügende Standardtabellenklassifizierungen generiert ServiceNow Fluent Dateien in einer logischen Verzeichnisstruktur innerhalb von Fluent/generiert Verzeichnis, in das Metadaten anfänglich umgewandelt werden ServiceNow Fluent Code. Zum Beispiel: Business-Regeln [sys_script] werden zu hinzugefügt Fluent/generated/Server-Development/Business-rule Verzeichnis. Skripteinbindungen [sys_script_include] werden zu hinzugefügt Fluent/generated/Server-Development/script-include Verzeichnis. Sie können die Standardzuordnungen überschreiben oder zusätzliche Zuordnungen konfigurieren. Im folgenden Beispiel überschreibt die Konfiguration das Standardverzeichnis für Business-Regeln [sys_script] und den Fallback-Ordner und konfiguriert eine zusätzliche Zuordnung für Metadaten aus einer anwenderdefinierten Tabelle. "taxonomy": { "mapping": { "sys_script": "scripts/server/rules", "custom_table": "my-custom-folder/my-nested-folder" }, "fallbackFolderName": "unclassified" } Zuordnung: Ein Objekt, das Tabellennamen Verzeichnissen zuordnet. Verzeichnispfade beziehen sich auf das mit konfigurierte Verzeichnis generatedDirParameter und darf nur Kleinbuchstaben, Zahlen, Bindestriche, Unterstriche und Schrägstriche enthalten, um Unterverzeichnisse zu trennen. FallbackFolderName: Ein Name für ein Verzeichnis, das für Tabellen verwendet werden soll, für die keine Standard- oder anwenderdefinierte Zuordnung konfiguriert ist. Innerhalb dieses Verzeichnisses ServiceNow Fluent Dateien werden Unterverzeichnissen hinzugefügt, die nach der Tabelle benannt sind, z. B. src/Fluent/generated/other/x-unmap-table/ . Standard: Standardtaxonomiezuordnungen sind für alle Standards definiert ServiceNow Tabellen und werden automatisch angewendet, wenn in keine anwenderdefinierte Konfiguration definiert ist Now.config.JSON Für eine Anwendung. Der Standardwert von fallbackFolderNameIst Sonstiges .
TrustedModules	Array	Eine Liste von NPM-Paketen, die als vertrauenswürdig (oder intern) identifiziert werden sollen. Vertrauenswürdige Module haben Zugriff auf ServiceNow APIs. Zum Beispiel: "trustedModules": [ "<package-name>", // Specific package "@servicenow/*" // All packages from an organization ] In der Tabelle „ECMAScript-Modul“ [sys_Module] wird Externe Quelle Feld ist für vertrauenswürdige Module auf „falsch“ festgelegt. Warnung: Fügen Sie nur Abhängigkeiten hinzu, denen Sie vollständig als vertrauenswürdige Module vertrauen. Gültige Muster: Vollqualifizierte Paketnamen, z. B. „@servicenow/sdk“ . Organisationspräfixe mit Platzhalterzeichen, z. B. „@servicenow/*“ Oder „@mycompany/*“ .
TsconfigPath	Zeichenfolge	Ein Pfad zu Tsconfig.JSON Datei mit anwenderdefinierten Optionen für die Übertragung von TypeScript in JavaScript während des Build-Prozesses. Wird angegeben TsconfigPath Generiert Diagnosergebnisse aus TypeScript mithilfe von Tsconfig.JSON Datei. Warnung: Sie können diesen Parameter und nicht verwenden ModulePaths Parameter. Die Konfiguration beider Elemente führt zu einem Fehler. Standard: .

Anwendungskonfiguration im Quellcode

{
  "scope": "x_snc_example_app",
  "scopeId": "2f8400eb07426110f736e28f69d3017a",
  "name": "ExampleApp",
  "dependencies": {
    "global": {
      "tables": ["incident"],
      "roles": ["admin"],
    },
    "x_custom": {
      "tables": ["custom_table"]
    }
  },
  "metadataDir": "metadata",
  "fluentDir": "src/fluent",
  "generatedDir": "generated",
  "serverModulesDir": "src/server",
  "clientDir": "src/client",
  "appOutputDir": "dist/app",
  "staticContentDir": "dist/static",
  "packOutputDir": "target",
  "modulePaths": {
      "src/server/*.ts": "dist/server/*.js",
    },
  "staticContentPaths": {
      "src/client/*.html": "dist/static/*.html",
    },
  "ignoreTransformTableList": ["ua_table_licensing_config", "sys_embedded_help_role"],
  "taxonomy": {
        "mapping": {
            "sys_script": "scripts/server/rules",
            "custom_table": "my-custom-folder/my-nested-folder"
        },
        "fallbackFolderName": "unclassified" 
    }
}

Zugehörige Konzepte

• Anwendungszugriffseinstellungen