Vai al contenuto

Dettagli - Mostrare dati secondari collegati a una riga

Note

Questo tutorial presuppone quello che è stato fatto nel tutorial Lookup - Celle con una lista di opzioni da scegliere. Se hai saltato il precedente tutorial o vuoi sperimentare per poi tornare indietro, non preoccuparti! Puoi importare questo file .eap per ripristinare o sincronizzare con ciò che vedi in questa documentazione. Impara a ripristinare usando i file .eap. Se non vuoi usare l'.eap, ciò che vedi potrebbe differire leggermente dagli screenshot.

Imparerai cosa sono i Dettagli, come crearli e come puoi applicare restrizioni sull'editabilità dei dati sui Dettagli.

Puoi estendere ulteriormente la possibilità di registrare dati in un'applicazione eLegere. I Dettagli sono tabelle collegati a una riga della tabella di Master.

La tabella di Master registra varie righe. Puoi associare una tabella secondari contenente ulteriori dati alla riga della tabella di Master. Queste tabelle secondarie sono i Dettagli.

I Dettagli sono un modo per rappresentare una relazione fra due campi Storage come tabelle secondarie collegata a una singola riga della tabella di Master. (Vedi Regole per Relazioni e Lookup per comprendere l'argomento delle Relazioni e la loro rappresentazione.)

Note

Il tutorial spiega prima i passi per creare un Dettaglio e la sua relazione. Il tutorial richiederà di ripetere più volte lo stesso schema di operazioni. Se preferisci comprendere la teoria prima della pratica, vai a Relazioni e Dettagli. Torna in seguito all'inizio e segui l'ordine del tutorial. Altrimenti, continua a leggere le sezioni in modo sequenziale.

Transazioni divise per Prodotto e Servizio in Transactions Products and Services

Prendi l'applicazione Transactions Products and Services che hai costruito come esercizio nel precedente tutorial.

Creerai un Dettaglio che elenca le transazioni che ricadono sotto ciascun prodotto o categoria di servizio in Transactions Products and Services.

I passi per creare un Dettaglio sono i seguenti.

Creare la relazione in Transactions Products Services

Devi stabilire una Relazione sullo storage Transactions Products Services. Dettagli e Lookup richiedono una relazione. Per questa ragione, questo stadio sarà simile alla creazione di una relazione per una Lookup.

Nel prossimo passo, configurerai l'applicazione per rappresentare la relazione come Dettaglio. Per ora, crea una nuova relazione come segue.

  1. Entra nell'editor di Storage di Transactions Products Services.

  2. Nel sotto-pannello Relations, crea una nuova relazione e scegli lo storage Transactions.

  3. Scegli come campo source IdTransactionsProductService e TransactionsProductServiceId come target field. Nomina la relazione Transactions_Details. La relazione da un campo Identity a un campo Numeric è corretta. Scoprirai in Relazioni e Dettagli perché in questo caso inverti i campi Numeric e Identity nella relazione.

  4. Salva tutti i cambiamenti sullo storage Transactions Products Services.

Configurare la relazione come Dettaglio nell'applicazione Transactions Products and Services

In Regole per Relazioni e Lookup hai imparato che le relazionisono indipendenti dalla loro rappresentazione in un'applicazione. Sia per le Lookup che per i Dettagli devi prima stabilire una relazione. Ma Lookup e Dettagli differiscono nella loro configurazione dentro l'applicazione. Imparerai come i Dettagli differiscono e la loro configurazione.

Devi configurare l'applicazione Transactions Products and Services per rappresentare la relazione Transactions_Details come Dettaglio.

  1. Entra nel Design Mode di Transactions Products and Services.

  2. Abilita il campo IdTransactionsProductService come Primary Key cliccando sul pulsante Is Primary Key () accanto alla casella di testo del campo.

    Aggiungere Dettagli richiede abilitare una Primary Key. L'applicazione associa le righe del Dettaglio a ogni riga del Master tramite la Primary Key.

    Puoi configurare come Primary Key solo campi che hanno l'opzione Unique abilitata sullo storage.

    Le Primary Key sono utili per altre funzionalità come Sharing Rows. (Imparereai in seguito un altro uso delle Primary Key nella sezione Condividi con un altro familiare la tua transazione.)

    Tip

    È buona pratica impiegare campi Identity come Primary Key.

  3. Clicca sulla scheda Dettagli sulla barra laterale sinistra.

  4. Accederai al sotto-pannello Dettagli.

    Clicca sul pulsante Add Detail sull'angolo in altro a destra del sotto-pannello. Una nuova scheda di apparirà nel sotto-pannelo.

    Cliccare su Add Detail crea una nuova Scheda Dettaglio (Detail Tab).

    • (1) Detail Tab: Come la scheda appare nell'applicazione.
    • (2) Settings: Puoi decidere l'etichetta per il Dettaglio, scegliere un'icona, opzioni desktop e mobile, visibilità, restrizioni e colori.
    • (3) Details Available: Puoi popolare una scheda di Dettaglio con differenti tipi di Dettagli.

    Info

    Tipi di Dettaglio:

    • Table Una tabella da uno storage che possiede una relazione con uno dei campi dell'applicazione attuale.
    • Image Mostra una galleria immagini da un campo Uri di uno Storage
    • Field Mostra in una Detail Tab uno o più campi della tabella di Master per diminuire il numero di colonne.

    Per questo tutorial hai bisogno solo del Dettaglio di tipo Table ().

  5. Trascina l'opzione Table () sotto la barra al centro del sotto-pannello.

  6. Apparirà una finestra per scegliere la relazione da usare come tabella di Dettaglio. Scegli Transactions_Details come tabella.

  7. La finestra mostrerà le opzioni campo per lo storage Transactions nello stesso modo della configurazione di una tabella di Master.

    Cambia le seguenti opzioni per la tabella.

    • (1) Configura le Column Headers' Label. (Digita le stesse etichette dell'applicazione Personal Budget)
    • (2) Scegli il Format per i campi BudgetValue, BudgetDate e BudgetTime.
    • (3) Abilita l'ordinamento per i campi evidenziati cliccando sul pulsante Is Sortable ().
    • (4) Abilità i campi evidenziati come ricercabili cliccando sul pulsante Is Searchable ().
    • (5) Abilità la visibilità dei campi evidenziati cliccando sul pulsante Visible in the Grid ().
    • (6) Configura le Lookup ().

    La configurazione dovrebbe apparire come segue.

    Puoi ignorare la configurazione di TransactionsProductServiceId. Avendo configurato un dettaglio di Transactions Products and Services, non hai bisogno di mostrare due volte le stesse informazioni nel Master e nel Dettaglio.

  8. Clicca sul pulsante Confirm sulle opzioni della finestra Detail Table Setting per confermare la configurazione.

  9. Hai configurato il Dettaglio. Personalizza nome e icone della scheda del Dettaglio.

    • Digita un nome per la scheda del dettaglio nella casella di testo. Chiama la scheda di dettaglio Transactions Related.
    • Scegli un'icona per la scheda, per esempio (cerca fa-th-list).

  10. Personalizza il layout di Transactions Related nel sotto-pannello Layout.

    Disponi le colonne come segue:

    • Name
    • Value
    • Payment Method
    • Income/Expense
    • Date
    • Time
    • Notes

  11. Salva qualunque cambiamento nel Design Mode di Transactions Products and Services.

