ER Creare le configurazioni richieste per importare dati da un file esterno

Articolo
03/21/2023

I passaggi seguenti illustrano come un utente assegnato al ruolo di amministratore di sistema o di sviluppatore per la creazione di report elettronici può progettare configurazioni per la creazione di report elettronici per importare dati nell'applicazione da un file esterno. In questo esempio verranno create le configurazioni ER necessarie per la società di esempio Litware, Inc. Per effettuare queste operazioni, è innanzitutto necessario completare i passaggi nella guida attività, "ER Creare un provider di configurazione e contrassegnarlo come attivo". Tali passaggi possono essere completati mediante il set di dati USMF. È inoltre necessario scaricare e salvare localmente i file seguenti:

Descrizione contenuto	Nome file
Configurazione del modello di dati ER - 1099	1099model.xml
Configurazione di formato ER - 1099	1099format.xml
Esempio del documento in entrata in formato XML	1099entries.xml
Esempio di cartella di lavoro per la gestione dei dati del documento in entrata	1099entries.xlsx

ER consente agli utenti aziendali di configurare il processo di importazione dei file di dati esterni nelle tabelle in formato TXT o XML. Innanzitutto, un modello dati astratto e una configurazione del modello dati ER devono essere disponibili per rappresentare i dati da importare. Quindi, è necessario definire la struttura del file da importare e il metodo che verrà utilizzato per trasferire i dati dal file al modello dati astratto. La configurazione del formato ER che esegue il mapping al modello dati progettato deve essere creata per il modello dati astratto. Quindi, la configurazione del modello dati deve essere estesa con un mapping che descrive come i dati importati vengono resi persistenti come dati del modello dati astratto e come vengono utilizzati per aggiornare le tabelle. La configurazione del modello dati ER deve essere aggiunta a un nuovo mapping di modello che descrive l'associazione del modello dati alle destinazioni dell'applicazione.

Il seguente scenario illustra le capacità dell'importazione di dati ER. Sono incluse le transazioni fornitore che vengono registrate esternamente e quindi vengono importate per essere dichiarate in seguito nella liquidazione del fornitore per i moduli 1099.

Aggiungere una nuova configurazione del modello ER

Andare ad Amministrazione organizzazione > Aree di lavoro > Creazione di report elettronici.

Verificare che il provider di configurazione per la società di esempio "Litware, Inc." sia disponibile e contrassegnato come attivo. Se il provider di configurazione non viene visualizzato, è necessario innanzitutto completare i passaggi della procedura "Creare un provider di configurazione e contrassegnarlo come attivo".
Fare clic su Configurazioni report.

Anziché creare un nuovo modello per supportare l'importazione dati, caricare il file, 1099model.xml, scaricato in precedenza. Questo file contiene il modello dati personalizzati delle transazioni fornitore. Questo modello dati è mappato ai componenti di dati inclusi nell'entità di dati AOT.
Fare clic su Scambia.
Fare clic su Carica da file XML.

Fare clic su Sfoglia e trovare il file 1099model.xml in precedenza scaricato.
Fare clic su OK.
Nella struttura selezionare '1099 Modello pagamenti'.

Esaminare le impostazioni del modello dati

Fare clic su Progettazione.

Questo modello è progettato per rappresentare le transazioni dei fornitori dal punto di vista aziendale e sono separate dall'implementazione.
Nella struttura espandere '1099-MISC'.
Nella struttura selezionare '1099-MISC\Transazioni'.
Nella struttura espandere '1099-MISC\Transazioni'.

L'elemento Transazioni del modello rappresenta le singole transazioni. Gli elementi figlio vengono utilizzati per specificare i dettagli necessari, ad esempio il conto fornitore e la data di transazione, per ciascuna transazione.
Chiudere la pagina.

Aggiungere una nuova configurazione del formato ER che supporta l'importazione dati

I passaggi in questa sottoattività indicano come una nuova configurazione di formato può essere creata per gestire l'importazione di dati da file esterni.

Fare clic su Crea configurazione per aprire la finestra di dialogo a discesa .
Nel campo Nuovo immettere 'Formato in base al modello dati 1099 Modello pagamenti'.
Selezionare Sì nel campo Supporta importazione dati.
Premere il tasto ESC per chiudere la pagina.

