Neu vergebene Objekte auf dieser Seite: Codeunits 50116–50118, Page 50105, Enum Extensions 50100 und 50101. Alle liegen im Bereich 50100–50149 der Haupt-App.
1Erst integrieren, dann programmieren
In NAV 2017 war fast jede Anbindung ein Entwicklungsauftrag: Excel über Automation, Outlook über ein Add-in mit eigener Installation, Benachrichtigungen über selbst gebaute Job-Queue-Codeunits. In Business Central ist vieles davon Einrichtung. Deine Aufgabe verschiebt sich: Du sorgst dafür, dass deine Erweiterung in diesen Integrationen gut aussieht und sich sauber ansprechen lässt.
| Wunsch des Kunden | NAV 2017 | Business Central | Deine Arbeit |
|---|---|---|---|
| Datensatz mit Kollegen besprechen | Screenshot per E-Mail | Link in Teams wird zur Karte | Feldgruppe Brick pflegen |
| Liste in Excel bearbeiten | Export, Import per XMLport | „In Excel bearbeiten“ | keine, aber Validierung im Tabellencode |
| Auswertung für die Geschäftsführung | RDLC-Bericht | Analysemodus, Excel-Layout, Power BI | Query oder API bereitstellen |
| Nachricht bei einem Ereignis | eigener Code mit SMTP | Power Automate | Geschäftsereignis veröffentlichen |
| Genehmigung | Workflow-Modul oder Eigenbau | Workflow oder Power Automate | meist keine |
| Text vorschlagen, Daten zusammenfassen | nicht möglich | Copilot | ToolTips pflegen, bei Bedarf eigene Funktion |
| Externer Assistent greift auf Daten zu | SOAP-Dienst | MCP Server über API-Pages | API-Page schreiben, Rechte sauber setzen |
2Teams
Die Business-Central-App für Teams bietet vier Dinge:
| Funktion | Was der Anwender sieht |
|---|---|
| Karte | Ein eingefügter Link auf einen Datensatz wird zu einer kompakten Karte mit ausgewählten Feldern. Derselbe Effekt entsteht über „In Teams teilen“ im Web-Client. |
| Details | Die Schaltfläche „Details“ auf der Karte öffnet die echte Page in einem Fenster innerhalb von Teams, mit FactBoxes, Aktionen und Bearbeitung. |
| Tab | Eine Liste oder ein Datensatz als Registerkarte in einem Kanal oder Chat. |
| Kontaktsuche | Geschäftskontakte aus Business Central in Teams suchen. |
Was du als Entwickler beeinflusst
| Element | Stellschraube |
|---|---|
| Felder auf der Karte | Feldgruppe Brick der Quelltabelle. Sie bestimmt auch die Kacheldarstellung im Web-Client und auf dem Telefon. Zusätzlich gibt es zwei Teams-Events, die Microsoft nur als Ergänzung empfiehlt. |
| Layout der Karte, weitere Schaltflächen | nicht änderbar |
| Details und Tabs | Es wird die normale Page eingebettet, samt Erweiterungen, Rollenanpassung und Personalisierung. Jede Änderung wirkt in allen Clients. |
| Unterstützte Seitentypen | Karten: Card, Document, ListPlus. Tabs zusätzlich: List und Worksheet. Role Center nicht. |
| Tabs automatisch anlegen | über die Microsoft Graph API |
fieldgroups
{
fieldgroup(Brick; "Customer No.", "Visit Date", "Visit Type", Description)
{
}
fieldgroup(DropDown; "Entry No.", "Customer No.", "Visit Date")
{
}
}
Mehr ist für eine brauchbare Teams-Karte der Besuchsverwaltung nicht nötig. Die Feldgruppen kennst du von Seite 3.
3Outlook
Das Outlook-Add-in zeigt neben einer E-Mail die Daten des Absenders aus Business Central: offene Belege, Saldo, Kontaktdaten. Aus der E-Mail heraus lassen sich Angebote oder Aufträge anlegen und Belege als Anhang zurückschicken. Belegnummern im Text einer E-Mail werden erkannt und verlinkt.
| Thema | Hinweis für Entwickler |
|---|---|
| Bereitstellung | zentral durch den Microsoft-365-Administrator oder über die unterstützte Einrichtung in Business Central |
| Angezeigte Seiten | normale Pages in schmaler Darstellung. Deine Page Extensions erscheinen dort ebenfalls, also Felder sparsam und in sinnvoller Reihenfolge hinzufügen. |
| E-Mail-Versand aus Business Central | über das E-Mail-Modul der System Application mit Konten für Microsoft 365, aktuellen Benutzer oder SMTP. Im Code: Codeunits "Email Message" und Email (Seite 6). |
| Eingehende E-Mails | werden zunehmend von Agenten verarbeitet (Abschnitt 12), nicht mehr von selbst geschriebenen Postfach-Abrufen. |
4Excel
| Funktion | Was sie tut | Technik dahinter |
|---|---|---|
| In Excel öffnen | exportiert die aktuelle Liste mit Filtern als Datei | reiner Export, keine Rückschreibung |
| In Excel bearbeiten | öffnet die Liste mit einem Add-in, Änderungen werden zurückgeschrieben | OData auf der Page. Trigger und Validierung der Tabelle laufen. |
| Analysemodus | Pivot, Gruppierung und Summen direkt auf jeder Liste im Browser | arbeitet auf den Feldern der Page und der Tabelle |
| Excel-Layouts für Berichte | Bericht liefert Daten in ein Excel-Blatt, die Auswertung baut der Anwender selbst | rendering-Block mit Type = Excel (Seite 7) |
| Finanzberichte nach Excel | Bilanz und GuV mit Vorlage | Standardfunktion |
| Konfigurationspakete | Massendaten für die Einrichtung | RapidStart, wie in NAV |
OnValidate, OnModify). Seiten, die nicht in Excel bearbeitet werden sollen, schützt du über Berechtigungen, nicht über Hoffnung.
Für eigene Exporte aus Code bleibt die Tabelle „Excel Buffer“ mit Streams (Seite 7). In den meisten Fällen ist ein Bericht mit Excel-Layout aber weniger Arbeit und für den Kunden selbst anpassbar.
5Word
| Einsatz | Beschreibung |
|---|---|
| Word-Layouts für Belege | Angebot, Auftragsbestätigung, Rechnung als Word-Vorlage. Der Kunde ändert Schrift, Logo und Texte selbst über die Seite „Berichtslayouts“. |
| Word-Add-in für Belegberichte | Mit Version 29 überarbeitet: Felder des Berichts lassen sich im Add-in suchen und einfügen, statt über den XML-Zuordnungsbereich. |
| Wiederverwendbare Kopf- und Fußzeilen, Designs | Ebenfalls neu in Version 29: Briefkopf einmal pflegen, in vielen Layouts nutzen. |
| Word-Vorlagen für Serienbriefe | Vorlagen auf Basis beliebiger Tabellen, zum Beispiel Anschreiben an Debitoren. Verknüpfte Tabellen lassen sich einbeziehen. |
Für dich als Entwickler gilt die Regel von Seite 7: Die Spaltennamen im Dataset sind eine Schnittstelle. Benennst du eine Spalte um, brechen die Layouts, die der Kunde selbst gebaut hat.
6OneDrive
Online ist OneDrive ohne Einrichtung angebunden. Dateien aus Business Central lassen sich direkt im Browser öffnen oder teilen, statt sie herunterzuladen:
- Anhänge an Belegen und Stammdaten („In OneDrive öffnen“, „Teilen“),
- Berichte aus dem Berichtseingang,
- Excel-Exporte von Listen.
Eigene Dateien, die du im Code erzeugst, kannst du auf demselben Weg anbieten. Zuständig ist das Modul „Document Sharing“ der System Application. Du füllst einen temporären Datensatz mit Dateiname, Erweiterung und Inhalt und übergibst ihn an die gleichnamige Codeunit. Prüfe die genaue Signatur mit F12, bevor du sie verwendest.
7Power BI
| Baustein | Beschreibung |
|---|---|
| Eingebettete Berichte | Power-BI-Berichte erscheinen als Teil im Role Center und als FactBox auf Listen, gefiltert auf den gewählten Datensatz. |
| Fertige Power-BI-Apps | Microsoft liefert Berichtspakete für Finanzen, Verkauf, Einkauf, Lager, Projekte und Produktion. |
| Datenquelle | Der Business-Central-Konnektor in Power BI liest API-Pages und API-Queries. |
| Lizenz | Anzeigen eigener Berichte ist in der Business-Central-Lizenz enthalten, Teilen und Erstellen braucht je nach Fall Power BI Pro. |
Was du beisteuerst
- API-Queries statt API-Pages für Auswertungen. Eine Query verdichtet auf dem SQL Server und liefert weniger Zeilen. Die Query „ABC Visits per Customer“ aus Seite 7 ist dafür die Vorlage.
DataAccessIntent = ReadOnlyan Queries und API-Pages für Auswertungen, damit die Abfragen auf der Lesereplik laufen.- Stabile Feldnamen. Ein umbenanntes API-Feld bricht jeden Power-BI-Bericht, der es verwendet.
- Inkrementelles Laden über
SystemModifiedAtermöglichen, indem du das Feld in der API ausgibst.
8Power Automate
Power Automate verbindet Business Central mit hunderten anderer Dienste, ohne AL-Code. Ein Ablauf (Flow) besteht aus einem Auslöser und Aktionen.
| Art | Beispiel |
|---|---|
| Automatischer Flow | Wenn ein Datensatz angelegt oder geändert wird, sende eine Nachricht in einen Teams-Kanal. |
| Genehmigungs-Flow | Einkaufsbestellung über 5.000 € geht zur Freigabe an die Abteilungsleitung, Antwort per Teams oder E-Mail. |
| Sofort-Flow | Der Anwender startet den Flow aus der Aktionsleiste einer Page (Menü „Automatisieren“) für den markierten Datensatz. |
| Geplanter Flow | Jeden Montag eine Liste überfälliger Besuche per E-Mail. |
| Flow auf Geschäftsereignis | Wenn ein Besuch als erledigt gemeldet wird, lege eine Aufgabe in Planner an (Abschnitt 9). |
Berührungspunkte mit AL
| Thema | Erklärung |
|---|---|
| Konnektor | Der Business-Central-Konnektor arbeitet mit API-Pages. Deine eigene API-Page aus Seite 7 ist dort sichtbar, sobald sie veröffentlicht ist. |
| Auslöser bei Datenänderung | beruhen auf Webhooks der APIs. Sie melden mit Verzögerung und sagen nicht, was sich fachlich ereignet hat. |
| Geschäftsereignisse | melden fachliche Ereignisse mit eigenen Nutzdaten. Das ist der sauberere Weg (Abschnitt 9). |
| Flow als Aktion auf einer Page | In Page Extensions gibt es dafür customaction mit CustomActionType = Flow. Meist reicht es, wenn der Anwender den Flow selbst über „Automatisieren“ anheftet. |
| Gebundene Aktionen | Prozeduren mit [ServiceEnabled] auf API-Pages lassen sich aus einem Flow aufrufen, zum Beispiel „Besuch abschließen“. |
9Geschäftsereignisse nach außen
Auf Seite 5 hast du Events kennengelernt, die innerhalb von Business Central wirken. Ein externes Geschäftsereignis geht einen Schritt weiter: Fremde Systeme abonnieren es und erhalten eine Benachrichtigung über das Netz. Power Automate nutzt dafür den Dataverse-Auslöser „Wenn eine Aktion ausgeführt wird“. Andere Systeme abonnieren direkt über eine API.
enumextension 50100 "ABC Event Category" extends EventCategory
{
value(50100; "ABC Visits")
{
Caption = 'Customer Visits';
}
}
codeunit 50116 "ABC Visit Business Events"
{
Access = Internal;
[ExternalBusinessEvent('abcvisitcompleted', 'Customer visit completed',
'Triggered when a customer visit is marked as completed.', EventCategory::"ABC Visits")]
[RequiredPermissions(PermissionObjectType::TableData, Database::"ABC Customer Visit", 'R')]
procedure VisitCompleted(visitId: Guid; customerNo: Code[20]; visitDate: Date)
begin
end;
[EventSubscriber(ObjectType::Table, Database::"ABC Customer Visit", 'OnAfterModifyEvent', '', false, false)]
local procedure RaiseOnVisitCompleted(var Rec: Record "ABC Customer Visit"; var xRec: Record "ABC Customer Visit"; RunTrigger: Boolean)
begin
if Rec.IsTemporary() then
exit;
if Rec.Completed and not xRec.Completed then
VisitCompleted(Rec.SystemId, Rec."Customer No.", Rec."Visit Date");
end;
}
| Baustein | Erklärung |
|---|---|
| Prozedur mit leerem Rumpf | Sie ist nur die Beschreibung des Ereignisses. Der Aufruf löst die Benachrichtigung aus. |
| Attributparameter | technischer Name, Anzeigename, Beschreibung, Kategorie |
| Parameter der Prozedur | bilden die Nutzdaten. Erlaubt sind einfache Typen wie Guid, Text, Code, Boolean, Decimal, Integer, Date, DateTime, Enum, RecordId. Keine Records. |
[RequiredPermissions] | optional: Nur wer diese Rechte hat, darf abonnieren. |
| Berechtigungssatz | Abonnenten brauchen den Standardsatz „Ext. Events – Subscr“. |
| Katalog aktualisieren | In Power Apps an der Tabelle „Business Central Virtual Data Source Configuration“ die Aktion „Refresh Business Event Catalog“ ausführen, sonst erscheint das neue Ereignis nicht. |
HttpClient-Aufruf mitten in der Buchung nicht bekommst (Seite 6).
Schicke in den Nutzdaten Schlüssel statt Inhalte: die SystemId und wenige Kennfelder. Der Empfänger holt Details bei Bedarf über die API. Wie jedes Event ist auch dieses eine Schnittstelle. Name und Parameter änderst du nach der Auslieferung nicht mehr.
10Dataverse und Power Apps
Dataverse ist die Datenplattform hinter Dynamics 365 Sales, Customer Service und Power Apps. Zwischen Business Central und Dataverse gibt es vier Arten der Zusammenarbeit:
| Art | Beschreibung | Wann |
|---|---|---|
| Datensynchronisation | Datensätze werden zwischen beiden Systemen abgeglichen (Debitor ↔ Firma, Kontakt ↔ Kontakt). | Vertrieb arbeitet in Dynamics 365 Sales |
| Virtuelle Tabellen | Business-Central-Daten erscheinen in Dataverse, ohne kopiert zu werden. Grundlage sind API-Pages. | Power Apps soll Live-Daten lesen und schreiben |
| Datenänderungsereignisse | Anlegen, Ändern, Löschen als Auslöser | einfache Reaktionen |
| Geschäftsereignisse | fachliche Ereignisse aus Abschnitt 9 | Abläufe über Systemgrenzen |
Neu in Version 29: Zusätzliche Dataverse-Felder lassen sich in Business Central zuordnen, ohne dass ein Entwickler die Integrationstabellen erweitern muss.
Power Apps eignet sich für schmale Oberflächen neben dem ERP: eine Erfassungsmaske für den Außendienst auf dem Telefon, eine Inventur-App, ein Kiosk in der Werkstatt. Bevor du so etwas baust, prüfe, ob die mobile Business-Central-App mit einer einfachen eigenen Page nicht genügt.
11Copilot: was eingebaut ist
Microsoft unterscheidet zwei Begriffe. Copilot ist ein Assistent, den der Anwender anstößt und der Vorschläge macht. Agenten arbeiten selbstständig Aufgaben ab und legen dem Menschen Ergebnisse zur Prüfung vor (Abschnitt 12).
| Bereich | Funktion | Was sie tut |
|---|---|---|
| Für alle | Chat | findet Datensätze und erklärt Felder und Abläufe, auch die aus Zusatz-Apps |
| Analyseassistent | baut aus einer Beschreibung in Alltagssprache eine Analyseansicht mit Gruppierung, Pivot und Summen | |
| Zusammenfassen | zeigt neben einem Datensatz die wichtigsten Punkte mit Links | |
| Autofill | schlägt Feldwerte auf Karten und Belegen vor, auch auf eigenen Seiten | |
| Finanzen | Bankabstimmung | schlägt Zuordnungen und Gegenkonten vor |
| E-Beleg-Zuordnung | ordnet elektronische Eingangsrechnungen Bestellzeilen zu | |
| Verkauf | Verkaufszeilen vorschlagen | erzeugt Zeilen aus Freitext, einer eingefügten Unterhaltung oder einer Datei |
| Marketingtexte | schreibt Artikelbeschreibungen, optional direkt für Shopify | |
| Lager | Ersatzartikel | schlägt Alternativen für nicht lieferbare Artikel vor |
| Einrichtung | Nummernserien | schlägt einheitliche Nummernserien vor |
Was das für deine Erweiterung bedeutet
| Stellschraube | Wirkung |
|---|---|
ToolTip an jedem Feld | Der Chat erklärt Felder anhand der ToolTips. Fehlen sie, kann Copilot zu deiner App nichts sagen. Seit einigen Versionen stehen ToolTips am Tabellenfeld (Seite 3). |
Sprechende Caption-Texte | Suche, Chat und Analyseassistent arbeiten mit den Bezeichnungen. |
AboutTitle und AboutText an Pages | beschreiben den Zweck einer Seite, für Einführungshinweise und für Copilot |
| Feldgruppen und Datenklassifizierung | bestimmen, was in Zusammenfassungen sinnvoll erscheint und was als vertraulich gilt |
| Seite „Copilot- und Agent-Funktionen“ | Hier schaltet der Administrator jede Funktion einzeln ein oder aus, auch deine eigene. |
12Agenten
| Agent | Aufgabe |
|---|---|
| Sales Order Agent | liest Kundenanfragen aus einem Postfach, erkennt den Kontakt, erstellt ein Angebot zur Prüfung und wandelt es nach Bestätigung in einen Auftrag um |
| Payables Agent | überwacht ein Postfach auf Eingangsrechnungen, liest die Daten aus, gleicht mit Bestellungen und Wareneingängen ab und schlägt Konten für offene Zeilen vor |
| Expense Agent | Spesenerfassung per Foto, E-Mail oder Chat mit Prüfung gegen Firmenrichtlinien. Mitarbeiter brauchen dafür keine Business-Central-Lizenz. |
Wie Agenten technisch arbeiten
- Ein Agent ist ein eigener Benutzer mit eigenen Berechtigungssätzen. Was auf Seite 8 über Berechtigungen steht, gilt für ihn genauso.
- Er arbeitet über die normalen Pages mit einem eigenen Profil. Deine Page Extensions sieht er also auch, und deine Validierungen greifen.
- Jeder Schritt wird protokolliert. Der Mensch prüft und gibt frei. Seit Version 29 gibt es dafür einen gemeinsamen Aufgabenbereich für alle Agenten und die Prüfung direkt auf der Seite.
- Die Nutzung wird nach Verbrauch abgerechnet. Das ist ein Kostenpunkt, den der Kunde kennen muss.
Folgen für deinen Code
| Regel | Grund |
|---|---|
Keine Confirm- oder Message-Dialoge in Validierungen ohne GuiAllowed()-Prüfung | Ein Agent kann Rückfragen nicht wie ein Mensch beantworten. |
| Fehlermeldungen mit klarem Text und Handlungsanweisung | Der Agent liest die Meldung und versucht, darauf zu reagieren. |
| Pflichtfelder im Tabellencode erzwingen, nicht nur auf der Page | Der Agent nutzt möglicherweise eine andere Seite oder ein anderes Profil. |
| Eigene Felder mit ToolTip versehen | Sonst weiß der Agent nicht, wofür sie gedacht sind. |
Eigene Agenten baust du heute auf zwei Wegen: in Copilot Studio über den MCP Server (Abschnitt 14) oder mit den Agent-Werkzeugen in AL, die Microsoft schrittweise öffnet. Für den Anfang ist der erste Weg der einfachere.
13Eigene Copilot-Funktion in AL
Das KI-Modul der System Application (Namespace System.AI) bindet Azure OpenAI an. Es unterstützt Sprachmodelle für Text, keine Bild- oder Spracherkennung. Eine eigene Funktion besteht aus vier Teilen.
Teil 1: Funktion registrieren
enumextension 50101 "ABC Copilot Capability" extends "Copilot Capability"
{
value(50100; "ABC Visit Summary")
{
Caption = 'Summarize customer visits';
}
}
codeunit 50117 "ABC Copilot Setup"
{
Subtype = Install;
Access = Internal;
InherentEntitlements = X;
InherentPermissions = X;
trigger OnInstallAppPerDatabase()
begin
RegisterCapability();
end;
procedure RegisterCapability()
var
EnvironmentInfo: Codeunit "Environment Information";
CopilotCapability: Codeunit "Copilot Capability";
LearnMoreUrlTxt: Label 'https://www.decoso-web.de', Locked = true;
begin
if not EnvironmentInfo.IsSaaSInfrastructure() then
exit;
if CopilotCapability.IsCapabilityRegistered(Enum::"Copilot Capability"::"ABC Visit Summary") then
exit;
CopilotCapability.RegisterCapability(
Enum::"Copilot Capability"::"ABC Visit Summary",
Enum::"Copilot Availability"::Preview,
LearnMoreUrlTxt);
end;
}
Die App hat bereits die Install-Codeunit 50112 aus Seite 8. Mehrere Install-Codeunits sind erlaubt. Rufe RegisterCapability() zusätzlich aus der Upgrade-Codeunit auf, sonst fehlt die Registrierung bei Kunden, die von Version 1.1 kommen. Die Funktion erscheint danach auf der Seite „Copilot- und Agent-Funktionen“ und kann dort abgeschaltet werden.
Teil 2: Zugangsdaten sicher ablegen
Du brauchst die Adresse einer Azure-OpenAI-Ressource, den Namen der Bereitstellung und einen Schlüssel. Diese Werte stehen nie im Code. Sie kommen in IsolatedStorage, der Schlüssel als SecretText (Seite 6).
Teil 3: Text erzeugen
codeunit 50118 "ABC Visit Summary"
{
Access = Internal;
procedure Generate(CustomerNo: Code[20]; UserWish: Text): Text
var
AzureOpenAI: Codeunit "Azure OpenAI";
AOAIChatMessages: Codeunit "AOAI Chat Messages";
AOAIChatCompletionParams: Codeunit "AOAI Chat Completion Params";
AOAIOperationResponse: Codeunit "AOAI Operation Response";
Endpoint: Text;
Deployment: Text;
ApiKey: SecretText;
begin
IsolatedStorage.Get('ABCEndpoint', DataScope::Module, Endpoint);
IsolatedStorage.Get('ABCDeployment', DataScope::Module, Deployment);
IsolatedStorage.Get('ABCApiKey', DataScope::Module, ApiKey);
AzureOpenAI.SetAuthorization(Enum::"AOAI Model Type"::"Chat Completions", Endpoint, Deployment, ApiKey);
AzureOpenAI.SetCopilotCapability(Enum::"Copilot Capability"::"ABC Visit Summary");
AOAIChatCompletionParams.SetMaxTokens(800);
AOAIChatCompletionParams.SetTemperature(0);
AOAIChatMessages.SetPrimarySystemMessage(GetMetaprompt());
AOAIChatMessages.AddUserMessage(BuildVisitText(CustomerNo) + ' ' + UserWish);
AzureOpenAI.GenerateChatCompletion(AOAIChatMessages, AOAIChatCompletionParams, AOAIOperationResponse);
if not AOAIOperationResponse.IsSuccess() then
Error(AOAIOperationResponse.GetError());
exit(AOAIChatMessages.GetLastMessage());
end;
local procedure GetMetaprompt(): Text
begin
exit('You summarize customer visits for a sales team. ' +
'Use only the visits given in the user message. ' +
'Answer in the language of the user. ' +
'Return at most five short sentences. ' +
'If there are no visits, say so and do not invent any.');
end;
local procedure BuildVisitText(CustomerNo: Code[20]): Text
var
CustomerVisit: Record "ABC Customer Visit";
Builder: TextBuilder;
begin
CustomerVisit.SetRange("Customer No.", CustomerNo);
CustomerVisit.SetCurrentKey("Visit Date");
CustomerVisit.Ascending(false);
if CustomerVisit.FindSet() then
repeat
Builder.AppendLine(StrSubstNo('%1 | %2 | %3',
Format(CustomerVisit."Visit Date", 0, 9),
CustomerVisit."Visit Type",
CustomerVisit.Description));
until (CustomerVisit.Next() = 0) or (Builder.Length() > 6000);
exit(Builder.ToText());
end;
}
| Begriff | Bedeutung |
|---|---|
| Metaprompt (Systemnachricht) | legt Rolle, Grenzen und Ausgabeform des Modells fest. Hier steckt die eigentliche Arbeit. In echten Apps legst du ihn nicht als Text im Code ab, sondern in einem Key Vault oder in IsolatedStorage. |
| Temperatur | 0 bis 2. Niedrig ergibt gleichbleibende, sachliche Antworten, hoch ergibt freiere Texte. |
| Token | Abrechnungs- und Längeneinheit. Eingabe und Ausgabe zusammen dürfen die Grenze des Modells nicht überschreiten. ApproximateTokenCount schätzt vorab. |
| Abrechnungsart | Seit 2025 Wave 2 gibst du bei der Registrierung an, wer zahlt: „Custom Billed“ (du oder der Kunde über eine eigene Azure-Ressource), „Microsoft Billed“ (Business-Central-KI-Ressourcen) oder „Not Billed“. |
Teil 4: Oberfläche mit PromptDialog
page 50105 "ABC Visit Summary Prompt"
{
Caption = 'Summarize visits with Copilot';
PageType = PromptDialog;
Extensible = false;
IsPreview = true;
ApplicationArea = All;
layout
{
area(Prompt)
{
field(UserWish; UserWish)
{
ShowCaption = false;
MultiLine = true;
InstructionalText = 'What should the summary focus on?';
}
}
area(Content)
{
field(Summary; Summary)
{
ShowCaption = false;
MultiLine = true;
Editable = false;
}
}
}
actions
{
area(SystemActions)
{
systemaction(Generate)
{
Caption = 'Generate';
trigger OnAction()
var
VisitSummary: Codeunit "ABC Visit Summary";
begin
Summary := VisitSummary.Generate(CustomerNo, UserWish);
end;
}
systemaction(Regenerate)
{
Caption = 'Regenerate';
trigger OnAction()
var
VisitSummary: Codeunit "ABC Visit Summary";
begin
Summary := VisitSummary.Generate(CustomerNo, UserWish);
end;
}
systemaction(OK)
{
Caption = 'Keep it';
}
systemaction(Cancel)
{
Caption = 'Discard';
}
}
}
procedure SetCustomer(NewCustomerNo: Code[20])
begin
CustomerNo := NewCustomerNo;
end;
var
CustomerNo: Code[20];
UserWish: Text;
Summary: Text;
}
Der Seitentyp PromptDialog gibt den Ablauf vor, den Anwender von allen Copilot-Funktionen kennen: Eingabe, Erzeugen, Ergebnis ansehen, behalten oder verwerfen. Aufgerufen wird die Seite aus einer Aktion auf der Debitorenkarte, üblicherweise im Bereich area(Prompting) mit dem Copilot-Symbol.
14MCP Server: deine APIs als Werkzeuge für Agenten
Das Model Context Protocol (MCP) ist ein Standard, über den KI-Assistenten Werkzeuge ansprechen. Auf Seite 10 hast du den AL MCP Server kennengelernt, der beim Entwickeln hilft. Hier geht es um den Business Central MCP Server: Er macht die Daten und Aktionen einer Umgebung für Agenten zugänglich, etwa in Copilot Studio, Microsoft Copilot, Teams, VS Code oder Claude.
Was Agenten darüber können
| Vorgang | Grundlage |
|---|---|
| Datensätze lesen | API-Pages und API-Queries |
| Anlegen, Ändern, Löschen | API-Pages, wenn in der Konfiguration erlaubt |
| Aktionen ausführen | gebundene Aktionen an API-Pages, zum Beispiel Buchen |
| Freie Datenabfragen (Vorschau) | Werkzeuge wie bc_data_find_tables, bc_data_get_table_schema, bc_data_query, nur lesend |
Einrichtung
- Seite „Model Context Protocol (MCP) Server Configurations“ öffnen (Page 8350). Nötig ist der Berechtigungssatz „MCP - Admin“.
- Neue Konfiguration anlegen, Name und Beschreibung vergeben, „Active“ zunächst aus lassen.
- Unter „Server Features“ die „API Tools“ aktivieren.
- Unter „Available APIs“ die gewünschten API-Objekte hinzufügen und je Objekt festlegen: Allow Read, Create, Modify, Delete, Actions.
- Für Schreibzugriffe zusätzlich „Unblock Edit Tools“ einschalten.
- „Validate“ ausführen, dann „Active“ setzen. Eine aktive Konfiguration ist schreibgeschützt.
- Über „Advanced“ → „Connection String“ die Verbindungsdaten für den Client kopieren.
"businesscentral": {
"url": "https://mcp.businesscentral.dynamics.com",
"type": "http",
"headers": {
"TenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"EnvironmentName": "DEV",
"Company": "CRONUS DE",
"ConfigurationName": "ABC Besuche"
}
}
Aus API-Objekten werden Werkzeuge
Jede erlaubte Operation wird zu einem Werkzeug. Der Name entsteht aus den API-Metadaten, nicht aus der Caption:
| Erlaubnis | Werkzeugname | Beispiel für die Besuchs-API (Page 50103) |
|---|---|---|
| Allow Read | List_<EntitySetName>_PAG<ID> | List_CustomerVisits_PAG50103 |
| Allow Create | Create_<EntityName>_PAG<ID> | Create_CustomerVisit_PAG50103 |
| Allow Modify | Modify_<EntityName>_PAG<ID> | Modify_CustomerVisit_PAG50103 |
| Allow Delete | Delete_<EntityName>_PAG<ID> | Delete_CustomerVisit_PAG50103 |
Die Beispielnamen setzen voraus, dass deine API-Page EntitySetName = 'customerVisits' und EntityName = 'customerVisit' trägt. Daran siehst du, warum die Namensgebung aus Seite 7 wichtig ist: Ein Agent wählt sein Werkzeug anhand dieses Namens.
Regeln für agententaugliche API-Pages
- Nur Felder ausgeben, die ein Außenstehender sehen darf. Was die API zeigt, sieht auch der Agent.
- Sprechende, stabile Namen für
EntityName,EntitySetNameund Felder. - Unterseiten vom Typ ListPart oder CardPart werden nicht als Werkzeug unterstützt. Jede Entität braucht eine eigene API-Page auf oberster Ebene.
- Schreibrechte nur dort freigeben, wo die Tabelle alle Prüfungen selbst erzwingt.
- Copilot Studio erlaubt höchstens 70 Werkzeuge je Agent. Bei vielen APIs hilft der „Dynamic Tool Mode“.
15Weitere nützliche Funktionen
| Funktion | Nutzen | Für Entwickler |
|---|---|---|
| Page Scripting | Abläufe im Browser aufzeichnen und wieder abspielen, für Abnahmetests nach Updates. Seit Version 29 allgemein verfügbar. | Aufzeichnungen lassen sich in die Pipeline einbinden (Seite 9). |
| Analysemodus | Pivot auf jeder Liste, Ansichten speicher- und teilbar | Felder in der Tabelle sauber benennen, FlowFields sparsam einsetzen |
| Mobile App | Telefon und Tablet, Kamera und Standort | Barcode-Scan über die Feldeigenschaft ExtendedDatatype = Barcode |
| Control Add-ins | eigene Oberflächenelemente in JavaScript, zum Beispiel Diagramme, Karten, Unterschriftenfeld | Objekttyp controladdin, Ersatz für die alten Client-Add-ins (Seite 6) |
| Shopify-Connector | Artikel, Kunden, Aufträge und Bestände mit einem Shop abgleichen. In Version 29 um B2B und Retouren erweitert. | erweiterbar über Events der Shopify-App |
| E-Belege | Rahmenwerk für elektronische Rechnungen mit länderspezifischen Formaten | eigene Formate und Dienste über Interfaces anbinden |
| Telemetrie | Laufzeitdaten der App in Application Insights, auswertbar mit fertigen Power-BI-Berichten | Verbindungszeichenfolge in app.json, eigene Signale über Session.LogMessage (Seite 9) |
| Rollenanpassung und Personalisierung | Kunden blenden Felder selbst ein und aus | Felder mit Visible = false anbieten statt für jeden Wunsch eine Page Extension zu schreiben |
16Übung: Besuchsverwaltung anbinden
Voraussetzung ist eine Online-Sandbox mit Teams. Für Schritt 4 brauchst du zusätzlich eine Azure-OpenAI-Ressource. Wenn du keine hast, lass ihn aus.
Schritt 1: Teams-Karte
- In
src/ABCCustomerVisit.Table.aldie FeldgruppeBrickaus Abschnitt 2 ergänzen oder anpassen. - App veröffentlichen, die Besuchskarte öffnen, Link kopieren und in einen Teams-Chat einfügen.
- Prüfen: Zeigt die Karte die vier Felder? Öffnet „Details“ die Besuchskarte?
- In einem Kanal einen Tab mit der Liste „Kundenbesuche“ anlegen.
Schritt 2: Geschäftsereignis
src/ABCEventCategory.EnumExt.alundsrc/ABCVisitBusinessEvents.Codeunit.alaus Abschnitt 9 anlegen.- Beide neuen Objekte in den Berechtigungssatz „ABC Visit - Objects“ aufnehmen.
- Dataverse-Verbindung mit „Virtuelle Tabellen und Ereignisse aktivieren“ einrichten und den Katalog aktualisieren.
- In Power Automate einen Flow mit dem Auslöser „Wenn eine Aktion ausgeführt wird“ bauen: Katalog „Dynamics 365 Business Central“, Kategorie „Customer Visits“, Aktion „Customer visit completed“. Als Folgeschritt eine Nachricht in einen Teams-Kanal senden.
- Einen Besuch auf „Erledigt“ setzen und prüfen, ob die Nachricht erscheint.
Schritt 3: MCP Server
- Konfiguration „ABC Besuche“ nach Abschnitt 14 anlegen, API-Page 50103 mit „Allow Read“ hinzufügen, validieren, aktivieren.
- Verbindungszeichenfolge in einen MCP-fähigen Client eintragen, zum Beispiel VS Code.
- Fragen: „Welche Besuche gab es im letzten Monat bei Debitor 10000?“
- Gegenprobe mit einem Benutzer ohne den Satz „ABC Visit - Read“. Der Zugriff muss scheitern.
Schritt 4 (optional): Copilot-Zusammenfassung
- Die Objekte aus Abschnitt 13 anlegen: Enum Extension 50101, Codeunits 50117 und 50118, Page 50105.
- Auf der Seite „ABC Visit Setup“ drei Aktionen oder Felder ergänzen, über die ein Administrator Endpunkt, Bereitstellung und Schlüssel in
IsolatedStorageschreibt. Den Schlüssel als maskiertes Feld erfassen und nie wieder anzeigen. - Auf der Debitorenkarte eine Aktion „Besuche zusammenfassen“ ergänzen, die Page 50105 mit
SetCustomer(Rec."No.")undRunModal()öffnet. - Prüfen, dass die Funktion auf der Seite „Copilot- und Agent-Funktionen“ erscheint und sich abschalten lässt.
Schritt 5: Übersetzen und einchecken
| Englisch | Deutsch |
|---|---|
| Customer Visits (Kategorie) | Kundenbesuche |
| Customer visit completed | Kundenbesuch erledigt |
| Summarize customer visits | Kundenbesuche zusammenfassen |
| Summarize visits with Copilot | Besuche mit Copilot zusammenfassen |
| What should the summary focus on? | Worauf soll die Zusammenfassung achten? |
| Keep it / Discard | Übernehmen / Verwerfen |
git add .
git commit -m "Integration: Teams-Karte, Geschaeftsereignis, Copilot-Zusammenfassung"
git push
17Typische Fallen
| Falle | Folge | Abhilfe |
|---|---|---|
Keine Feldgruppe Brick | Teams-Karte zeigt zufällige oder kaum Felder | Feldgruppe an jeder eigenen Tabelle mit Karte pflegen |
| Prüfung nur auf der Page | „In Excel bearbeiten“, API, Agent und MCP umgehen sie | Prüfung in die Tabelle |
Confirm in OnValidate | Agenten und Hintergrundsitzungen scheitern | GuiAllowed() prüfen oder Rückfrage auf die Page verlegen |
| API-Page ohne Rechteprüfung ausgeliefert | über den MCP Server für jeden berechtigten Benutzer lesbar | Ausführungsrecht nur in passenden Sätzen, Felder beschränken |
| API-Feld oder Ereignis umbenannt | Flows, Power-BI-Berichte und Agenten brechen | Namen als Schnittstelle behandeln, neue Version anlegen |
| HTTP-Aufruf in der Buchung statt Geschäftsereignis | Benachrichtigung trotz Rollback, langsame Transaktion | Geschäftsereignis und Power Automate |
| API-Schlüssel im Code oder in einer normalen Tabelle | Schlüssel lesbar für jeden mit Tabellenzugriff | SecretText und IsolatedStorage oder Key Vault |
| Copilot-Funktion nur in der Install-Codeunit registriert | fehlt bei Bestandskunden nach dem Upgrade | auch im Upgrade-Code registrieren |
| KI-Ergebnis ungeprüft gespeichert | falsche Daten im System | immer Vorschlag mit Übernehmen oder Verwerfen |
| Test nur in Docker | Teams, Copilot und MCP lassen sich dort nicht prüfen | Online-Sandbox verwenden |
| Fehlende ToolTips | Copilot-Chat kann die eigenen Felder nicht erklären | ToolTip an jedem Feld, die Code-Analyse meldet Lücken |
18Selbsttest und Zusammenfassung
1. Womit bestimmst du die Felder einer Teams-Karte?
Mit der Feldgruppe Brick der Quelltabelle. Die Teams-Events sind nur eine Ergänzung.
2. Warum reicht eine Prüfung auf der Page nicht aus?
Weil Excel-Bearbeitung, APIs, Agenten und der MCP Server die Daten auf anderen Wegen ändern. Nur Tabellencode greift überall.
3. Was unterscheidet ein externes Geschäftsereignis von einem Integration Event?
Das Integration Event wirkt innerhalb von Business Central für andere Apps. Das Geschäftsereignis benachrichtigt fremde Systeme, und zwar erst nach dem Commit.
4. Welche Datentypen darf ein Geschäftsereignis als Parameter haben?
Einfache Typen wie Guid, Text, Code, Boolean, Zahlen, Datum, Enum, RecordId. Keine Records.
5. Was ist der Unterschied zwischen Copilot und einem Agenten?
Copilot wird vom Anwender angestoßen und macht Vorschläge. Ein Agent arbeitet selbstständig Aufgaben ab und legt Ergebnisse zur Prüfung vor.
6. Kannst du dem Copilot-Chat einen eigenen Befehl hinzufügen?
Nein. Der Chat ist nicht erweiterbar. Du beeinflusst ihn über ToolTips, Captions und Seitenbeschreibungen. Eigene Funktionen baust du als PromptDialog.
7. Welche zwei Objekte registrieren eine eigene Copilot-Funktion?
Eine enumextension von „Copilot Capability“ und eine Codeunit, die RegisterCapability aufruft.
8. Deine App enthält eine API-Page. Was kann ein Agent über den MCP Server ohne weitere Einrichtung?
Die Seite finden und lesen, sofern der angemeldete Benutzer sie ausführen und die Tabelle lesen darf. Schreiben erst nach ausdrücklicher Freigabe in einer Konfiguration.
9. Wie heißt das Lesewerkzeug für eine API-Page 50103 mit EntitySetName = 'customerVisits'?
List_CustomerVisits_PAG50103.
Zusammenfassung
- Viele frühere Entwicklungsaufträge sind heute Einrichtung in Teams, Excel, Power BI und Power Automate.
- Deine Erweiterung wird gut integrierbar durch vier Dinge: Feldgruppen, ToolTips, Prüfungen in der Tabelle und saubere API-Pages.
- Fachliche Ereignisse meldest du mit
[ExternalBusinessEvent]nach außen, die Reaktion baut der Kunde in Power Automate. - Copilot schlägt vor, Agenten arbeiten selbstständig. Beide nutzen deine Pages und Metadaten.
- Eigene KI-Funktionen entstehen aus Registrierung, sicherer Schlüsselablage, Metaprompt und
PromptDialog. - Über den MCP Server werden API-Pages zu Werkzeugen für Agenten. Berechtigungen sind dabei der einzige Schutz.
Quellen (Stand November 2026)
- Microsoft Learn: Developing for Microsoft Teams Integration
- Microsoft Learn: Business Central AI
- Microsoft Learn: Build the Copilot capability in AL
- Microsoft Learn: Business events on Business Central (preview)
- Microsoft Learn: Configure Business Central MCP Server
- Microsoft Learn: Update 29.0 for Business Central 2026 release wave 2