Ora hai un Dettaglio per ogni categoria di prodotto e servizio con tutte le transazioni che ricadono in ciascuna categoria.

Inserire dati nei Dettagli

Lo scopo del Dettaglio Transactions Related è mostrare le transazioni per categoria: l'utente non deve inserire alcun dato.

Warning

Nota che puoi aggiungere, rimuovere o modificare una riga in un Dettaglio se la configurazione relativa è attiva.

In caso tu voglia abilitare le modifiche per le righe del Dettaglio:

  1. Accedi al Design Mode di Transactions Products and Services.

  2. Clicca sulla scheda Settings sulla barra laterale sinistra.

  3. Accederai alle opzioni delle tabelle. Clicca sulla scheda di Transactions Related.

  4. Modifica le seguenti opzioni:

Come visualizzare i Dettagli di una riga

Una breve spiegazione su come accedere ai Dettagli.

  1. Clicca sul pulsante Row Options () fra la casella di spunta e la prima colonna della riga.

  2. Clicca sul pulsante Details sulla striscia pop-up.

Tip

Come alternativa, puoi fare doppio-click sul pulsante Row Options per accedere ai Dettagli.

Tip

Se vuoi risparmiare spazio nella finestra: puoi nascondere la riga a cui si riferisce il Dettaglio (i.e. Parent Row) nella sezione Dettaglio. Clicca sul pulsante Hide Parent Rows. (Clicca su Show Parent Rows se vuoi mostrare di nuovo la riga a cui si riferisce il Dettaglio.)

Tip

Puoi visualizzare i Dettagli di più righe assieme e al tempo stesso in una sola tabella.

  1. Spunta le righe della tabelle di Master di cui vuoi vedere i Dettagli.

  2. Clicca sul pulsante Aggregate Details sull'angolo superiore destro della tabella di Master.

Vedrai una singola tabella con tutti i dati dei Dettagli delle righe selezionate.

