Zum Inhalt springen
Von C/AL zu AL: der Kurs für NAV-EntwicklerEin Kurs der decoso GmbH & Co. KGErstgespräch
Kursübersicht › Seite 4 von 11

Pages und Oberfläche

Pages, Page Extensions und Aktionen in AL: was sich gegenüber NAV 2017 ändert und wie du die Oberfläche erweiterst, ohne den Standard zu ändern.

Stand November 2026 · Version 29

Autor: Elvis Schmidt, decoso GmbH & Co. KG

Lernziele dieser Seite. Du kannst danach eigene Seiten in AL schreiben, Standardseiten mit einer Page Extension erweitern, Aktionen und FactBoxes ergänzen, Seiten ohne MenuSuite in die Suche bringen und deine Texte per XLIFF ins Deutsche übersetzen. Die Übung am Ende gibt der Besuchsverwaltung von Seite 3 eine Oberfläche.

1Eine Page, alt und neu

Der Page Designer mit seinen Zeilen und Einrückungen ist verschwunden. Die Struktur ist dieselbe geblieben: Container, Gruppen, Felder, Aktionen. Sie wird jetzt durch geschweifte Klammern ausgedrückt.

NAV 2017, Textexport (gekürzt)
OBJECT Page 50000 Customer Visits
{
  PROPERTIES
  {
    Editable=No;
    CaptionML=[DEU=Kundenbesuche;
               ENU=Customer Visits];
    SourceTable=Table50000;
    PageType=List;
    CardPageID=Customer Visit Card;
    ActionList=ACTIONS
    {
      { 1000;  ;ActionContainer;
          ActionContainerType=RelatedInformation }
      { 1001;1 ;Action ;
          CaptionML=[DEU=Debitor;
                     ENU=Customer];
          RunObject=Page 21;
          RunPageLink=No.=FIELD(Customer No.);
          Promoted=Yes;
          Image=Customer;
          PromotedCategory=Process }
    }
  }
  CONTROLS
  {
    { 1 ;0 ;Container ;
        ContainerType=ContentArea }
    { 2 ;1 ;Group ;
        GroupType=Repeater }
    { 3 ;2 ;Field ;
        SourceExpr="Customer No." }
    { 4 ;2 ;Field ;
        SourceExpr="Visit Date" }
  }
}
Business Central, AL (gekürzt)
page 50100 "ABC Customer Visits"
{
    PageType = List;
    Caption = 'Customer Visits';
    SourceTable = "ABC Customer Visit";
    CardPageId = "ABC Customer Visit Card";
    Editable = false;
    ApplicationArea = All;
    UsageCategory = Lists;

    layout
    {
        area(Content)
        {
            repeater(Visits)
            {
                field("Customer No."; Rec."Customer No.")
                {
                }
                field("Visit Date"; Rec."Visit Date")
                {
                }
            }
        }
    }

    actions
    {
        area(Navigation)
        {
            action(Customer)
            {
                Caption = 'Customer';
                Image = Customer;
                RunObject = page "Customer Card";
                RunPageLink = "No." = field("Customer No.");
            }
        }
        area(Promoted)
        {
            actionref(Customer_Promoted; Customer)
            {
            }
        }
    }
}

Was sich geändert hat:

  • Jedes Steuerelement hat einen Namen. field("Customer No."; Rec."Customer No.") bedeutet: Das Steuerelement heißt „Customer No.“ und zeigt den Ausdruck Rec."Customer No.". Über diesen Namen sprechen Page Extensions das Feld an. Die Control-IDs von früher gibt es nicht mehr.
  • Rec. ist Pflicht. Ohne Rec. meldet der Compiler eine Warnung, in neueren Versionen einen Fehler.
  • ApplicationArea und UsageCategory sind neu und entscheiden, ob etwas sichtbar und auffindbar ist (Abschnitt 5).
  • Hochgestufte Aktionen stehen in einem eigenen Bereich area(Promoted) und verweisen mit actionref auf die eigentliche Aktion (Abschnitt 7).
  • Captions nur auf Englisch, Übersetzung per XLIFF (Abschnitt 13).

2Seitentypen

PageTypeVerwendungHinweis
CardEin Datensatz mit Inforegistern (FastTabs).Wie früher.
ListListe von Datensätzen.Wie früher. Mit CardPageId öffnet ein Klick die Karte.
DocumentKopf mit Zeilen-Unterseite, z. B. Verkaufsauftrag.Wie früher.
WorksheetErfassungsblätter wie Buch.-Blätter.Wie früher.
ListPart, CardPartUnterseiten und FactBoxes.Wie früher.
ListPlusListe mit Zusatzbereichen.Selten.
RoleCenterStartseite eines Profils.Aufbau geändert: Navigation liegt in den Aktionen der Seite.
StandardDialog, ConfirmationDialogEinfache Dialoge mit OK/Abbrechen bzw. Ja/Nein.Wie früher.
NavigatePageAssistenten mit Zurück/Weiter.Wird für Einrichtungsassistenten viel genutzt.
HeadlinePartBegrüßungszeilen im Rollencenter.Neu.
APISeite ohne Oberfläche, als Webdienst-Endpunkt.Neu, Thema von Seite 7.
PromptDialogDialoge für Copilot-Funktionen.Neu, nur für KI-Funktionen.

3Seiteneigenschaften

