Die neue AL-Methode Rec.Truncate ist mit der Datensatz-API verfügbar. Mit dieser Methode können Entwickler Tabellenzeilen löschen und Filter auf effizienteste Weise abgleichen.

Die Methode verfügt über Parameter, mit denen Sie folgende Aktionen ausführen können:

• Überprüfen Sie, ob die Tabelle das Abschneiden nicht unterstützt.
• Setzen Sie AutoIncrement-Felder auf den Wert zurück, den sie vor dem Löschen hatten, oder setzen Sie sie auf 0 zurück.

Wenn die Methode mit Filtern verwendet wird, kopiert die Plattform Daten in eine temporäre Tabelle und verschiebt sie nach dem Abschneiden wieder zurück. Verwenden Sie Filter nur, wenn Sie eine signifikante Anzahl von Zeilen löschen – durch Die Verwendung von Filtern für kleinere Löschungen entsteht ein unnötiger Aufwand.

Abschneiden benötigt Löschberechtigungen und keine Sicherheitsfilter in der Tabelle für den aktuellen Benutzer.

Die Methode unterstützt nicht:

• Tabellen mit OnDelete-Triggern oder Ereignisabonnements (es tritt ein Laufzeitfehler auf; um diesen zu behandeln, verwenden Sie IF Rec.Truncate THEN als Fallback auf DeleteAll oder um den Fehler offenzulegen).
• Tabellen mit Medien- oder Mediaset-Feldern.
• Verwenden Sie innerhalb von Try-Funktionen.
• Wird mit Filtern in FlowFields verwendet.

Mit diesem Update können Sie AL-Code in Erweiterungen verwenden, um Zusammenfassungen zu beeinflussen, die Copilot generiert.

Sicherheit, Datenschutz und KI

Copilot basiert auf dem umfassenden Ansatz von Microsoft für Unternehmenssicherheit, Datenschutz, Compliance und verantwortungsvolle KI. Wir glauben, dass Ihre Daten Ihre Daten sind. Business Central verwendet keine Kundendaten, um KI-Modelle zu trainieren.

Lesen Sie die häufig gestellten Fragen zu Copilot-Datensicherheit und -Datenschutz für Dynamics 365

Nehmen Sie an der Unterhaltung teil

Wir freuen uns, Sie auf unserer Copilot-Reise dabei zu haben.

Helfen Sie uns, mit Ideen, Vorschlägen und Feedback Dynamics 365 Business Central zu verbessern. Nutzen Sie das Forum unter aka.ms/bcIdeas, oder nehmen Sie an der Diskussion der Partnercommunity im Dynamics 365 Business Central Partner Community Network auf Viva Engage (ehemals Yammer) teil, um die Zukunft der KI in Business Central mitzugestalten.

AL-Entwickler können ein Ereignis abonnieren und benutzerdefinierte Logik hinzufügen, die KI oder andere Methoden verwendet, damit Copilot Werte für ein bestimmtes Feld vorschlägt.

Sicherheit, Datenschutz und KI

Copilot basiert auf dem umfassenden Ansatz von Microsoft für Unternehmenssicherheit, Datenschutz, Compliance und verantwortungsvolle KI. Wir glauben, dass Ihre Daten Ihre Daten sind. Business Central verwendet keine Kundendaten, um KI-Modelle zu trainieren.

Lesen Sie „Häufig gestellte Fragen zur Datensicherheit und zum Datenschutz von Copilot für Dynamics 365“.

Nehmen Sie an der Unterhaltung teil

Wir freuen uns, Sie auf unserer Copilot-Reise dabei zu haben.

Helfen Sie uns, mit Ideen, Vorschlägen und Feedback Dynamics 365 Business Central zu verbessern. Nutzen Sie das Forum unter aka.ms/bcIdeas, oder nehmen Sie an der Diskussion der Partnercommunity im Dynamics 365 Business Central Partner Community Network auf Viva Engage (ehemals Yammer) teil, um die Zukunft der KI in Business Central mitzugestalten.

Um einen Schlüsseltresor für eine App zu registrieren, müssen Partner keine E-Mail mehr senden und darauf warten, dass wir ihre Entra Tenant-ID registrieren.

Stattdessen müssen die Partner:

• Erteilen Sie der Dynamics 365 Business Central ISV Key Vault Reader-App Leseberechtigung.
• Ein spezielles Geheimnis mit dem Namen AllowedBusinessCentralAppIds in ihrem jeweiligen Schlüsseltresor erstellen Dieses Geheimnis enthält die App-IDs für alle Apps, die auf den Schlüsseltresor zugreifen. Trennen Sie mehrere App-IDs durch ein Komma.

Um die Wartezeit für die Registrierung zu verkürzen, gehen Sie folgendermaßen vor.

Um eine höhere Version einer App einzureichen, müssen AppSource-Anwendungen den AllowedBusinessCentralAppIds geheimen Schlüssel hinzufügen, wenn sie ihre Entra Tenant ID bereits registriert haben. Wenn dieser reservierte geheime Schlüssel fehlt, schlägt die Übermittlung wahrscheinlich fehl.

Sie können jetzt Objekte aus heruntergeladenen Symbolpaketen über die Funktion Symbol nach Name öffnen (Strg+T) suchen.

Diese Funktion erleichtert das Auffinden von Objekten und das Öffnen des Quellcodes, wenn die Symbole Quellcode enthalten.

Es stärkt auch GitHub Copilot in Visual Studio Code. Sie können den Quellcode für ausgewählte verwandte Symbole öffnen, um ihn als Kontext für Copilot Studio zu verwenden, wenn Sie Ihren eigenen Code schreiben, so dass Sie bessere Vorschläge erhalten.

Sie können auch die verbesserte Leistung bei der Suche nach Workspace-Symbolen nutzen, um die größere Anzahl verfügbarer Symbole zu unterstützen.

AL-Entwickelnde können auf einfache Weise die HttpClient-Aufrufe Get, Put, Delete und Post in Komponententests simulieren. Durch Hinzufügen einer Handlerfunktion können Sie HttpClient-Aufrufe abfangen und die Antworten für HttpClient-Aufrufe in Unit-Tests einfach ersetzen.

Wenn Sie einer Testmethode eine HttpClientHandler hinzufügen, fängt der Handler jede HTTP-Anforderung ab, die während der Ausführung dieses Tests auftritt. Der Handler erhält eine Meldung TestHttpRequestMessage , die Informationen über die HTTP-Anforderung enthält. Er erhält auch eine Angabe TestHttpResponseMessage , die die simulierten HTTP-Antwortwerte enthält, die der Handler aktualisiert. Der Handler gibt einen booleschen Wert zurück, der angibt, ob die ursprüngliche HTTP-Anforderung weitergeleitet und ausgegeben werden soll (true) oder die simulierte Antwort (false) verwendet werden soll.

Die TestHttpRequestPolicy Eigenschaft für Testcodeunits bestimmt, wie ausgehende HTTP-Anforderungen während der Testausführung behandelt werden. Es unterstützt die folgenden Werte:

• BlockOutboundRequests: Jede HTTP-Anforderung, die während der Testausführung ausgegeben wird und von einem HTTP-Clienthandler nicht abgefangen und verarbeitet wird, löst eine Ausnahme aus.
• AllowOutboundFromHandler: Ein HTTP-Client-Handler fängt alle HTTP-Anforderungen ab, die während der Testausführung ausgegeben werden. Der Handler kann zulassen, dass die Anforderung durchlaufen wird, und die ursprüngliche Anforderung an den externen Endpunkt ausgeben.
• AllowAllOutboundRequests: Die Testausführung lässt alle ausgehenden HTTP-Anfragen zu.

Das folgende Beispiel zeigt eine Codeunit, die einen externen Webdienstaufruf ausführt, und eine Testcodeunit, die den Aufruf abfängt und mockt. Beachten Sie die Verwendung von HttpClientHandler im Test-codeunit.

