Database logico e relativi oggetti
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.
Estensione di report: estende le funzionalità dei report 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.
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.
Quando si sviluppa un'app per Business Central Online, occorre richiedere un intervallo di oggetti in termini di licenza. Lo sviluppo per Business Central viene eseguito mediante Visual Studio Code con l'estensione del linguaggio AL per Microsoft Dynamics 365 Business Central.
Al momento sono disponibili due intervalli che è possibile richiedere. Entrambi presentano alcune caratteristiche da tenere a mente:
Intervallo di oggetti RSP (intervallo ID 1000.000-69.999.999): questo intervallo di oggetti è associato al programma RSP. Per visualizzare queste informazioni è necessario effettuare l'accesso tramite un account aziendale o dell'istituto di istruzione. Al momento consigliamo ai nuovi editori di non richiedere un intervallo di oggetti RSP.
Intervallo di oggetti app (intervallo ID 70.000.000-74.999.999): questo intervallo di oggetti è stato originariamente progettato solo per le app nel marketplace commerciale Microsoft da usare in Business Central online. Al momento consigliamo ai nuovi editori di richiedere un intervallo di oggetti app.
Attualmente è possibile implementare app sviluppate sia nell'intervallo di oggetti RSP che nell'intervallo di oggetti app in Business Central Online e in locale, nonché ospitate dai partner.
Per altre informazioni, consultare Richiesta di un intervallo di oggetti.
Nelle sezioni seguenti vengono descritti i diversi intervalli di oggetti disponibili nell'applicazione base e nelle estensioni.
0 - 49.999
Questo intervallo è assegnato alla funzionalità dell'app di base Business Central e non deve essere usato in estensioni o personalizzazioni.
50.000 - 99.999
Questo intervallo è destinato alle personalizzazioni e a scopi di test. Per Business Central Online, un partner può sviluppare un'estensione personalizzata per il singolo tenant al fine di soddisfare le proprie esigenze. Il partner sviluppa l'estensione usando un tenant sandbox oppure ottenendo un'immagine Docker. Una volta portato a termine lo sviluppo, l'estensione può essere distribuita al singolo tenant.
Inoltre, è possibile usare questo intervallo come parte della formazione e/o iniziative simili, ad esempio se si usa un tenant sandbox o una build di Business Central su Docker.
100.000 - 999.999
Gli oggetti in questo intervallo vengono progettati quando il team Microsoft localizza Business Central per un Paese o una regione specifici. Questi oggetti non possono essere usati dai partner.
1.000.000 - 69.999.999
Questo intervallo di oggetti è destinato al programma RSP (Registered Solution Program). Il partner può scegliere di usare questo intervallo per sviluppare estensioni che possono essere usate in Business Central Online o in locale. Se usate in Business Central Online, queste estensioni vengono scaricate come app da Appsource.
70.000.000-74.999.999
I partner possono ottenere gli ID in questo intervallo per le estensioni per Business Central Online. Anche queste estensioni vengono ottenute come app da Appsource. Per altre informazioni, consultare Introduzione alla creazione di app.
Consultare le guide alle licenze per scaricare la guida alle licenze di Business Central.
Prefisso e suffisso
Nell'estensione il nome di ogni nuovo oggetto dell'applicazione (tabella, pagina, codeunit), deve contenere un prefisso o un suffisso. Questa regola si applica a tutti gli oggetti. È possibile usare i valori Caption per decidere cosa rendere visibile all'utente. Quando si modifica un oggetto principale di Dynamics 365 usando un'estensione di tabella o di pagina, il prefisso/suffisso deve essere definito a livello di controllo/campo/azione/gruppo.
Vantaggi
L'uso di un prefisso/suffisso riduce le collisioni di nomi con oggetti definiti in altre estensioni. Gli ambienti con estensioni con conflitti di nomi possono riscontrare problemi durante la distribuzione delle nuove estensioni, durante l'aggiornamento dell'ambiente o durante la creazione di un sandbox come copia dell'attuale ambiente (per gli ambienti di produzione).
Regole generali
Di seguito sono elencate alcune regole generali da seguire:
Il prefisso/suffisso deve contenere almeno tre 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 i propri oggetti, è necessario impostare il prefisso/suffisso al livello dell'oggetto superiore
Per le pagine/tabelle/enumerazioni/report/permissionset 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/procedura/valori/elemento dati/colonna.
Usare lo strumento AppSourceCop per trovare tutti i prefissi e/o i suffissi mancanti. Le opzioni di configurazione per questo strumento, assieme alla sezione delle regole, sono disponibili in Regole dell'analizzatore AppSourceCop. La sezione Regole spiega i diversi controlli che l'analizzatore effettua. Per il rilevamento del prefisso/suffisso, fare riferimento alla sezione Configurazione. Spiega come impostare il prefisso/suffisso nel file AppSourceCop.json.
Requisiti di prefisso e suffisso per le estensioni
Esistono alcuni requisiti per AppSource e per le estensioni dei tenant.
Per le estensioni di AppSource
L'uso di un prefisso/suffisso per i nomi degli oggetti è obbligatorio per gli invii di AppSource come parte dell'elenco di controllo Convalida tecnica.
Per soddisfare i requisiti per la convalida tecnica di AppSource, è necessario disporre di un prefisso/suffisso di tre lettere registrato per l'editore dell'estensione da usare obbligatoriamente nell'estensione.
Se non è ancora stato registrato alcun prefisso/suffisso, contattare Microsoft all'indirizzo d365val@microsoft.com e fornire le seguenti informazioni per riservare il prefisso/suffisso desiderato.
ID MPN
Nome dell'editore usato nelle estensioni (nel file app.json)
Occorre fornire almeno cinque suggerimenti di prefisso/suffisso. Ognuno di essi deve essere composto esattamente da tre caratteri.
Prefissi e suffissi non prevedono il riconoscimento di maiuscole/minuscole, il che significa che, ad esempio, "ABC", "abc" e "AbC" vengono trattati come se fossero la stessa cosa. Fornire sia "ABC" che "abc" conta come un solo suggerimento.
Tenere presente che non è necessario modificare i prefissi/suffissi già registrati: è possibile continuare a usarli. Le linee guida si applicano solo alle nuove registrazioni.
Per le estensioni per tenant
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.
Se l'estensione per tenant causa un conflitto con un nuovo oggetto nell'applicazione di base o in un'app AppSource aggiornata, è necessaria l'estensione per tenant per apportare la modifica.
Per altre informazioni sull'uso di prefissi o suffissi, consultare Vantaggi e linee guida per l'uso di un prefisso o di un suffisso.