EigenschaftBedeutung
SourceTable, SourceTableView, SourceTableTemporaryDatenquelle, feste Sortierung und Filter, temporäre Nutzung. Beispiel: SourceTableView = sorting("Customer No.", "Visit Date") order(descending) where("Visit Type" = const(Phone));
Caption, DataCaptionExpression, DataCaptionFieldsTitel der Seite und des Datensatzes.
CardPageIdKarte, die aus der Liste geöffnet wird.
Editable, InsertAllowed, ModifyAllowed, DeleteAllowedWie früher.
DelayedInsertDatensatz wird erst beim Verlassen der Zeile eingefügt, nicht schon nach dem ersten Feld. Wichtig für Listen und Erfassungsblätter.
AutoSplitKey, MultipleNewLines, PopulateAllFieldsVerhalten bei Zeilenseiten, wie früher.
RefreshOnActivateSeite lädt Daten neu, wenn sie wieder aktiv wird.
ApplicationAreaStandardwert für alle Steuerelemente der Seite (in neueren Versionen).
UsageCategory, AdditionalSearchTermsAuffindbarkeit in der Suche (Abschnitt 5).
AboutTitle, AboutTextEinführungstexte, die Benutzern beim ersten Öffnen als Hinweisblase gezeigt werden. Neu.
Extensiblefalse verbietet Page Extensions durch andere Apps.
SaveValuesMerkt sich Eingaben auf Dialog- und Anforderungsseiten.
PermissionsZusätzliche Rechte für den Code der Seite.

4Das Layout

layout
{
    area(Content)
    {
        group(General)
        {
            Caption = 'General';

            field("Customer No."; Rec."Customer No.")
            {
                ToolTip = 'Specifies the customer who was visited.';
                ShowMandatory = true;
                Importance = Promoted;
            }
            field("Visit Date"; Rec."Visit Date")
            {
                ToolTip = 'Specifies the date of the visit.';
            }
            group(Details)
            {
                Caption = 'Details';
                Visible = ShowDetails;

                field("Duration (Minutes)"; Rec."Duration (Minutes)")
                {
                    ToolTip = 'Specifies how long the visit took.';
                    Importance = Additional;
                }
            }
        }
        part(Lines; "ABC Visit Subform")
        {
            SubPageLink = "Visit Entry No." = field("Entry No.");
        }
    }
    area(FactBoxes)
    {
        part(CustomerDetails; "Customer Details FactBox")
        {
            SubPageLink = "No." = field("Customer No.");
        }
        systempart(Links; Links)
        {
        }
        systempart(Notes; Notes)
        {
        }
    }
}
ElementBedeutung
area(Content)Hauptbereich der Seite.
area(FactBoxes)Infobereich rechts.
area(RoleCenter)Inhalt eines Rollencenters.
groupAuf oberster Ebene ein Inforegister, verschachtelt eine Untergruppe mit Überschrift.
repeaterZeilen einer Liste. Eigenschaften u. a. FreezeColumn, IndentationColumn, ShowAsTree.
grid, fixedTabellarische Anordnung von Feldern. Im Web-Client eingeschränkt, sparsam verwenden.
cuegroupKacheln mit Zahlen im Rollencenter.
partEingebettete Seite, verknüpft über SubPageLink und SubPageView. Mit Provider hängt eine FactBox an einer anderen Unterseite statt an der Hauptseite.
systempartEingebaute Teile: Links und Notes.
usercontrolControl Add-in in JavaScript. Ersetzt die alten .NET-Add-ins des Windows-Clients.
labelReiner Text ohne Datenbindung.

Feldeigenschaften auf Seiten

EigenschaftBedeutung
ApplicationAreaOhne Wert (und ohne Vorgabe auf Seitenebene) bleibt das Feld unsichtbar.
ToolTipErklärung beim Überfahren. Der Analyzer verlangt sie. Konvention: beginnt mit „Specifies …“.
CaptionÜberschreibt die Caption des Tabellenfelds. Bei Variablen und Ausdrücken Pflicht.
Visible, Enabled, EditableFest oder über eine Boolean-Variable gesteuert (Abschnitt 9).
ImportancePromoted: Wert steht auch im zugeklappten Inforegister. Additional: erst nach „Mehr anzeigen“ sichtbar.
ShowMandatoryRoter Stern für Pflichtfelder. Nur Anzeige, keine Prüfung.
Style, StyleExprFarbe und Schriftschnitt. Werte: Standard, StandardAccent, Strong, StrongAccent, Attention, AttentionAccent, Favorable, Unfavorable, Ambiguous, Subordinate.
MultiLine, ExtendedDatatypeMehrzeilige Eingabe, Darstellung als E-Mail, URL, Telefonnummer, verdecktes Kennwort.
DrillDown, Lookup, DrillDownPageId, LookupPageId, TableRelationVerhalten beim Nachschlagen, wie früher.
QuickEntryfalse überspringt das Feld bei der Eingabe mit der Eingabetaste.
HideValue, ShowCaption, BlankZero, WidthFeinheiten der Darstellung.
AboutTitle, AboutTextEinführungshinweis zu diesem Feld.

Feld-Trigger gibt es wie früher: OnValidate, OnLookup, OnDrillDown, OnAssistEdit. Fachliche Prüfungen gehören weiterhin in die Tabelle, nicht in die Seite, weil sie sonst bei Importen, Webdiensten und anderen Seiten nicht greifen.

5Sichtbar und auffindbar: ApplicationArea und UsageCategory

ApplicationArea

Jedes Feld, jede Aktion und jeder Part gehört zu einem oder mehreren Anwendungsbereichen. Der Client zeigt ein Element nur, wenn mindestens einer seiner Bereiche im Mandanten aktiv ist. Microsoft nutzt das, um je nach Lizenz und Einrichtung Funktionen auszublenden (z. B. Basic, Suite, Manufacturing, Service).

  • Für eigene Entwicklungen nimmst du fast immer ApplicationArea = All;.
  • In neueren Versionen kannst du den Wert einmal auf Seitenebene setzen, er gilt dann für alle Elemente der Seite.
  • In Page Extensions setzt du ihn an jedem hinzugefügten Element.
Die häufigste Anfängerfalle. „Mein Feld kompiliert, ist aber auf der Seite nicht da.“ In neun von zehn Fällen fehlt ApplicationArea. Der Analyzer warnt davor, wenn du die Code-Analyse von Seite 2 eingeschaltet hast.

