Ressourcen in Erweiterungen paketieren und über AL darauf zugreifen

Von Bedeutung

Dieser Inhalt ist archiviert und wird nicht aktualisiert. Die neueste Dokumentation finden Sie unter Neuerungen oder Änderungen in Business Central. Die neuesten Versionspläne finden Sie unter Dynamics 365, Power Platform und Cloud for Industry Versionspläne.

Aktiviert für	Öffentliche Vorschauversion	Allgemeine Verfügbarkeit
Administrierende, Erstellende, Marketingfachkräfte oder Mitarbeitende in der Analyse, automatisch	3. Feb. 2025	3. Feb. 2025

Geschäftswert

Funktionen benötigen oft einige Daten, z. B. für die Initialisierung und Einrichtung. Bisher war es nur möglich, solche Daten hinzuzufügen und aus AL durch die Verwendung von Beschriftungen oder Code zu nutzen. In dieser Version fügen wir die Möglichkeit hinzu, Ressourcen in Erweiterungen einzuschließen und über AL auf diese zuzugreifen.

Einzelheiten zur Funktion

Entwickelnde können Ressourcen in Erweiterungen paketieren und innerhalb des AL-Codes auf den Inhalt dieser Ressourcen zugreifen. Dies kann verwendet werden, um Daten für Setup- und Initialisierungsfunktionen (z. B. für RapidStart-Pakete, Demodaten, Vorlagen und mehr) zu versenden, wodurch die Verwendung von Beschriftungen oder Codeunits für diesen Zweck vermieden wird.

Um Ressourcen in einer Erweiterung zu packen, müssen Sie deklarieren, welche Ordner in Ihrem Projekt Ressourcen enthalten, die in die Manifestdatei (app.json) der Erweiterung gepackt werden sollen. Fügen Sie der Manifestdatei dazu die Eigenschaft „resourceFolders“ hinzu. Sie können mehrere Ordner angeben. Ressourcenordner können auch Unterordner enthalten.

Auf Ressourcen kann zur Laufzeit über AL-Code zugegriffen werden. Es gibt mehrere Methoden, um mit Ressourcen zu interagieren:

• NavApp.GetResource(ResourceName: Text; var ResourceStream: Instream; (Optional) Encoding: TextEncoding) wird verwendet, um den Inhalt von Ressourcendateien zur Laufzeit zu lesen.
• NavApp.GetResourceAsText(ResourceName: Text; (Optional) Encoding: TextEncoding): Text wird verwendet, um den Inhalt von Ressourcendateien direkt in ein Text-Objekt einzulesen.
• NavApp.GetResourceAsJson(ResourceName: Text; (Optional) Encoding: TextEncoding): JsonObject wird verwendet, um den Inhalt von Ressourcendateien direkt in ein JsonObject einzulesen.

Beachten Sie, dass eine Erweiterung nur auf ihre eigenen Ressourcen zugreifen kann.

Dies sind die aktuellen Größenbeschränkungen für Ressourcen:

• Die maximale Größe einer einzelnen Ressourcendatei beträgt 16 MB.
• Die maximale Größe aller Ressourcendateien insgesamt beträgt 256 MB.
• Die maximale Anzahl von Ressourcendateien in einer Erweiterung beträgt 256 Dateien.

Teilen Sie uns Ihre Meinung mit.

Helfen Sie uns, mit Ideen, Vorschlägen und Feedback Dynamics 365 Business Central zu verbessern. Nutzen Sie das Forum unter https://aka.ms/bcideas.

Weitere Infoangebote

Ressourcen in Business Central-Erweiterungen hinzufügen und darauf zugreifen (Dokumente)