Configurare l'importazione di dati da SharePoint

Articolo
03/08/2023

Per importare dati da un file ricevuto utilizzando il framework di creazione di report elettronici (ER, electronic reporting), è necessario configurare un formato di ER che supporti l'importazione e quindi eseguire il mapping di modello del tipo A destinazione che utilizza quel formato come origine dati. Per importare i dati, è necessario passare al file da importare. Il file ricevuto può essere selezionato manualmente dall'utente. Con la nuova funzionalità di ER per supportare l'importazione dei dati da Microsoft SharePoint, questo processo può essere configurato come automatico. È possibile utilizzare le configurazioni di ER per eseguire l'importazione di dati dai file che sono archiviati in cartelle di Microsoft SharePoint. In questo articolo viene descritto come completare l'importazione da SharePoint. Gli esempi utilizzano transazioni fornitore come dati aziendali.

Prerequisiti

Per completare gli esempi in questo articolo, è necessario disporre del seguente accesso:

Accesso a uno dei seguenti ruoli:
- Sviluppatore per la creazione di report elettronici
- Consulente funzionale per la creazione di report elettronici
- Amministratore di sistema
Accesso all'istanza di Microsoft SharePoint Server configurato per l'utilizzo con l'applicazione.
Configurazioni di formato ER e di modello per 1099 pagamenti.

Creare le configurazioni di ER richieste

Riprodurre le guide attività ER Importare i data da un file di Microsoft Excel, che fanno parte del processo aziendale 7.5.4.3 Acquisire/sviluppare componenti di soluzioni/servizi IT (10677). Queste guide attività illustrano in dettaglio il processo di progettazione e di utilizzo delle configurazioni ER per importare in modo interattivo transazioni fornitori da file di Microsoft Excel. Per ulteriori informazioni, vedere Analizzare i documenti in entrata in formato Excel. Dopo aver completato le guide di attività, si avrà la configurazione seguente.

Configurazioni ER

Configurazione del modello di ER, 1099 Modello pagamenti
Configurazione del formato per ER, Formato per importare transazioni fornitori da Excel

Configurazioni di ER per importare i dati da SharePoint.

Esempio di file ricevuto per l'importazione dei dati

File di Excel 1099import-data.xlsx, con transazioni fornitori che devono essere importate.

Esempio di file Excel per l'importazione da SharePoint.

Nota

Il formato per l'importazione delle transazioni fornitori è selezionato come mapping di modello predefinito. Se quindi si esegue un mapping di modello del 1099 modello pagamenti e quel mapping di modello è di tipo A destinazione, il mapping di modello esegue questo formato per importare i dati da file esterni. Utilizza quindi i dati per aggiornare le tabelle dell'applicazione.

Configurare l'accesso a SharePoint per l'archiviazione dei file

Per archiviare i file di report elettronici in un percorso di SharePoint, è necessario configurare l'accesso all'istanza di SharePoint Server che verrà utilizzato dalla società corrente. In questo esempio, la società è USMF. Per istruzioni, vedere Configurazione dell'archiviazione di SharePoint.

Completare i passaggi in Configurazione dell'archiviazione di SharePoint.
Aprire il sito di SharePoint configurato.
Creare le seguenti cartelle dove è possibile archiviare i file di report elettronici in arrivo:
- Origine di importazione dei file (principale) (esempio mostrato nella schermata seguente)
- Origine di importazione dei file (alternativa)
(Facoltativo) Creare le seguenti cartelle dove è possibile archiviare i file dopo l'importazione.
- Cartella di archiviazione dei file – Questa cartella è per i file importati correttamente.
- Cartella di avvisi dei file – Questa cartella è per i file importati con un avviso.
- Cartella di errori dei file – Questa cartella è per i file la cui importazione non è riuscita.
Selezionare Amministrazione organizzazione > Gestione documenti > Tipi di documento.
Creare i tipi di documento seguenti che verranno utilizzati per accedere alle cartelle di SharePoint appena create. Per istruzioni, vedere Configurare i tipi di documento.

Tipo di documento	Raggruppa	Posizione	Cartella SharePoint
Principale di SP	File	SharePoint	Origine di importazione dei file (principale)
Alternativa di SP	File	SharePoint	Origine di importazione dei file (alternativa)
Archivio SP	File	SharePoint	Cartella di archiviazione dei file
Avviso SP	File	SharePoint	Cartella di avvisi dei file
Errore SP	File	SharePoint	Cartella di errori dei file

Impostazione di SharePoint - nuovo tipo di documento.

Configurare le origini di ER per il formato di ER