UsageCategory statt MenuSuite

Eine Seite oder ein Bericht erscheint in der Suche („Wie möchten Sie weiter verfahren“, Alt+Q), wenn UsageCategory gesetzt ist und die ApplicationArea passt.

UsageCategoryGedacht für
ListsStammdaten- und Postenlisten
TasksErfassungsblätter, Verarbeitungen
DocumentsBeleglisten
ReportsAndAnalysisBerichte
HistoryGebuchte Belege, Register
AdministrationEinrichtungsseiten
None (Standard)Nicht in der Suche. Richtig für Karten, Unterseiten und FactBoxes.

Mit AdditionalSearchTerms = 'besuch,visit,termin'; findet die Suche die Seite auch unter anderen Begriffen. Die Kategorie bestimmt außerdem, wo die Seite im Rollen-Explorer (Umschalt+F12) einsortiert wird.

Navigation im Rollencenter

Soll die Seite zusätzlich fest im Menü eines Rollencenters stehen, erweiterst du das Rollencenter:

pageextension 50102 "ABC Order Proc. RC Ext" extends "Order Processor Role Center"
{
    actions
    {
        addlast(Embedding)
        {
            action(ABCCustomerVisits)
            {
                ApplicationArea = All;
                Caption = 'Customer Visits';
                RunObject = page "ABC Customer Visits";
                ToolTip = 'View the list of recorded customer visits.';
            }
        }
    }
}

Die Bereiche eines Rollencenters heißen Embedding (obere Navigationsleiste), Sections (Menüs mit Untereinträgen), Processing, Creation und Reporting.

6Page Extension: Standardseiten erweitern

pageextension 50100 "ABC Customer Card Ext" extends "Customer Card"
{
    layout
    {
        addlast(General)
        {
            field("ABC Kundenklasse"; Rec."ABC Kundenklasse")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the customer class (A, B or C).';
            }
        }
        addafter("Phone No.")
        {
            field("ABC Letzter Besuch"; Rec."ABC Letzter Besuch")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the date of the last visit to the customer.';
            }
        }
        modify("Credit Limit (LCY)")
        {
            Importance = Promoted;
        }
        modify("Fax No.")
        {
            Visible = false;
        }
        moveafter(Name; "Search Name")
        addfirst(FactBoxes)
        {
            part(ABCVisitFactBox; "ABC Customer Visit FactBox")
            {
                ApplicationArea = All;
                SubPageLink = "No." = field("No.");
            }
        }
    }
}
SchlüsselwortWirkung
addfirst(Anker), addlast(Anker)Am Anfang oder Ende einer Gruppe oder eines Bereichs einfügen.
addafter(Anker), addbefore(Anker)Hinter oder vor einem bestimmten Element einfügen.
movefirst, movelast, moveafter, movebeforeVorhandene Elemente umstellen.
modify(Element)Eigenschaften eines vorhandenen Elements ändern und Trigger ergänzen.

Dieselben Schlüsselwörter gelten im Abschnitt actions.

Den richtigen Anker finden

