Das Seitenobjekt „Rewards Level List“ erstellen

7 Minuten

Der folgende Code fügt die Seite 50101 Rewards Level List hinzu, auf der der Benutzer neue Belohnungsstufen und die entsprechenden erforderlichen Mindestpunkte anzeigen, bearbeiten oder hinzufügen kann. Das Codebeispiel enthält QuickInfos für Steuerelemente und einen Link zur kontextbezogenen Hilfe.

Hinweis

Später in diesem Modul gibt es eine Übung, in der Sie dieses Objekt erstellen können, indem Sie Schritt-für-Schritt-Anweisungen befolgen.

page 50101 "Rewards Level List"
{ 
    PageType = List;
    ContextSensitiveHelpPage = 'sales-rewards';
    SourceTable = "Reward Level";
    SourceTableView = sorting ("Minimum Reward Points") order(ascending);

    layout
    {
        area(content)
        {
            repeater(Group)
            {
                field(Level; Level)
                {
                    ApplicationArea = All;
                    Tooltip = 'Specifies the level of reward that the customer has at this point.';
                }

                field("Minimum Reward Points"; "Minimum Reward Points")
                {
                    ApplicationArea = All;
                    Tooltip = 'Specifies the number of points that customers must have to reach this level.';
                }
            }
        }
    }

    trigger OnOpenPage(); 
    begin 

        if not CustomerRewardsExtMgt.IsCustomerRewardsActivated then 
            Error(NotActivatedTxt); 
    end; 

    var 
        CustomerRewardsExtMgt: Codeunit "Customer Rewards Ext. Mgt."; 
        NotActivatedTxt: Label 'Customer Rewards is not activated'; 
}

Stellen Sie sicher, dass Sie das Objekt mithilfe der Tastenkombination STRG+S speichern. (Sie können dies erst erfolgreich kompilieren, wenn Sie alles in diesem Modul abgeschlossen haben.)

Die Struktur einer Seite ist hierarchisch und ist in drei Abschnitte gegliedert:

Metadatenabschnitt – Der erste Codeblock enthält Metadaten für die Gesamtseite:

Seitentyp
Quelltabelle, aus der die Seite Daten anzeigt

Die Seite Rewards Level List enthält eine Nummer, einen Namen und mehrere Eigenschaften (zum Beispiel)

    page 50101 "Rewards Level List"
    { 
    	PageType = List;
    	SourceTable = "Reward Level";
    	SourceTableView = sorting ("Minimum Reward Points") order(ascending);
    	ApplicationArea = All;
    	UsageCategory = Lists;

Layout-Bereich – Der zweite Abschnitt beschreibt das Seitenlayout:
- Visuelle Teile – Dieser Teil des Codes zeigt die visuellen Teile auf der Seite.
  
  Das folgende Beispiel zeigt den Layoutabschnitt der Seite Rewards Level List.
```
  	layout
  	{
  		area(content)
  		{
  			repeater(Group)
  			{
  				field(Level; Level)
  				{
  					ApplicationArea = All;
  					Tooltip = 'Specifies the level of reward that the customer has at this point.';
  				}

  				field("Minimum Reward Points"; "Minimum Reward Points")
  				{
  					ApplicationArea = All;
  					Tooltip = 'Specifies the number of points that customers must have to reach this level.';
  				}
  			}
  		}
  	} 
```
- QuickInfos steuern – Gemäß dem Benutzerunterstützungsmodell für Business Central wird erwartet, dass Apps QuickInfos für Steuerelemente von Seiten anwenden. Im Client werden QuickInfos angezeigt, wenn Sie auf die Beschriftung des Steuerelements zeigen. Der Standardwert ist eine leere Zeichenfolge. Dies bedeutet, dass keine QuickInfo bereitgestellt wird. Im vorhergehenden Beispiel ist die Eigenschaft QuickInfo für die Felder auf der Seite festgelegt.
- Anwendungsbereiche – Die Eigenschaft ApplicationArea legt die Anwendungsbereiche fest, die für das Steuerelement gelten. Anwendungsbereiche stellen eine Funktion im System dar, die Entwicklern, Administratoren und Benutzern die Möglichkeit bietet, differenzierte Benutzererfahrungen zu definieren. Die Bereiche werden Steuerelementen zugeordnet, um sie auf Seitenobjekten anzuzeigen oder auszublenden, um mehr oder weniger Geschäftsszenarien zu ermöglichen. Ein Anwendungsbereichstag muss das Format Name haben, wobei „Name“ der Anwendungsbereich ist. Der Name kann aus jeder Kombination von Buchstaben (Aa-Zz) und Zahlen (0-9) ohne Leerzeichen bestehen.
  
  Wenn die Eigenschaft beispielsweise auf Basic, FixedAssets festgelegt wird, gibt sie die Anwendungsbereiche „Basic“ und „FixedAssets“ an. Wenn das Steuerelement für alle Anwendungsbereiche gilt, können Sie die Eigenschaft auf Alle festlegen. Dies bedeutet, dass das Steuerelement immer in der Benutzeroberfläche angezeigt wird. Wenn in einer Sitzung ein oder mehrere Anwendungsbereiche aktiviert sind, werden Steuerelemente, die nicht mit einem Anwendungsbereich gekennzeichnet sind, nicht auf der Benutzeroberfläche angezeigt.
- Auffindbare Seiten oder Berichte – Die Eigenschaft UsageCategory ist eine erforderliche Einstellung, die zusammen mit der Eigenschaft ApplicationArea verwendet wird. Sie können durch die Funktion Wie möchten Sie weiter verfahren? in Business Central mithilfe der Eigenschaft UsageCategory aktivieren, dass eine Seite oder ein Bericht über die Website erkennbar ist.
  
  Wenn die UsageCategory auf Keine eingestellt ist, oder wenn Sie keine UsageCategory angeben:
  - Die Seite oder der Bericht wird nicht angezeigt, wenn Sie die Suchfunktion verwenden.
  - Benutzer können keinen Link zur Seite oder zum Berichtsobjekt über die Benutzeroberfläche mit einem Lesezeichen versehen.
Veröffentlichter Aktionsabschnitt – Im dritten Abschnitt werden die auf der Seite veröffentlichten Aktionen beschrieben. Auf der Seite Rewards Level List haben Sie keine benutzerdefinierten Aktionen definiert.

Weiter

Feedback