Fai clic su Amministrazione organizzazione>Creazione di report elettronici>Origine creazione di report elettronici.
Nella pagina Origine creazione di report elettronici configurare i file di origine per l'importazione dei dati utilizzando il formato di ER configurato.
Definire una maschera del nome di file, in modo che solo i file con estensione xlsx vengano importati. La maschera del nome di file è facoltativa e viene utilizzata solo quando è stata definita. È possibile definire una sola maschera per ogni formato di ER.
Modificare Ordina i file prima di importare in Non ordinare se vi sono vari file da importare e l'ordine di importazione non è importante
Selezionare tutte le cartelle di SharePoint create in precedenza.

Nota

L'origine di ER viene definita per ogni società dell'applicazione individualmente. Le configurazioni di ER vengono invece condivise tra le società.
Quando si elimina un'impostazione di origine di ER per un formato di ER, vengono eliminati anche tutti gli stati dei file connessi (vedere sotto) dietro conferma.

Esaminare gli stati dei file per il formato di ER

Nella pagina Origine creazione di report elettronici selezionare Stati dei file per le origini per esaminare il contenuto delle origini dei file configurate per il formato di ER corrente.
Nella sezione File esaminare l'elenco dei file. Questo elenco presenta gli elementi seguenti:
- File di origine applicabili, in base alla maschera del nome di file (se viene definita una maschera del nome di file), e pronti per l'importazione di dati. Per tali file, la sezione Registri delle origini per il formato di importazione è vuota.
- File precedentemente importati. Per ognuno di questi file, nella sezione Registri delle origini per il formato di importazione è possibile esaminare la cronologia di importazione del file.

È inoltre possibile aprire la pagina Stati dei file per le origini selezionando Amministrazione organizzazione>Creazione di report elettronici>Stati dei file per le origini. In questo caso, la pagina fornisce informazioni sulle origini dei file per tutti i formati di ER per cui sono state configurate le origini dei file nella società a cui si è attualmente connessi.

Importare dati da file di Excel in una cartella di SharePoint

In SharePoint, caricare il file di Microsoft Excel denominato 1099import-data.xlsx, contenente le transazioni fornitori, nella cartella di SharePoint Origine di importazione dei file (principale) creata in precedenza.
Nella pagina Stati dei file per le origini selezionare Aggiorna per aggiornare la pagina. Il file di Excel che è stato caricato in SharePoint viene visualizzato in questa pagina con lo stato Pronto. Al momento sono disponibili i seguenti stati:
- Pronto - Assegnato automaticamente per ogni nuovo file in una cartella di SharePoint. Questo stato indica che il file è pronto per l'importazione.
- Importazione - Assegnato automaticamente da un report di ER quando il file viene bloccato dal processo di importazione per impedirne l'utilizzo da parte di altri processi (nel caso in cui vengano eseguiti più processi contemporaneamente).
- Importato - Assegnato automaticamente da un report di ER al termine della corretta importazione di file. Questo stato indica che il file importato è stato eliminato dall'origine di file configurata (cartella di SharePoint).
- Non riuscito - Assegnato automaticamente da un report di ER quando l'importazione dei file genera errori o eccezioni.
- In attesa - Assegnato manualmente dall'utente in questa pagina. Questo stato indica che il file non verrà importato per il momento. Questo stato può essere utilizzato per posticipare l'importazione di alcuni file.

Importa dati da file SharePoint

Aprire la struttura delle configurazioni di ER, selezionare 1099 Modello pagamenti ed espandere l'elenco di componenti del modello di ER.
Selezionare il nome del mapping di modello per aprire l'elenco di mapping di modello della configurazione del modello di ER selezionata.
Selezionare Esegui per eseguire il mapping di modello selezionato. Poiché sono state configurate origini di file per il formato di ER, è possibile modificare l'impostazione dell'opzione Origine file se necessario. Se si mantiene l'impostazione di questa opzione, i file con estensione xslx vengono importati dalle origini configurate (le cartelle di SharePoint, in questo esempio).

In questo esempio, si importa un solo file. Se tuttavia sono presenti più file questi vengono selezionati per l'importazione nell'ordine in cui sono stati aggiunti nella cartella di SharePoint. Ogni esecuzione di un formato di ER importa un singolo file selezionato.
Il mapping di modello può essere eseguito automaticamente nella modalità batch. In questo caso, ogni volta che si esegue un batch in questo formato di ER, viene importato un singolo file dalle origini di file configurate.