Der Anker ist der Name des Steuerelements auf der Standardseite, nicht der Feldname der Tabelle und nicht die deutsche Beschriftung. Meist stimmen Steuerelement- und Feldname überein, aber nicht immer.

  • In VS Code: Cursor auf "Customer Card", F12, dann im Quelltext der Seite nachsehen.
  • IntelliSense: Nach addafter( zeigt Strg+Leertaste alle möglichen Anker.
  • Im Browser: Strg+Alt+F1 öffnet die Seitenprüfung (Abschnitt 14).

Was eine Page Extension kann und was nicht

MöglichNicht möglich
Felder, Gruppen, Parts und Aktionen hinzufügen
Elemente verschieben und ausblenden
Ausgewählte Eigenschaften ändern (Caption, ToolTip, Visible, Enabled, Editable, Importance, Style …)
Eigene Variablen, Funktionen und Trigger ergänzen
Ansichten (Views) hinzufügen
Elemente löschen (stattdessen Visible = false)
Quelltabelle oder Seitentyp ändern
Code der Standardseite ändern oder entfernen
Mehr als eine Extension derselben Seite in einer App

Trigger in Page Extensions

pageextension 50101 "ABC Customer List Ext" extends "Customer List"
{
    layout
    {
        modify("Salesperson Code")
        {
            trigger OnAfterValidate()
            begin
                CurrPage.Update(true);
            end;
        }
    }

    actions
    {
        modify(NewSalesInvoice)
        {
            trigger OnBeforeAction()
            begin
                Rec.TestField("ABC Kundenklasse");
            end;
        }
    }

    trigger OnOpenPage()
    begin
        // läuft nach dem OnOpenPage der Standardseite
    end;

    trigger OnAfterGetRecord()
    begin
        // läuft nach dem OnAfterGetRecord der Standardseite
    end;
}
WoTrigger
SeiteOnOpenPage, OnClosePage, OnAfterGetRecord, OnAfterGetCurrRecord, OnNewRecord, OnInsertRecord, OnModifyRecord, OnDeleteRecord, OnQueryClosePage. Sie laufen zusätzlich zum Standard-Trigger.
modify(Feld)OnBeforeValidate, OnAfterValidate, in neueren Versionen auch OnLookup, OnDrillDown, OnAssistEdit, sofern der Standard dort keinen eigenen Code hat.
modify(Aktion)OnBeforeAction, OnAfterAction.
Reihenfolge bei mehreren Apps. Erweitern mehrere Apps dieselbe Seite, ist die Reihenfolge ihrer Trigger nicht garantiert. Schreibe deinen Code so, dass er nicht davon abhängt, ob eine andere Erweiterung vorher oder nachher läuft.

7Aktionen

actions
{
    area(Processing)
    {
        action(MarkAsDone)
        {
            Caption = 'Mark as Done';
            Image = Completed;
            ToolTip = 'Mark the selected visits as done.';
            Scope = Repeater;
            Enabled = HasCustomer;

            trigger OnAction()
            var
                Visit: Record "ABC Customer Visit";
            begin
                CurrPage.SetSelectionFilter(Visit);
                // ... Verarbeitung der markierten Zeilen ...
                CurrPage.Update(false);
            end;
        }
        group(Functions)
        {
            Caption = 'Functions';
            Image = Action;

            action(CopyVisit)
            {
                Caption = 'Copy Visit';
                Image = Copy;
                ToolTip = 'Create a new visit based on the selected one.';

                trigger OnAction()
                begin
                    // ...
                end;
            }
        }
    }
    area(Navigation)
    {
        action(Customer)
        {
            Caption = 'Customer';
            Image = Customer;
            ToolTip = 'Open the card of the visited customer.';
            RunObject = page "Customer Card";
            RunPageLink = "No." = field("Customer No.");
            ShortcutKey = 'Shift+F7';
        }
    }
    area(Reporting)
    {
        action(VisitReport)
        {
            Caption = 'Visit Overview';
            Image = Report;
            ToolTip = 'Print an overview of customer visits.';
            RunObject = report "ABC Visit Overview";
        }
    }
    area(Promoted)
    {
        group(Category_Process)
        {
            Caption = 'Process';

            actionref(MarkAsDone_Promoted; MarkAsDone)
            {
            }
            actionref(Customer_Promoted; Customer)
            {
            }
        }
        group(Category_Report)
        {
            Caption = 'Report';

            actionref(VisitReport_Promoted; VisitReport)
            {
            }
        }
    }
}
BereichFrüherer ActionContainerTypeInhalt
area(Processing)ActionItemsFunktionen, die etwas tun.
area(Navigation)RelatedInformationSprünge zu zugehörigen Daten.
area(Reporting)ReportsBerichte.
area(Creation)NewDocumentItemsNeue Belege anlegen.
area(Promoted)Eigenschaften Promoted, PromotedCategory, PromotedIsBigVerweise auf Aktionen, die direkt in der Aktionsleiste stehen sollen.

Hochstufen: alt und neu

Alte Schreibweise
action(Customer)
{
    Caption = 'Customer';
    Promoted = true;
    PromotedCategory = Process;
    PromotedIsBig = true;
    PromotedOnly = true;
    ...
}

Dazu PromotedActionCategories an der Seite mit einer kommagetrennten Liste von Kategorienamen.

Neue Schreibweise
area(Promoted)
{
    group(Category_Process)
    {
        actionref(Customer_Promoted; Customer)
        {
        }
    }
}

Die Aktion wird einmal definiert und im Bereich Promoted referenziert. Gruppen ersetzen die Kategorien.

Die alte Schreibweise kompiliert in vielen Versionen noch, gilt aber als auslaufend. Beide Formen lassen sich auf derselben Seite nicht mischen. Die Standardseiten verwenden die neue Form, also musst du in Page Extensions ebenfalls actionref verwenden. Benutzer können die Aktionsleiste außerdem selbst per Personalisierung umbauen.

Wichtige Aktionseigenschaften

EigenschaftBedeutung
RunObject, RunPageLink, RunPageView, RunPageModeSeite, Bericht oder Codeunit ohne Code starten. RunPageMode = Create öffnet die Seite mit einem neuen Datensatz. Einwertige Filter aus RunPageLink werden dabei als Vorbelegung übernommen.
ImageSymbol aus einer festen Liste. IntelliSense zeigt die gültigen Namen.
Scope = RepeaterAktion erscheint auch im Zeilenmenü der Liste.
ShortcutKeyTastenkürzel. Viele Kombinationen sind vom Browser belegt.
Enabled, VisibleFest oder über Variable.
EllipsisHängt drei Punkte an, wenn ein Dialog folgt.

8Seiten-Trigger und CurrPage

TriggerWannTypische Verwendung
OnInitVor dem LadenStartwerte für Sichtbarkeitsvariablen.
OnOpenPageBeim ÖffnenFilter setzen, Einrichtung lesen.
OnAfterGetRecordFür jede angezeigte ZeileBerechnete Spalten, Zeilenformatierung. Muss schnell sein.
OnAfterGetCurrRecordWenn der aktuelle Datensatz wechseltAktionen aktivieren oder deaktivieren.
OnNewRecordNeuer leerer DatensatzVorbelegungen.
OnInsertRecord, OnModifyRecord, OnDeleteRecordVor der DatenbankoperationRückgabewert false unterdrückt die Operation.
OnQueryClosePageVor dem SchließenPrüfungen, mit CloseAction als Parameter.
OnClosePageBeim SchließenAufräumen.
OnFindRecord, OnNextRecordNavigationSelten, für Seiten auf temporären Daten.
OnPageBackgroundTaskCompletedHintergrundaufgabe fertigNeu: langsame Berechnungen laden, ohne die Seite zu blockieren.
CurrPage.Update(false);              // neu anzeigen, ohne zu speichern
CurrPage.Update(true);               // aktuellen Datensatz speichern und neu anzeigen
CurrPage.SetSelectionFilter(Visit);  // markierte Zeilen in eine Record-Variable übernehmen
CurrPage.Close();
CurrPage.Editable(false);
CurrPage.Lines.Page.MyFunction();    // Funktion einer eingebetteten Unterseite aufrufen
CurrPage.SaveRecord();

9Dynamisch ein- und ausblenden, sperren, einfärben

page 50101 "ABC Customer Visit Card"
{
    ...
    layout
    {
        area(Content)
        {
            group(General)
            {
                field("Visit Type"; Rec."Visit Type")
                {
                    ToolTip = 'Specifies how the visit took place.';

                    trigger OnValidate()
                    begin
                        SetControls();
                    end;
                }
                field("Duration (Minutes)"; Rec."Duration (Minutes)")
                {
                    ToolTip = 'Specifies how long the visit took.';
                    Enabled = DurationEnabled;
                    StyleExpr = DurationStyle;
                }
            }
        }
    }

    var
        DurationEnabled: Boolean;
        DurationStyle: Text;

    trigger OnAfterGetCurrRecord()
    begin
        SetControls();
    end;

    local procedure SetControls()
    begin
        DurationEnabled := Rec."Visit Type" <> Rec."Visit Type"::"Trade Show";

        if Rec."Duration (Minutes)" > 240 then
            DurationStyle := Format(PageStyle::Attention)
        else
            DurationStyle := Format(PageStyle::Standard);
    end;
}
  • Visible, Enabled und Editable nehmen eine Boolean-Variable oder ein Boolean-Feld, keine Ausdrücke mit Vergleichen. Berechne den Wert in einer Funktion.
  • StyleExpr nimmt eine Textvariable mit dem Namen des Stils. Der Enum PageStyle ist neuer, in älteren Versionen schreibst du den Text direkt: DurationStyle := 'Attention';.
  • In Listen wird Visible einer Spalte nur beim Öffnen ausgewertet, nicht pro Zeile. Editable und StyleExpr wirken pro Zeile, wenn du sie in OnAfterGetRecord setzt.
  • Die Eigenschaft IncludeInDataSet der Variablen von früher gibt es nicht mehr, das erledigt die Plattform.

10FactBoxes

Eine FactBox ist eine Seite vom Typ CardPart oder ListPart, die im Bereich FactBoxes einer anderen Seite eingebettet wird.

page 50102 "ABC Customer Visit FactBox"
{
    PageType = CardPart;
    Caption = 'Visits';
    SourceTable = Customer;
    Editable = false;
    ApplicationArea = All;

    layout
    {
        area(Content)
        {
            field("ABC Anzahl Besuche"; Rec."ABC Anzahl Besuche")
            {
                ToolTip = 'Specifies how many visits are recorded for the customer.';
            }
            field("ABC Letzter Besuch"; Rec."ABC Letzter Besuch")
            {
                ToolTip = 'Specifies the date of the last visit to the customer.';
            }
            field("ABC Kundenklasse"; Rec."ABC Kundenklasse")
            {
                ToolTip = 'Specifies the customer class (A, B or C).';
            }
        }
    }
}

Das FlowField „ABC Anzahl Besuche“ zählt Datensätze der Besuchstabelle. Ein Klick darauf öffnet automatisch die Seite, die in der Besuchstabelle als DrillDownPageId eingetragen ist, gefiltert auf die gezählten Datensätze. Dafür ist kein Code nötig.

11Ansichten (Views) auf Listen

Ansichten sind vordefinierte Filter und Sortierungen, die Benutzer links neben der Liste auswählen. Sie ersetzen viele der gefilterten Menüeinträge, die du früher in der MenuSuite oder im Rollencenter angelegt hast.

views
{
    view(OnSiteVisits)
    {
        Caption = 'On Site Visits';
        Filters = where("Visit Type" = const("On Site"));
        OrderBy = descending("Visit Date");
    }
    view(LongVisits)
    {
        Caption = 'Long Visits';
        Filters = where("Duration (Minutes)" = filter('>120'));
        SharedLayout = false;

        layout
        {
            movefirst(Visits; "Duration (Minutes)")
        }
    }
}

Mit SharedLayout = false bekommt die Ansicht eine eigene Spaltenanordnung. In Page Extensions fügst du Ansichten mit addfirst oder addlast im Abschnitt views hinzu.

12Dialoge und Meldungen in Kürze

// Nachschlagen wie früher
if Page.RunModal(Page::"Customer List", Customer) = Action::LookupOK then
    Rec.Validate("Customer No.", Customer."No.");

// Seite nicht modal öffnen
Page.Run(Page::"ABC Customer Visits", Visit);

// Rückfrage
if not Confirm(DeleteQst, false, Rec."Customer No.") then
    exit;

// Hinweis, der die Arbeit nicht unterbricht (neu)
VisitNotification.Message := NoVisitMsg;
VisitNotification.Scope := NotificationScope::LocalScope;
VisitNotification.Send();

Message, Confirm, Error und StrMenu funktionieren wie früher. Neu ist der Typ Notification: ein Hinweisbalken am oberen Seitenrand, der den Benutzer nicht stoppt und Aktionen enthalten kann. Für Fehlermeldungen mit Schaltflächen zur Korrektur gibt es ErrorInfo (Seite 5).

Modale Dialoge und Transaktionen. Page.RunModal und Confirm sind innerhalb einer offenen Schreibtransaktion weiterhin verboten. Frage zuerst, schreibe danach.

13Übersetzung: XLIFF statt CaptionML

NAV 2017
CaptionML=[DEU=Besuchsdatum;
           ENU=Visit Date];

Alle Sprachen stehen im Objekt.

Business Central
Caption = 'Visit Date';

Im Code steht nur Englisch. Jede weitere Sprache ist eine eigene Datei im Ordner Translations.

Ablauf

  1. In der app.json muss "features": ["TranslationFile"] stehen (auf Seite 2 schon eingetragen).
  2. Beim Bauen mit Strg+Umschalt+B entsteht Translations/ABC Kundenapp.g.xlf. Das g steht für „generated“. Diese Datei wird bei jedem Build überschrieben, bearbeite sie nie.
  3. Kopiere sie nach Translations/ABC Kundenapp.de-DE.xlf.
  4. Setze im Kopf target-language="de-DE" und ergänze zu jedem <source> ein <target>.
  5. Erneut bauen und veröffentlichen. Die Übersetzung ist Teil der .app-Datei.
<?xml version="1.0" encoding="utf-8"?>
<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
  <file datatype="xml" source-language="en-US" target-language="de-DE" original="ABC Kundenapp">
    <body>
      <group id="body">
        <trans-unit id="Table 1234567890 - Field 2345678901 - Property 2879900210"
                    size-unit="char" translate="yes" xml:space="preserve">
          <source>Visit Date</source>
          <target>Besuchsdatum</target>
          <note from="Developer" annotates="general" priority="2"></note>
          <note from="Xliff Generator" annotates="general" priority="3">Table ABC Customer Visit - Field Visit Date - Property Caption</note>
        </trans-unit>
      </group>
    </body>
  </file>
</xliff>
  • Die id ist ein Schlüssel aus Hashwerten. Ändere sie nie. Welches Element gemeint ist, steht lesbar in der Notiz des „Xliff Generator“.
  • Übersetzt werden Caption, ToolTip, OptionCaption, InstructionalText, AboutTitle, AboutText und alle Label-Variablen.
  • Die deutschen Texte des Standards liefert Microsoft. In einer deutschen Umgebung sind sie bereits vorhanden.
  • Solange deine Übersetzungsdatei fehlt, sehen deutsche Benutzer deine englischen Texte.

Labels mit Zusatzangaben

var
    VisitCreatedMsg: Label 'Visit %1 was created for customer %2.',
        Comment = '%1 = Entry No., %2 = Customer Name';
    ApiPathTok: Label 'api/v2.0/visits', Locked = true;
    ShortTxt: Label 'Visit', MaxLength = 10;
ZusatzBedeutung
CommentErklärung für den Übersetzer, vor allem zu Platzhaltern. Landet in der XLIFF-Datei.
Locked = trueText wird nicht übersetzt. Für technische Werte wie Pfade und Schlüssel.
MaxLengthHöchstlänge der Übersetzung.

Übliche Endungen für Label-Namen: Msg (Meldung), Err (Fehler), Qst (Frage), Lbl (Beschriftung), Txt (Text), Tok (technischer, gesperrter Wert). Der Analyzer prüft das.

Werkzeugunterstützung

Das Kopieren von Hand trägt nur beim ersten Mal. Sobald du Texte ergänzt, muss die deutsche Datei mit der generierten abgeglichen werden. Die VS-Code-Erweiterung NAB AL Tools macht das mit einem Befehl: Sie übernimmt neue Einträge in alle Sprachdateien, markiert sie als zu prüfen und springt zum nächsten unübersetzten Text. CaptionML kompiliert technisch noch, ist für neue Entwicklungen aber nicht vorgesehen und in AppSource-Apps nicht erlaubt.

14Seiten prüfen und direkt aufrufen

NAV 2017Business Central
Info zu dieser Seite (Strg+Alt+F1), ZoomSeitenprüfung, ebenfalls Strg+Alt+F1. Zeigt Seitennummer, Quelltabelle, alle Felder des Datensatzes mit Werten (auch nicht angezeigte), aktive Filter und welche Erweiterungen die Seite verändern.
Seite aus dem Object Designer ausführenAdressparameter ?page=50100 oder Startobjekt in der launch.json.
Bericht ausführen?report=50100
Mandant wechseln?company=CRONUS%20DE

Die Seitenprüfung ist dein wichtigstes Werkzeug, wenn ein Kunde sagt „das Feld da oben“. Sie nennt dir den technischen Feldnamen, die Tabelle und die App, aus der das Feld stammt.

15Personalisierung, Profile und pagecustomization

  • Personalisierung: Jeder Benutzer kann Felder ein- und ausblenden, verschieben und Aktionen umsortieren. Felder, die auf der Seite vorhanden, aber mit Visible = false ausgeblendet sind, kann er selbst einblenden. Das ist ein guter Platz für selten gebrauchte Spalten.
  • Profile (Rollen): Ein Administrator kann eine Seite für alle Benutzer eines Profils anpassen, ebenfalls ohne Code.
  • Im Code: Die Objekte profile und pagecustomization liefern solche Anpassungen mit der App aus.
profile "ABC SALES"
{
    Caption = 'ABC Sales';
    RoleCenter = "Order Processor Role Center";
    Customizations = "ABC Customer List Cust";
}

pagecustomization "ABC Customer List Cust" customizes "Customer List"
{
    layout
    {
        modify("Phone No.")
        {
            Visible = false;
        }
        moveafter(Name; "ABC Kundenklasse")
    }
}

Eine pagecustomization hat keine Objekt-ID, kann keine neuen Felder und keinen Code enthalten und wirkt nur für die Profile, die sie einbinden. Für alles, was für alle Benutzer gelten soll, nimmst du die Page Extension.

16Übung: Oberfläche für die Besuchsverwaltung

Schritt 1. Ergänze in src/ABCCustomerVisit.Table.al unter DataClassification die beiden Zeilen, die auf Seite 3 noch als Kommentar standen:

    LookupPageId = "ABC Customer Visits";
    DrillDownPageId = "ABC Customer Visits";

Schritt 2. src/ABCCustomerVisits.Page.al

page 50100 "ABC Customer Visits"
{
    PageType = List;
    Caption = 'Customer Visits';
    SourceTable = "ABC Customer Visit";
    SourceTableView = sorting("Customer No.", "Visit Date") order(descending);
    CardPageId = "ABC Customer Visit Card";
    Editable = false;
    ApplicationArea = All;
    UsageCategory = Lists;
    AdditionalSearchTerms = 'visit,besuch';

    layout
    {
        area(Content)
        {
            repeater(Visits)
            {
                field("Entry No."; Rec."Entry No.")
                {
                    ToolTip = 'Specifies the number of the entry.';
                    Visible = false;
                }
                field("Customer No."; Rec."Customer No.")
                {
                    ToolTip = 'Specifies the customer who was visited.';
                }
                field("Customer Name"; Rec."Customer Name")
                {
                    ToolTip = 'Specifies the name of the customer.';
                }
                field("Visit Date"; Rec."Visit Date")
                {
                    ToolTip = 'Specifies the date of the visit.';
                }
                field("Visit Type"; Rec."Visit Type")
                {
                    ToolTip = 'Specifies how the visit took place.';
                }
                field(Description; Rec.Description)
                {
                    ToolTip = 'Specifies a description of the visit.';
                }
                field("Salesperson Code"; Rec."Salesperson Code")
                {
                    ToolTip = 'Specifies the salesperson who made the visit.';
                }
                field("Duration (Minutes)"; Rec."Duration (Minutes)")
                {
                    ToolTip = 'Specifies how long the visit took.';
                }
            }
        }
        area(FactBoxes)
        {
            systempart(Links; Links)
            {
            }
            systempart(Notes; Notes)
            {
            }
        }
    }

    actions
    {
        area(Navigation)
        {
            action(Customer)
            {
                Caption = 'Customer';
                Image = Customer;
                ToolTip = 'Open the card of the visited customer.';
                RunObject = page "Customer Card";
                RunPageLink = "No." = field("Customer No.");
            }
        }
        area(Promoted)
        {
            group(Category_Process)
            {
                Caption = 'Process';

                actionref(Customer_Promoted; Customer)
                {
                }
            }
        }
    }

    views
    {
        view(OnSiteVisits)
        {
            Caption = 'On Site Visits';
            Filters = where("Visit Type" = const("On Site"));
        }
    }
}

Schritt 3. src/ABCCustomerVisitCard.Page.al

page 50101 "ABC Customer Visit Card"
{
    PageType = Card;
    Caption = 'Customer Visit';
    SourceTable = "ABC Customer Visit";
    ApplicationArea = All;

    layout
    {
        area(Content)
        {
            group(General)
            {
                Caption = 'General';

                field("Customer No."; Rec."Customer No.")
                {
                    ToolTip = 'Specifies the customer who was visited.';
                    ShowMandatory = true;
                }
                field("Customer Name"; Rec."Customer Name")
                {
                    ToolTip = 'Specifies the name of the customer.';
                }
                field("Visit Date"; Rec."Visit Date")
                {
                    ToolTip = 'Specifies the date of the visit.';
                }
                field("Visit Type"; Rec."Visit Type")
                {
                    ToolTip = 'Specifies how the visit took place.';
                }
                field("Salesperson Code"; Rec."Salesperson Code")
                {
                    ToolTip = 'Specifies the salesperson who made the visit.';
                }
                field("Duration (Minutes)"; Rec."Duration (Minutes)")
                {
                    ToolTip = 'Specifies how long the visit took.';
                }
            }
            group(NotesGroup)
            {
                Caption = 'Notes';

                field(Description; Rec.Description)
                {
                    ToolTip = 'Specifies a description of the visit.';
                    MultiLine = true;
                }
            }
        }
    }

    trigger OnNewRecord(BelowxRec: Boolean)
    begin
        Rec."Visit Date" := WorkDate();
    end;
}

Schritt 4. src/ABCCustomerVisitFactBox.Page.al: die FactBox aus Abschnitt 10.

Schritt 5. Ersetze src/ABCCustomerCardExt.PageExt.al:

pageextension 50100 "ABC Customer Card Ext" extends "Customer Card"
{
    layout
    {
        addlast(General)
        {
            field("ABC Kundenklasse"; Rec."ABC Kundenklasse")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the customer class (A, B or C).';
            }
            field("ABC Letzter Besuch"; Rec."ABC Letzter Besuch")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the date of the last visit to the customer.';
            }
        }
        addfirst(FactBoxes)
        {
            part(ABCVisitFactBox; "ABC Customer Visit FactBox")
            {
                ApplicationArea = All;
                SubPageLink = "No." = field("No.");
            }
        }
    }

    actions
    {
        addlast(Navigation)
        {
            action(ABCVisits)
            {
                ApplicationArea = All;
                Caption = 'Visits';
                Image = Calendar;
                ToolTip = 'View the visits recorded for this customer.';
                RunObject = page "ABC Customer Visits";
                RunPageLink = "Customer No." = field("No.");
            }
        }
        addlast(Processing)
        {
            action(ABCNewVisit)
            {
                ApplicationArea = All;
                Caption = 'New Visit';
                Image = New;
                ToolTip = 'Record a new visit for this customer.';
                RunObject = page "ABC Customer Visit Card";
                RunPageLink = "Customer No." = field("No.");
                RunPageMode = Create;
            }
        }
        addlast(Promoted)
        {
            actionref(ABCNewVisit_Promoted; ABCNewVisit)
            {
            }
            actionref(ABCVisits_Promoted; ABCVisits)
            {
            }
        }
    }
}

