Gestire diversi mapping derivati per una singola radice del modello
Un modello di dati di Creazione di report elettronici (ER) viene utilizzato in ogni componente formato di report elettronico configurato come origine dati per generare documenti in uscita. Per descrivere un singolo dominio aziendale, configura un componente del modello di dati che abbia molte definizioni radice.
Ogni definizione radice consente di rappresentare i dati di quel dominio nel modo più adatto a scopi di creazione di report specifici. Per ogni definizione di radice, puoi configurare un componente di mapping dei modelli di creazione di report elettronici come Microsoft Dynamics 365 Finance, implementazione specifica del modello di dati. In questo modo, descrivi come verrà compilato il tuo modello di dati in fase di esecuzione.
I componenti di mapping del modello di creazione di report elettronici (ER) possono risiedere nelle configurazionidel modello di dati ER e nelle configurazioni del mapping del modello ER. Una singola configurazione ER può contenere molti componenti di mapping, ognuno dei quali è configurato per una singola definizione di radice. In alternativa, una singola configurazione ER può contenere un solo componente di mapping configurato per una singola definizione di radice.
Molti provider di configurazione potrebbero offrire configurazioni di mapping del modello ER per lo stesso modello di dati ER. Tali configurazioni di mapping del modello potrebbero contenere componenti di mapping per diverse definizioni di root. È consigliabile utilizzare un mapping del modello per una definizione radice offerta da un provider e utilizzare un mapping del modello per un'altra definizione di radice offerta da un altro provider.
Le procedure in questo articolo spiegano come gestire più configurazioni di mapping del modello ER di un modello di dati ER quando contengono diversi componenti di mapping del modello configurati per la stessa definizione radice.
Per completare la procedura di questo articolo, devi avere il ruolo di amministratore di sistema o di sviluppatore per la creazione di report elettronici assegnato.
Tutte le seguenti procedure possono essere eseguite nell'azienda USMF. Non è richiesta alcuna codifica.
Configurare il framework ER
Come utente che dispone del ruolo di sviluppatore per la creazione di report elettronici, configura il set minimo di parametri ER prima di poter iniziare a utilizzare il framework ER per generare documenti aziendali.
Importare le configurazioni del formato ER standard
Per aggiungere le configurazioni ER standard all'istanza corrente di Finance, è necessario importarle dall'archivio ER che era configurato per quell'istanza. Segui i passaggi in Scaricare configurazioni ER dall'archivio globale del servizio di configurazione per importare le seguenti configurazioni di formato ER:
- Fattura a testo libero (Excel) versione 220.106
- Fattura di progetto (Excel) versione 226.27
Rivedere le configurazioni ER importate
Andare a Amministrazione organizzazione>Aree di lavoro>Creazione di report elettronici.
Nella pagina Configurazioni localizzazione, nella sezione Configurazioni, selezionare il riquadro Configurazioni report.
Nella pagina Configurazioni, nella struttura delle configurazioni del riquadro sinistro, espandi Modello di fattura.
Rivedi il formato Fattura a testo libero (Excel):
Nell'albero di configurazione nel riquadro sinistro, seleziona Fattura a testo libero (Excel).
Nel riquadro azioni selezionare Progettazione.
Nella pagina Progettazione formati, nella scheda Mapping, nell'elenco delle origini dati, seleziona Modello.
Seleziona Visualizza.
Il formato ER corrente è configurato per utilizzare la definizione di radice InvoiceCustomer di Modello di fattura. Quando viene eseguito questo formato, e viene chiamata l'origine dati Modello, il mapping del modello configurato per la definizione di radice InvoiceCustomer viene utilizzato per accedere ai dati dell'applicazione e compilare il modello di dati.
Chiudere la pagina Progettazione formati.
Rivedi il contenuto della configurazione Mapping di modello di fattura:
Nell'albero di configurazione nel riquadro sinistro, seleziona Mapping di modello di fattura.
Nel riquadro azioni selezionare Progettazione.
Nella pagina Modello per mapping origine dati si noti che l'attuale configurazione del mapping del modello ER contiene diversi componenti del mapping del modello:
- Il mapping del modello Fattura cliente è configurato per la definizione radice InvoiceCustomer di Modello di fattura. Pertanto, quando viene eseguito il formato ER Fattura a testo libero (Excel), il mapping del modello Fattura cliente di questa configurazione ER può essere scelto per accedere ai dati dell'applicazione e compilare il modello di dati.
- Il mapping del modello Fattura progetto è configurato per la definizione radice InvoiceProject di Modello di fattura. Pertanto, quando viene eseguito il formato ER Fattura progetto(Excel), il mapping del modello Fattura progetto di questa configurazione ER può essere scelto per accedere ai dati dell'applicazione e compilare il modello di dati.
Chiudere la pagina Modello per mapping origine dati.
Nella Scheda dettaglio Versioni, seleziona Elimina per eliminare tutte le versioni di questa configurazione ER che sono successive alla versione 240.175.
Rivedi il contenuto della configurazione Mapping del modello di fattura di progetto (RDP):
Nell'albero di configurazione nel riquadro sinistro, seleziona Mapping del modello di fattura di progetto (RDP).
Nel riquadro azioni selezionare Progettazione.
Nella pagina Modello per mapping origine dati si noti che l'attuale configurazione del mapping del modello ER contiene il mapping del modello InvoiceProject e che questo mapping del modello è configurato per la definizione radice InvoiceProject di Modello di fattura. Quando viene eseguito il formato ER Fattura progetto(Excel), seleziona il mapping del modello InvoiceProject di questa configurazione ER per accedere ai dati dell'applicazione e compilare il modello di dati.
Chiudere la pagina Modello per mapping origine dati.
Nella Scheda dettaglio Versioni, seleziona Elimina per eliminare tutte le versioni di questa configurazione ER che sono successive alla versione 226.35.
Personalizzare le configurazioni ER importate
Questa sezione spiega come personalizzare i mapping del modello forniti da Microsoft. Ad esempio, potrebbe essere necessaria la personalizzazione per implementare la logica personalizzata o aggiungere binding mancanti.
Personalizzare la configurazione del mapping del modello di fattura
Nella pagina Configurazioni, nella struttura delle configurazioni del riquadro sinistro, selezionare Mapping di modello di fattura.
Nel riquadro azioni, selezionare Crea configurazione.
Nella finestra di dialogo a discesa Crea configurazione, nel gruppo di campi Nuovo, selezionare Deriva da nome: Mapping del modello di fattura, Microsoft.
Nel campo Nome digitare Mapping di modello di fattura Litware.
Selezionare Crea configurazione.
Contrassegna la versione bozza del mapping derivato disponibile per l'uso in fase di esecuzione:
- Nel riquadro azioni, scheda Configurazioni, gruppo Impostazioni avanzate, selezionare Parametri utente.
- Nella finestra di dialogo Parametri utente, imposta l'opzione Esegui impostazioni su Sì, quindi seleziona OK.
- Seleziona Modifica per rendere la pagina modificabile come richiesto.
- Per la configurazione Mapping di modello di fattura Litware attualmente selezionata nell'albero di configurazione, imposta l'opzione Esegui bozza su Sì.
Nel riquadro azioni seleziona Progettazione per rivedere i mapping del modello di questa configurazione.
Suggerimento
È ora possibile aprire uno qualsiasi dei componenti di mapping del modello ER di questa configurazione ER nella finestra di progettazione per configurare la logica personalizzata. Per ulteriori informazioni, vedere Personalizzare la configurazione del mapping di modello.
Chiudere la pagina Modello per mapping origine dati.
Adesso hai le configurazioni Mapping del modello di fattura e Mapping del modello fattura Litware, ognuna delle quali ha un mapping del modello configurato per la definizione radice InvoiceCustomer. Assegna esplicitamente uno dei mapping del modello come mapping del modello predefinito che viene utilizzato da uno qualsiasi dei formati ER, come il formato Fattura a testo libero (Excel) che contiene un'origine dati del modello con definizione radice InvoiceCustomer. Altrimenti, quando esegui, modifichi o convalidi uno dei formati ER, viene generata la seguente eccezione per avvisarti che nessun mapping del modello predefinito è stato assegnato esplicitamente:
Esiste più di un mapping del modello per il modello di dati "<nome di modello> (<descrittore radice>)" nelle configurazioni <nomi di configurazioni separati con virgole>. Imposta una delle configurazioni come predefinita.
Personalizzare la configurazione del mapping del modello di fattura di progetto (RDP)
Nella pagina Configurazioni, nella struttura delle configurazioni del riquadro sinistro, selezionare Mapping di modello di fattura di progetto.
Nel riquadro azioni, selezionare Crea configurazione.
Nella finestra di dialogo a discesa Crea configurazione, nel gruppo di campi Nuovo, selezionare Deriva da nome: Mapping del modello di fattura di progetto (RDP), Microsoft.
Nel campo Nome digitare Mapping di modello di fattura di progetto Litware.
Selezionare Crea configurazione.
Per la configurazione Mapping del modello fattura di progetto attualmente selezionata nell'albero di configurazione, imposta l'opzione Esegui bozza su Sì.
Nel riquadro azioni seleziona Progettazione per rivedere i mapping del modello di questa configurazione.
Chiudere la pagina Modello per mapping origine dati.
Adesso hai a disposizione le configurazioni Mapping del modello di fattura, Mapping del modello di fattura di progetto (RDP) e Mapping del modello fattura di progetto Litware. Ciascuna di queste configurazioni ha un mapping del modello configurato per la definizione radice InvoiceProject. Assegna in modo esplicito uno dei mapping del modello come mapping del modello predefinito utilizzato da qualsiasi formato ER. Ad esempio, usa il formato Fattura progetto (Excel) che contiene un'origine dati del modello con definizione radice InvoiceProject. Altrimenti, quando esegui o modifichi uno dei formati ER, viene generata un'eccezione per avvisarti che nessun mapping del modello predefinito è stato assegnato esplicitamente.
Seleziona la configurazione del mapping del modello di fattura Litware derivata come configurazione che contiene mapping di modello predefinite
Nella pagina Configurazioni, nella struttura delle configurazioni del riquadro sinistro, selezionare Mapping di modello di fattura Litware.
Impostare l'opzione Impostazione predefinita per mapping di modello su Sì.
A causa di questa impostazione, il mapping del modello Copia fattura cliente viene utilizzato quando si esegue Fattura a testo libero (Excel) o quando lo modifichi o lo convalidi. Il mapping del modello Fattura cliente dalla configurazione Mapping del modello di fattura viene ignorato.
È ora possibile aprire il formato Fattura a testo libero (Excel) per la revisione nella finestra d progettazione del formato.
Seleziona la configurazione del mapping del modello di fattura di progetto Litware derivata come configurazione che contiene mapping di modello predefinite
Nella pagina Configurazioni, nella struttura delle configurazioni del riquadro sinistro, selezionare Mapping di modello di fattura di progetto Litware.
Impostare l'opzione Impostazione predefinita per mapping di modello su Sì.
In questo caso, a differenza del caso descritto per la configurazione Mapping del modello di fattura Litware nella sezione precedente, non è possibile iniziare a utilizzare il mapping del modello Copia InvoiceProject dalla configurazione Mapping del modello di fattura progetto Litware. Due configurazioni che contengono una mapping del modello per la definizione radice InvoiceProject sono attualmente contrassegnate come configurazione predefinita. Pertanto, hanno uguale priorità per l'uso. Per risolvere questo problema, completare i passaggi rimanenti di questa procedura.
Nell'albero di configurazione nel riquadro sinistro, seleziona Mapping di modello di fattura Litware.
Nel riquadro azioni selezionare Progettazione.
Nella pagina Modello per mapping origine dati, seleziona Modifica per rendere la pagina modificabile, come richiesto.
Seleziona il mapping del modello Copia fattura progetto, quindi seleziona la casella di controllo Eliminato per esso.
A causa di questa impostazione, la configurazione Mapping di modello di fattura Litware viene considerata come se non avesse alcun mapping del modello per la definizione radice InvoiceProject. Il mapping del modello Copia InvoiceProject rilasciato per impostazione predefinita. La configurazione Mapping del modello di fattura di progetto Litware che contiene il mapping del modello, è contrassegnata come configurazione predefinita. Poiché è contrassegnata come predefinito, ha una priorità maggiore rispetto al modello di mapping InvoiceProject dalla configurazione Mapping del modello di fattura di progetto (RDP).
Altre considerazioni
Il mapping del modello Copia InvoiceProject Copy della configurazione Mapping del modello di fattura di Litware è progettato per utilizzare l'origine dati ReportDataProvider. L'origine dati fa parte del tipo di Oggetto che fa riferimento alla classe di applicazione PsaProjInvoiceDP. Questa classe viene implementata come provider di dati per il report SQL Server Reporting Services (SSRS) della fattura del progetto del framework di gestione della stampa. Seleziona questa origine dati come punto di integrazione ER. L'attuale implementazione ER per i report di gestione della stampa tiene conto di questa impostazione. Per maggiori dettagli, rivedi il codice sorgente della classe di applicazione ERPrintMgmtDataProviderReport. In fase di esecuzione, l'assegnazione dell'origine dati ReportDataProvider come punto di integrazione del mapping del modello obbliga Finance a trattare questo componente di mapping con una priorità maggiore rispetto al componente di mapping InvoiceProject dalla configurazione Mapping del modello di fattura del progetto (RDP).