Das Seitenerweiterungsobjekt „Debitorenliste“ erstellen
In diesem Szenario fügen Sie eine Aktion auf der Seite Debitorenliste hinzu. Diese Aktivität sollte die Liste der Belohnungsstufen öffnen.
In Business Central werden Aktionen oben auf jeder Seite angezeigt. Dieser Bereich wird oft als Aktionsleiste bezeichnet. Jede Seite verfügt über unterschiedliche Aktionen, abhängig vom Seitentyp und den von der Seite unterstützten Prozessen. Sie sollten die Geschäftsprozesse Ihrer Debitoren gut verstehen, um die entsprechenden Aktivitäten für eine Seite zu erstellen.
Das folgende Seitenerweiterungsobjekt erweitert das Seitenobjekt Debitorenliste durch Hinzufügen eines Aktionssteuerelements namens Belohnungsstufen zur Gruppe Debitor auf der Seite.
pageextension 50101 CustomerList extends "Customer List"
{
actions
{
addfirst("&Customer")
{
action("Reward Levels")
{
ApplicationArea = All;
Image = CustomerRating;
Promoted = true;
PromotedCategory = Process;
PromotedIsBig = true;
ToolTip = 'Open the list of reward levels.';
trigger OnAction();
var
CustomerRewardsExtMgt: Codeunit "Customer Rewards Ext Mgt";
begin
if CustomerRewardsExtMgt.IsCustomerRewardsActivated then
CustomerRewardsExtMgt.OpenRewardsLevelPage
else
CustomerRewardsExtMgt.OpenCustomerRewardsWizard;
end;
}
}
}
}
Die Eigenschaft Image gibt das Symbol an, das einer Aktion zugeordnet werden soll. Business Central enthält Bilder, die Sie für Aktionen in Befehlsleistenmenüs und für heraufgestufte Aktionen im Menüband verwenden können. Wenn Sie einer Aktion ein Bild hinzufügen möchten, fügen Sie die Image-Eigenschaft hinzu, und geben Sie aus der Bibliothek der Aktionssymbole in Business Central den Namen des Bilds ein, das Sie verwenden möchten. Standardmäßig sind Bilder 16 Pixel hoch und 16 Pixel breit. Für heraufgestufte Aktionen können Sie größere Bilder mit einer Höhe von 32 Pixeln und einer Breite von 32 Pixeln anzeigen.
Die Eigenschaft Promoted gibt an, ob die ausgewählte Aktion heraufgestuft wird. Dies bedeutet, dass sie in der Aktionsleiste und in der Gruppe, in der sie definiert ist, zu einer heraufgestuften Kategorie hochgestuft wird. Mit dieser Funktion können Sie eine Kopie einer Aktion erstellen und diese auf der Aktionsleiste platzieren, wo sie leichter zu finden ist. Heraufgestufte Aktionen sind Aktionen, die in den Aktionsmenüs, Navigationsmenüs oder Berichtsmenüs auf der Aktionsleiste eingerichtet, aber auch für die Anzeige auf der Registerkarte Start konfiguriert werden. Obwohl die Aktionen in den Aktionsmenüs, Navigationsmenüs oder Berichtsmenüs eingerichtet werden, können sie in diesen Menüs ausgeblendet und nur auf der Registerkarte Start angezeigt werden, wenn Sie dies wünschen.
Die Eigenschaft PromotedCategory legt eine Kategorie für eine heraufgestufte Aktion fest. Heraufgestufte Aktionen werden auf der Aktionsleiste einer Seite angezeigt. Sie können eine Aktion heraufstufen, indem Sie die Eigenschaft Promoted festlegen. Mit Kategorien können Sie ähnliche Aktionen unter einer gemeinsamen Beschriftung gruppieren.
Sie können zwischen 20 Kategorien auswählen:
Neue Aktionen werden im Menü „Neu“ angezeigt.
Prozessaktionen werden im Menü „Prozess“ angezeigt.
Berichtsaktionen werden im Menü „Bericht“ angezeigt.
Category4-Aktionen werden im Menü „Category 4“ angezeigt.
Category5-Aktionen werden im Menü „Category 5“ angezeigt.
Category6-Aktionen werden im Menü „Category 6“ angezeigt.
Category7-Aktionen werden im Menü „Category 7“ angezeigt.
Category8-Aktionen werden im Menü „Category 8“ angezeigt.
Category9-Aktionen werden im Menü „Category 9“ angezeigt.
Category10-Aktionen werden im Menü „Category 10“ angezeigt.
Category11-Aktionen werden im Menü „Category 11“ angezeigt.
Category12-Aktionen werden im Menü „Category 12“ angezeigt.
Category13-Aktionen werden im Menü „Category 13“ angezeigt.
Category14-Aktionen werden im Menü „Category 14“ angezeigt.
Category15-Aktionen werden im Menü „Category 15“ angezeigt.
Category16-Aktionen werden im Menü „Category 16“ angezeigt.
Category17-Aktionen werden im Menü „Category 17“ angezeigt.
Category18-Aktionen werden im Menü „Category 18“ angezeigt.
Category19-Aktionen werden im Menü „Category 19“ angezeigt.
Category20-Aktionen werden im Menü „Category 20“ angezeigt.
Standardmäßig werden die Kategorienamen als Beschriftungen im Menüband verwendet. Diese Kategorienamen entsprechen den Beschriftungen, die für die Kategorie auf der Seite in Business Central angezeigt werden. Wahrscheinlich möchten Sie die Beschriftungen ändern, insbesondere Kategorie 4 bis Kategorie 10.
Die Eigenschaft PromotedIsBig legt einen Wert fest, der angibt, ob die Aktion vor anderen Aktionen auf der Aktionsleiste angezeigt werden soll, unabhängig von ihrer Position in der AL-Seitendefinition. Wenn die Eigenschaft PromotedIsBig für mehr als eine Aktion auf true gesetzt ist, werden die Aktionen vor anderen Aktionen in der Reihenfolge angezeigt, in der sie in AL definiert sind.
In diesem Beispiel verwenden Sie den Trigger OnAction. Dieser Trigger wird ausgeführt, wenn ein Benutzer eine Aktion auf der Seite auswählt.
trigger OnAction();
var
CustomerRewardsExtMgt: Codeunit "Customer Rewards Ext Mgt";
begin
if CustomerRewardsExtMgt.IsCustomerRewardsActivated then
CustomerRewardsExtMgt.OpenRewardsLevelPage
else
CustomerRewardsExtMgt.OpenCustomerRewardsWizard;
end;
Der Code überprüft, ob die Kundenbelohnungserweiterung aktiviert wurde. Ist dies der Fall, wird die Seite Belohnungsstufe geöffnet. Wenn die Erweiterung für Kundenbelohnungen nicht aktiviert wurde, müssen Sie die Seite des Assistenten für Kundenbelohnungen ausführen, die in einem späteren Modul dieses Lernpfads erstellt wird.