Schritt 6. src/ABCCustomerListExt.PageExt.al

pageextension 50101 "ABC Customer List Ext" extends "Customer List"
{
    layout
    {
        addafter(Name)
        {
            field("ABC Kundenklasse"; Rec."ABC Kundenklasse")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the customer class (A, B or C).';
            }
            field("ABC Letzter Besuch"; Rec."ABC Letzter Besuch")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the date of the last visit to the customer.';
                StyleExpr = ABCVisitStyle;
            }
        }
    }

    var
        ABCVisitStyle: Text;

    trigger OnAfterGetRecord()
    begin
        ABCVisitStyle := 'Standard';
        if Rec."ABC Letzter Besuch" = 0D then
            exit;
        if Rec."ABC Letzter Besuch" < CalcDate('<-6M>', WorkDate()) then
            ABCVisitStyle := 'Attention';
    end;
}

Schritt 7. Testen.

  1. Mit F5 veröffentlichen, Debitorenkarte öffnen.
  2. „New Visit“ anklicken. Die Besuchskarte öffnet sich mit vorbelegter Debitorennummer und dem Arbeitsdatum. Art und Beschreibung ausfüllen, Seite schließen.
  3. Die Debitorenkarte mit F5 im Browser neu laden. Die FactBox zeigt einen Besuch, das Feld „Last Visit“ das Datum. Ein Klick auf die Anzahl öffnet die gefilterte Besuchsliste.
  4. Über die Suche (Alt+Q) „Customer Visits“ eingeben. Die Liste wird gefunden.
  5. Auf der Debitorenliste mit Strg+Alt+F1 die Seitenprüfung öffnen und unter den Erweiterungen deine App suchen.