Wenn Sie die RunObject-Eigenschaft in einer Aktion angeben und auf eine Seite oder einen Bericht verweisen, verwendet die Aktion die AboutText- und AboutTitle-Eigenschaften des Zielseiten- oder Berichtsanwendungsobjekts im Report Explorer. Wenn Sie diese Eigenschaften für die Aktion selbst angeben, werden diese Werte für die Aktion verwendet. Dieses Verhalten stellt die Konsistenz und Wiederverwendung im Berichts-Explorer sicher, auch für vorhandene Aktionen.

Auf Seiten wird für Aktionen, die sich auf Berichte beziehen, standardmäßig der im Zielbericht definierte "Tooltip" verwendet. Um dieses Verhalten zu unterstützen, können Sie die ToolTip Eigenschaft für Berichte festlegen.

Der Performance-Profiler ordnet jetzt Client-Browser-Interaktionen benutzerzentrierten Beschreibungen zu. Die Messungen enthalten beschreibende Werte, die den Benutzeraktionen ähneln, sodass Sie bei der Analyse von Profilen mehr Klarheit erhalten, insbesondere wenn Sie sie filtern und gruppieren.

Um Erweiterungen nachzuverfolgen, die Sie als Teil von DevOps-Pipelines erstellen, haben wir die Quelleigenschaften und Buildeigenschaften in der app.json Manifestdatei der Erweiterungen in der 1. Veröffentlichungswelle von Business Central 2024 eingeführt. Mit diesen Eigenschaften können Sie das relevante Quellrepository, die Commit-ID und das Buildsystem, das zum Erstellen der Erweiterung verwendet wird, leicht finden. Im 2. Veröffentlichungszyklus 2024 von Business Central haben wir die Möglichkeit hinzugefügt , Quellinformationen auf der Erweiterungskarte auf der Seite Erweiterungsverwaltung anzuzeigen. Im 1. Veröffentlichungszyklus 2025 haben wir auch die Build-Informationen hinzugefügt.

Die Detailkartenseite für Erweiterungen auf der Seite Erweiterungsverwaltung enthält jetzt die Build-Informationen. Die Buildinformationen bestehen aus zwei Teilen: by verfolgt den Build-Agent, und url gibt die URL zum Buildsystemaufruf an, in dem sich der Build befindet.

Weitere Informationen zu den Quell- und Buildinformationen finden Sie unter Nachverfolgen von Quell- und Buildmetadaten für Erweiterungen.

Sie können jetzt die CardPageID Eigenschaft auf Listen- und Listenteilseiten mithilfe eines PageExtension Objekts ändern. Mit dieser Änderung können Sie auswählen, welche Kartenseite angezeigt wird, wenn ein Benutzer auf ein Element auf einer Listen- oder Listenteilseite doppelklickt.

Wenn die Basisseite bereits über die Eigenschaft verfügt, wird sie durch den Wert ersetzt, den Sie in festgelegt haben PageExtension . Wenn mehrere PageExtension Objekte die Eigenschaft ändern, wird die Änderung in der letzten Erweiterung wirksam. Da die Erweiterungen pro Mandant nach AppSource-Apps angewendet werden, können Sie jeden Konflikt zwischen mehreren AppSource-Apps lösen, die dieselbe CardPageId in einer mandantenspezifischen Erweiterung festlegen. Dieser Konflikt kommt selten vor.

Wie viele andere Programmiersprachen unterstützt AL jetzt die Verwendung von continue in Schleifen, um die nächste Schleifeniteration auszulösen. Zuvor wurde nur das break Schlüsselwort unterstützt. Das break Schlüsselwort bricht die gesamte Schleife ab. Das continue Schlüsselwort überspringt die aktuelle Iteration und geht zur nächsten über.

Um einen Breaking Change zu vermeiden, unterstützt der Compiler das Schlüsselwort continue nicht in Schleifen, wenn der Kontext über ein Mitglied wie continue, z. B. eine Methode oder ein Feld, verfügt. Der Compiler warnt vor dieser Einschränkung, lässt aber weiterhin das Deklarieren von Objekttypen mit dem Namen continue.

Die neue Überladung der IncStr Methode unterstützt das Erhöhen oder Verringern einer Zahl in einer Zeichenfolgenvariablen um einen beliebigen Betrag. Mit dieser Methode können Sie Nummernreihen oder ähnliche Reihen in einem einzigen Schritt um mehr als eine Position inkrementieren.

Um eine positive Zahl zu verringern, verwenden Sie eine try Funktion, um Fälle zu behandeln, in denen die Zeichenfolge nicht weiter verringert werden kann. Wenn Sie eine Zahl verringern, fügt die Methode bei Bedarf führende Nullen hinzu.

Das folgende Beispiel zeigt, wie die ganze Zahl 99 in der Zeichenfolgenvariablen AText in einem einzigen Aufruf auf 109 erhöht wird, indem die neue IncStr-Methodenüberladung mit dem Inkrementwert 10 verwendet wird.

Stellen Sie eine Verbindung mit externen Speicherkonten, Containern und Blobs her, und arbeiten Sie mit ihnen über Ihren AL-Code. Das External File Storage-Modul bietet Ihnen ein Framework, mit dem Sie problemlos eine Verbindung mit Azure Blob Services oder Azure Files herstellen können.

Als AL-Entwickler können Sie das Modul für folgende Aufgaben verwenden:

• Erstellen, öffnen, ändern und löschen Sie Dateien über eine benutzerfreundliche API.
• Geben Sie externe Dateispeicherszenarien an, und lassen Sie Benutzer den Speicher für jedes Szenario konfigurieren.
• Durchsuchen Sie externe Dateispeicher.

Weitere Informationen finden Sie unter Externer Dateispeicher.

Auf der Seite Erweiterungsverwaltung bietet die Aktionsgruppe In VS Code entwickeln Entwicklern neue Optionen. Eine Option ist die Aktion In VS Code herunterladen . Mit dieser Aktion können Sie eine oder mehrere Erweiterungen auswählen, die in Visual Studio Code geöffnet werden sollen.

Im geöffneten Visual Studio Code-Projekt haben Sie immer Zugriff auf Symbole für diese Erweiterungen. Der Zugriff auf den Quellcode hängt von den IP-Schutzeinstellungen für die Erweiterungen und Benutzerberechtigungen ab.

Nun können Sie direkt im Web-Client eine passende launch.json Konfiguration für die jeweilige Umgebung generieren. Mit dieser Konfiguration können Sie eine bestimmte Umgebung in Visual Studio Code einfacher untersuchen oder debuggen.

Der Business Central Web-Client bietet zwei Möglichkeiten, die launch.json Konfiguration zu generieren.

• Verwenden Sie die Aktion Startkonfigurationen für diese Umgebung generieren im Abschnitt Fehlerbehebung auf der Seite Hilfe und Support .

• Verwenden Sie die Aktion Startkonfigurationen generieren in der Aktionsgruppe In VS Code entwickeln im Seitenmenü Erweiterungsverwaltung .

Jetzt können Sie Listen oder Wörterbücher von Schnittstellen erstellen.

Die Syntax folgt diesen Mustern. Sie entsprechen der Syntax zum Erstellen einer Liste oder eines Wörterbuchs eines einfachen Typs:

• Liste von [Interface IFoo]
• Wörterbuch von [; Interface IFoo]

In der Systemanwendung finden Sie vollständige Beispiele für die Verwendung einer Liste von Schnittstellen im Telemetrie-Logger.

In den folgenden Beispielen wird gezeigt, wie Listen und Wörterbücher mit Schnittstellen erstellt werden.

Sie können jetzt eine Zeichenkette in AL schreiben, die sich über mehrere Zeilen erstreckt, indem Sie ihr das Präfix voranstellen @. Mit dieser Funktion können Sie die Zeichenfolge in einer besser lesbaren Form schreiben. Verwenden Sie diese Option, wenn die Zeichenfolge strukturierte Formate enthält, z. B. JSON-Inhalte.