Anziché creare un nuovo formato per supportare l'importazione dati, caricare il file 1099format.xml scaricato in precedenza. Questo file contiene la struttura definita del file da importare e il mapping della struttura al modello dati personalizzati delle transazioni fornitore.
Fare clic su Scambia.
Fare clic su Carica da file XML. Fare clic su Sfoglia e trovare il file 1099format.xml in precedenza scaricato.
Fare clic su OK.
Nella struttura espandere '1099 Modello pagamenti'.
Nella struttura, selezionare '1099 Modello pagamenti\Formato per importazione transazioni fornitori'.

Esaminare le impostazioni di formato

Fare clic su Progettazione.
Attivare 'Mostra dettagli'.
Fare clic su Espandi/Comprimi.
Fare clic su Espandi/Comprimi.

Il formato progettato rappresenta la struttura prevista del file esterno. Questo file deve essere in formato XML e disporre dell'elemento radice della liquidazione. Ogni transazione fornitore è rappresentata dall'elemento transazione definito in base alla molteplicità zero a molti. Ciò significa che il file in entrata può contenere da zero a più transazioni. Gli elementi nidificati dell'elemento "transazione" rappresentano gli attributi di una singola transazione. Tenere presente che tutti gli attributi, ad eccezione del paese, sono contrassegnati come obbligatori, ovvero è necessaria la loro presenza nel file di importazione.

Esaminare le impostazioni del mapping di formato al modello dati

Fare clic su Mapping formato a modello.

Il mapping "Formato per importazione transazioni fornitori" contiene le regole di trasferimento di dati dal file XML in entrata nella parte selezionata del modello dati personalizzati, definita selezionando la definizione 1099-MISC.
Fare clic su Progettazione.
Attivare 'Mostra dettagli'.
Nella struttura espandere 'formato: Record'.
Nella struttura selezionare 'formato: Record'.

Si noti che il formato progettato è visualizzato come componente di origine dati.
Nella struttura espandere format: Record\*settlement: XML Element 1..1 (settlement): Record.
Nella struttura espandere format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list.
Nella struttura espandere format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list\*vendor: XML Element 1..1 (vendor): Record.
Nella struttura espandere format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list\country: XML Element 0..1 (country): Record.
Nella struttura selezionare format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list\*vendor: XML Element 1..1 (vendor): Record.

Si noti che la presentazione di elementi di formato obbligatori e facoltativi è diversa nel componente predefinito origine dati "formato".
Nella struttura, espandere 'Transazioni: Elenco di record= format.settlement.'$enumerated''.

Tenere presente che gli elementi del formato che definisce la struttura del file importato sono associati agli elementi del modello dati personalizzati. In base a queste associazioni, il contenuto del file XML importato verrà archiviato in fase di esecuzione nel modello dati esistente. Si consiglia di prestare attenzione all'associazione dell'elemento paese. Per qualsiasi elemento di transazione nel file in entrata che non ha tale elemento, il codice paese predefinito "USA" verrà inserito nel modello dati.
Fare clic sulla scheda Convalide.

Il mapping di formato può contenere la logica definita dall'utente per convalidare l'accuratezza dei dati importati dal punto di vista dell'azienda. Ad esempio, in base all'impostazione, per qualsiasi transazione nel file di importazione senza codice paese definito viene generato un messaggio di avviso nel Registro informazioni che informa l'utente sul caso e indica il numero progressivo della transazione.
Chiudere la pagina.

Eseguire il mapping di formato al modello dati

Eseguire questo mapping di formato a scopo di verifica. Utilizzare il file 1099entries.xml in precedenza scaricato. È possibile esportare il file della cartella di lavoro 1099entries.xlsx utilizzata per gestire le transazioni fornitore. L'output generato verrà importato dal file XML selezionato per popolare il modello dati personalizzati al momento dell'importazione effettiva.

Fare clic su Esegui.

Fare clic su Sfoglia e trovare il file 1099entries.xml in precedenza scaricato.
Fare clic su OK.

Si noti il messaggio di avviso relativo al codice paese mancante per una transazione nel file importato.

Esaminare l'output in formato XML, che rappresenta i dati che sono stati importati dal file selezionato e trasferiti nel modello dati.
Chiudere la pagina.
Chiudere la pagina.

Esaminare le impostazioni per il mapping di modello alle destinazioni

Nella struttura selezionare '1099 Modello pagamenti'.
Fare clic su Progettazione.
Fare clic su Mappa modello a origine dati.