Gli Aggregate Details funzionano come una qualunque tabella di Dettaglio con due eccezioni:

  • La colonna Name (1) sulla sinistra specifica a quale riga di Master appartiene la riga di Dettaglio in (2). Sulla destra, c'è la tabella standard contente tutte le righe aggregate (2).
  • Non puoi né aggiungere né cancellare righe, anche se il pannello Settings in Design Mode ha abilitato Enable Add Record e Enable Remove Record

Relazioni e Dettagli

Qui c'è una piccola spiegazione riguardo Relazioni e Dettagli.

Note

Questa parte da per scontato le nozioni apprese nella sezione Regole per Relazioni e Lookup

Le relazioni per i Dettagli sono il contrario delle Lookup: se in una Lookup il campo source è un campo Numeric e il campo target è un campo Identity, nei Dettagli:

  • Il campo source è un campo Identity nello storage con i dati primari (Transactions Products Services).
  • Il campo target è un campo Numeric in uno storage con i dati secondari (Transactions).

Tip

Non hai bisogno di creare un nuovo campo di tipo Numeric per questo Dettaglio. I campi precedentemente usati per la relazione di Lookup hanno i dati che ti servono: Transactions ha già un campo Numeric usato per una Lookup con Transactions Products Services.

Nel precedente tutorial, la Lookup ha associata una categoria con più transazioni.

In questo tutorial, stai costruendo un Dettaglio. Il Dettaglio elenca tutte le righe che hai associato alla categoria. Questo è il perché i Dettagli lavorano nella maniera opposta delle Lookup.

Storage Applicazione Storage Dettaglio
campo Identity campo Numeric

Lookup

Ogni transazione si riferisce a un singolo prodotto o categoria di servizio. (Numeric > Identity).

Dettagli

Per un singolo prodotto o categoria di servizio, ci sono transazioni multiple. (Identity > Numeric).

Come dividere le spese per metodo di pagamento in Payment Methods

Prendi l'applicazione Payment Methods che hai costruito durante il precedente tutorial.

Supponi che tu voglia vedere le spese fatte per ciascun metodo di pagamento.

Riassumerai ciascuna transazione in Payment Methods tramite un Dettaglio chiamato Expenses. Anche in questo caso,lo storage Transactions conterrà i dati da mostrare nel Dettaglio Expenses.

I passi per creare un Dettaglio come Expenses sono i seguenti.

Stabilire la relazione Transactions_Expenses_Detail

Stabilisci la relazione Transactions_Expenses_Detail fra IdPaymentMethod in Payment Methods e PaymentMethodId in Transactions.

Userai Transactions_Expenses_Detail per creare il Dettaglio Expenses.

  1. In Storages, entra nell'editor dello storage Payment Methods.

  2. In Payment Methods, stabilisci una relazione con Transactions.

    I campi per la relazione sono IdPaymentMethod in Payment Methods e il campo PaymentMethodId in Transactions.

  3. Clicca sul pulsante Save and Exit.

Hai stabilito la relazione richiesta per Expenses.

Configurare il Dettaglio Expenses nell'applicazione Payment Methods

Devi configurare l'applicazione Payment Methods per rappresentare Transactions_Expenses_Detail come Dettaglio della tabella di Master.

  1. Entra nel Design mode dell'applicazione Payment Methods.

  2. Abilita il campo IdPaymentMethod come Primary key cliccando sul pulsante Is Primary Key () accanto alla casella di testo del campo.

  3. Clicca sulla scheda Details nella barra laterale sinistra. Accederai al sotto-pannello Details.

  4. Cliccare su Add Detail sull'angolo in alto a destr del sotto-pannello Details.

  5. Trascina l'opzione Table () sotto la barra al centro del sotto-pannello. Scegli Transactions_Expenses_Detail come tabella per il Dettaglio.

  6. La finestra mostrerà i campi dello storage Transactions.

    Cambia le seguenti opzioni per la tabella.

    • (1) Configura le Column Headers' Label. (Digita le stesse etichette dell'applicazione Personal Budget)
    • (2) Scegli il Format per i campi BudgetValue, BudgetDate e BudgetTime.
    • (3) Abilita l'ordinamento per i campi evidenziati cliccando sul pulsante Is Sortable ().
    • (4) Abilità i campi evidenziati come ricercabili cliccando sul pulsante Is Searchable ().
    • (5) Abilità la visibilità dei campi evidenziati cliccando sul pulsante Visible in the Grid ().
    • (6) Configura le Lookup ().

    La configurazione dovrene essere come la seguente.

    Puoi ignorare la configurazione di PaymentMethodId. Avendo configurato un dettaglio di Payment Methods, non hai bisogno di mostrare due volte le stesse informazioni nel Master e nel Dettaglio.

  7. Clicca sul pulsante Confirm sulla finestra Detail Table Setting per confermare la configurazione.

  8. Hai configurato il Dettaglio. Personalizza nome e icone della scheda del Dettaglio.

    • Digita il nome del Dettaglio nella casella di testo. Chiama la scheda Expenses.
    • Scegli un'icona per la scheda, per esempio (cerca minus).

  9. Nel sotto-pannello Layout, clicca sulla scheda Expenses e personalizza e disponi le colonne.

    Disponi l'ordine delle colonne come segue:

    • Income/Expense
    • Name
    • Value
    • Product Service
    • Date
    • Time
    • Notes

