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.
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" }
}
}
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 AusdruckRec."Customer No.". Über diesen Namen sprechen Page Extensions das Feld an. Die Control-IDs von früher gibt es nicht mehr. Rec.ist Pflicht. OhneRec.meldet der Compiler eine Warnung, in neueren Versionen einen Fehler.ApplicationAreaundUsageCategorysind neu und entscheiden, ob etwas sichtbar und auffindbar ist (Abschnitt 5).- Hochgestufte Aktionen stehen in einem eigenen Bereich
area(Promoted)und verweisen mitactionrefauf die eigentliche Aktion (Abschnitt 7). - Captions nur auf Englisch, Übersetzung per XLIFF (Abschnitt 13).
2Seitentypen
| PageType | Verwendung | Hinweis |
|---|---|---|
Card | Ein Datensatz mit Inforegistern (FastTabs). | Wie früher. |
List | Liste von Datensätzen. | Wie früher. Mit CardPageId öffnet ein Klick die Karte. |
Document | Kopf mit Zeilen-Unterseite, z. B. Verkaufsauftrag. | Wie früher. |
Worksheet | Erfassungsblätter wie Buch.-Blätter. | Wie früher. |
ListPart, CardPart | Unterseiten und FactBoxes. | Wie früher. |
ListPlus | Liste mit Zusatzbereichen. | Selten. |
RoleCenter | Startseite eines Profils. | Aufbau geändert: Navigation liegt in den Aktionen der Seite. |
StandardDialog, ConfirmationDialog | Einfache Dialoge mit OK/Abbrechen bzw. Ja/Nein. | Wie früher. |
NavigatePage | Assistenten mit Zurück/Weiter. | Wird für Einrichtungsassistenten viel genutzt. |
HeadlinePart | Begrüßungszeilen im Rollencenter. | Neu. |
API | Seite ohne Oberfläche, als Webdienst-Endpunkt. | Neu, Thema von Seite 7. |
PromptDialog | Dialoge für Copilot-Funktionen. | Neu, nur für KI-Funktionen. |
3Seiteneigenschaften
| Eigenschaft | Bedeutung |
|---|---|
SourceTable, SourceTableView, SourceTableTemporary | Datenquelle, feste Sortierung und Filter, temporäre Nutzung. Beispiel: SourceTableView = sorting("Customer No.", "Visit Date") order(descending) where("Visit Type" = const(Phone)); |
Caption, DataCaptionExpression, DataCaptionFields | Titel der Seite und des Datensatzes. |
CardPageId | Karte, die aus der Liste geöffnet wird. |
Editable, InsertAllowed, ModifyAllowed, DeleteAllowed | Wie früher. |
DelayedInsert | Datensatz wird erst beim Verlassen der Zeile eingefügt, nicht schon nach dem ersten Feld. Wichtig für Listen und Erfassungsblätter. |
AutoSplitKey, MultipleNewLines, PopulateAllFields | Verhalten bei Zeilenseiten, wie früher. |
RefreshOnActivate | Seite lädt Daten neu, wenn sie wieder aktiv wird. |
ApplicationArea | Standardwert für alle Steuerelemente der Seite (in neueren Versionen). |
UsageCategory, AdditionalSearchTerms | Auffindbarkeit in der Suche (Abschnitt 5). |
AboutTitle, AboutText | Einführungstexte, die Benutzern beim ersten Öffnen als Hinweisblase gezeigt werden. Neu. |
Extensible | false verbietet Page Extensions durch andere Apps. |
SaveValues | Merkt sich Eingaben auf Dialog- und Anforderungsseiten. |
Permissions | Zusä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)
{
}
}
}
| Element | Bedeutung |
|---|---|
area(Content) | Hauptbereich der Seite. |
area(FactBoxes) | Infobereich rechts. |
area(RoleCenter) | Inhalt eines Rollencenters. |
group | Auf oberster Ebene ein Inforegister, verschachtelt eine Untergruppe mit Überschrift. |
repeater | Zeilen einer Liste. Eigenschaften u. a. FreezeColumn, IndentationColumn, ShowAsTree. |
grid, fixed | Tabellarische Anordnung von Feldern. Im Web-Client eingeschränkt, sparsam verwenden. |
cuegroup | Kacheln mit Zahlen im Rollencenter. |
part | Eingebettete Seite, verknüpft über SubPageLink und SubPageView. Mit Provider hängt eine FactBox an einer anderen Unterseite statt an der Hauptseite. |
systempart | Eingebaute Teile: Links und Notes. |
usercontrol | Control Add-in in JavaScript. Ersetzt die alten .NET-Add-ins des Windows-Clients. |
label | Reiner Text ohne Datenbindung. |
Feldeigenschaften auf Seiten
| Eigenschaft | Bedeutung |
|---|---|
ApplicationArea | Ohne Wert (und ohne Vorgabe auf Seitenebene) bleibt das Feld unsichtbar. |
ToolTip | Erklä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, Editable | Fest oder über eine Boolean-Variable gesteuert (Abschnitt 9). |
Importance | Promoted: Wert steht auch im zugeklappten Inforegister. Additional: erst nach „Mehr anzeigen“ sichtbar. |
ShowMandatory | Roter Stern für Pflichtfelder. Nur Anzeige, keine Prüfung. |
Style, StyleExpr | Farbe und Schriftschnitt. Werte: Standard, StandardAccent, Strong, StrongAccent, Attention, AttentionAccent, Favorable, Unfavorable, Ambiguous, Subordinate. |
MultiLine, ExtendedDatatype | Mehrzeilige Eingabe, Darstellung als E-Mail, URL, Telefonnummer, verdecktes Kennwort. |
DrillDown, Lookup, DrillDownPageId, LookupPageId, TableRelation | Verhalten beim Nachschlagen, wie früher. |
QuickEntry | false überspringt das Feld bei der Eingabe mit der Eingabetaste. |
HideValue, ShowCaption, BlankZero, Width | Feinheiten der Darstellung. |
AboutTitle, AboutText | Einfü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.
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.
| UsageCategory | Gedacht für |
|---|---|
Lists | Stammdaten- und Postenlisten |
Tasks | Erfassungsblätter, Verarbeitungen |
Documents | Beleglisten |
ReportsAndAnalysis | Berichte |
History | Gebuchte Belege, Register |
Administration | Einrichtungsseiten |
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üsselwort | Wirkung |
|---|---|
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, movebefore | Vorhandene 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öglich | Nicht 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;
}
| Wo | Trigger |
|---|---|
| Seite | OnOpenPage, 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. |
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)
{
}
}
}
}
| Bereich | Früherer ActionContainerType | Inhalt |
|---|---|---|
area(Processing) | ActionItems | Funktionen, die etwas tun. |
area(Navigation) | RelatedInformation | Sprünge zu zugehörigen Daten. |
area(Reporting) | Reports | Berichte. |
area(Creation) | NewDocumentItems | Neue Belege anlegen. |
area(Promoted) | Eigenschaften Promoted, PromotedCategory, PromotedIsBig | Verweise auf Aktionen, die direkt in der Aktionsleiste stehen sollen. |
Hochstufen: alt und neu
action(Customer)
{
Caption = 'Customer';
Promoted = true;
PromotedCategory = Process;
PromotedIsBig = true;
PromotedOnly = true;
...
}
Dazu PromotedActionCategories an der Seite mit einer kommagetrennten Liste von Kategorienamen.
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
| Eigenschaft | Bedeutung |
|---|---|
RunObject, RunPageLink, RunPageView, RunPageMode | Seite, Bericht oder Codeunit ohne Code starten. RunPageMode = Create öffnet die Seite mit einem neuen Datensatz. Einwertige Filter aus RunPageLink werden dabei als Vorbelegung übernommen. |
Image | Symbol aus einer festen Liste. IntelliSense zeigt die gültigen Namen. |
Scope = Repeater | Aktion erscheint auch im Zeilenmenü der Liste. |
ShortcutKey | Tastenkürzel. Viele Kombinationen sind vom Browser belegt. |
Enabled, Visible | Fest oder über Variable. |
Ellipsis | Hängt drei Punkte an, wenn ein Dialog folgt. |
8Seiten-Trigger und CurrPage
| Trigger | Wann | Typische Verwendung |
|---|---|---|
OnInit | Vor dem Laden | Startwerte für Sichtbarkeitsvariablen. |
OnOpenPage | Beim Öffnen | Filter setzen, Einrichtung lesen. |
OnAfterGetRecord | Für jede angezeigte Zeile | Berechnete Spalten, Zeilenformatierung. Muss schnell sein. |
OnAfterGetCurrRecord | Wenn der aktuelle Datensatz wechselt | Aktionen aktivieren oder deaktivieren. |
OnNewRecord | Neuer leerer Datensatz | Vorbelegungen. |
OnInsertRecord, OnModifyRecord, OnDeleteRecord | Vor der Datenbankoperation | Rückgabewert false unterdrückt die Operation. |
OnQueryClosePage | Vor dem Schließen | Prüfungen, mit CloseAction als Parameter. |
OnClosePage | Beim Schließen | Aufräumen. |
OnFindRecord, OnNextRecord | Navigation | Selten, für Seiten auf temporären Daten. |
OnPageBackgroundTaskCompleted | Hintergrundaufgabe fertig | Neu: 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,EnabledundEditablenehmen eine Boolean-Variable oder ein Boolean-Feld, keine Ausdrücke mit Vergleichen. Berechne den Wert in einer Funktion.StyleExprnimmt eine Textvariable mit dem Namen des Stils. Der EnumPageStyleist neuer, in älteren Versionen schreibst du den Text direkt:DurationStyle := 'Attention';.- In Listen wird
Visibleeiner Spalte nur beim Öffnen ausgewertet, nicht pro Zeile.EditableundStyleExprwirken pro Zeile, wenn du sie inOnAfterGetRecordsetzt. - Die Eigenschaft
IncludeInDataSetder 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).
Page.RunModal und Confirm sind innerhalb einer offenen Schreibtransaktion weiterhin verboten. Frage zuerst, schreibe danach.
13Übersetzung: XLIFF statt CaptionML
CaptionML=[DEU=Besuchsdatum;
ENU=Visit Date];
Alle Sprachen stehen im Objekt.
Caption = 'Visit Date';
Im Code steht nur Englisch. Jede weitere Sprache ist eine eigene Datei im Ordner Translations.
Ablauf
- In der
app.jsonmuss"features": ["TranslationFile"]stehen (auf Seite 2 schon eingetragen). - Beim Bauen mit Strg+Umschalt+B entsteht
Translations/ABC Kundenapp.g.xlf. Dasgsteht für „generated“. Diese Datei wird bei jedem Build überschrieben, bearbeite sie nie. - Kopiere sie nach
Translations/ABC Kundenapp.de-DE.xlf. - Setze im Kopf
target-language="de-DE"und ergänze zu jedem<source>ein<target>. - 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
idist 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,AboutTextund alleLabel-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;
| Zusatz | Bedeutung |
|---|---|
Comment | Erklärung für den Übersetzer, vor allem zu Platzhaltern. Landet in der XLIFF-Datei. |
Locked = true | Text wird nicht übersetzt. Für technische Werte wie Pfade und Schlüssel. |
MaxLength | Hö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 2017 | Business Central |
|---|---|
| Info zu dieser Seite (Strg+Alt+F1), Zoom | Seitenprü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ühren | Adressparameter ?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 = falseausgeblendet 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
profileundpagecustomizationliefern 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.
- Mit F5 veröffentlichen, Debitorenkarte öffnen.
- „New Visit“ anklicken. Die Besuchskarte öffnet sich mit vorbelegter Debitorennummer und dem Arbeitsdatum. Art und Beschreibung ausfüllen, Seite schließen.
- 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.
- Über die Suche (Alt+Q) „Customer Visits“ eingeben. Die Liste wird gefunden.
- 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:
| Englisch | Deutsch |
|---|---|
| Customer Visits | Kundenbesuche |
| Customer Visit | Kundenbesuch |
| Visit Date | Besuchsdatum |
| Visit Type | Besuchsart |
| On Site / Phone / Trade Show | Vor Ort / Telefon / Messe |
| Duration (Minutes) | Dauer (Minuten) |
| Customer Class | Kundenklasse |
| Last Visit | Letzter Besuch |
| No. of Visits | Anzahl Besuche |
| New Visit | Neuer Besuch |
| Visits | Besuche |
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.“
ApplicationAreafehlt, 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
modifyundVisible = falseausblenden. - „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.“
UsageCategorysetzen, 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.