Il mapping per l'importazione manuale delle transazioni 1099 è stato definito con il tipo di direzione A destinazione. Ciò significa che è stato immesso per supportare l'importazione di dati e contiene l'impostazione delle regole che definiscono come il file esterno importato e persistente come dati del modello dati astratto viene utilizzato per aggiornare le tabelle nell'applicazione.
Fare clic su Progettazione.
Nella struttura espandere 'modello: Modello dati 1099 Modello pagamenti'.
Nella struttura, espandere 'modello: Modello dati 1099 Modello pagamenti\Transazioni: Elenco di record'.

Si noti che il modello progettato è visualizzato come elemento di origine dati. In fase di esecuzione, contiene i dati importati dal file esterno. Diverse tabelle sono state aggiunte come elementi di origine dati per assicurarsi che i dati importati siano conformi ai dati dell'applicazione corrente, ad esempio se il conto fornitore di transazione di importazione è disponibile nel sistema, se la combinazione di codici paese e stato/regione di importazione è presente e così via.
Nella struttura, selezionare 'modello: Modello dati 1099 Modello pagamenti\Transazioni: Elenco di record list$failed: Campo calcolato = IF(OR(ISEMPTY(model.Transactions.'$refs'.vendor), ISEMPTY(model.Transactions.'$refs'.vendor1099), ISEMPTY(model.Transactions.'$refs'.box1099), ISEMPTY(model.Transactions.'$refs'.country), ISEMPTY(model.Transactions.'$refs'.state), ISEMPTY(model.Transactions.'$refs'.location)), true, false): Boolean'.
Fare clic su Modifica.
Fare clic su Modifica formula.

Quando almeno una convalida ha esito negativo per una singola transazione importata, la transazione verrà contrassegnata come errata dall'attributo di origine dati "$failed".
Chiudere la pagina.
Scegliere Annulla.
Nella struttura, selezionare 'tax1099trans: Tabella 'VendSettlementTax1099' record= model.Validated'.
Fare clic su Modifica destinazione.

La destinazione ER è stata aggiunta per specificare come i dati importati aggiorneranno le tabelle dell'applicazione. In questo caso, la tabella dati VendSettlementTax1099 è stata selezionata. Poiché l'azione di record Inserisci è selezionata, le transazioni importate verranno inserite nella tabella VendSettlementTax1099. Tenere presente che un singolo mapping modello può contenere più destinazioni. Ciò significa che i dati importati possono essere utilizzati per aggiornare più tabelle dell'applicazione contemporaneamente. Le tabelle, le viste e le entità di dati possono essere utilizzate come destinazioni ER.

Se il mapping verrà chiamato da un punto dell'applicazione (ad esempio un pulsante o una voce di menu) che specificatamente è stata progettata per questa azione, la destinazione ER deve essere contrassegnata come punto di integrazione. In questo esempio il punto è ERTableDestination#VendSettlementTax1099.
Scegliere Annulla.
Fare clic su Mostra tutto.
Fare clic su Mostra solo non mappati.
Nella struttura, espandere 'tax1099trans: Tabella 'VendSettlementTax1099' record= model.Validated'.

Si noti che l'elemento di origine dati contenente le sole transazioni convalidate è associato alla destinazione creata. È possibile filtrare le transazioni importate per ignorare queste che sono incompatibili con i dati delle applicazioni.
Nella struttura, selezionare 'operazione non riuscita: Tabella 'VendSettlementTax1099Entity' record= model.Failed'.
Fare clic sulla scheda Convalide.

Il mapping di modello può contenere la logica definita dall'utente per convalidare la correttezza dei dati importati dai dati dell'applicazione esistenti. Ad esempio, in base all'impostazione attuale, per qualsiasi transazione nel file importato con un conto fornitore che non è nel sistema, viene generato un messaggio di avviso nel Registro informazioni che informa l'utente sul caso e indica il codice conto fornitore non corretto.

Tenere presente che l'opzione Azione post-convalida può essere utilizzata per ogni convalida, per specificare se il processo di importazione deve essere eseguito o interrotto nonché se gli inserimenti/aggiornamenti già eseguiti possono essere mantenuti o sottoposti a rollback.
Fare clic su Mostra solo non mappati.
Fare clic su Mostra tutto.
Chiudere la pagina.

Eseguire il mapping di modello per provare i mapping di modello e formato progettati. Utilizzare il file 1099entries.xml. I dati del file selezionato verranno importati nel sistema.
Fare clic su Esegui.

Si noti che la finestra di dialogo non contiene domande aggiuntive sul mapping di formato da utilizzare per analizzare il file importato e quindi trasferire i dati nel modello dati. Questo accade perché attualmente un solo formato utilizza il modello, che viene contrassegnato come progettato per supportare l'importazione di dati.

