Gestire il ciclo di vita della configurazione per la creazione di report elettronici

In questo articolo viene descritto come gestire il ciclo di vita delle configurazioni per la creazione di report elettronici (ER) per Dynamics 365 Finance.

Panoramica

Creazione di report elettronici (ER, Electronic Reporting) è un motore che supporta i documenti elettronici specifici dei paesi e quelli richiesti dalla legge. In generale, ER presuppone la capacità di eseguire le seguenti attività per un singolo documento elettronico. Per ulteriori informazioni, vedere Panoramica dello strumento di creazione di report elettronici.

• Progettare un modello per un documento elettronico:

  • Identificare le origini dati necessarie che possono essere presentate nel documento:

    • Dati sottostanti, come tabelle dati, entità di dati e classi.
    • Proprietà specifiche del processo, come data e ora di esecuzione e fuso orario.
    • Parametri di input utente, specificati dall'utente finale in fase di esecuzione.

  • Definire gli elementi del documento necessari e relativa topologia per specificare un formato di documento finale.

  • Configurare il flusso di dati desiderato dalle origini dati selezionate agli elementi del documento definiti (attraverso le associazioni delle origini dati ai componenti del formato documento) e specificare la logica di controllo del processo.

• Rendere disponibile un modello in modo che possa essere utilizzato in altre istanze:

  • Trasformare un modello di documento creato in una configurazione di ER ed esportare la configurazione dell'istanza corrente dell'applicazione come pacchetto XML che può essere archiviato in locale o in Lifecycle Services (LCS).
  • Trasformare una configurazione di ER in un modello di documento dell'applicazione.
  • Importare un pacchetto XML archiviato in locale o in LCS dell'istanza corrente.

• Personalizzare il modello di un documento elettronico:

  • Importare un modello da LCS nell'istanza corrente come configurazione ER.
  • Progettare una versione personalizzata di una configurazione ER e mantenere un riferimento alla versione di base.

• Integrare un modello con un processo aziendale specifico, in modo che sia disponibile nell'applicazione:

  • Configurare le impostazioni dell'applicazione in modo che inizi a utilizzare una configurazione di ER, facendo riferimento a quella configurazione in un parametro correlato al processo. Ad esempio, fare riferimento alla configurazione ER in un metodo di pagamento contabilità fornitori specifico per generare un messaggio di pagamento elettronico per l'elaborazione delle fatture.

• Utilizzare un modello in un processo aziendale specifico:

  • Eseguire una configurazione di ER in un processo aziendale specifico. Ad esempio, per generare un messaggio di pagamento elettronico per l'elaborazione delle fatture quando è selezionato un metodo di pagamento che fa riferimento alla configurazione ER.

Concetti

I seguenti ruoli e attività correlate sono associati al ciclo di vita di una configurazione ER:

Ciclo di vita di sviluppo della configurazione ER

Per i motivi correlati a ER seguenti, consigliamo di progettare le configurazioni ER nell'ambiente di sviluppo, come istanza separata di finanza e operazioni:

• Gli utenti con il ruolo Sviluppatore per la creazione di report elettronici o Consulente funzionale per la creazione di report elettronici possono modificare le configurazioni ed eseguirle a scopo di test. Questo scenario può determinare chiamate a metodi di classi e tabelle che potrebbero essere potenzialmente pericolose per i dati aziendali e le prestazioni dell'istanza.
• Le chiamate a metodi di classi e tabelle come origini dati ER di configurazioni ER non sono limitate dai punti di ingresso e dal contenuto aziendale registrato. Di conseguenza, gli utenti con il ruolo Sviluppatore per la creazione di report elettronici o Consulente funzionale per la creazione di report elettronici possono accedere a dati aziendali.

Le configurazioni ER progettate nell'ambiente di sviluppo possono essere caricate nell'ambiente di test per la valutazione della configurazione (integrazione del processo appropriata, correttezza dei risultati, prestazioni) e il controllo della qualità (correttezza dei diritti di accesso basati sui ruoli, separazione dei compiti). Le funzionalità che consentono lo scambio di configurazioni ER possono essere utilizzate a tale scopo. Le configurazioni ER testate possono essere caricate in LCS per essere condivise con gli abbonati al servizio oppure possono essere importate nell'ambiente di produzione per uso interno.

Considerazione sulla persistenza dei dati

Puoi importare individualmente differenti versioni di una configurazione ER nell'istanza di Finance. Quando viene importata una nuova versione di una configurazione ER, il sistema controlla il contenuto della versione bozza di questa configurazione:

• Quando la versione importata è inferiore alla versione più alta di questa configurazione nell'istanza corrente di Finance, il contenuto della versione bozza di questa configurazione rimane invariato.
• Quando la versione importata è superiore a qualsiasi altra versione di questa configurazione nell'istanza corrente di Finance, il contenuto della versione importata viene copiato nella versione bozza di questa configurazione per continuare a modificare l'ultima versione completata.