Schritt 8. Übersetzen. Baue das Paket, kopiere die .g.xlf zur .de-DE.xlf und trage die Übersetzungen ein:

EnglischDeutsch
Customer VisitsKundenbesuche
Customer VisitKundenbesuch
Visit DateBesuchsdatum
Visit TypeBesuchsart
On Site / Phone / Trade ShowVor Ort / Telefon / Messe
Duration (Minutes)Dauer (Minuten)
Customer ClassKundenklasse
Last VisitLetzter Besuch
No. of VisitsAnzahl Besuche
New VisitNeuer Besuch
VisitsBesuche

Veröffentliche erneut und prüfe, dass die Oberfläche bei deutscher Spracheinstellung (Zahnrad → Meine Einstellungen → Sprache) deutsch erscheint. Committe danach den Stand einschließlich der .de-DE.xlf. Die .g.xlf kannst du ebenfalls einchecken oder ignorieren, beides ist üblich.

17Typische Denkfehler

  • „Das Feld fehlt, obwohl alles kompiliert.“ ApplicationArea fehlt, oder das Feld wurde vom Benutzer per Personalisierung ausgeblendet.
  • „Ich suche den Anker nach der deutschen Beschriftung.“ Maßgeblich ist der Name des Steuerelements im Quelltext der Standardseite.
  • „Ich lösche das Standardfeld von der Seite.“ Geht nicht. Mit modify und Visible = false ausblenden.
  • „Die Prüfung schreibe ich in den OnValidate der Seite.“ Dann greift sie nicht bei Importen, Webdiensten und anderen Seiten. Prüfungen gehören in die Tabelle oder in einen Event Subscriber.
  • „OnAfterGetRecord kann ruhig ein paar Datensätze nachlesen.“ Der Trigger läuft für jede sichtbare Zeile und bei jedem Blättern. Jede Datenbankabfrage dort macht die Liste spürbar langsamer.
  • „Meine Seite braucht einen Menüeintrag.“ UsageCategory setzen, dann findet die Suche sie. Ein Eintrag im Rollencenter ist zusätzlich möglich, aber nicht nötig.
  • „Ich schreibe die deutschen Texte direkt in die Caption.“ Dann sehen auch englische Benutzer Deutsch, und der Analyzer meldet es. Englisch im Code, Deutsch in der XLIFF-Datei.
  • „Für die Client-Integration nehme ich ein .NET-Add-in.“ Die gibt es im Web-Client nicht. Der Ersatz sind Control Add-ins in JavaScript.