Definire l'ID giustificativo per distinguere le transazioni importate da altre transazioni che potrebbero essere già stati immessi manualmente o importati.
Nel campo Immetti ID giustificativo, digitare 'IMPORT-001'.

Esplorare per trovare il file '1099entries.xml'.
Fare clic su OK.

L'elenco degli avvisi generati fornisce informazioni sui conti fornitore errati, un codice casella 1099 d'imposta errato, i codici paese mancanti e così via. Confrontare l'elenco degli avvisi al contenuto incluso nel file XML di esecuzione.
Chiudere la pagina.
Chiudi la pagina.
Chiudi la pagina.
Chiudi la pagina.
Passare a Contabilità fornitori > Attività periodiche > Imposta 1099 > Liquidazione fornitore per i moduli 1099.

In questo modulo vengono visualizzate le transazioni cumulative nella tabella Tax1099Summary creata in base alle transazioni importate.
Nel campo Data iniziale impostare la data su "01-01-2000".
Fare clic su Transazioni 1099 manuali.

Questo modulo contiene l'elenco delle transazioni aggiunte manualmente e quelle solo importate.
Aprire filtro di colonna Giustificativo.
Immettere il valore di filtro "IMPORT-001" nel campo "Giustificativo" utilizzando l'operatore di filtro "inizia con".

Esaminare la relazione tra il modello e i mapping di formato

Chiudi la pagina.
Chiudi la pagina.
Andare ad Amministrazione organizzazione > Aree di lavoro > Creazione di report elettronici.
Fare clic su Configurazioni report.
Nella struttura selezionare '1099 Modello pagamenti'.

Si supponga che si desideri supportare l'importazione degli stessi dati ma da un formato di file TXT.
Fare clic su Crea configurazione per aprire la finestra di dialogo.
Nel campo Nuovo immettere 'Formato in base al modello dati 1099 Modello pagamenti'.
Digitare 'Importare dati da file TXT' nel campo Nome.
Selezionare Sì nel campo Supporta importazione dati.
Fare clic su Crea configurazione.
Fare clic su Progettazione.
Fare clic su Mapping formato a modello.
Fare clic su Nuovo.
Nel campo Definizione immettere o selezionare un valore.

Selezionare l'opzione '1099-MISC'.
Digitare 'Importare dati da file TXT' nel campo Nome.
Digitare 'Importare dati da file TXT' nel campo Descrizione.
Fare clic su Salva.
Chiudere la pagina.
Chiudere la pagina.
Fare clic su Modifica.

Se hai installato l'hotfix "KB 4012871 Supporto dei mapping di modello GER in configurazioni separate con la possibilità di specificare diversi tipi di prerequisiti per la distribuzione in diverse versioni di Dynamics 365 Finance" (KB 4012871), esegui il passaggio successivo "Attivare il flag Impostazione predefinita per mapping di modello" per la configurazione di formato immessa. In caso contrario ignorare il passaggio successivo.
Selezionare Sì nel campo Impostazione predefinita per mapping di modello.
Nella struttura selezionare '1099 Modello pagamenti'.
Fare clic su Progettazione.
Fare clic su Mappa modello a origine dati.
Fare clic su Esegui.

Se è stato installato l'aggiornamento rapido KB 4012871 Supporto dei mapping di modello GER in configurazioni separate con la possibilità di specificare diversi tipi di prerequisiti per la distribuzione in diverse versioni (KB 4012871), selezionare il mapping di modello preferito nel campo di ricerca. Se non è stato ancora installato l'hotfix, ignorare il passaggio successivo perché il mapping è già stato selezionato dalla definizione della configurazione di formato predefinita.

Se non è stato installato l'aggiornamento rapido KB 4012871, notare che la finestra di dialogo contiene una domanda di mapping di modello aggiuntiva utilizzata per analizzare il file da importare. I dati quindi vengono trasferiti dalla finestra di dialogo nel modello dati. Attualmente, è possibile scegliere il formato di mapping che deve essere utilizzato in base al tipo di file che si prevede di importare.

Se si prevede di chiamare il mapping di modello da un punto nell'applicazione progettato appositamente per l'azione, la destinazione ER e il mapping di formato devono essere contrassegnati come parte dell'integrazione.
Scegliere Annulla.
Chiudere la pagina.
Chiudere la pagina.

Condividi tramite