Creazione dell'oggetto pagina Elenco dei livelli dei premi
Il codice seguente aggiunge la pagina Elenco dei livelli dei premi 50101 che consente all'utente di visualizzare, modificare o aggiungere nuovi livelli di premi e i relativi punti minimi richiesti. L'esempio di codice include descrizioni comandi per i controlli e un collegamento relativo alla Guida sensibile al contesto.
Nota
Più avanti in questo modulo, un esercizio consentirà di creare questo oggetto fornendo istruzioni dettagliate.
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';
}
Salvare l'oggetto con la combinazione di tasti CTRL+S. Sarà possibile completare la compilazione solo dopo aver compilato ogni elemento del modulo.
La struttura di una pagina è gerarchica e si suddivide in tre sezioni:
Sezione metadati: il primo blocco di codice contiene i metadati per la pagina globale:
Tipo di pagina
Tabella di origine a partire dalla quale vengono visualizzati i dati
Pagina Elenco dei livelli dei premi, contenente un numero, un nome e diverse proprietà (ad esempio)
page 50101 "Rewards Level List" { PageType = List; SourceTable = "Reward Level"; SourceTableView = sorting ("Minimum Reward Points") order(ascending); ApplicationArea = All; UsageCategory = Lists;
Sezione layout: la seconda sezione descrive il layout della pagina:
Parti visive: questa porzione di codice mostra le parti visive nella pagina.
L'esempio seguente mostra la sezione layout della pagina Elenco dei livelli dei premi.
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.'; } } } }Descrizioni comandi dei controlli: in base al modello di assistenza utente per Business Central, le app dovrebbero applicare le descrizioni dei comandi ai controlli sulle pagine. Nel client, le descrizioni comandi vengono visualizzate quando si punta alla didascalia del controllo. L'impostazione predefinita è una stringa vuota, a indicare che non vengono offerte descrizioni comando. Nell'esempio precedente la proprietà Tooltip è stata impostata per i campi nella pagina.
Aree di applicazione: la proprietà ApplicationArea imposta le aree di applicazione che si applicano al controllo. Le aree di applicazione rappresentano una funzionalità del sistema che offre a sviluppatori, amministratori e utenti la possibilità di definire esperienze utente differenziate. Le aree sono mappate ai controlli per mostrarli o nasconderli negli oggetti della pagina per abilitare più o meno scenari di business. Un tag dell'area di applicazione deve avere il formato nome, dove nome è l'area di applicazione. Il nome può essere una combinazione qualsiasi di lettere (Aa-Zz) e numeri (0-9) senza spazi.
Ad esempio, per specificare le aree di applicazione Basic e Cespiti, impostare la proprietà su Basic, FixedAssets. Se il controllo si applica a tutte le aree di applicazione, è possibile impostare la proprietà su Tutto, il che significa che il controllo apparirà sempre nell'interfaccia utente. Se in una sessione sono abilitate una o più aree di applicazione, i controlli senza tag di un'area di applicazione non saranno visualizzati nell'interfaccia utente.
Pagine o report individuabili: la proprietà UsageCategory è un'impostazione obbligatoria usata insieme alla proprietà ApplicationArea. È possibile abilitare una pagina o un report affinché sia individuabile tramite la funzionalità Dimmi in Business Central usando la proprietà UsageCategory.
Se la proprietà UsageCategory è impostata su Nessuno o se non si specifica una proprietà UsageCategory:
La pagina o il report non verrà visualizzato quando si usa la funzionalità di ricerca.
Gli utenti non saranno in grado di aggiungere un collegamento all'oggetto pagina o report dall'interfaccia utente.
Sezione azioni pubblicate: la terza sezione descrive in dettaglio le azioni pubblicate nella pagina. Nella pagina Elenco dei livelli dei premi non sono state definite azioni personalizzate.