18Selbsttest

Was bedeuten die zwei Angaben in field("Customer No."; Rec."Customer No.")?

Die erste ist der Name des Steuerelements, über den Page Extensions es ansprechen. Die zweite ist der angezeigte Ausdruck.

Wie machst du eine Seite über die Suche auffindbar?

UsageCategory auf einen Wert ungleich None setzen und eine passende ApplicationArea angeben.

Wie entfernst du ein Standardfeld von einer Standardseite?

Gar nicht. Du blendest es in der Page Extension mit modify(Feld) { Visible = false; } aus.

Wie stellst du eine Aktion in der neuen Schreibweise hoch?

Mit einem actionref im Bereich area(Promoted), der auf die Aktion verweist.

Welche Datei bearbeitest du für die deutsche Übersetzung, und welche nie?

Die .de-DE.xlf bearbeitest du. Die .g.xlf wird bei jedem Build neu erzeugt und bleibt unangetastet.

Wie findest du heraus, aus welcher App ein Feld auf einer Seite stammt?

Mit der Seitenprüfung im Browser, Strg+Alt+F1.

Warum öffnet ein Klick auf das FlowField „Anzahl Besuche“ die Besuchsliste, ohne dass du Code geschrieben hast?

Weil in der Besuchstabelle DrillDownPageId gesetzt ist. Der Client öffnet diese Seite mit den Filtern der Berechnungsformel.

Worin unterscheiden sich Page Extension und pagecustomization?

Die Page Extension gilt für alle Benutzer und kann Felder, Aktionen und Code hinzufügen. Die pagecustomization gilt nur für bestimmte Profile und kann nur vorhandene Elemente verschieben, ausblenden und in Eigenschaften ändern.

19Zusammenfassung

Seiten sind dieselben Bausteine wie in NAV 2017, als Text mit benannten Steuerelementen. Standardseiten veränderst du mit Page Extensions über Anker und die Schlüsselwörter add, move und modify. ApplicationArea entscheidet über Sichtbarkeit, UsageCategory ersetzt die MenuSuite, actionref das Promoted-Kennzeichen, und die Übersetzung liegt in XLIFF-Dateien.

Checkliste: Liste, Karte und FactBox für Besuche angelegt · Debitorenkarte um Felder, FactBox und zwei Aktionen erweitert · Debitorenliste mit eingefärbter Spalte · Seite über die Suche gefunden · Seitenprüfung benutzt · deutsche Übersetzung eingebunden · Stand committet.

Code-Review für deine erste Extension?Wir schauen drauf, bevor sie zum Kunden geht.

Erstgespräch vereinbaren

Fehler gefunden? Bitte melden. Wir prüfen jede Meldung.