Database logico e relativi oggetti

Completato

In modo analogo a molte altre applicazioni cloud, Dynamics 365 Business Central è creato su un database. Tale database non contiene solo i dati (come clienti, fornitori, prodotti e così via), ma anche tutti gli oggetti usati nell'applicazione. Quando si richiedono i dati dei clienti, tali dati vengono visualizzati come una pagina sullo schermo con una determinata struttura.

Il database di Business Central memorizza anche la struttura di questa pagina, che consente agli sviluppatori di aggiungere e modificare oggetti esistenti e di distribuire rapidamente nuove soluzioni. Quando si desidera modificare la posizione di determinati campi di input sullo schermo, non è necessario creare una nuova versione del prodotto.

Ogni soluzione è creata sulla base di uno o più oggetti. Sono necessari elementi diversi, ad esempio tabelle per memorizzare i dati, pagine per presentarli, la possibilità di consentire l'interazione con l'utente, report da visualizzare nonché la possibilità di stampare i dati in layout specifici.

Le codeunit consentono di raggruppare funzioni da riutilizzare in luoghi diversi, mentre l'oggetto Query e l'oggetto XMLPort consentono, rispettivamente, di interrogare il database e di importare o esportare funzionalità nella soluzione creata.

I tipi di oggetti comunemente usati includono i seguenti:

  • Tabella: descrive il modo in cui vengono archiviati e recuperati i dati.

  • Pagina: consente agli utenti di visualizzare, aggiungere, modificare o eliminare i record in una tabella.

  • Report: consente di stampare, elaborare o visualizzare in anteprima i dati.

  • Codeunit: contenitore del codice di programmazione. Le codeunit vengono chiamate da altri oggetti per completare un'attività specifica.

  • Query: modello di dati relazionale per l'interrogazione diretta ed efficiente del database sottostante.

  • XMLPort: consente di importare o esportare dati in formato XML o testo.

Business Central dispone di molti oggetti con funzionalità incorporati. Non è possibile modificare il codice sorgente degli oggetti, ma è possibile modificare il comportamento estendendo gli oggetti incorporati.

Altri due tipi di oggetti che è possibile usare sono i seguenti:

  • Estensione di tabella: estende le funzionalità delle tabelle esistenti.

  • Estensione di pagina: estende le funzionalità delle pagine esistenti.

Database logico

Nel database di Business Central è possibile configurare diverse società. I dati di una società vengono archiviati come record in tabelle diverse e ogni record è costituito da più campi.

Le società sono la più maggiore struttura logica in un database e i dati sono, e devono essere, per lo più specifici della società. a differenza degli oggetti. È compito dello sviluppatore creare, modificare ed estendere gli oggetti, che saranno quindi applicabili a tutte le società all'interno dello stesso database.

Illustrazione che mostra un progetto di database logico.

Gestione degli oggetti

Prima di iniziare a creare nuovi oggetti per le soluzioni personalizzate, è necessario tenere presenti le convenzioni di numerazione degli oggetti. Ogni oggetto nella soluzione Business Central è identificato da un numero univoco. Le convenzioni di numerazione consentono di organizzare la gestione delle versioni, la localizzazione e la personalizzazione e garantiscono che gli aggiornamenti abbiano esito positivo.

I numeri degli oggetti da 0 a 49.999 indicano oggetti usati da Microsoft e nelle versioni internazionali. L'intervallo di numeri da 100.000 a 999.999 contiene gli oggetti localizzati, ovvero oggetti sono generalmente progettati per paesi e aree geografiche diversi nel mondo. Anche questi oggetti specifici dell'area vengono creati da Microsoft.

In termini di licenza, probabilmente si opera con tre diversi intervalli di oggetti. Tutti i tenant possono usare liberamente gli oggetti nei seguenti intervalli:

  • 50.000-99.999

  • 1.000.000-60.000.000

  • 70.000.000-74.999.999

Le sezioni seguenti spiegano l'intenzione di ogni singolo intervallo.

Intervallo: 50.000-99.999

Intervallo per la personalizzazione di ogni tenant/cliente. Un partner può sviluppare un'estensione personalizzata per il singolo tenant al fine di soddisfare le proprie esigenze. Il partner che sviluppa l'estensione può usare un tenant sandbox o un'immagine Docker della versione corrente di Business Central che corrisponde alla versione del tenant. Completato lo sviluppo, l'estensione può essere distribuita al singolo tenant.

Intervallo: 1.000.000-60.000.000

Questo intervallo è correlato al programma RSP (Registered Solution Program), riservato ai partner sviluppatori che dispongono di una soluzione ISV. Il partner può scegliere di usare questo intervallo per sviluppare estensioni che possono essere usate in Microsoft Dynamics NAV in locale o in Dynamics 365 Business Central nel cloud. Se usate in Dynamics 365 Business Central, tali estensioni si possono in genere ottenere come app da AppSource.

Intervallo: 70.000.000-74.999.999

I partner possono ottenere intervalli per lo sviluppo di estensioni eseguite in Business Central. Tali intervalli sono disponibili solo per lo sviluppo di estensioni e anche come app da AppSource.

Per ulteriori informazioni su Microsoft AppSource, vedere Programma Ready To Go.

Prefisso e suffisso

Oltre al requisito di essere associato a un numero univoco, ogni oggetto deve avere anche un nome univoco. Due tabelle, pertanto, non possono avere lo stesso nome. Business Central consente di installare più estensioni e alcune di queste possono provenire da AppSource. AppSource è un marketplace centrale in cui è possibile acquistare nuove funzionalità aggiuntive per Business Central.

È molto probabile che si installino estensioni con lo stesso nome per una tabella. Per risolvere questo problema, gli sviluppatore devono usare i prefissi o i suffissi.

Un prefisso o suffisso in Business Central è un tag di almeno tre caratteri che deve essere posto all'inizio o alla fine di ogni oggetto creato. In caso di conflitto, la priorità viene assegnata a chi ha registrato il tag. Per registrare un tag, ad esempio per la propria azienda, è necessario inviare un messaggio e-mail all'indirizzo d365val@microsoft.com per prenotare il prefisso e/o il suffisso.

Per ogni oggetto (pagine, tabelle, codeunit e così via), specificare il tag al livello dell'oggetto superiore.

Alle app in AppSource è richiesto di registrarsi e usare un prefisso o un suffisso. Solo in rari casi le app incontreranno conflitti di denominazione.

Alle estensioni per tenant non è richiesto l'uso di un prefisso o di un suffisso, anche se è vivamente consigliato. È possibile usare pte come prefisso o suffisso per evitare conflitti con app AppSource o oggetti di base.

Regole generali

  • Il prefisso/suffisso deve contenere almeno 3 caratteri.

  • Il nome dell'oggetto/campo deve iniziare o terminare con il prefisso/suffisso.

  • In caso di conflitto, la priorità viene assegnata a chi ha registrato il prefisso/suffisso.

  • Per le proprie pagine/tabelle/codeunit, è necessario impostare il prefisso/suffisso al livello dell'oggetto superiore.

  • Per le pagine/tabelle nell'applicazione di base o altre app che si estendono, è necessario impostare il prefisso/suffisso al livello dell'oggetto superiore e anche al livello del controllo/campo/azione.

  • Usare lo strumento AppSourceCop per trovare i prefissi e/o i suffissi mancanti. La sezione Regole spiega i diversi controlli che l'analizzatore effettuerà. Per il rilevamento del prefisso/suffisso, fare riferimento alla sezione Configurazione. Spiega come impostare il prefisso nel file AppSourceCop.json.