Restrizione sui dati del Dettaglio Expenses usando una Formula

  1. A questo punto, Expenses mostra tutte le righe dato che non ci sono restrizioni.

    Devi configurare una restrizione per far mostrare a Expenses solo le spese associate al metodo di pagamento.

    Userai le Formule per configurare le restrizioni per i dettagli.

    • (1) Clicca sul sotto-pannello Settings sulla barra laterale sinistra.

    • (2) Nella parte sinistra del sotto-pannello, clicca sulla scheda Expenses.

    • (3) Clicca su Restrictions > Row.

  2. Apparirà l'Editor Formule (Formula Editor).

    Digita o copia-incolla la seguente formula:

    1
    =EQ($CURRENTSTORAGE.IncomeExpensesTypeId; 1)
    La formula specifica di prendere solo le righe con il campo IncomeExpensesTypeId uguale a 1. 1 è l'ID visibile per la riga "Expense" in Income Expense Type: devi conoscere l'ID esatto dell'opzione

    A questo punto, il Dettaglio Expenses mostrerà solo le righe delle transazioni classificate come Expense.

  3. Salva tutti i cambiamenti nel Design Mode di Payment Methods.

Ora, hai associato dei dati secondari da un altro Storage alle righe di Payment Methods. Ciascun metodo di pagamento avrà un Dettaglio con tutte le spese fatte.

Il Dettaglio mostrerà solo le righe classificate come spese ("Expenses") grazie alla Formula nella Row Restriction.

Esercizio: Dividere le entrate per metodo di pagamento in Payment Methods

Prova da solo o da sola ad aggiungere un Dettaglio in Payment Methods per le entrate ("Income") ricevuto con ciascun metodo di pagamento. (Qui trovi la soluzione.)

Tip

Puoi stabilire relazioni multiple usando gli stessi campi. Differenzia le relazioni create sugli stessi campi usando nomi che rendono chiaro il loro ruolo. (es. Nome_Relazione_Detail, Nome_Relazione_Lookup)

Personalizzare la scheda del Dettaglio

Note

Questo passaggio è opzionale.

Come altri parti di un'applicazione, puoi personalizzare anche l'aspetto della scheda del Dettaglio (Details' Tab).

Imparerai come assegna un colore a ciascuna scheda. Questo aiuta a identificare una scheda a colpo d'occhio. Infatti, usare i colori diventa utile quando la tua applicazione ha molti Dettagli da navigare.

Per esempio, cambia il colore della scheda per i Dettagli Income ed Expenses in Payment Methods.

  1. Torno al sotto-pannello Details in Design Mode.

  2. In Details, puoi notare due menù a tendina con le palette di colori chiamate Colors.

    • (1) La palette colori sulla sinistra cambia il colore della scheda.
    • (2) La palette colori sulla destra cambia il colore del testo etichetta della scheda Dettaglio.

    Clicca sulla palette colori 1 e scegli una sfumatura di rosso per la scheda Dettaglio Expenses.

  3. Ripeti il passo 2 ma per la scheda Dettaglio Income. Scegli una sfumatura di verde per distinguere Income da Expenses.

  4. Salva i cambiamenti in Design Mode.

A questo punto, puoi nascondere la colonna Income/Expense dei Dettagli. Il Dettaglio raggruppa ciascuna riga per tipo e i colori identificano ciascuna voce.

  1. Torna al sotto-pannello Dettagli in Design Mode.

  2. Clicca sul pulsante Configure () accanto alla riga della tabella del Dettaglio.

  3. Disabilita l'opzione Is Visible in Grid () per la colonna Income/Expense.

  4. Ripeti il passo 3 per il Dettaglio Income.

  5. Salva tutti i cambiamenti nel Design Mode.

Accedendo all'applicazione Payment Methods, vedrai le schede Dettaglio colorate senza la colonna Income/Expense.

Congratulazioni, hai imparato come si creano i Dettagli!

A questo punto, hai realizzato un'applicazione potente e funzionale senza alcuna conoscenza di programmazione. Ma puoi potenziarla introducendo dei processi automatizzati.

Success

Continua con il tutorial Automatizza la tua applicazione. Imparerai i fondamentali delle automazioni del flusso di lavoro per eLegere tramite esempi: Colonne Logiche, Custom Actions, eLegere Script e Scheduled Jobs.