Wenn Sie diese Option verwenden, vermeiden Sie das Hinzufügen von zusätzlichem Leerzeichen, z. B. durch Einrücken von Zeilen. Das Leerzeichen wird Teil der Zeichenfolge.

Das folgende Beispiel zeigt, wie Sie diese Funktion verwenden, wenn Sie einer Textvariablen eine JSON-Vorlagenstruktur zuweisen. Im Beispiel wird am Anfang der Zeichenfolge verwendet @ , um eine mehrzeilige Zeichenfolge anzugeben.

Die folgenden neuen Eigenschaften sind für Berichtslayouts verfügbar:

• ObsoleteState
• ExcelLayoutMultipleDataSheets

Mit der ObsoleteState-Eigenschaft können Sie ein Layout als veraltet markieren und angeben, dass das Layout in einer zukünftigen Version entfernt wird. Die Eigenschaft wird auf der Seite Berichtslayouts angezeigt.

Mit der ExcelLayoutMultipleDataSheets-Eigenschaft können Sie die Eigenschaft für das Layout so festlegen, dass die globale Eigenschaft für das Berichtsobjekt überschrieben wird. Für Berichte, in denen Sie die globale Eigenschaft ExcelLayoutMultipleDataSheets nicht festgelegt haben (die vom System als falsch interpretiert wird), können Sie Excel-Layouts hinzufügen, die die ExcelLayoutMultipleDataSheets-Eigenschaft verwenden, ohne zu riskieren, dass vorhandene Excel-Layouts, die Benutzer hinzugefügt haben, beschädigt werden.

Mit diesem Veröffentlichungszyklus wird ein neuer Seitentyp eingeführt, der die Einbettung von Power BI-Berichten verbessert. Power BI-Berichte werden in einer schlanken, optisch ansprechenden und benutzerfreundlichen Oberfläche angezeigt. Zu den wichtigsten Verbesserungen gehören:

• Die Benutzeroberfläche entfernt irrelevante Schaltflächen wie Löschen und Bearbeiten für eingebettete Berichte.
• Die Benutzeroberfläche verfeinert und gleicht Ränder und Abstände um Berichte herum aus.
• Die Benutzeroberfläche verwendet Titel, die weniger Platz beanspruchen.
• Die Benutzeroberfläche fügt neue Steuerelemente für den Zoom und die Anpassung an die Seite hinzu.

Diese Verbesserungen gelten für die meisten Power BI-Berichte in Business Central, sodass Sie auf der gesamten Plattform eine konsistente, verbesserte Erfahrung erhalten. Die folgenden Abbildungen zeigen den Unterschied zwischen der vorherigen und der neuen Benutzeroberfläche für den Verkaufsbericht:

Vorher

Jetzt

Neuer UserControlHost-Seitentyp

Der UserControlHost Seitentyp in AL aktiviert die neue eingebettete Power BI-Berichtsoberfläche. Der UserControlHost Seitentyp vereinfacht das Einbetten von benutzerdefinierten Steuerelementen, z. B. Power BI-Berichten, im Vergleich zur Verwendung eines Card Seitentyps in früheren Versionen, indem unnötige Komplexitäten entfernt werden.

Zu den wichtigsten Aspekten des Seitentyps gehören:

• Eigenschaften und Trigger, die nicht für Steuerelement-Add-Ins gelten, z. B. die SourceTable-Eigenschaft und der OnAfterGetRecord-Trigger, werden ausgeschlossen.
• In der Benutzeroberfläche nimmt das eingebettete Steuerelement den gesamten Seitenbereich ein, sodass keine zusätzlichen Aktionen oder Schaltflächen vorhanden sind.
• Entwickler können den Seitentyp problemlos im AL-Code verwenden.

Betrachten Sie dieses vereinfachte Codebeispiel einer Seite, die ein WebPageViewer-Steuerelement mithilfe des Seitentyps Card anzeigt.

page 50100 UserControl {     PageType = Card;     ApplicationArea = All;     SourceTable = Customer;     InsertAllowed = false;     ModifyAllowed = false;     DeleteAllowed = false;     Editable = false;     Caption = 'UserControl Example';      layout     {         area(Content)         {             usercontrol(Webpageview; WebPageViewer)             {                 ApplicationArea = All;                  trigger ControlAddInReady(callback: text)                 begin                     CurrPage.Webpageview.Navigate(HyperLinkTxt)                 end;                 trigger Refresh(CallbackUrl: Text)                 begin                     CurrPage.Webpageview.Navigate(HyperLinkTxt)                 end;             }         }     } } 

Im folgenden Code wird der UserControlHost Seitentyp verwendet. Der UserControlHost Seitentyp lässt die Eigenschaften SourceTable, InsertAllowed, ModifyAllowed und DeleteAllowed nicht zu.

page 50122 UserControl {     PageType = UserControlHost;     ApplicationArea = All;     Editable = false;     Caption = 'UserControl Example';      layout     {         area(Content)         {             usercontrol(Webpageview; WebPageViewer)             {                 ApplicationArea = All;                  trigger ControlAddInReady(callback: text)                 begin                     CurrPage.Webpageview.Navigate(HyperLinkTxt)                 end;                  trigger Refresh(CallbackUrl: Text)                 begin                     CurrPage.Webpageview.Navigate(HyperLinkTxt)                 end;             }         }     } } 

Der Business Central-Client sendet ein Telemetrieereignis, wenn eine Ausnahme in einem Client-Add-In auftritt. Mit Telemetriedaten können Administratoren Fehler überwachen und beheben, bevor Benutzer die Probleme melden.

Der Client protokolliert die folgenden Arten von Informationen zu Problemen:

• Umgebung und Unternehmen
• Erweiterung, App oder Add-In
• Typ des Clients (Browser, Tablet, Smartphone usw.)
• Informationen zum Fehler
• Der Benutzer, bei dem der Fehler auftritt.

In den letzten beiden Versionen konnten Sie Tabellen und Felder zwischen Erweiterungen für Erstanbietererweiterungen von Microsoft verschieben. In dieser Version können Partner diese Funktionen für ihre Erweiterungen verwenden.

Die beste Abdeckung dieser Funktionen finden Sie in der vorhandenen Dokumentation, die die Unterstützung in Erstanbieter-Apps abdeckt. Weitere Informationen finden Sie unter Verschieben von Tabellen und Feldern zwischen Erweiterungen.

Die API für den Zugriff auf JSON-Daten enthält jetzt Methoden, die Sie verwenden können, anstatt Daten immer über ein JsonToken zu lesen.

Verwenden Sie für JsonObject-Instanzen Folgendes:

value := GetBoolean(Key: Text [; DefaultIfNotFound: Boolean]) value := GetByte(Key: Text [; DefaultIfNotFound: Boolean]) value := GetChar(Key: Text [; DefaultIfNotFound: Boolean]) value := GetInteger(Key: Text [; DefaultIfNotFound: Boolean]) value := GetBigInteger(Key: Text [; DefaultIfNotFound: Boolean]) value := GetDecimal(Key: Text [; DefaultIfNotFound: Boolean]) value := GetOption(Key: Text [; DefaultIfNotFound: Boolean]) value := GetDateTime(Key: Text [; DefaultIfNotFound: Boolean]) value := GetDate(Key: Text [; DefaultIfNotFound: Boolean]) value := GetTime(Key: Text [; DefaultIfNotFound: Boolean]) value := GetDuration(Key: Text [; DefaultIfNotFound: Boolean]) value := GetText(Key: Text [; DefaultIfNotFound: Boolean]) value := GetArray(Key: Text [; DefaultIfNotFound: Boolean]) value := GetObject(Key: Text [; DefaultIfNotFound: Boolean]) 

Verwenden Sie für JsonArray-Instanzen Folgendes:

value := GetBoolean(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetByte(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetChar(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetInteger(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetBigInteger(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetDecimal(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetOption(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetDateTime(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetDate(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetTime(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetDuration(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetText(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetArray(Index: Integer [; DefaultIfNotFound: Boolean]) value := GetObject(Index: Integer [; DefaultIfNtFound: Boolean]) 

Um ein neues vorlagenbasiertes AL-Projekt in Visual Studio Code zu erstellen, verwenden Sie den Befehl AL: Neues Projekt . Die Tastenkombination ist ALT+AALT+P.

Wenn Sie den Befehl ausführen, wählen Sie aus, ob Sie Copilot-Beispiel-Apps oder das klassische Hello World AL-Projekt erstellen möchten.

Die ToText-Methode ist jetzt für einfache Typen wie BigInteger, Boolean, Byte, Date, DateTime, Decimal, Duration, Guid, Integer, Time und Version verfügbar. Verwenden Sie diese Methode, um diese Typen einfach in Text zu konvertieren.

Verwenden Sie für erweiterte Formatierungsoptionen die FORMAT-Methode.

Das Feature erweitert das vorhandene JsonObject, sodass Sie YAML in das JsonObject einlesen, es mit der JsonObject-API als JSON bearbeiten und möglicherweise erneut als YAML schreiben können.

Das Feature fügt zwei neue Methoden zum Einlesen von YAML in eine JsonObject-Instanz hinzu:

[Ok :=] ReadFromYaml(String) [Ok :=] ReadFromYaml(InStream) 

Das Feature fügt zwei neue Methoden hinzu, um eine JsonObject-Instanz als YAML zu schreiben:

[Ok :=] WriteToYaml(String) [Ok :=] WriteToYaml(OutStream) 

Um die Sicherheit von HTTP-Aufrufen von AL zu erhöhen, validiert die AL-Runtime jetzt alle Serverzertifikate, wenn Sie einen Webdienstendpunkt mit dem Datentyp HttpClient aufrufen. Die Zertifikatüberprüfung ist standardmäßig aktiviert. Ein Serverzertifikat befindet sich auf der Endpunktseite. Es handelt sich nicht um das Zertifikat, das Sie an eine Anforderung in AL anfügen.

Wenn eine App oder eine Erweiterung pro Mandant die Zertifikatüberprüfung deaktivieren muss, fügen Sie die neue Eigenschaft dem HttpClient-Datentyp hinzu. AL-Code kann die Überprüfung des Serverzertifikats für den ausgehenden Webdienstaufruf deaktivieren.

Wenn der Herausgeber einer App oder einer Erweiterung pro Mandant fehlerhafte HTTP-Aufrufe debuggen muss, weil Serverzertifikate nicht überprüft werden können, fügen Sie das neue Telemetrieereignis hinzu. Das Ereignis tritt ein, wenn die Zertifikatsüberprüfung fehlschlägt.

Herausgeber von App- und Pro-Mandanten-Erweiterungen können die Zertifikatüberprüfung mithilfe eines Featureverwaltungsschlüssels deaktivieren. In Version 27 ist die Zertifikatüberprüfung immer aktiviert und kann nicht deaktiviert werden.

Entwickler können Ressourcen in Erweiterungen packen und über AL-Code auf diese Ressourcen zugreifen. Verwenden Sie diese Funktion, um Daten für Setup- und Initialisierungsfunktionen zu senden, z. B. RapidStart-Pakete, Demodaten und Vorlagen. Zu diesem Zweck müssen Sie keine Labels oder Codeunits verwenden.

Um Ressourcen in einer Erweiterung zu packen, deklarieren Sie die Ordner in Ihrem Projekt, die Ressourcen in der Manifestdatei der Erweiterung enthalten (app.json). Fügen Sie der Manifestdatei die resourceFolders-Eigenschaft hinzu. Sie können mehrere Ordner angeben. Ressourcenordner können Unterordner enthalten.

AL-Code kann zur Laufzeit auf Ressourcen zugreifen. Verwenden Sie mehrere Methoden, um mit Ressourcen zu interagieren:

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

Eine Erweiterung kann nur auf ihre eigenen Ressourcen zugreifen.

Für Ressourcen gelten die folgenden Größenbeschränkungen:

• Jede einzelne Ressourcendatei kann bis zu 16 MB groß sein.
• Alle Ressourcendateien zusammen können bis zu 256 MB groß sein.
• Eine Erweiterung kann bis zu 256 Ressourcendateien enthalten.

Wenn Sie eine Erweiterung aus Visual Studio Code bereitstellen, stellen Sie ein Diagramm der installierten Erweiterungen in der Zielumgebung bereit. Beim Bereitstellungsprozess werden abhängige Erweiterungen der ersten Ebene deinstalliert und deren Veröffentlichung aufgehoben, sodass sie nach der Bereitstellung der Erweiterung neu kompiliert werden können. Wenn bei der Bereitstellung von Visual Studio Code ein Fehler auftritt (z. B. aufgrund eines Kompilierungsproblems auf dem Server), wird auf dem Server ein unvollständiges Diagramm der installierten Erweiterungen angezeigt. Sie müssen die zuvor installierten Erweiterungen manuell in der richtigen Reihenfolge erneut bereitstellen. In dieser Version versucht Visual Studio Code, den vorherigen Erweiterungsstatus wiederherzustellen, sodass Sie in der Regel keine manuelle Arbeit leisten müssen.

Sie können nun eine oder mehrere vorhandene Schnittstellen erweitern, wenn Sie eine Schnittstelle deklarieren. Wenn Sie eine Schnittstelle implementieren, die andere Schnittstellen erweitert, müssen Sie auch alle Methoden aller erweiterten Schnittstellen implementieren.

Diese Funktion funktioniert auch mit den Testing- und Casting-Operatoren is und as, die in dieser Version der AL-Sprache ebenfalls neu hinzugefügt wurden.

Das folgende Beispiel zeigt die Syntax. Sie können TheImplementor als IFoo, IBarund IFooBarverwenden.

Verwenden Sie zum Ausführen von Seitenskripts in Ihren eigenen Pipelines den eigenständigen bc-replay-Skriptplayer. Der Script-Player ist als npm-Paket (Node Package Manager) verfügbar. Installieren Sie die neueste Version des Pakets aus dem npm-Feed. Es ist kein Setup erforderlich. Führen Sie einfach den folgenden Befehl aus: npm install @microsoft/bc-replay --save.

Weitere Informationen zu Anforderungen, Setup und Parametern finden Sie auf der bc-replay npm-Paketseite.

Wir planen, später Unterstützung für AL-Go für GitHub hinzuzufügen. Mit dieser Unterstützung können Sie eine Pipeline schneller einrichten, wenn Sie AL-Go für GitHub verwenden. Wenn Sie einen anderen CI/CD-Agent und eine andere Umgebung verwenden, erstellen Sie Ihre eigenen Pipeline-Setups.

Zuvor haben wir generische Unterstützung für das Ausführen von Codeaktionen für das aktive Dokument, das aktive Projekt oder den gesamten Arbeitsbereich hinzugefügt. Codeaktionen übernehmen diese Unterstützung. Diese Codeaktionen konvertieren die Verwendung von ApplicationArea oder QuickInfos (Tooltips). In dieser Version können Sie die Codeaktion ausführen, mit der die Verwendung von with für das gesamte Dokument, das aktive Projekt und den gesamten Arbeitsbereich konvertiert wird. Diese Änderung macht es wesentlich produktiver, die Verwendung von with Anweisungen in vorhandenem Code in explizite Datensätze umzuwandeln.

Das this Schlüsselwort bietet Selbstreferenzunterstützung für alle Objekte, wie man sie aus anderen Programmiersprachen kennt.

Die Verwendung des Schlüsselworts this bringt die folgenden Hauptvorteile:

• Ermöglicht es Codeunits, einen Verweis auf sich selbst als Argument an eine andere Methode zu übergeben.
• Die Lesbarkeit wird verbessert, indem signalisiert wird, dass ein referenziertes Symbol ein Mitglied des Objekts selbst ist.

Eine neue CodeCop-Regel AA0248 wird hinzugefügt und standardmäßig mit dem Schweregrad "versteckt" aktiviert. "Versteckt" bedeutet, dass die Regel als drei Punkte im Editor angezeigt wird, aber nicht als Diagnose in der Problemansicht in Visual Studio Code oder in Pipelines. Ein arbeitsbereichsweiter CodeFixer aktualisiert vorhandenen Code, um das this Schlüsselwort zu verwenden.

Die Systemanwendung wird konvertiert, um das Schlüsselwort this zum Verweisen auf Methoden und globale Variablen im selben Objekt zu verwenden.

Verwenden Sie den ternären Operator ? : , um einer Variablen basierend auf der Bedingung in einem Ausdruck einen von zwei Werten zuzuweisen.

Im Folgenden finden Sie ein Beispiel, das die Verwendung if-then-else mit dem neuen ternären Operator vergleicht.

In dieser Version haben wir das Feature "Erkunden in Visual Studio Code" verbessert, indem wir die Quell- und Buildmetadaten in einem Erweiterungsmanifest verwendet haben, um die Quelle aus dem zugehörigen GitHub-Repository und aus einem bestimmten Build abzurufen. Mit dieser Funktion können Sie im Code für Erweiterungen navigieren, wenn Sie über Quellzugriff verfügen. Sie können auch einen Hotfix für ein Build anwenden oder synchronisieren, um die neuesten Änderungen zur Untersuchung oder zur Entwicklung abzurufen.

Auf der Listenseite Erweiterungsverwaltung können Sie im Kontextmenü für eine Erweiterung die neue Option Open Source in VS Code auswählen.

Wenn Sie diese Option auswählen, wird Visual Studio Code geöffnet und fragt, ob das GitHub-Repository für die Erweiterung geklont oder geöffnet werden soll. Visual Studio Code verwendet die Repository-Metadaten, die von der Erweiterung bei der Erstellung hinzugefügt werden.

Weitere Informationen zu Quell- und Buildmetadaten in der app.json Datei finden Sie unter:

• Quell- und Build-Metadaten für Erweiterungen verfolgen
• JSON-Dateien

Zusätzlich zu der bestehenden interaktiven Methode zum Erfassen eines Leistungsprofils fügt die Funktion einen regelbasierten Planungsmodus hinzu, der Profile im Hintergrund erfasst. Die vorhandene interaktive Methode zum Erfassen eines Leistungsprofils startet das Profil, führt Reproduktionsschritte im Client aus, stoppt den Profiler und analysiert dann die Ergebnisse.

Mit dem neuen Planungsmodus kann ein Kundenadministrator, Berater, Supportmitarbeiter oder Entwickler eine bestimmte geplante Regel einrichten. Zum Beispiel können Sie ein Profil als Benutzer oder Sitzungstyp für eine gewisse Dauer erstellen. Wenn Sie die Regel definieren und aktivieren, löst der Server jedes Mal ein Profil aus, wenn die Regel erfüllt ist. Am Ende der Dauer beendet der Server die Profilerstellung. Sie können die Ergebnisse überprüfen, um festzustellen, ob Leistungsprobleme vorliegen, einschließlich zeitweiliger oder lang andauernder Probleme.

Öffnen Sie die Seite Profiler-Zeitpläne, um einen neuen Zeitplan für Profilregeln zu erstellen. Auf der Seite werden die definierten Zeitpläne und die zusätzlichen Zeitplandetails aufgelistet. Sie können einen neuen Zeitplan erstellen.

Wenn Sie einen neuen Zeitplan für die Profilerfassung erstellen, definieren Sie Regeln und Einstellungen für den Zeitplan:

• Aktiviert: Aktivieren oder deaktivieren Sie den Zeitplan.
• Start- und Endzeit: Legen Sie die Dauer fest, in der der Zeitplan aktiv ist und Profilerfassungen auslösen kann.
• Beschreibung: Fügen Sie eine Beschreibung für den Profilzeitplan hinzu.
• Benutzer-ID: Wählen Sie aus, ob der Zeitplan nur Profile für einen bestimmten Benutzer erfasst.
• Aktivitätstyp: Wählen Sie die Art der Aktivität aus, die die Profilerfassung auslöst. Dabei kann es sich um Hintergrundaufgaben oder Aktivitäten im Browser handeln, z. B. das Öffnen einer Seite.
• Sampling-Häufigkeit: Wählen Sie die Sampling-Häufigkeit für die Erfassung von Profilen aus. Wählen Sie die gleichen Optionen wie im vorhandenen interaktiven In-Client-Leistungsprofiler oder AL-Profiler in Visual Studio Code aus.
• Schwellenwert für die Profilerstellung: Legen Sie die Mindestdauer des Profils fest.
• Aufbewahrungszeitraum: Legen Sie fest, wie lange erfasste Profile für diesen Zeitplan aufbewahrt werden sollen.

Im folgenden Beispiel wird gezeigt, wie Sie einen Zeitplan für die Erfassung von Profilen für die Browseraktivität eines bestimmten Benutzers für einen Zeitraum von fünf Tagen einrichten.

Wenn Sie Profilzeitpläne definieren, aktivieren und ausführen, können Sie alle erfassten Profile auf der Listenseite "Leistungsprofile " anzeigen. Sie können ein ausgewähltes Profil für eine detaillierte Analyse öffnen, ähnlich wie bei der Erfahrung im In-Client-Performance-Profiler.

Als AL-Entwickler können Sie jetzt angeben, welche Tabellenfelder in Volltextsuchindizes in der Datenbank aufgenommen werden sollen. Wenn Sie diese Felder angeben, werden die Suchfunktionen in Dynamics 365 Business Central schneller und bieten bessere Suchfunktionen. Zu diesen Funktionen gehören:

• Unternehmensweite Suche (Datensuche)
• Suche auf der Listenseite
• Lookup-Suche

Um die Volltextsuche anzugeben, legen Sie die OptimizeForTextSearch Eigenschaft für Felder in Tabellen oder Tabellenerweiterungen fest.

Verwenden Sie im AL-Code die neue && Filtersyntax in der SetFilter() Methode. Beispiel:

FieldRef.SetFilter('&&' + SearchString + '*') 

Diese Syntax unterstützt eine Teilmenge des SQL Server-Operators CONTAINS .

Verwenden Sie die neue OptimizedForTextSearch Eigenschaft für die virtuelle Tabelle Field und IsOptimizedForTextSearch die Eigenschaft für Variablen des FieldRef-Datentyps.

In dieser Version fügen wir Unterstützung für Reseller und Herausgeber hinzu, um Symbole für AppSource-Anwendungen herunterzuladen, für die entwickelt werden soll, indem wir einen öffentlichen NuGet-Feed mit Paketen bereitstellen, die Symbole für AppSource-Anwendungen enthalten. Wenn Sie AL-Go für GitHub verwenden, werden diese Symbole während des Builds automatisch gesucht und heruntergeladen. Sie können auch AL-Go für GitHub verwenden, um Tests in Online-Sandboxes auszuführen.

Mit dieser Funktion können Sie Profilerweiterungsobjekte in Ihrem AL-Code erstellen. Verwenden Sie diese Objekte, um die Beschriftung oder das Rollencenter des Zielprofils zu ändern. Sie können diese Objekte auch verwenden, um das Profil in den Rollen-Explorer aufzunehmen oder daraus zu entfernen. Sie können Seitenanpassungen zu einem angegebenen Profil hinzufügen.

Zusätzlich zur Sprachunterstützung wurde eine zusätzliche Abdeckung in IntelliSense, AL Explorer und Analyseregeln aufgenommen.

Das folgende Codebeispiel zeigt eine Profilerweiterung:

In dieser Version führen wir Unterstützung für die Umwandlung zwischen AL-Schnittstellen ein. Wenn eine Schnittstelle A angegeben ist, können Sie sie in Schnittstelle B umwandeln, wenn das zugrunde liegende Objekt (vorerst nur Codeunit-Objekte) Schnittstelle B implementiert. Um diese Vorgänge zu vereinfachen, haben wir zwei neue Operatoren hinzugefügt: is und as.

Der Operator is

Mit dem is Operator können Sie testen, ob eine Instanz einer Schnittstelle oder der Inhalt einer Variante eine bestimmte Schnittstelle unterstützt. Hier ist die Syntax für die Verwendung des is Schlüsselworts:

Sie können den Operator is auch mit Varianten verwenden:

Der Operator as

Verwenden Sie den as Operator, um eine Instanz einer Schnittstelle in eine bestimmte Schnittstelle umzuwandeln. Wenn die Quellschnittstelle die Zielschnittstelle nicht implementiert, löst der Vorgang zur Laufzeit einen Fehler aus. Ein Beispiel:

Das as Keyword funktioniert auch mit Varianten:

Verwenden Sie Berichtsdokumente in Business Central, wenn Sie ein Dokument, z. B. ein Angebot, einen Auftrag oder eine Rechnung, an Ihre Kunden oder Lieferanten senden müssen. In den folgenden Abschnitten sind die Verbesserungen in dieser Version aufgeführt.

Word-Layouts

Die Word-Layoutfunktion enthält die folgenden Verbesserungen:

• Sie können Abschnitte in Word-Layouts nutzen, auch wenn der Bericht die Eigenschaft „WordMergeDataItem“ in AL-Code verwendet. Diese Verbesserung gibt Ihnen die Möglichkeit, Layouteigenschaften zu ändern, z. B. Ränder, Ausrichtung (Hoch- oder Querformat) oder Spalten in Ihrem Word-Layout. Sie können auch unterschiedliche Wasserzeichen für verschiedene Teile des Layouts verwenden. Weitere Informationen finden Sie unter Verwenden von Abschnitten in einem Word-Layout.

• Ein neues Word-Add-In, mit dem Sie die bedingte Sichtbarkeit von Text, Tabellen oder Tabellenzeilen und -spalten steuern können.

• Neue Layouts, auf die Sie Designs anwenden können, sind für die folgenden Dokumentberichte verfügbar: Rechnungsentwürfe, Verkaufsangebote, Bestätigungen, Rechnungen, Gutschriften, Lieferungen, Rücksendungen und Bestellungen.

Wenn Sie das Office-Design auf der Registerkarte Entwurf ändern, können Sie das Erscheinungsbild des Berichts, einschließlich Farben, Schriftarten und Formatvorlagen, direkt in Word aktualisieren.

Seite „Berichtslayouts“

Auf der Seite Berichtslayouts können Sie jetzt die folgenden Aufgaben ausführen:

• Ein Berichtsschema als benutzerdefinierte Microsoft Word-XML-Datei exportieren. Verwenden Sie diese Datei, um die Konvertierung eines RDL-Layouts oder einer vom Kunden bereitgestellten Word-Datei in ein Word-Layout für einen Bericht zu vereinfachen.

• Ein Layout mit der neuesten Definition des Berichtsdatensatzes aktualisieren.

• Ein neues leeres Word-Layout für einen beliebigen Bericht erstellen.

Seite „Benutzerdefinierte Berichtslayouts“

Auf der Seite Benutzerdefinierte Berichtslayouts können Sie Layouts in die neue Systemtabelle für Layouts migrieren. Die Layouts werden auf der Seite Berichtslayouts angezeigt.

Visual Studio Code

In Visual Studio Code haben wir einen Codeausschnitt für Berichte und Abfragen DataLinkItem hinzugefügt, um Entwicklern zu helfen, beim Erstellen von Berichtsobjekten produktiver zu sein.

Berichtslayout für Lebenszyklustelemetrie (25.1)

Das System sendet ein Telemetrieereignis, wenn Sie auf der Seite Berichtslayouts eine der folgenden Aktionen ausführen:

• Berichtslayout hinzufügen
• Standardlayout für einen Bericht ändern
• Eigenschaften für ein Berichtslayout ändern
• Berichtslayout exportieren
• Berichtslayout ersetzen
• Berichtslayout löschen

Entwickler können mehrere Datei-Uploads verarbeiten. Mit dieser Verbesserung können AL-Entwickler flexiblere und benutzerfreundlichere Schnittstellen innerhalb von Business Central erstellen. Wenn Entwickler bestimmte Aktionen festlegen, können Benutzer mehrere Dateien gleichzeitig hochladen, was die Effizienz verbessert.

Diese Funktion ist besonders nützlich für Entwickler, die an Anwendungen oder Anpassungen arbeiten, bei denen Benutzer mehrere Dateien gleichzeitig hochladen müssen.

Mit der FileUploadAction-Aktion verwenden Entwickler die AllowMultipleFiles-Eigenschaft, um anzugeben, ob eine Aktion eine einzelne Datei oder mehrere Dateien verarbeitet. Entwickler verwenden die AllowedFileExtensions-Eigenschaft, um die Dateitypen anzugeben, die Benutzer hochladen können. Der OnAction-Trigger in der FileUploadAction-Eigenschaft wird mit der Liste der Dateien aufgerufen.

page 50102 HappyMultiFileUploadPage {     PageType = Card;     SourceTable = Item;     UsageCategory = Administration;      layout     {         area(content)         {         }     }      actions     {         area(Processing)         {             fileuploadaction(ProductImageUpload)             {                 Caption = 'Upload product image';                 AllowMultipleFiles = true;                 AllowedFileExtensions = '.jpg', '.jpeg', '.png';                 trigger OnAction(Files: List of [FileUpload])                 var                     CurrentFile: FileUpload;                     TempInStream: InStream;                 begin                     foreach CurrentFile in Files do begin                         CurrentFile.CreateInStream(TempInStream, TEXTENCODING::UTF8);                         // Code here to handle the file                         Message('%1 has a length of %2', CurrentFile.FileName, TempInStream.Length)                     end;                 end;             }         }     } } 

Die neue mobile Business Central-App, die in der letzten Version eingeführt wurde , unterstützte die in der App beschriebenen Funktionen nicht vollständig für alle Szenarien in Business Central Online.

Jetzt unterstützen und ermöglichen sowohl Business Central online als auch lokal diese Szenarien vollständig. Zu diesen Szenarien gehört das ereignisgesteuerte Scannen von Barcodes mit kompatiblen High-End-Laserscannern auf Geräten, auf denen Android OS ausgeführt wird. Weitere Informationen zu diesen Szenarien finden Sie unter Hinzufügen von Barcode-Scans zur mobilen App.

In den folgenden Abschnitten werden die neuen Funktionen beschrieben:

• Verwenden Sie Clienterweiterbarkeiten mit Steuerelement-Add-Ins. Entwickler deklarieren AL usercontrol auf ihren Seiten mit den APIs für Steuerelement-Add-Ins. Weitere Informationen finden Sie unter dem GitHub-Link.
• Im Vergleich zu vorhandenen Steuerelement-Add-Ins verfügen neue Steuerelement-Add-Ins nicht über eine Benutzeroberfläche. Die Seite enthält keinen iFrame oder einen visuellen Indikator. Sie können keine Skript- oder Formatierungsfunktionen bereitstellen.
• Aktualisieren Sie Ihren Code, um diese Funktionalität zu verwenden, und verwenden Sie die Steuerelement-Add-Ins.
• Das Mobilgerät verwendet die Business Central Mobile App Version 4.0 oder höher. Wechseln Sie zu https://aka.ms/bcmobileapp, um die aktuelle Version herunterzuladen.
• Dedizierte Barcode-Scanner laufen mit Android 11 oder höher.

Weitere Anleitungen finden Sie im GitHub-Repository mit dem Camera Barcode Scanner Provider.

Mit dieser Funktion können Sie sowohl das Basisobjekt als auch das Erweiterungsobjekt in derselben App definieren. Sie können z. B. eine Tabelle und eine Tabellenerweiterung in derselben App definieren.

In Metadaten sind Erweiterungsobjekte weiterhin getrennt. Jedes Erweiterungsobjekt benötigt eine eigene Objekt-ID im verwendeten Bereich. Die wichtigste Änderung besteht darin, dass sich Erweiterungsobjekte jetzt in derselben Erweiterung und App wie das Basisobjekt befinden können. Bei Tabellen werden Tabellenerweiterungen, die sich in derselben App wie die Basistabelle befinden, mit dieser Tabelle im Datenbankschema zusammengeführt. Diese Zusammenführung bedeutet, dass es keine Erweiterung für die Begleittabelle gibt.

Diese Funktion gilt für alle erweiterbaren Objekttypen. Einige Beispiele sind Seiten-, Tabellen-, Berichts-, Enumerations- und Berechtigungssatzobjekte.

Wenn Sie die Laufzeitversion 13.0 als Ziel verwenden, ist diese Funktion standardmäßig aktiviert.

Diese Version bietet die folgenden Verbesserungen am Datentyp der Nummernkreise:

• Neuer Neustartvorgang

  Vor dieser Version mussten Sie einen Nummernkreis löschen und neu erstellen, um ihn neu zu starten. Der neue Neustart-Vorgang vereinfacht und beschleunigt diesen Prozess nun. Der Vorgang verwendet die folgende Syntax:

  Restart(name: text; seed: BigInteger; CompanySpecific: bool) 

• Neue RangeStart-Operation

  Mit dem neuen RangeStart-Vorgang können Sie mehrere Werte gleichzeitig aus dem Nummernkreis anfordern. Dieser Ansatz beseitigt Lücken und reduziert SQL-Roundtrips. Der Vorgang verwendet die folgende Syntax:

    RangeStart : = Range(name: text; count: integer; CompanySpecific: bool); 

• Verbesserte Operationen Next, Current und Exists

  Diese Vorgänge sind jetzt um 8 bis 32 Prozent schneller.

Vor dieser Version musste ein Entwickler zum Abfragen eines OData-Endpunkts einen Filterausdruck schreiben. Um beispielsweise eine Anfrage an eine API für eine kurze Liste von Kundennummern zu stellen, schrieb der Entwickler $filter=CustomerNo eq '10000' or CustomerNo eq '20000' or CustomerNo eq '30000'.

In diesem Release kann der Entwickler den OData IN-Operator verwenden und schreiben $filter=CustomerNo IN ('10000','20000','30000').

Mit dem Page-Scripting-Tool im Business Central-Webclient können Sie Ihre Aktionen, wie z. B. das Öffnen von Seiten oder das Eingeben von Daten, aufzeichnen und wiedergeben. Sie können die Aufzeichnung speichern und für die zukünftige Wiedergabe mit anderen teilen. Ein wichtiger Anwendungsfall für das Tool ist das Erfassen und Ausführen von Benutzerakzeptanztests. Dieser Anwendungsfall ist der erste Schwerpunkt in dieser Veröffentlichungswelle.

Tool öffnen

Im Web-Client greifen Sie über das Menü Einstellungen (Zahnrad-Symbol) auf das Page-Scripting-Tool zu. Die Aktion "Seitenskripting" wird nur angezeigt, wenn Sie über die Aufnahme- oder Wiedergabeberechtigung zur Verwendung des Werkzeugs verfügen.

Der Bereich Page Scripting wird auf der rechten Seite geöffnet. Sie können eine neue Aufzeichnung starten oder eine vorhandene Aufzeichnung öffnen, um sie zu überprüfen oder wiederzugeben.

Datensatz

Um Ihre Aktionen aufzuzeichnen und einen Benutzerakzeptanztest zu starten, wählen Sie Neu starten oder Neu>Neue Aufzeichnung in der Symbolleiste oben im Bereich aus. Wenn die Aufzeichnung startet, wird in der Symbolleiste ein durchgehender roter Kreis angezeigt. Führen Sie die Aktionen aus, die Sie erfassen möchten.

Das Seiten-Scripting-Tool erfasst Ihre Interaktionen auf dem Bildschirm und die daraus resultierenden Aktionen. Es erfasst Aktionen wie das Öffnen oder Schließen von Seiten, Auswahlen und Dateneingaben.

Während der Aufzeichnung können Sie den letzten aufgezeichneten Schritt löschen.

Um die Aufzeichnung zu stoppen, verwenden Sie die Schaltfläche Stopp in der Symbolleiste. Um die Aufzeichnung fortzusetzen und weitere Schritte hinzuzufügen, wählen Sie in der Symbolleiste die runde Schaltfläche Aufzeichnung starten aus.

Die folgende Abbildung zeigt einige erfasste Schritte und die Symbolleiste während der Aufzeichnung.

Optionen zum Erfassen von Schritten

Während der Aufzeichnung können Sie spezielle Schritte hinzufügen, indem Sie mit der rechten Maustaste auf ein Seitensteuerelement klicken, z. B. ein Feld, und eine Option auswählen. In den folgenden Abschnitten werden diese Optionen erläutert.

In die Zwischenablage kopieren und einfügen

Das Seitenskripting-Tool enthält eine Zwischenablage, die Sie zum Kopieren von Feldwerten verwenden können. Sie können z. B. kopierte Werte in andere Felder einfügen, sie in Ausdrücken verwenden oder sie zum Überprüfen von Ergebnissen verwenden. Um während der Aufzeichnung zu kopieren und einzufügen, klicken Sie mit der rechten Maustaste auf ein Seitensteuerelement, und wählen Sie im Kontextmenü Kopieren oder Einfügen aus.

Sitzungsinformationen einfügen

Wenn Sie aufzeichnen, können Sie auf Sitzungsinformationen zugreifen, z. B. auf die Benutzer-ID. Mit diesen Informationen können Sie Filter basierend auf dem aktuellen Benutzer festlegen. Um die Benutzer-ID einzufügen, klicken Sie mit der rechten Maustaste auf ein Steuerelement auf der Seite, und wählen Sie Einfügen>Sitzungsinformationen>Benutzer-ID aus. Ein Beispiel finden Sie in der vorherigen Abbildung.

Validieren eines Ergebnisses

Fügen Sie während der Aufzeichnung Validierungsschritte ein, um das Ergebnis bei der Wiedergabe der Aufzeichnung zu überprüfen. Klicken Sie mit der rechten Maustaste auf ein Steuerelement, z. B. ein Feld oder einen Hinweis, und wählen Sie im Kontextmenü Überprüfen aus. In diesem Schritt wird ein Validierungsschritt mit dem aktuellen Wert eingefügt. Um den Wert zu ändern, den der Schritt überprüft, wechseln Sie zum Validierungsschritt in der Liste Page Scripting-Schritt , wählen Sie das Kontextmenü ... und dann Eigenschaften aus.

Schritte an Bedingungen knüpfen

Während der Aufzeichnung können Sie einen Bedingungsverzweigungsschritt einfügen. Zum Beispiel könnten Sie einige Schritte nur während der Wiedergabe ausführen, wenn keine aktuellen Zeilen in einer Liste vorhanden sind.

Um einen Zweig von bedingten Schritten einzufügen, klicken Sie mit der rechten Maustaste auf ein Seitensteuerelement, wählen Sie Bedingte Schritte hinzufügen aus, wenn, und wählen Sie dann eine Option aus.

Wenn Sie den bedingten Schritt einfügen, können Sie weitere Schritte hinzufügen, die ausgeführt werden sollen, wenn die Bedingung erfüllt ist.

Um den bedingten Zweig zu beenden, wählen Sie Bereich beenden in der Liste der Page Scripting-Schritte aus.

Um die Bedingung zu ändern, wählen Sie den Schritt "Bedingung" in der Liste der Page Scripting-Schritte aus. Erweitern Sie die Eigenschaften, und legen Sie die Vergleichsregel und den Wert fest.

Erfasste Schritte bearbeiten

Während der Aufzeichnung und Wiedergabe können Sie einen erfassten Schritt im Bereich Seitenskripterstellung bearbeiten, indem Sie das Kontextmenü ... des Schritts verwenden. Die Optionen im Kontextmenü hängen davon ab, ob Sie sich im Aufnahme- oder Wiedergabemodus befinden und um welche Art von Schritt es sich handelt. Einige der Optionen werden in den folgenden Abschnitten beschrieben.

Eigenschaften

Einige Schritte verfügen über Eigenschaften, die bedingte Schritte oder Validierungsschritte enthalten. Wählen Sie Eigenschaften aus dem Kontextmenü eines Schritts, um die Eigenschaften für einen Schritt anzuzeigen.

Ausdrücke in Eigenschaften verwenden

Werte und Bedingungen können Ausdrücke für einfache Berechnungen verwenden. Power Fx ist die Ausdruckssprache. Die Benutzeroberfläche enthält einen Link zur Referenzdokumentation für Power Fx-Ausdrücke.

Neben den Power Fx-Funktionen stehen drei Objekte der obersten Ebene zur Verfügung:

• Clipboard für den Zugriff auf die aktuellen Einträge, die Sie in der Aufzeichnung kopiert haben.
• Parameters für den Zugriff auf den Wert aller Parameter, die Sie an die Aufzeichnung übergeben.
• SessionInfo für Sitzungsinformationen wie die aktuelle Benutzer-ID.

Hier sind ein paar Beispiele:

• Um zu überprüfen, ob ein zuvor kopierter Wert in einem Validierungsschritt inkrementiert wird, verwenden Sie den Ausdruck Clipboard.'SO Processor Activities - ReadyToShip' + 1.
• Um einen "zufälligen" Namen zu generieren, der in einem Eingabeschritt verwendet werden soll, verwenden Sie den Ausdruck Customer " & Today().

Optionalseiten behandeln

Manchmal wird in einem aufgezeichneten Flow keine Seite angezeigt, da die Seite von Daten oder Einstellungen abhängt. Bei der Seite kann es sich z. B. um das Bestätigungsdialogfeld handeln, das angezeigt wird, wenn Sie einen Auftrag schließen. Um diese Situation zu bewältigen, machen Sie die Seite zu einer optionalen Seite. Der Flow führt die Schritte unter der Seite nur aus, wenn die Seite angezeigt wird. Um eine Seite optional zu machen, gehen Sie zur Schrittliste Page Scripting , wählen Sie den aufgezeichneten Schritt mit dem Namen Seite X wurde angezeigt, wählen Sie das Kontextmenü ... und wählen Sie Diese Seite als optionale Seite festlegen aus.

Die Schritte, die auf der Seite ausgeführt werden, werden eingerückt, um anzuzeigen, dass es sich um optionale Schritte handelt. Die Schritte werden nur ausgeführt, wenn die Seite angezeigt wird.

Aufzeichnung wiedergeben

Wählen Sie in der Symbolleiste die Option "Wiedergabe " aus, um eine Aufzeichnung abzuspielen, die Sie aus einer Datei aufgenommen oder geöffnet haben.

Während der Wiedergabe haben Sie folgende Möglichkeiten:

• Gehen Sie einen Schritt vorwärts oder rückwärts, indem Sie die Schaltflächen Vorwärts und Rückwärts in der Symbolleiste verwenden. Wenn Sie einen Schritt zurückgehen, macht das Werkzeug die Änderungen nicht rückgängig. Sie müssen die Änderungen manuell rückgängig machen.
• Gehen Sie zurück zum Anfang der Aufnahme.
• Führen Sie die Aufzeichnung bis zu einem bestimmten Schritt aus. Wählen Sie das Kontextmenü ... aus, und wählen Sie dann Ausführen bis hierher aus.

Während das Tool die Schritte wiedergibt, zeichnet es auf, ob jeder Schritt erfolgreich abgeschlossen wurde (grünes Häkchen) oder fehlschlägt (rotes Ausrufezeichen). Das Werkzeug zeigt das Ergebnis für alle Schritte an, mit denen ein Ergebnis überprüft wird.

Aufzeichnung speichern

Wählen Sie in der Symbolleiste Speichern aus, um die Aufzeichnung zu speichern. Mit dieser Aktion wird eine YAML-Datei erstellt, die Sie herunterladen, freigeben, bearbeiten und für die Wiedergabe erneut öffnen können.

Freigeben einer Aufzeichnung

Wählen Sie in der Symbolleiste Freigeben aus, um eine Aufzeichnung als Link freizugeben. Der Link enthält die vollständige Aufzeichnung und das Wiedergabeergebnis. Im folgenden Beispiel schlägt die Wiedergabe nach der Hälfte der Aufzeichnung fehl.

Unterstützte Erfassungsaktionen

Das Seitenskripting-Tool erfasst Aktionen, die aus der Ausführung von AL-Code resultieren. Bei dem Tool handelt es sich nicht um ein allgemeines HTML-Automatisierungstool. Es kann keine Elemente wie Steuerungs-Add-Ins (wie Diagramme), eingebettete Power BI oder Power Apps oder irgendetwas außerhalb der Business Central-Webclient-Erfahrung automatisieren.

Mit dieser Funktion können Sie beim Debuggen schrittweise in die Codebasis der Systemanwendung zugreifen. Sie können den Codefluss verstehen und Variablen überprüfen, es sei denn, die Variablen sind durch den neuen SecureText-Typ geschützt.

Der Zugriff auf das Debuggen der Systemanwendung hilft bei der Entwicklung und Problembehandlung von AppSource und kundenspezifischen Anwendungen. Es ist auch hilfreich, wenn Sie zur Systemanwendung beitragen über https://github.com/microsoft/BCApps.

Vor dieser Version musste man, wenn man eine QuickInfo in einem Feld benötigte (z. B. auf einer Karte und auch auf einer Listenseite), die QuickInfo in diesen beiden Seitenobjekten duplizieren.

In dieser Version definieren Sie den Tooltip in der Tabelle. Auf allen Seiten, auf denen das Feld angezeigt wird, wird automatisch der Tooltip angezeigt. Auf einer Seite können Sie eine für die Tabelle definierte QuickInfo überschreiben, indem Sie eine andere QuickInfo auf der Seite angeben.

Die AL-Spracherweiterung für Visual Studio Code beinhaltet nun Codeaktionen, die Tooltips von einer Seite zur Quelltabelle verschieben.

Der HttpClient-Datentyp unterstützt jetzt offiziell Cookies. Mit dieser Unterstützung können AL-Entwickler effizient Cookies senden und empfangen, wenn sie HTTP-Anfragen senden.

Mit dem Update wird ein neuer Cookie-Datentyp zusammen mit mehreren AL-Schnittstellen für die Verarbeitung von Cookies eingeführt:

• UseResponseCookies AL-Schnittstelle für den HttpClient-Datentyp, der die Zwischenspeicherung für Servercookies aktiviert oder deaktiviert.
• Cookie Datentyp, der ein Cookie-Objekt darstellt.
• AL-Schnittstellen zum Abrufen von Cookies aus einer HttpResponseMessage.
• AL-Schnittstellen zum Abrufen und Entfernen von Cookies aus einer HttpRequestMessage bzw. zum Hinzufügen von Cookies zu dieser Nachricht

Entwickler können wählen, ob sie Antwort-Cookies automatisch wiederverwenden, Cookies manuell verarbeiten oder eine Mischung aus beiden Ansätzen verwenden möchten.