Ispezionare il componente ER configurato per evitare problemi di runtime
Ogni formato Reporting elettronico (ER) configurato e componente del mapping del modello può essere convalidato in fase di progettazione. Durante questa convalida, viene eseguito un controllo di coerenza per aiutare a prevenire problemi di runtime che potrebbero verificarsi, come errori di esecuzione e riduzione delle prestazioni. Per ogni problema riscontrato, il controllo fornisce il percorso di un elemento problematico. Per alcuni problemi è disponibile una correzione automatica.
Per impostazione predefinita, la convalida viene applicata automaticamente nei seguenti casi per una configurazione ER che contiene i componenti ER precedentemente menzionati:
- Si importa una nuova versione di una configurazione ER nell'istanza di Microsoft Dynamics 365 Finance.
- Si modifica lo stato della configurazione ER modificabile da Bozza a Completata.
- Risolvere una configurazione ER modificabile applicando una nuova versione di base.
È possibile eseguire esplicitamente questa convalida. Selezionare una delle tre opzioni seguenti e seguire i passaggi forniti:
Opzione 1:
- Andare a Amministrazione organizzazione> Creazione di report elettronici > Configurazioni.
- Nella struttura ad albero delle configurazioni nel riquadro di sinistra, selezionare la configurazione ER desiderata che contiene il formato ER o il componente di mapping del modello ER.
- Nella scheda dettaglio Versioni selezionare la versione desiderata della configurazione ER.
- Nel riquadro azioni seleziona Convalida.
Opzione 2, per un formato ER:
- Andare a Amministrazione organizzazione> Creazione di report elettronici > Configurazioni.
- Nella struttura ad albero delle configurazioni nel riquadro di sinistra, selezionare la configurazione ER desiderata che contiene il componente del formato ER.
- Nella scheda dettaglio Versioni selezionare la versione desiderata della configurazione ER.
- Nel riquadro azioni selezionare Progettazione.
- Nella pagina Progettazione formati, nel riquadro azioni, selezionare Convalidare.
Opzione 3, per un mapping del modello ER:
- Andare a Amministrazione organizzazione> Creazione di report elettronici > Configurazioni.
- Nella struttura ad albero delle configurazioni nel riquadro di sinistra, selezionare la configurazione ER desiderata che contiene il componente di mapping del modello ER.
- Nella scheda dettaglio Versioni selezionare la versione desiderata della configurazione ER.
- Nel riquadro azioni selezionare Progettazione.
- Selezionare Progettazione nel riquadro azioni della pagina Modello per mapping origine dati.
- Selezionare Convalida nel riquadro azioni della pagina Progettazione mapping modello.
Per saltare la convalida quando la configurazione viene importata, attenersi alla seguente procedura.
- Andare a Amministrazione organizzazione> Creazione di report elettronici > Configurazioni.
- Nella pagina Configurazioni, nel Riquadro azioni, nella scheda Configurazioni, nel gruppo Impostazioni avanzate, selezionare Parametri utente.
- Impostare l'opzione Convalida la configurazione dopo l'importazione su No.
Per saltare la convalida quando lo stato della versione viene modificato o riassegnato, seguire i seguenti passaggi.
- Andare a Amministrazione organizzazione> Creazione di report elettronici > Configurazioni.
- Nella pagina Configurazioni, nel Riquadro azioni, nella scheda Configurazioni, nel gruppo Impostazioni avanzate, selezionare Parametri utente.
- Impostare l'opzione Ignora convalida alla riassegnazione e alla modifica dello stato della configurazione su Sì.
ER utilizza le seguenti categorie per raggruppare le ispezioni di controllo della coerenza:
- Eseguibilità - Ispezioni che rilevano problemi critici che potrebbero verificarsi in fase di esecuzione. Questi problemi sono per lo più in un livello Errore.
- Prestazione - Ispezioni che rilevano problemi che potrebbero causare un'esecuzione inefficiente dei componenti ER configurati. Questi problemi sono per lo più a un livello Avviso.
- Integrità dei dati - Ispezioni che rilevano problemi che potrebbero causare perdita di dati o problemi di runtime. Questi problemi sono per lo più a un livello Avviso.
Elenco delle ispezioni
Nella seguente tabella viene fornita una panoramica delle ispezioni che ER offre. Per ulteriori informazioni su queste ispezioni, utilizza i collegamenti nella prima colonna per accedere alle sezioni pertinenti di questo articolo. Queste sezioni spiegano i tipi di componenti per i quali ER fornisce ispezioni e come è possibile riconfigurare i componenti ER per aiutare a prevenire problemi.
| Nome | Categoria | Livello | Messaggio |
|---|---|---|---|
| Conversione di tipo | Eseguibilità | Errore |
Impossibile convertire l'espressione di tipo <genere> al campo di tipo <genere>. Errore di runtime: Eccezione di tipo |
| Compatibilità di genere | Eseguibilità | Errore |
L'espressione configurata non può essere utilizzata come associazione dell'elemento di formato corrente a un'origine dati poiché questa espressione restituisce il valore del tipo di dati <genere> che va oltre l'ambito dei tipi di dati supportati dall'elemento di formato corrente di tipo <genere>. Errore di runtime: Eccezione di tipo |
| Elemento di configurazione mancante | Eseguibilità | Errore |
Percorso non trovato <percorso>. Errore di runtime: Elemento della configurazione <percorso> non trovato |
| Eseguibilità di un'espressione con la funzione FILTER | Eseguibilità | Errore |
L'espressione elenco della funzione di FILTRO non è disponibile per query. Errore di runtime: il filtro non è supportato. Convalidare la configurazione per ottenere maggiori dettagli su questo. |
| Eseguibilità di un'origine dati GROUPBY | Eseguibilità | Errore | Percorso <percorso> non supporta le query. |
| Eseguibilità | Errore |
Raggruppa per funzione non può essere eseguito con la query. Errore di runtime: Raggruppa per funzione non può essere eseguito con la query. |
|
| Eseguibilità di un'origine dati JOIN | Eseguibilità | Errore |
Non è possibile entrare in un elenco <percorso> che non è un filtro nella query. Errore di runtime: l'origine dati unita alla funzione deve essere un'espressione di filtro che il campo calcolato è stato chiamato in modo errato. |
| Preferibilità della funzione FILTER rispetto a WHERE | Prestazioni | Avviso | L'uso della funzione FILTER per l'espressione è preferibile rispetto a WHERE dal punto di vista delle prestazioni. Selezionare Correggi per sostituirlo automaticamente. |
| Preferibilità della funzione ALLITEMSQUERY rispetto a ALLITEMS | Prestazioni | Avviso | L'uso della funzione ALLITEMSQUERY per l'espressione è preferibile rispetto a ALLITEMS dal punto di vista delle prestazioni. Selezionare Correggi per sostituirlo automaticamente. |
| Considerazione di casi di elenchi vuoti | Eseguibilità | Avviso |
L'elenco <percorso> non ha alcun controllo per casi di elenco vuoto, ciò può causare un errore in fase di esecuzione. Aggiungere un segno di spunta per un caso elenco vuoto. Errore di runtime: l'elenco è vuoto in <percorso> potenziale problema: la riga viene popolata una volta mentre un'origine dati da cui viene popolata contiene più record |
| Eseguibilità di un'espressione con la funzione FILTER (memorizzazione nella cache) | Eseguibilità | Errore |
La funzione FILTER non può essere applicata al tipo selezionato di origine dati. Un'origine dati del genere Record di tabella è applicabile solo quando non è memorizzata nella cache e non dispone di origini dati nidificate aggiunte manualmente. Errore di runtime: il filtro non è supportato. Convalidare la configurazione per ottenere maggiori dettagli su questo. |
| Associazione mancante | Eseguibilità | Avviso |
Percorso <percorso> non ha alcun legame con alcuna origine dati nell'utilizzo del mapping del modello. Errore di runtime: percorso <percorso> non è vincolato |
| Modello non collegato | Integrità dei dati | Avviso | Il <nome> del file non è collegato a nessun componente del file e verrà rimosso dopo aver modificato lo stato della versione di configurazione. |
| Formato non sincronizzato | Integrità dei dati | Avviso | Nome definito <il nome del componente> non esiste nel foglio Excel <nome del foglio> |
| Formato non sincronizzato | Integrità dei dati | Avviso |
Il tag <Controllo del contenuto di Word con tag> non esiste nel file di modello di Word Errore di runtime: il tag <Controllo del contenuto di Word con tag> non esiste nel file di modello di Word. |
| Nessun mapping predefinito | Integrità dei dati | Errore |
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>. Impostare una delle configurazioni come predefinita Errore di runtime: Esiste più di un mapping dei modelli per il modello di dati <nome di modello (descrittore radice)> nelle configurazioni <nomi di configurazioni separati con virgole>. Imposta una delle configurazioni come predefinita. |
| Impostazione incoerente dei componenti di intestazione o piè di pagina | Integrità dei dati | Errore |
Le intestazioni/piè di pagina (<tipo di componente: intestazione o piè di pagina>) sono incoerenti Runtime: l'ultimo componente configurato viene utilizzato in fase di runtime se viene eseguita la versione bozza del formato ER configurato. |
| Impostazione incoerente del componente Pagina | Integrità dei dati | Errore | Sono presenti più di due componenti intervallo senza replica. Rimuovere i componenti non necessari. |
| Eseguibilità di un'espressione con la funzione ORDERBY | Eseguibilità | Errore |
L'espressione elenco della funzione ORDERBY non è disponibile per query. Errore di runtime: l'ordinamento non è supportato. Convalidare la configurazione per ottenere maggiori dettagli su questo. |
| Artefatto dell'applicazione obsoleto | Integrità dei dati | Avviso |
L'elemento <percorso> è contrassegnato come obsoleto. Esempio di errore di runtime: "<percorso>" della classe non trovato. |
Conversione di tipo
ER controlla se il tipo di dati di un campo del modello di dati è compatibile con il tipo di dati di un'espressione configurata come associazione di quel campo. Se i tipi di dati non sono compatibili, si verifica un errore di convalida nel designer di mapping del modello ER. Il messaggio che ricevi indica che ER non può convertire un'espressione di tipo A in un campo di tipo B.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il modello di dati ER e i componenti di mapping del modello ER contemporaneamente.
Nell'albero del modello di dati, aggiungere un campo denominato X e selezionare Numero intero come tipo di dati.
Nel riquadro Origine dati del mapping del modello, aggiungere un'origine dati di tipo Campo calcolato.
Assegnare un nome alla nuova origine dati Y e configurarlo in modo che contenga l'espressione
INTVALUE(100).Associare X a Y.
Nella finestra di progettazione del modello di dati, modificare il tipo di dati del campo X da Numero intero a Int64.
Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Designer del mapping del modello.
Selezionare Convalida per ispezionare il componente di mapping del modello della configurazione ER selezionata nella pagina Configurazioni.
Notare che si verifica un errore di convalida. Il messaggio afferma che il valore del tipo Numero intero che l'origine dati dell'
INTVALUE(100)espressione di Y restituisce non può essere archiviato nel campo del modello di dati X del tipo Int64.
La figura seguente mostra l'errore di runtime che si verifica se si ignora l'avviso e si seleziona Esegui per eseguire un formato configurato per utilizzare il mapping del modello.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Aggiornare la struttura del modello dati modificando il tipo di dati del campo del modello dati in modo che corrisponda al tipo di dati dell'espressione configurata per l'associazione di quel campo. Nell'esempio precedente, il tipo di dati del campo X deve essere modificato di nuovo in Numero intero.
Opzione 2
Aggiornare il mapping del modello modificando l'espressione dell'origine dati associata al campo del modello di dati. Nell'esempio precedente, l'espressione dell'origine dati Y deve essere modificata in INT64VALUE(100).
Compatibilità di genere
ER controlla se il tipo di dati di un elemento di formato è compatibile con il tipo di dati di un'espressione configurata come associazione dell'elemento di formato. Se i tipi di dati non sono compatibili, si verifica un errore di convalida nella progettazione delle operazioni ER. Il messaggio che si riceve afferma che l'espressione configurata non può essere utilizzata come associazione dell'elemento di formato corrente a un'origine dati poiché questa espressione restituisce un valore del tipo di dati A che va oltre l'ambito dei tipi di dati supportati dall'elemento di formato corrente di tipo B.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il modello di dati ER e i componenti di formato ER contemporaneamente.
Nell'albero del modello di dati, aggiungere un campo denominato X e selezionare Numero intero come tipo di dati.
Nell'albero della struttura del formato, aggiungere un elemento di formato del tipo Numerico.
Assegnare un nome al nuovo elemento di formato Y. Nel campo Tipo numerico, selezionare Numero intero come tipo di dati.
Associare X a Y.
Nell'albero della struttura del formato, modificare il tipo di dati dell'elemento di formato Y da Numero intero a Int64.
Selezionare Convalida per ispezionare il componente formato modificabile nella pagina Progettazione formati.
Notare che si verifica un errore di convalida. Il messaggio indica che l'espressione configurata può solo accettare i valori Int64. Pertanto, il valore del campo del modello di dati X del genere Numero intero non può essere inserito nell'elemento di formato Y.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Aggiornare la struttura del formato modificando il tipo di dati dell'elemento di formato Numerico in modo che corrisponda al tipo di dati dell'espressione configurata per l'associazione di quell'elemento. Nell'esempio precedente, il valore di tipo Numerico dell'elemento di formato X deve essere modificato di nuovo in Intero.
Opzione 2
Aggiornare il mapping di formato dell'elemento di formato X modificando l'espressione da model.X a INT64VALUE(model.X).
Elemento di configurazione mancante
ER controlla se le espressioni di associazione contengono solo origini dati configurate nel componente ER modificabile. Per ogni associazione che contiene un'origine dati mancante nel componente ER modificabile, si verifica un errore di convalida nella progettazione delle operazioni ER o nella progettazione mapping modello di ER.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il modello di dati ER e i componenti di mapping del modello ER contemporaneamente.
Nell'albero del modello di dati, aggiungere un campo denominato X e selezionare Numero intero come tipo di dati.
Nel riquadro Origine dati del mapping del modello, aggiungere un'origine dati di tipo Campo calcolato.
Assegnare un nome alla nuova origine dati Y e configurarlo in modo che contenga l'espressione
INTVALUE(100).Associare X a Y.
Nella progettazione mapping modello, nel riquadro Origini dati, eliminare l'origine dati Y.
Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Designer del mapping del modello.
Notare che si verifica un errore di convalida. Il messaggio afferma che l'associazione del campo del modello di dati X contiene il percorso che fa riferimento all'origine dati Y, ma questa origine dati non è stata trovata.
Risoluzione automatica
Selezionare Separa per risolvere automaticamente questo problema rimuovendo l'associazione dell'origine dati mancante.
Risoluzione manuale
Opzione 1
Separare il campo del modello di dati X per interrompere il riferimento all'origine dati Y inesistente.
Opzione 2
Nel riquadro Origini dati della progettazione mapping modello, aggiungere nuovamente l'origine dati Y.
Eseguibilità di un'espressione con la funzione FILTER
La funzione ER FILTER incorporata viene utilizzata per accedere a tabelle, viste o entità di dati dell'applicazione inserendo una singola chiamata SQL per ottenere i dati richiesti come elenco di record. Un'origine dati del tipo Elenco di record viene utilizzata come argomento di questa funzione e specifica l'origine della domanda di lavoro per la chiamata. ER verifica se è possibile stabilire una query SQL diretta su un'origine dati a cui si fa riferimento nella funzione FILTER. Se non è possibile stabilire una query diretta, si verifica un errore di convalida nella finestra di progettazione del mapping del modello ER. Il messaggio ricevuto indica che l'espressione ER che include la funzione FILTER non può essere eseguita in fase di esecuzione.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il componente di mapping del modello ER.
Aggiungere un'origine dati del tipo Dynamics 365 for Operations \ Record di tabella.
Assegnare un nome alla nuova origine dati Fornitore. Nel campo Tabella, selezionare VendTable per specificare che questa origine dati richiederà la tabella VendTable.
Aggiungere un'origine dati del tipo Campo calcolato.
Assegnare un nome alla nuova origine dati FornitoreFiltrato e configurarla in modo che contenga l'espressione
FILTER(Vendor, Vendor.AccountNum="US-101").Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Progettazione mapping modello e verificare che l'espressione
FILTER(Vendor, Vendor.AccountNum="US-101")nell'origine dati Fornitore possa essere interrogata.Modificare l'origine dati Fornitore aggiungendo un campo nidificato del tipo Campo calcolato per ottenere il numero di conto del fornitore ridotto.
Assegnare un nome al nuovo campo nidificato $AccNumber e configurarlo in modo che contenga l'espressione
TRIM(Vendor.AccountNum).Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Progettazione mapping modello e verificare che l'espressione
FILTER(Vendor, Vendor.AccountNum="US-101")nell'origine dati Fornitore possa essere interrogata.
Si noti che si verifica un errore di convalida, perché l'origine dati Fornitore contiene un campo nidificato del tipo Campo calcolato che non consente l'espressione dell'origine dati FornitoreFiltrato da tradurre nell'istruzione SQL diretta.
La figura seguente mostra l'errore di runtime che si verifica se si ignora l'avviso e si seleziona Esegui per eseguire un formato configurato per utilizzare il mapping del modello.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Invece di aggiungere un campo nidificato del tipo Campo calcolato all'origine dati Fornitore, aggiungere il campo nidificato $AccNumber all'origine dati FornitoreFiltrato e configurarla in modo che contenga l'espressione TRIM(FilteredVendor.AccountNum). In questo modo, l'espressione FILTER(Vendor, Vendor.AccountNum="US-101") può essere eseguita a livello SQL e calcolare il campo nidificato $AccNumber in seguito.
Opzione 2
Cambiare l'espressione dell'origine dati FornitoreFiltrato da FILTER(Vendor, Vendor.AccountNum="US-101") a WHERE(Vendor, Vendor.AccountNum="US-101"). Non è consigliabile modificare l'espressione per una tabella che ha un grande volume di dati (tabella transazionale), perché tutti i record verranno recuperati e la selezione dei record richiesti verrà eseguita in memoria. Pertanto, questo approccio può causare prestazioni ridotte. Per ulteriori informazioni, vedere Funzione ER WHERE.
Eseguibilità di un'origine dati GROUPBY
L'origine dati GROUPBY divide il risultato della query in gruppi di record, in genere allo scopo di eseguire una o più aggregazioni su ciascun gruppo. Ogni origine dati GROUPBY può essere configurata in modo che venga eseguita a livello di database o in memoria. Quando un'origine dati GROUPBY è configurata in modo da essere eseguita a livello di database, ER verifica se è possibile stabilire una query SQL diretta su un'origine dati a cui si fa riferimento in tale origine dati. Se non è possibile stabilire una query diretta, si verifica un errore di convalida nella finestra di progettazione del mapping del modello ER. Il messaggio che si riceve indica che l'origine dati configurata GROUPBY non può essere eseguita in fase di esecuzione.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il componente di mapping del modello ER.
Aggiungere un'origine dati del tipo Dynamics 365 for Operations \ Record di tabella.
Assegnare un nome alla nuova origine dati Trans. Nel campo Tabella, selezionare VendTrans per specificare che questa origine dati richiederà la tabella VendTrans.
Aggiungere un'origine dati del tipo Raggruppa per.
Assegnare un nome alla nuova origine dati GroupedTrans e configurarla nel modo seguente:
- Selezionare l'origine dati Trans come origine dei record che dovrebbero essere raggruppati.
- Nel campo Ubicazione dell'esecuzione, selezionare Query per specificare che si desidera eseguire questa origine dati a livello di database.
Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Progettazione mapping modello e verificare che l'origine dati configurata GroupedTrans possa essere interrogata.
Modificare l'origine dati Trans aggiungendo un campo nidificato del tipo Campo calcolato per ottenere il numero di conto del fornitore ridotto.
Assegnare un nome alla nuova origine dati $AccNumber e configurarla in modo che contenga l'espressione
TRIM(Trans.AccountNum).
Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Progettazione mapping modello e verificare che l'origine dati configurata GroupedTrans possa essere interrogata.
Si noti che si verifica un errore di convalida, perché l'origine dati Trans contiene un campo nidificato del tipo Campo calcolato che non consente la chiamata per l'origine dati GroupedTrans da tradurre nell'istruzione SQL diretta.
La figura seguente mostra l'errore di runtime che si verifica se si ignora l'avviso e si seleziona Esegui per eseguire un formato configurato per utilizzare il mapping del modello.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Invece di aggiungere un campo nidificato del tipo Campo calcolato all'origine dati Trans, aggiungere il campo nidificato $AccNumber per l'elemento GroupedTrans.lines dell'origine dati GroupedTrans e configurarla in modo che contenga l'espressione TRIM(GroupedTrans.lines.AccountNum). In questo modo, l'origine dati GroupedTrans può essere eseguita a livello SQL e calcolare il campo nidificato $AccNumber in seguito.
Opzione 2
Modificare il valore del campo Ubicazione di esecuzione per l'origine dati GroupedTrans da Query a In memoria. Non è consigliabile modificare il valore per una tabella che ha un grande volume di dati (tabella transazionale), perché tutti i record verranno recuperati e il raggruppamento e l'aggregazione verranno eseguiti in memoria. Pertanto, questo approccio può causare prestazioni ridotte.
Eseguibilità di un'origine dati JOIN
L'origine dati JOIN combina i record di due o più tabelle di database, in base ai campi correlati. Ogni origine dati JOIN può essere configurata in modo che venga eseguita a livello di database o in memoria. Quando un'origine dati JOIN è configurata in modo da essere eseguita a livello di database, ER verifica se è possibile stabilire una query SQL diretta su origini dati a cui si fa riferimento in tale origine dati. Se non è possibile stabilire una query SQL diretta con almento un'origine dati a cui si fa riferimento, si verifica un errore di convalida nella finestra di progettazione del mapping del modello ER. Il messaggio che si riceve indica che l'origine dati configurata JOIN non può essere eseguita in fase di esecuzione.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il componente di mapping del modello ER.
Aggiungere un'origine dati del tipo Dynamics 365 for Operations \ Record di tabella.
Assegnare un nome alla nuova origine dati Fornitore. Nel campo Tabella, selezionare VendTable per specificare che questa origine dati richiederà la tabella VendTable.
Aggiungere un'origine dati del tipo Dynamics 365 for Operations \ Record di tabella.
Assegnare un nome alla nuova origine dati Trans. Nel campo Tabella, selezionare VendTrans per specificare che questa origine dati richiederà la tabella VendTrans.
Aggiungere un'origine dati del tipo Campo calcolato come campo nidificato dell'origine dati Fornitore.
Assegnare un nome alla nuova origine dati FilteredTrans e configurarla in modo che contenga l'espressione
FILTER(Trans, Trans.AccountNum=Vendor.AccountNum).Aggiungere un'origine dati del tipo Join.
Assegnare un nome alla nuova origine dati JoinedList e configurarla nel modo seguente:
- Aggiungere l'origine dati Fornitore come primo set di record da unire.
- Aggiungere l'origine dati Vendor.FilteredTrans come secondo set di record da unire. Selezionare INNER come tipo.
- Nel campo Esegui, selezionare Query per specificare che si desidera eseguire questa origine dati a livello di database.
Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Progettazione mapping modello e verificare che l'origine dati configurata JoinedList possa essere interrogata.
Cambiare l'espressione dell'origine dati Vendor.FilteredTrans da
FILTER(Trans, Trans.AccountNum=Vendor.AccountNum)aWHERE(Trans, Trans.AccountNum=Vendor.AccountNum).Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Progettazione mapping modello e verificare che l'origine dati configurata JoinedList possa essere interrogata.
Si noti che si verifica un errore di convalida, poiché l'espressione dell'origine dati Vendor.FilteredTrans non può essere tradotta nella chiamata SQL diretta. Inoltre, la chiamata SQL diretta non consente la chiamata per l'origine dati JoinedList da tradurre nell'istruzione SQL diretta.
La figura seguente mostra l'errore di runtime che si verifica se si ignora l'avviso e si seleziona Esegui per eseguire un formato configurato per utilizzare il mapping del modello.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Cambiare l'espressione dell'origine dati Vendor.FilteredTrans da WHERE(Trans, Trans.AccountNum=Vendor.AccountNum) indietro a FILTER(Trans, Trans.AccountNum=Vendor.AccountNum), come consigliato dall'avviso.
Opzione 2
Modificare il valore del campo Esegui per l'origine dati JoinedList da Query a In memoria. Non è consigliabile modificare il valore per una tabella che ha un grande volume di dati (tabella transazionale), perché tutti i record verranno recuperati e il join verrà eseguito in memoria. Pertanto, questo approccio può causare prestazioni ridotte. Viene visualizzato un avviso di convalida per informarti di questo rischio.
Preferibilità della funzione FILTER rispetto a WHERE
La funzione ER FILTER incorporata viene utilizzata per accedere a tabelle, viste o entità di dati dell'applicazione inserendo una singola chiamata SQL per ottenere i dati richiesti come elenco di record. La funzione WHERE preleva tutti i record dall'origine data ed esegue la selezione dei record in memoria. Un'origine dati del tipo Elenco di record viene utilizzato come argomento di entrambe le funzioni e specifica un'origine per ottenere i record. ER verifica se è possibile stabilire una chiamata SQL diretta su un'origine dati a cui si fa riferimento nella funzione WHERE. Se non è possibile stabilire una chiamata diretta, compare un avviso di convalida nella finestra di progettazione del mapping del modello ER. Il messaggio ricevuto consiglia di utilizzare la funzione FILTER invece della funzione WHERE per contribuire a migliorare l'efficienza.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il componente di mapping del modello ER.
Aggiungere un'origine dati del tipo Dynamics 365 for Operations \ Record di tabella.
Assegnare un nome alla nuova origine dati Trans. Nel campo Tabella, selezionare VendTrans per specificare che questa origine dati richiederà la tabella VendTrans.
Aggiungere un'origine dati del tipo Campo calcolato come campo nidificato dell'origine dati Fornitore.
Assegnare un nome alla nuova origine dati FilteredTrans e configurarla in modo che contenga l'espressione
WHERE(Trans, Trans.AccountNum="US-101").Aggiungere un'origine dati del tipo Dynamics 365 for Operations \ Record di tabella.
Assegnare un nome alla nuova origine dati Fornitore. Nel campo Tabella, selezionare VendTable per specificare che questa origine dati richiederà la tabella VendTable.
Aggiungere un'origine dati del tipo Campo calcolato.
Assegnare un nome alla nuova origine dati FornitoreFiltrato e configurarla in modo che contenga l'espressione
WHERE(Vendor, Vendor.AccountNum="US-101").Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Designer del mapping del modello.
Si noti che gli avvisi di convalida consigliano di utilizzare la funzione FILTER invece della funzione WHERE per le origini dati FilteredVendor e FilteredTrans.
Risoluzione automatica
Selezionare Correggi per sostituire automaticamente la funzione WHERE con la funzione FILTER nell'espressione di tutte le origini dati che appaiono nella griglia nella scheda Avvisi per questo tipo di ispezione.
In alternativa, è possibile selezionare la riga per un singolo avviso nella griglia e quindi selezionare Correzione selezionata. In questo caso, l'espressione viene modificata automaticamente solo nell'origine dati menzionata nell'avviso selezionato.
Risoluzione manuale
È possibile regolare manualmente le espressioni di tutte le origini dati nella griglia di convalida sostituendo la funzione WHERE con la funzione FILTER.
Preferibilità della funzione ALLITEMSQUERY rispetto a ALLITEMS
Le funzioni ER incorporate ALLITEMS e ALLITEMSQUERY vengono utilizzate per ottenere un valore bidimensionale Elenco di record che consiste in un elenco di record che rappresentano tutti gli elementi che corrispondono al percorso specificato. ER verifica se è possibile stabilire una chiamata SQL diretta su un'origine dati a cui si fa riferimento nella funzione ALLITEMS. Se non è possibile stabilire una chiamata diretta, compare un avviso di convalida nella finestra di progettazione del mapping del modello ER. Il messaggio ricevuto consiglia di utilizzare la funzione ALLITEMSQUERY invece della funzione ALLITEMS per contribuire a migliorare l'efficienza.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il componente di mapping del modello ER.
Aggiungere un'origine dati del tipo Dynamics 365 for Operations \ Record di tabella.
Assegnare un nome alla nuova origine dati Fornitore. Nel campo Tabella, selezionare VendTable per specificare che questa origine dati richiederà la tabella VendTable.
Aggiungere un'origine dati del tipo Campo calcolato per ottenere i record di vari fornitori.
Assegnare un nome alla nuova origine dati FornitoreFiltrato e configurarla in modo che contenga l'espressione
FILTER(Vendor, OR(Vendor.AccountNum="US-101",Vendor.AccountNum="US-102")).Aggiungere un'origine dati di tipo Campo calcolato per ottenere le transazioni di tutti i fornitori filtrati.
Assegnare un nome alla nuova origine dati FilteredVendorTrans e configurarla in modo che contenga l'espressione
ALLITEMS(FilteredVendor.'<Relations'.'VendTrans.VendTable_AccountNum').Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Designer del mapping del modello.
Notare che si verifica un avviso di convalida. Il messaggio consiglia di utilizzare la funzione ALLITEMSQUERY invece della funzione ALLITEMS per l'origine dati FilteredVendorTrans.
Risoluzione automatica
Selezionare Correggi per sostituire automaticamente la funzione ALLITEMS con la funzione ALLITEMSQUERY nell'espressione di tutte le origini dati che appaiono nella griglia nella scheda Avvisi per questo tipo di ispezione.
In alternativa, è possibile selezionare la riga per un singolo avviso nella griglia e quindi selezionare Correzione selezionata. In questo caso, l'espressione viene modificata automaticamente solo nell'origine dati menzionata nell'avviso selezionato.
Risoluzione manuale
È possibile regolare manualmente le espressioni di tutte le origini dati menzionate nella griglia di convalida sostituendo la funzione ALLITEMS con la funzione ALLITEMSQUERY.
Considerazione di casi di elenchi vuoti
È possibile configurare il formato ER o il componente di mapping del modello per ottenere il valore del campo di un'origine dati di tipo Elenco di record. ER controlla se la progettazione prende in considerazione il caso in cui un'origine dati chiamata non contenga record (ovvero è vuota), per evitare errori di runtime quando un valore viene recuperato da un campo di un record inesistente.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il modello di dati ER, il mapping di modello di ER e i componenti di formato ER contemporaneamente.
Nell'albero del modello di dati, aggiungere un elemento radice denominato Root3.
Modificare l'elemento Root3 aggiungendo un elemento nidificato del tipo Elenco di record.
Assegnare un nome al nuovo elemento nidificato Fornitore.
Modificare l'elemento Fornitore nel modo seguente:
- Aggiungere un campo nidificato del tipo Stringa e denominarlo Nome.
- Aggiungere un campo nidificato del tipo Stringa e denominarlo AccountNumber.
Nel riquadro Origine dati del mapping del modello, aggiungere un'origine dati di tipo Dynamics 365 for Operations \ Record tabella.
Assegnare un nome alla nuova origine dati Fornitore. Nel campo Tabella, selezionare VendTable per specificare che questa origine dati richiederà la tabella VendTable.
Aggiungere un'origine dati del tipo Parametro di input dell'utente \ Generale per cercare un account fornitore nella finestra di dialogo runtime.
Assegnare un nome alla nuova origine dati RequestedAccountNum. Nel campo Etichetta immettere il numero del conto del fornitore. Nel campo Nome del tipo di dati delle operazioni, lasciare il valore predefinito, Descrizione.
Aggiungere un'origine dati del tipo Campo calcolato per filtrare un fornitore su cui si richiedono informazioni.
Assegnare un nome alla nuova origine dati FornitoreFiltrato e configurarla in modo che contenga l'espressione
FILTER(Vendor, Vendor.AccountNum=RequestedAccountNum).Associare gli elementi del modello di dati alle origini dati configurate nel modo seguente:
- Associare FilteredVendor a Fornitore.
- Associare FilteredVendor.AccountNum a Vendor.AccountNumber.
- Associare FilteredVendor.'name()' a Vendor.Name.
Nell'albero della struttura del formato, aggiungere i seguenti elementi per generare un documento in uscita in formato XML che contiene i dettagli del fornitore:
Aggiungere l'elemento XML radice Rendiconto.
Per l'elemento XML Rendiconto, aggiungere l'elemento XML nidificato Parte.
Per l'elemento XML Parte, aggiungere i seguenti attributi XML nidificati:
- Nome
- AccountNum
Associare gli elementi di formato alle origini dati fornite nel modo seguente:
- Associare l'elemento di formato Rendiconto\Parte\Nome al campo origine dati model.Vendor.Name.
- Associare l'elemento di formato Rendiconto\Parte\AccountNum al campo origine dati model.Vendor.AccountNumber.
Selezionare Convalida per ispezionare il componente formato modificabile nella pagina Progettazione formati.
Notare che si verifica un errore di convalida. Il messaggio indica che potrebbe essere generato un errore per i componenti formato configurati Rendiconto\Parte\Nome e Rendiconto\Parte\AccountNum in fase di esecuzione se l'elenco
model.Vendorè vuoto.
La figura seguente mostra l'errore di runtime che si verifica se si ignora l'avviso, selezionare Esegui per eseguire il formato e selezionare il numero di conto di un fornitore che non esiste. Poiché il fornitore richiesto non esiste, l'elenco model.Vendor sarà vuoto (ovvero, non conterrà record).
Risoluzione automatica
Per la riga selezionata nella griglia nella scheda Avvisi, è possibile selezionare Separa. L'associazione indicata nella colonna Percorso viene automaticamente rimossa dagli elementi di formato.
Risoluzione manuale
Opzione 1
È possibile associare l'elemento di formato Rendiconto\Parte\Nome all'elemento origine dati model.Vendor. In fase di esecuzione, questa associazione chiama prima l'origine dati model.Vendor. Se model.Vendor restituisce un elenco di record vuoto, gli elementi di formato nidificati non vengono eseguiti. Pertanto, non si verificano avvisi di convalida per questa configurazione di formato.
Opzione 2
Modificare l'associazione dell'elemento di formato Rendiconto\Parte\Nome da model.Vendor.Name a FIRSTORNULL(model.Vendor).Name. L'associazione aggiornata converte in modo condizionale il primo record dell'origine dati model.Vendor del tipo Elenco di record in una nuova origine dati del tipo Record. Questa nuova origine dati contiene lo stesso insieme di campi.
- Se almeno un record è disponibile nell'origine dati
model.Vendor, i campi di quel record vengono riempiti con i valori dei campi del primo record dell'origine datimodel.Vendor. In questo caso, l'associazione aggiornata restituisce il nome del fornitore. - In caso contrario, ogni campo del record creato viene riempito con il valore predefinito per il tipo di dati di quel campo. In questo caso, la stringa vuota viene restituita come valore predefinito del tipo di dati Stringa.
Pertanto, non si verificano avvisi di convalida per l'elemento di formato Rendiconto\Parte\Nome quando è associato all'espressione FIRSTORNULL(model.Vendor).Name.
Opzione 3
Se si desidera specificare esplicitamente i dati inseriti in un documento generato quando l'origine dati model.Vendor del tipo Elenco di record non restituisce alcun record (il testo Non disponibile in questo esempio), modificare l'associazione dell'elemento di formato Rendiconto\Parte\Nome da model.Vendor.Name a IF(NOT(ISEMPTY(model.Vendor)), model.Vendor.Name, "Not available"). È possibile anche usare l'espressione IF(COUNT(model.Vendor)=0, model.Vendor.Name, "Not available").
Ulteriori considerazioni
L'ispezione avvisa anche di un altro potenziale problema. Per impostazione predefinita, quando si associano gli elementi di formato Rendiconto\Parte\Nome e Rendiconto\Parte\AccountNum ai campi appropriati dell'origine dati model.Vendor del tipo Elenco di record, quelle associazioni verranno eseguite e assumeranno i valori dei campi appropriati del primo record dell'origine dati model.Vendor, se l'elenco non è vuoto.
Perché l'elemento di formato Rendiconto\Parte non è stato vincolato con l'origine dati model.Vendor, l'elemento Rendiconto\Parte non verrà iterato per ogni record dell'origine dati model.Vendor durante l'esecuzione del formato. Al contrario, un documento generato verrà riempito con le informazioni solo dal primo record dell'elenco di record, se tale elenco contiene più record. Pertanto, potrebbe esserci un problema se il formato è inteso a riempire un documento generato con informazioni su tutti i fornitori dall'origine dati model.Vendor. Per risolvere questo problema, associare l'elemento Rendiconto\Parte all'origine dati model.Vendor.
Eseguibilità di un'espressione con la funzione FILTER (memorizzazione nella cache)
Diverse funzioni ER incorporate, incluse FILTER e ALLITEMSQUERY, vengono utilizzate per accedere a tabelle, viste o entità di dati dell'applicazione inserendo una singola chiamata SQL per ottenere i dati richiesti come elenco di record. Un'origine dati del tipo Elenco di record viene utilizzata come argomento di ognuna di queste funzioni e specifica un'origine della domanda di lavoro per la chiamata. ER verifica se è possibile stabilire una chiamata SQL diretta su un'origine dati a cui si fa riferimento in una di queste funzioni. Se non è possibile stabilire una chiamata perchè l'origine dati è stata contrassegnata come memorizzata nella cache, si verifica un errore di convalida nella finestra di progettazione del mapping del modello ER. Il messaggio ricevuto indica che l'espressione ER che contiene una di queste funzioni non può essere eseguita in fase di esecuzione.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il componente di mapping del modello ER.
Aggiungere un'origine dati del tipo Dynamics 365 for Operations \ Record di tabella.
Assegnare un nome alla nuova origine dati Fornitore. Nel campo Tabella, selezionare VendTable per specificare che questa origine dati richiederà la tabella VendTable.
Aggiungere un'origine dati del tipo Parametro di input dell'utente \ Generale per cercare un account fornitore nella finestra di dialogo runtime.
Assegnare un nome alla nuova origine dati RequestedAccountNum. Nel campo Etichetta immettere il numero del conto del fornitore. Nel campo Nome del tipo di dati delle operazioni, lasciare il valore predefinito, Descrizione.
Aggiungere un'origine dati del tipo Campo calcolato per filtrare un fornitore su cui si richiedono informazioni.
Assegnare un nome alla nuova origine dati FornitoreFiltrato e configurarla in modo che contenga l'espressione
FILTER(Vendor, Vendor.AccountNum=RequestedAccountNum).Contrassegnare l'origine dati configurata Fornitore come memorizzata nella cache.
Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Designer del mapping del modello.
Notare che si verifica un errore di convalida. Il messaggio afferma che la funzione FILTER non può essere applicata all'origine dati memorizzata nella cache Fornitore.
La figura seguente mostra l'errore di runtime che si verifica se si ignora l'avviso e si seleziona Esegui per eseguire il formato.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Rimuovere il flag Cache dall'origine dati Fornitore. L'origine dati FilteredVendor diventerà quindi eseguibile, ma l'origine dati Fornitore a cui si fa riferimento nella tabella VendTable sarà accessibile ogni volta che viene chiamata l'origine dati FilteredVendor.
Opzione 2
Cambiare l'espressione dell'origine dati FornitoreFiltrato da FILTER(Vendor, Vendor.AccountNum="US-101") a WHERE(Vendor, Vendor.AccountNum="US-101"). In questo caso, l'origine dati Fornitore a cui si fa riferimento nella tabella VendTable sarà accessibile solo durante la prima chiamata dell'origine dati Fornitore. Tuttavia, la selezione dei record verrà eseguita in memoria. Pertanto, questo approccio può causare prestazioni ridotte.
Associazione mancante
Quando si configura un componente del formato ER, il modello di dati ER di base viene offerto come origine dati predefinita per il formato ER. Quando viene eseguito il formato ER configurato, il mapping di modello predefinito per il modello di base viene utilizzato per riempire il modello di dati con i dati dell'applicazione. La progettazione del formato ER mostra un avviso se si associa un elemento di formato a un elemento del modello di dati che non è associato a nessuna origine dati mapping di modello che è attualmente selezionata come mapping di modello predefinito per il formato modificabile. Questo tipo di associazione non può essere eseguito in fase di esecuzione, perché il formato che viene eseguito non può riempire un elemento associato con i dati dell'applicazione. Pertanto, si verifica un errore in fase di esecuzione.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il modello di dati ER, il mapping di modello di ER e i componenti di formato ER contemporaneamente.
Nell'albero del modello di dati, aggiungere un elemento radice denominato Root3.
Modificare l'elemento Root3 aggiungendo un nuovo elemento nidificato del tipo Elenco di record.
Assegnare un nome al nuovo elemento nidificato Fornitore.
Modificare l'elemento Fornitore nel modo seguente:
- Aggiungere un campo nidificato del tipo Stringa e denominarlo Nome.
- Aggiungere un campo nidificato del tipo Stringa e denominarlo AccountNumber.
Nel riquadro Origine dati del mapping del modello, aggiungere un'origine dati di tipo Dynamics 365 for Operations \ Record tabella.
Assegnare un nome alla nuova origine dati Fornitore. Nel campo Tabella, selezionare VendTable per specificare che questa origine dati richiederà la tabella VendTable.
Aggiungere un'origine dati del tipo Parametro di input dell'utente \ Generale per chiedere informazioni su un account fornitore nella finestra di dialogo runtime.
Assegnare un nome alla nuova origine dati RequestedAccountNum. Nel campo Etichetta immettere il numero del conto del fornitore. Nel campo Nome del tipo di dati delle operazioni, lasciare il valore predefinito, Descrizione.
Aggiungere un'origine dati del tipo Campo calcolato per filtrare un fornitore su cui si richiedono informazioni.
Assegnare un nome alla nuova origine dati FornitoreFiltrato e configurarla in modo che contenga l'espressione
FILTER(Vendor, Vendor.AccountNum=RequestedAccountNum).Associare gli elementi del modello di dati alle origini dati configurate nel modo seguente:
- Associare FilteredVendor a Fornitore.
- Associare FilteredVendor.AccountNum a Vendor.AccountNumber.
Nota
Il campo del modello di dati Vendor.Name rimane non associato.
Nell'albero della struttura del formato, aggiungere i seguenti elementi per generare un documento in uscita in formato XML che contenga i dettagli dei fornitori di cui si cercano informazioni:
Aggiungere l'elemento XML radice Rendiconto.
Per l'elemento XML Rendiconto, aggiungere l'elemento XML nidificato Parte.
Per l'elemento XML Parte, aggiungere i seguenti attributi XML nidificati:
- Nome
- AccountNum
Associare gli elementi di formato alle origini dati fornite nel modo seguente:
- Associare l'elemento di formato Rendiconto\Parte all'elemento origine dati
model.Vendor. - Associare l'elemento di formato Rendiconto\Parte\Nome al campo origine dati model.Vendor.Name.
- Associare l'elemento di formato Rendiconto\Parte\AccountNum al campo origine dati model.Vendor.AccountNumber.
- Associare l'elemento di formato Rendiconto\Parte all'elemento origine dati
Selezionare Convalida per ispezionare il componente formato modificabile nella pagina Progettazione formati.
Notare che si verifica un avviso di convalida. Il messaggio afferma che l'origine dati model.Vendor.Name non è associato a nessuna origine dati nel mapping di modello configurato per essere utilizzato dal formato. Quindi, l'elemento formato Rendiconto\Parte\Nome potrebbe non essere compilato in fase di runtime e potrebbe verificarsi un'eccezione di runtime.
La figura seguente mostra l'errore di runtime che si verifica se si ignora l'avviso e si seleziona Esegui per eseguire il formato.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Modificare la mappatura del modello configurato aggiungendo un'associazione per il campo origine dati model.Vendor.Name.
Opzione 2
Modificare il formato configurato rimuovendo l'associazione per l'elemento di formato Rendiconto\Parte\Nome.
Modello non collegato
Quando si configura manualmente un componente formato ER per utilizzare un modello per generare un documento in uscita, è necessario aggiungere manualmente l'elemento Excel\File, aggiungere il modello richiesto come allegato del componente modificabile e selezionare tale allegato nell'elemento aggiunto Excel\File. In questo modo, si indica che l'elemento aggiunto riempirà il modello selezionato in fase di runtime. Quando si configura una versione del componente di formato nello stato Bozza, si potrebbero aggiungere diversi modelli al componente modificabile e quindi selezionare ogni modello nell'elemento Excel\lFile per eseguire il formato ER. In questo modo, è possibile vedere come i diversi modelli vengono riempiti in fase di esecuzione. Se disponi di modelli che non sono selezionati in alcun elemento Excel\File, la progettazione del formato ER avvisa che quei modelli verranno eliminati dalla versione modificabile del componente del formato ER quando il suo stato viene modificato da Bozza a Completato.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il componente formato ER.
Nell'albero della struttura del formato, aggiungere l'elemento File\Excel.
Per l'elemento File\Excel appena aggiunto, aggiungere un file di cartella di lavoro di Excel, A.xlsx, come un allegato. Utilizzare il tipo di documento configurato in Parametri ER per specificare l'archiviazione dei modelli in formato ER.
Per l'elemento File\Excel, aggiungere un altro file di cartella di lavoro di Excel, B.xlsx, come un allegato. Utilizzare lo stesso tipo di documento utilizzato per il file della cartella di lavoro A.
Nell'elemento File\Excel, selezionare il file della cartella di lavoro A.
Selezionare Convalida per ispezionare il componente formato modificabile nella pagina Progettazione formati.
Notare che si verifica un avviso di convalida. Il messaggio indica il file della cartella di lavoro B.xlsx non è collegato ad alcun componente e che verrà rimosso dopo la modifica dello stato della versione della configurazione.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Modificare il formato configurato rimuovendo tutti i modelli che non sono collegati ad alcun elemento File\Excel.
Formato non sincronizzato
Quando si configura un componente formato ER per utilizzare un modello Excel per generare un documento in uscita, è possibile aggiungere manualmente l'elemento File\Excel, aggiungere il modello richiesto come allegato del componente modificabile e selezionare tale allegato nell'elemento aggiunto File\Excel. In questo modo, si indica che l'elemento aggiunto riempirà il modello selezionato in fase di runtime. Poiché il modello Excel aggiunto è stato progettato esternamente, il formato ER modificabile potrebbe contenere nomi Excel mancanti dal modello aggiunto. La progettazione del formato ER ti avvisa di eventuali incongruenze tra le proprietà degli elementi del formato ER che fanno riferimento a nomi che non sono inclusi nel modello Excel aggiunto.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il componente formato ER.
Nell'albero della struttura del formato, aggiungere l'elemento File\ExcelReport.
Per l'elemento File\Excel appena aggiunto, aggiungere un file di cartella di lavoro di Excel, A.xlsx, come un allegato. Utilizzare il tipo di documento configurato in Parametri ER per specificare l'archiviazione dei modelli in formato ER.
Importante
Assicurarsi che la cartella di lavoro di Excel aggiunta non contenga il nome ReportTitle.
Aggiungere l'elemento Excel\CellaTitolo come elemento nidificato dell'elemento Report. Nel campo Intervallo Excel, immettere ReportTitle.
Selezionare Convalida per ispezionare il componente formato modificabile nella pagina Progettazione formati.
Notare che si verifica un avviso di convalida. Il messaggio afferma che il nome ReportTitle non esiste sul foglio Foglio1 del modello di Excel che stai utilizzando.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Modificare il formato configurato rimuovendo tutti gli elementi che fanno riferimento a nomi di Excel mancanti dal modello.
Opzione 2
Aggiornare il formato ER modificabile importando un modello Excel. La struttura del formato ER modificabile verrà sincronizzato con la struttura del modello Excel importato.
Ulteriori considerazioni
Per sapere come sincronizzare la struttura del formato con un modello ER nell'editor modelli di Gestione documenti aziendali, vedere Aggiornare la struttura di un modello di documento aziendale.
Non sincronizzato con un formato di modello di Word
Quando si configura un componente formato ER per utilizzare un modello Word per generare un documento in uscita, è possibile aggiungere manualmente l'elemento Excel\File, aggiungere il modello Word richiesto come allegato del componente modificabile e selezionare tale allegato nell'elemento aggiunto Excel\File.
Nota
Quando il documento Word è associato, la progettazione del formato ER presenta l'elemento modificabile come Word\File.
In questo modo, si indica che l'elemento aggiunto riempirà il modello selezionato in fase di runtime. Poiché il modello Word aggiunto è stato progettato esternamente, il formato ER modificabile potrebbe contenere riferimenti ai controlli del contenuto di Word non presenti nel modello aggiunto. La progettazione del formato ER ti avvisa di eventuali incongruenze tra le proprietà degli elementi del formato ER che fanno riferimento a controlli del contenuto che non sono inclusi nel modello Word aggiunto.
Per un esempio che mostra come potrebbe verificarsi questo problema, vedere Configurare il formato modificabile per sopprimere la sezione di riepilogo.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Modificare il formato configurato eliminando la formula Rimosso dall'elemento di formato menzionato nell'avviso di convalida.
Opzione 2
Modificare il modello di Word aggiungendo il tag necessario per il controllo del contenuto di Word pertinente.
Nessun mapping predefinito
Al termine della verifica Associazione mancante, le associazioni di formato verificate vengono valutate rispetto alle associazioni del componente di mapping del modello pertinente. Perché è possibile importare varie configurazioni del mapping di modello ER nell'istanza di Finance e ogni configurazione potrebbe contenere il componente di mapping del modello applicabile, una configurazione deve essere selezionata come configurazione predefinita. In caso contrario, quando si tenta di eseguire, modificare o convalidare il formato ER ispezionato, si verificherà un'eccezione e verrà visualizzato il messaggio seguente: "Esiste più di un mapping del modello per il modello dati <model name (root descriptor)> nelle configurazioni configuration <names separated by comma>. Impostare una delle configurazioni come predefinita."
Per un esempio che mostra come potrebbe verificarsi questo problema e come risolverlo, vedere Gestire diversi mapping derivati per una singola radice del modello.
Impostazione incoerente dei componenti di intestazione o piè di pagina
Quando si configura un componente formato ER per utilizzare un modello di Excel per generare un documento in uscita, è possibile aggiungere il componente Excel\Intestazione per compilare le intestazioni nella parte superiore di un foglio di lavoro in una cartella di lavoro di Excel. È anche possibile aggiungere il componente Excel\Piè di pagina per compilare i piè di pagina nella parte inferiore di un foglio di lavoro. Per ogni componente Excel\Intestazione o Excel\Piè di pagina aggiunto, è necessario impostare la proprietà Aspetto intestazione/piè di pagina per specificare le pagine per le quali viene eseguito il componente. Poiché è possibile configurare diversi componenti Excel\Intestazione o Excel\Piè di pagina per un singolo componente Foglio ed è possibile generare intestazioni o piè di pagina diversi per diversi tipi di pagine in un foglio di lavoro di Excel, è necessario configurare un singolo componente Excel\Intestazione o Excel\Piè di pagina per un valore specifico della proprietà Aspetto intestazione/piè di pagina. Se più di un componente Excel\Intestazione o Excel\Piè di pagina è configurato per un valore specifico della proprietà Aspetto intestazione/piè di pagina, si verifica un errore di convalida e viene visualizzato il seguente messaggio di errore: "Le intestazioni/piè di pagina (<tipo di componente: intestazione o piè di pagina>) sono incoerenti."
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Modificare il formato configurato eliminando uno dei componenti Excel\Intestazione o Excel\Piè di pagina incoerenti.
Opzione 2
Modifica il valore della proprietà Aspetto intestazione/piè di pagina per uno dei componenti Excel\Intestazione o Excel\Piè di pagina incoerenti.
Impostazione incoerente del componente Pagina
Quando configuri un componente di formato ER per utilizzare un modello di Excel per generare un documento in uscita, puoi aggiungere il componente Excel\Pagina per impaginare un documento generato utilizzando le formule ER. Per ogni componente Excel\Pagina che aggiungi, puoi aggiungere molti componenti nidificati Intervallo e rimangono comunque conformi alla struttura seguente:
- Il primo componente nidificato Intervallo può essere configurato in modo che la proprietà Direzione replica è impostata su Nessuna replica. Questo intervallo viene utilizzato per creare intestazioni di pagina nei documenti generati.
- Puoi aggiungere molti altri componenti nidificati Intervallo in cui la proprietà Direzione replica è impostata su Verticale. Questi intervalli vengono utilizzati per compilare i documenti generati.
- L'ultimo componente nidificato Intervallo può essere configurato in modo che la proprietà Direzione replica è impostata su Nessuna replica. Questo intervallo viene utilizzato per creare piè di pagina nei documenti generati e per aggiungere le interruzioni di pagina richieste.
Se non segui questa struttura per un formato ER in Progettazione formato ER in fase di progettazione, si verifica un errore di convalida e viene visualizzato il seguente messaggio di errore: "Sono presenti più di due componenti intervallo senza replica. Rimuovere i componenti non necessari."
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Modifica il formato configurato cambiando la proprietà Direzione replica per tutti i componenti incoerenti Excel\Intervallo.
Eseguibilità di un'espressione con la funzione ORDERBY
La funzione ER ORDERBY integrata viene utilizzata per ordinare i record di un'origine dati ER del tipo Elenco record specificato come argomento della funzione.
Argomenti della funzione ORDERBY possono essere specificati per ordinare i record di tabelle, visualizzazioni o entità di dati dell'applicazione inserendo una singola chiamata al database per ottenere i dati ordinati come elenco di record. Un'origine dati del tipo Elenco di record viene utilizzata come argomento di questa funzione e specifica l'origine della domanda di lavoro per la chiamata.
ER verifica se è possibile stabilire una query del database diretta su un'origine dati a cui si fa riferimento nella funzione ORDERBY. Se non è possibile stabilire una query diretta, si verifica un errore di convalida nella finestra di progettazione del mapping del modello ER. Il messaggio ricevuto indica che l'espressione ER che include la funzione ORDERBY non può essere eseguita in fase di esecuzione.
I passaggi seguenti mostrano come potrebbe verificarsi questo problema.
Iniziare a configurare il componente di mapping del modello ER.
Aggiungere un'origine dati del tipo Dynamics 365 for Operations \ Record di tabella.
Assegnare un nome alla nuova origine dati Fornitore. Nel campo Tabella, selezionare VendTable per specificare che questa origine dati richiederà la tabella VendTable.
Aggiungere un'origine dati del tipo Campo calcolato.
Assegnare un nome alla nuova origine dati OrderedVendors e configurarla in modo che contenga l'espressione
ORDERBY("Query", Vendor, Vendor.AccountNum).
Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Progettazione mapping modello e verificare che l'espressione nell'origine dati OrderedVendors possa essere interrogata.
Modificare l'origine dati Fornitore aggiungendo un campo nidificato del tipo Campo calcolato per ottenere il numero di conto del fornitore ridotto.
Assegnare un nome al nuovo campo nidificato $AccNumber e configurarlo in modo che contenga l'espressione
TRIM(Vendor.AccountNum).Selezionare Convalida per ispezionare il componente di mapping del modello modificabile nella pagina Progettazione mapping modello e verificare che l'espressione nell'origine dati Fornitore possa essere interrogata.
Si noti che si verifica un errore di convalida, perché l'origine dati Fornitore contiene un campo nidificato del tipo Campo calcolato che non consente l'espressione dell'origine dati OrderedVendors da tradurre nell'istruzione database diretta. Lo stesso errore si verifica in fase di esecuzione se si ignora l'errore di convalida e si seleziona Esegui per eseguire questa mapping del modello.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Opzione 1
Invece di aggiungere un campo nidificato del tipo Campo calcolato all'origine dati Fornitore, aggiungere il campo nidificato $AccNumber all'origine dati FilteredVendors e configurare il campo in modo che contenga l'espressione TRIM(FilteredVendor.AccountNum). In questo modo, l'espressione ORDERBY("Query", Vendor, Vendor.AccountNum) può essere eseguita a livello di database e il calcolo del campo nidificato $AccNumber può essere effettuato in seguito.
Opzione 2
Cambiare l'espressione dell'origine dati FilteredVendors da ORDERBY("Query", Vendor, Vendor.AccountNum) a ORDERBY("InMemory", Vendor, Vendor.AccountNum). Non è consigliabile modificare l'espressione per una tabella che ha un grande volume di dati (tabella transazionale), perché tutti i record verranno recuperati e l'ordinamento dei record richiesti verrà eseguita in memoria. Pertanto, questo approccio può causare prestazioni ridotte.
Artefatto dell'applicazione obsoleto
Quando progetti un componente di mapping del modello ER o un componente in formato ER, è possibile configurare un'espressione ER per chiamare un artefatto dell'applicazione in ER, ad esempio una tabella di database, un metodo di una classe, ecc. In Finance versione 10.0.30 e successive, puoi forzare ER ad avvisarti che l'artefatto dell'applicazione a cui si fa riferimento è contrassegnato nel codice sorgente come obsoleto. Questo avviso può essere utile perché di solito gli artefatti obsoleti vengono eventualmente rimossi dal codice sorgente. Essere informati sullo stato di un artefatto può impedire l'utilizzo dell'artefatto obsoleto nel componente ER modificabile prima della sua rimozione dal codice sorgente, aiutando a prevenire errori di chiamata di elementi dell'applicazione non esistenti da un componente ER in fase di esecuzione.
Abilita la funzionalità Convalida elementi obsoleti delle origini dati di Creazione di report elettronici nell'area di lavoro Gestione funzionalità per iniziare a valutare l'attributo obsoleto degli artefatti dell'applicazione durante l'ispezione di un componente ER modificabile. L'attributo obsoleto è attualmente valutato per i seguenti tipi di artefatti dell'applicazione:
- Tabella di database
- Campo di tabella
- Metodo di tabella
- Classe dell'applicazione
- Metodo di classe
Nota
Viene visualizzato un avviso durante l'ispezione del componente ER modificabile per un'origine dati che fa riferimento a un artefatto obsoleto solo quando questa origine dati viene utilizzata in almeno un'associazione di questo componente ER.
Suggerimento
Quando la classe SysObsoleteAttribute viene utilizzata per notificare al compilatore di emettere messaggi di avviso anziché errori, l'avviso di ispezione presenta l'avviso di codice sorgente specificato in fase di progettazione nella scheda dettaglio Dettagli sulla pagina Progettazione mapping modello o Progettazione formati.
L'illustrazione seguente mostra l'avviso di convalida che si verifica quando il campo DEL_Email obsoleto della tabella dell'applicazione CompanyInfo è associato a un campo del modello di dati tramite l'orgine dati company configurata.
Risoluzione automatica
Non è disponibile alcuna opzione per risolvere automaticamente questo problema.
Risoluzione manuale
Modifica il mapping o il formato del modello configurato rimuovendo tutte le associazioni a un'origine dati che fa riferimento a un artefatto dell'applicazione obsoleto.
Risorse aggiuntive
Panoramica di gestione dei documenti aziendali
Sopprimere i controlli del contenuto di Word nei report generati
Gestire diversi mapping derivati per una singola radice del modello
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per