Se questa configurazione è di proprietà del provider di configurazioni attualmente attivato, la versione bozza di questa configurazione è visibile nella Scheda dettaglio Versioni della pagina Configurazioni (Amministrazione organizzazione>Creazione di report elettronici>Configurazioni). È possibile selezionare la versione bozza della configurazione e modificarne il contenuto utilizzando il designer ER pertinente. Dopo la modifica della versione bozza di una configurazione ER, il relativo contenuto non corrisponde più al contenuto della versione più alta di questa configurazione nell'istanza corrente di Finance. Per evitare la perdita delle modifiche, il sistema visualizza un errore indicante che l'importazione non è in grado di continuare poiché la versione di questa configurazione è superiore alla versione più alta di questa configurazione nell'istanza corrente di Finance. Quando ciò accade, ad esempio con la configurazione del formato X, viene visualizzato l'errore Versione del formato "X" non completata.

Per annullare le modifiche introdotte nella versione bozza, selezionare la versione completata o condivisa più alta della configurazione ER in Finance nella Scheda dettaglio Versioni, quindi selezionare l'opzione Ottieni questa versione. Il contenuto della versione selezionata viene copiato nella versione bozza.

Considerazione sull'applicabilità

Quando si progetta una nuova versione di una configurazione ER, puoi definirne la dipendenza da altri componenti software. Questo passaggio è considerato un prerequisito per il controllo del download di questa versione della configurazione da un repository ER o un file XML esterno e per qualsiasi altro utilizzo della versione. Quando tenti di importare una nuova versione di una configurazione ER, il sistema utilizza i prerequisiti configurati per controllare se la versione può essere importata.

In alcuni casi, potrebbe essere necessario che il sistema ignori i prerequisiti configurati quando si importano nuove versioni delle configurazioni ER. Per fare in modo che il sistema ignori i prerequisiti durante l'importazione, segui questi passaggi.

1. Vai a Amministrazione organizzazione>Creazione di report elettronici>Configurazioni.

2. Nella pagina Configurazioni, nel Riquadro azioni, nella scheda Configurazioni, nel gruppo Impostazioni avanzate, selezionare Parametri utente.

3. Imposta l'opzione Ignora gli aggiornamenti del prodotto e il controllo dei prerequisiti della versione durante l'importazione su Sì.

   Nota

   Questo parametro è specifico dell'utente e dell'azienda.

Dipendenze da altri componenti

Le configurazioni ER possono essere configurate come dipendenti da altre configurazioni. Ad esempio, puoi importare una configurazione del modello di dati ER dal repository globale nell'istanza Microsoft Regulatory Configuration Services (RCS) o Dynamics 365 Finance, quindi creare una nuova configurazione di formato ER derivata dalla configurazione del modello di dati ER importata. La configurazione di formato ER derivata dipenderà dalla configurazione del modello di dati ER di base.

Al termine della progettazione del formato, puoi cambiare lo stato della versione iniziale della configurazione di formato ER da Bozza a Completata. Puoi quindi condividere la versione completata della configurazione di formato ER pubblicandola nel repository globale. Successivamente, puoi accedere al repository globale da qualsiasi istanza cloud RCS o Finance. Puoi quindi importare qualsiasi versione della configurazione ER applicabile all'applicazione dal repository globale in tale applicazione.

In base alla dipendenza dalla configurazione, quando selezioni la configurazione di formato ER nel repository globale per importarla in un'istanza RCS o Finance appena distribuita, la configurazione del modello di dati ER di base viene trovata automaticamente nel repository globale e importata insieme alla configurazione di formato ER selezionata come configurazione di base.

Puoi anche esportare la versione della configurazione di formato ER dall'istanza RCS o Finance corrente e archiviarla localmente come file XML.

Nelle versioni di Finance antecedenti alla versione 10.0.29, quando tenti di importare la versione della configurazione di formato ER da quel file XML o da qualsiasi repository che non sia il repository globale in un'istanza RCS o Finance appena distribuita che non contiene ancora alcuna configurazione ER, verrà generata la seguente eccezione per informarti dell'impossibilità di ottenere una configurazione di base:

Riferimenti non risolti rimanenti
Impossibile stabilire il riferimento dell'oggetto '<imported configuration name>' all'oggetto "Base" (<globally unique identifier of the missed base configuration>,<version of the missed base configuration>)

Nella versione10.0.29 e successive, quando tenti di eseguire la stessa importazione della configurazione, se non è possibile trovare una configurazione di base nell'istanza dell'applicazione corrente o nel repository di origine attualmente in uso (se applicabile), il framework ER proverà automaticamente a trovare il nome della configurazione di base mancante nella cache del repository globale. Presenterà quindi il nome e l'identificatore univoco globale (GUID) della configurazione di base mancante nel testo dell'eccezione generata.

Riferimenti non risolti rimanenti
Impossibile stabilire il riferimento dell'oggetto '<imported configuration name>' all'oggetto 'Base' (<name of the missed base configuration><globally unique identifier of the missed base configuration>,<version of the missed base configuration>)

Puoi utilizzare il nome fornito per trovare la configurazione di base e quindi importarla manualmente.

Risorse aggiuntive

Panoramica della creazione di report elettronici

Definire la dipendenza delle configurazioni ER in altri componenti