Quando un file viene importato correttamente dalla cartella di SharePoint, viene eliminato da quella cartella e spostato nella cartella dei file importati correttamente o nella cartella dei file importati con avvisi. In caso contrario, viene spostato nella cartella dei file la cui importazione non è riuscita a meno che tale cartella non sia stata creata.
Immettere l'ID giustificativo, ad esempio V-00001, quindi selezionare OK.
Nella pagina Stati dei file per le origini selezionare Aggiorna per aggiornare la pagina.
Nella sezione File esaminare l'elenco dei file. Nella sezione Registri delle origini per il formato di importazione è presente la cronologia dell'importazione del file di Excel. Poiché questo file è stato importato correttamente, nella cartella di SharePoint viene contrassegnato come Eliminato.
Esaminare la cartella di SharePoint Origine di importazione dei file (principale). I file di Excel importati correttamente sono stati eliminati da questa cartella.
Selezionare Contabilità fornitori>Attività periodiche>Imposta 1.099>Liquidazione fornitore per i moduli 1.099.
Nei campi Dal e Al immettere i valori appropriati. Selezionare quindi Transazioni 1099 manuali.

Le transazioni fornitori che sono state importate dai file di Excel in SharePoint per il giustificativo V-00001 vengono visualizzate nella pagina.

Preparare un file di Excel per l'importazione

Aprire il file di Excel utilizzato in precedenza. Nella riga 3 della colonna 1, aggiungere un codice fornitore che non esiste nell'applicazione. Aggiungere nella riga altre informazioni sul fornitore false.
Caricare il file di Excel aggiornato contenente le transazioni fornitori nella cartella di SharePoint Origine di importazione dei file (principale).
Aprire la struttura delle configurazioni di ER, selezionare 1099 Modello pagamenti ed espandere l'elenco di componenti del modello di ER.
Selezionare il nome del mapping di modello per aggiornare il mapping di modello in modo da considerare il codice fornitore errato come un errore durante il processo di importazione di dati.
Selezionare Designer.
Nella scheda Convalide, è necessario modificare l'azione post-convalida per la regola di convalida che è stata configurata per valutare se il conto fornitore importato esiste nell'applicazione. Aggiornare il valore del campo Azione post-convalida impostandolo su Arresta esecuzione, salvare le modifiche e chiudere la pagina.
Salvare le modifiche e chiudere la finestra Progettazione mapping di modello di ER.
Selezionare Esegui per eseguire il mapping di modello di ER modificato.
Immettere l'ID giustificativo, ad esempio V-00002, quindi selezionare OK.

Il Registro informazioni contiene una notifica che informa della presenza di un file nella cartella di SharePoint contenente un conto fornitore errato e che quindi non può essere importato.
Nella pagina Stati dei file per le origini, selezionare Aggiorna, quindi nella sezione File esaminare l'elenco dei file.

La sezione Registri delle origini per il formato di importazione indica che il processo di importazione non è riuscito e che il file si trova nella cartella di errori dei file di SharePoint (la casella di controllo Eliminato non è selezionata). Se si corregge questo file in SharePoint aggiungendo il codice fornitore appropriato è poi lo si sposta nella cartella Origine di importazione dei file (principale) di SharePoint, è possibile importare il file nuovamente.

Seleziona Contabilità fornitori>Attività periodiche>Imposta 1.099>Liquidazione fornitore per i moduli 1.099, immetti i valori appropriati nei campi Dal e Al e quindi selezionare Transazioni 1.099 manuali.

Solo le transazioni per il giustificativo V-00001 sono disponibili. Non sono presenti transazioni per il giustificativo V-00002 anche se l'errore dell'ultima transazione importata viene trovato nel file di Excel.

Limiti

Nelle versioni di Dynamics 365 Finance prima della versione 10.0.25, l'interfaccia utente del framework ER non offre la capacità di avviare un nuovo processo batch che eseguirà un mapping del modello in modalità automatica per l'importazione dei dati. È invece necessario sviluppare una nuova logica in modo che il mapping del modello ER configurato possa essere richiamato dall'interfaccia utente dell'applicazione per importare i dati dai file in ingresso. Per sviluppare questa logica, sono necessari alcune attività tecniche.

Per altre informazioni sull'API ER pertinente, vedere la sezione Codice per eseguire una mappatura del formato per l'importazione dei dati nell'argomento Modifiche all'API framework ER per l'aggiornamento dell'applicazione 7.3. Rivedere il codice nella BankImport_RU classe del modello Application Suite per vedere come implementare la tua logica personalizzata. La classe BankImport_RU estende la classe RunBaseBatch. In particolare, rivedi il metodo runER() in cui l'oggetto ERIModelMappingDestinationRun viene creato come l'esecutore di una mappatura del modello ER.

In Finance versione 10.0.25 e successive, l'interfaccia utente del framework ER offre la capacità di avviare un nuovo processo batch che eseguirà un mapping del modello in modalità automatica per l'importazione dei dati. Per altre informazioni su questo processo, vedi Importare dati da file selezionati manualmente in modalità batch.