Impostare i messaggi elettronici

La funzionalità Messaggi elettronici consente la gestione di processi di creazione di reporting elettronici differenti per vari tipi di documento. In alcuni scenari complessi che supportano funzionalità di creazione di report specifiche del paese o dell'area geografica, la funzionalità EM supporta una combinazione di molti stati dei messaggi, stati dell'elemento del messaggio, azioni, campi aggiuntivi e classi eseguibili. Per questi scenari, è possibile importare pacchetti di entità dati. Per usare questi pacchetti di entità dati, importarli in una persona giuridica usando lo strumento di gestione dei dati. Per ulteriori informazioni su come utilizzare lo strumento di gestione dati, vedere Gestione dei dati.

Se non si importa un pacchetto di entità di dati, è possibile configurare manualmente la funzionalità EM. In questo caso, configurare gli elementi seguenti:

• Sequenze numeriche
• Tipi di elementi del messaggio
• Stati elementi dei messaggi
• Stati del messaggio
• Campi aggiuntivi
• Impostazioni classe eseguibile
• Azioni di popolamento record
• Compilare i record di più aziende
• Applicazioni Web
• Impostazioni servizio Web
• Azioni di elaborazione messaggi
• Elaborazione messaggio elettronico

Nelle sezioni seguenti vengono fornite altre informazioni su ognuno di tali elementi.

Sequenze numeriche

Configurare sequenze numeriche per messaggi ed elementi del messaggio. Il sistema usa le sequenze numeriche per numerare automaticamente i messaggi e gli elementi dei messaggi. I numeri assegnati sono identificatori univoci per i messaggi e gli elementi del messaggio nel sistema. Per configurare le sequenze numeriche per la messaggistica elettronica, passare a General ledger>Ledger setup>General ledger parameters.

Tipi di elemento messaggio

I tipi di elementi del messaggio identificano i tipi di record che vengono utilizzati nei messaggi elettronici. Configura i tipi di elementi del messaggio andando in Imposte>Impostazioni>Messaggi elettronici>Tipi di elementi del messaggio.

Stati degli elementi del messaggio

Gli stati degli elementi del messaggio identificano gli stati si applicano agli elementi del messaggio nell'elaborazione che si sta configurando. Configurare gli stati degli elementi del messaggio passando a Imposte>Imposta>Messaggi elettronici>Stati degli elementi del messaggio.

Il parametro Consenti eliminazione di uno stato di elementi del messaggio definisce se è possibile eliminare elementi dei messaggi che hanno questo stato nella pagina Messaggi elettronici o Elementi del messaggio elettronico.

Stati dei messaggi

Configurare gli stati del messaggio che devono essere disponibili nell'elaborazione dei messaggi. Configurare gli stati dei messaggi andando in Imposte>Impostazione>Messaggi elettronici>Stati dei messaggi.

Nella tabella seguente sono descritti i campi della pagina Stati del messaggio.

Campi aggiuntivi

La funzionalità EM raccoglie i record dalle tabelle transazionali in Microsoft Dynamics 365 Field Service come elementi del messaggio. Usare questa funzionalità per preparare i record per la creazione di report e quindi segnalarli. Tuttavia, le tabelle transazionali a volte non forniscono informazioni sufficienti per compilare i record in modo da soddisfare i requisiti di creazione di report. Per compilare tutte le informazioni che devono essere segnalate per un record, impostare campi aggiuntivi. È possibile associare campi aggiuntivi a messaggi ed elementi di messaggio. Configurare i campi aggiuntivi andando in Imposte>Impostazione>Messaggi elettronici>Campi aggiuntivi.

Nella seguente tabella sono descritti i campi generali della pagina Campi aggiuntivi.

Sulla Scheda dettaglio Valori è possibile predefinire i valori che può avere un campo aggiuntivo. Questi valori sono quindi disponibili per la selezione da parte degli utenti. Pertanto, non è necessario compilare manualmente durante l'elaborazione. Nella seguente tabella vengono illustrati i campi.

Per impostazione predefinita, le combinazioni di criteri definiti dai campi Account/Gruppo, Codice account, Effettivo e Scadenza non influiscono sulla selezione dei valori per campi aggiuntivi. Tuttavia, una classe eseguibile può usare queste combinazioni per implementare una logica specifica che calcola i valori per campi aggiuntivi.

Impostazioni della classe eseguibile

Una classe eseguibile è un metodo o classe X++ che l'elaborazione del messaggio elettronico può chiamare in relazione a un'azione se una valutazione viene richiesta per il processo.

È possibile impostare manualmente una classe eseguibile che deve essere chiamata durante l'elaborazione andando su Imposta>Impostazione>Messaggi elettronici>Impostazioni classe eseguibile. Nella pagina Impostazioni classe eseguibile creare una riga e impostare i seguenti campi.

Alcune classi eseguibili hanno parametri obbligatori che è necessario definire prima dell'esecuzione della classe eseguibile per la prima volta. Per definire questi parametri, nel riquadro Azioni selezionare Parametri. Nella finestra di dialogo visualizzata impostare i campi, quindi selezionare OK. È importante selezionare OK. In caso contrario, i parametri non vengono salvati nel database e la classe eseguibile non viene chiamata correttamente.

Azioni di popolamento record

Le azioni di popolamento record sono utilizzate per configurare azioni che aggiungono record alla tabella Elementi del messaggio affinché possano essere aggiunti a un messaggio elettronico. Ad esempio, se il messaggio elettronico deve includere fatture cliente, è necessario configurare un'azione Popola record che è collegata al campo Origine dati nella tabella Giornale di registrazione fatture cliente.

È possibile configurare azioni di popolamento record andando a Imposta>Impostazione>Messaggi elettronici>Azioni di popolamento record. Creare un nuovo record per ogni azione che deve aggiungere record alla tabella e impostare i campi seguenti.

Nella scheda Dettaglio Impostazione origini dati, aggiungi una riga per ogni origine dati utilizzata per il processo e imposta i seguenti campi.

Compilare i record di più aziende

Se la tua azienda deve dichiarare per più persone giuridiche nello stesso database Finance, imposta le azioni di popolamento record per tutte le persone giuridiche da cui i dati devono essere inclusi nella dichiarazione.

Per abilitare questa funzionalità nell'ambiente Finance, seguire questa procedura:

1. Vai a Aree di lavoro>Gestione funzionalità.
2. Trova e seleziona la funzionalità Query interaziendali per le azioni di popolamento dei record nell'elenco.
3. Selezionare Abilita ora.

Per configurare le azioni di popolamento dei record per più società i cui dati si desidera includere nella creazione di report, seguire questa procedura:

1. Vai a Imposta>Impostazione>Messaggi elettronici>Azioni di popolamento record.

   Quando abiliti la funzionalità Query interaziendali per le azioni di popolamento dei record, la griglia Impostazione origini dati nella pagina Azione di popolamento record include un campo Società. Per i record esistenti creati durante la configurazione generale delle azioni di popolamento dei record, questo campo mostra l'identificatore della persona giuridica corrente.

2. Nella griglia Configurazione delle origini dati, aggiungi una riga per ogni entità giuridica controllata che vuoi includere nel reporting e imposta i campi seguenti.

   Nome del campo	Value
   Name	Immettere un valore di testo che consente di capire da dove proviene questo record. Ad esempio, inserisci Nome origine dati - Affiliata 1.
   Tipo di elemento messaggio	Seleziona il tipo di elemento del messaggio richiesto per l'elaborazione EM.
   Tipo di account	Specifica il tipo di account richiesto per l'elaborazione EM. Se la tua elaborazione EM non ha tipi di account specifici, seleziona Tutto.
   Nome tabella master	Specifica il nome della tabella master richiesta per l'elaborazione EM.
   Campo Numero documento	Specifica il campo che contiene il numero del documento nei record della tua elaborazione EM.
   Campo Data documento	Specifica il campo che contiene la data del documento nei record della tua elaborazione EM.
   Campo Conto documento	Specifica il campo che contiene l'account del documento nei record della tua elaborazione EM.
   Azienda	Seleziona l'ID della persona giuridica affiliata.
   Query utente	Questa casella di controllo viene selezionata automaticamente quando definisci i criteri selezionando Modifica query.

3. Per ogni nuova riga, selezionare Modifica query e specificare i criteri correlati per la persona giuridica specificata nel campo Società nella riga.

Applicazioni Web

Per configurare un'applicazione Web di modo che supporti Open Authorization (OAuth) 2.0, utilizzare le impostazioni dell'applicazione Web. OAuth è lo standard aperto che consente agli utenti di concedere l'"accesso delegato protetto" all'applicazione per loro conto, senza condividere le loro credenziali di accesso. È anche possibile eseguire il processo di autorizzazione ottenendo un codice di autorizzazione e un token di accesso. Configurare le impostazioni dell'applicazione Web passando a Imposte>Impostazione>Messaggi elettronici>Applicazioni Web.

Nella tabella seguente sono descritti i campi della pagina Applicazioni Web.

Inoltre, i seguenti pulsanti sono disponibili nel Riquadro azioni della pagina Applicazioni Web per supportare il processo di autorizzazione:

• Ottieni codice di autorizzazione - Inizializzare l'autorizzazione dell'applicazione Web. Questa funzione utilizza il formato ER specificato nel campo Mapping formato autorizzazione per generare una richiesta di autorizzazione.
• Ottieni token di accesso - Inizializzare il processo di acquisizione di un token di accesso.
• Aggiorna token di accesso - Aggiornare un token di accesso. Questa funzione utilizza il formato ER specificato nel campo Importa mapping modello token per importare informazioni sul token di accesso ricevuto.

Quando si archivia un token di accesso a un'applicazione Web nel database del sistema in formato crittografato, è possibile usarlo per le richieste a un servizio Web. Ai fini della sicurezza, limitare l'accesso al token ai ruoli di sicurezza autorizzati a soddisfare tali richieste. Se qualcuno all'esterno del gruppo di sicurezza tenta di elaborare una richiesta, viene generato un errore indicante che questi non sono autorizzati a interagire tramite l'applicazione Web selezionata. Per impostare i ruoli di sicurezza che devono avere accesso al token di accesso, utilizzare la Scheda dettaglio Ruoli di sicurezza della pagina Applicazioni Web. Se non si definiscono ruoli di sicurezza per un'applicazione Web, solo un amministratore di sistema può interagire usando l'applicazione Web.

Per ogni azione con l'applicazione Web selezionata, la Scheda dettaglio Registro azioni salva le informazioni sull'utente e la data e l'ora.

Alcuni servizi Web potrebbero richiedere l'inclusione di intestazioni diverse nelle richieste. L'amministratore di sistema può impostare intestazioni aggiuntive e i loro valori sulla Scheda dettaglio Intestazioni supplementari, quindi utilizzarli durante la generazione della richiesta.

Impostazioni servizio Web

Utilizzare le impostazioni del servizio Web per configurare la trasmissione di dati diretta a un servizio Web. Per configurare le impostazioni del servizio web, passare a Imposta>Imposta>Messaggi elettronici>Impostazioni del servizio web.

Nella seguente tabella sono descritti i campi della pagina Impostazioni servizio Web.

Azioni di elaborazione dei messaggi

Le azioni di elaborazione messaggi consentono di creare azioni per i processi e configurare i relativi parametri. È possibile configurare azioni di elaborazione messaggi andando a Imposta>Impostazione>Messaggi elettronici>Azioni di elaborazione messaggi.

Nelle tabelle seguenti vengono descritti i campi della pagina Azioni di elaborazione messaggi.

Scheda dettaglio Generale

Tipi di azioni di elaborazione messaggi

Nel campo Tipo di azione sono disponibili le seguenti opzioni:

• Crea messaggio - Utilizzare questo tipo di azione per consentire agli utenti di creare manualmente messaggi nella pagina Messaggio elettronico. Non è possibile configurare uno stato iniziale per un'azione di questo tipo.
• Popola record - Questo tipo di azione deve essere già impostato. Associarlo a un'azione di popolamento di record affinché sia inclusa nell'elaborazione. Si presuppone che questo tipo di azione sia utilizzato per la prima azione nell'elaborazione del messaggio (quando nessun messaggio elettronico è stato creato in anticipo) o per un'azione che aggiunge elementi del messaggio a un messaggio creato in precedenza (mediante un tipo di azione Crea messaggio). Pertanto, per le azioni di questo tipo, è possibile configurare uno stato dei risultati solo per gli elementi del messaggio. È possibile configurare uno stato iniziale solo per i messaggi.
• Livello di esecuzione del messaggio : usare questo tipo di azione per configurare una classe eseguibile valutata dal sistema a livello di messaggio.
• Livello di esecuzione dell'elemento del messaggio : usare questo tipo di azione per configurare una classe eseguibile valutata dal sistema a livello di elemento del messaggio.
• Esportazione di report elettronici : usare questo tipo di azione per le azioni che generano un report in base a una configurazione ER di esportazione a livello di elemento del messaggio.
• Messaggio di esportazione di report elettronici : usare questo tipo di azione per azioni che generano un report in base a una configurazione ER di esportazione a livello di messaggio, ad esempio quando un messaggio non contiene elementi di messaggio.
• Importazione creazione di report elettronici - Utilizzare questo tipo di azione per le azioni che devono generare un report basato su una configurazione ER di importazione.
• Elaborazione utente livello del messaggio - Utilizzare questo tipo di azione per le azioni che presuppongono azioni manuali da parte dell'utente a livello del messaggio. Ad esempio, l'utente potrebbe aggiornare lo stato dei messaggi.
• Elaborazione utente - Utilizzare questo tipo di azione per le azioni che presuppongono azioni manuali da parte dell'utente a livello dell'elemento del messaggio. Ad esempio, l'utente potrebbe aggiornare lo stato degli elementi del messaggio.
• Servizio Web : usare questo tipo di azione per le azioni che trasmettono un report generato a un servizio Web. Questo tipo di azione non viene utilizzato per il reporting relativo alla comunicazione di fatture di vendita e di acquisto per l'Italia. Per questo tipo di azione, la pagina Azioni di elaborazione messaggi include una Scheda dettaglio Dettagli vari dove è possibile specificare un testo di conferma. Questo testo di conferma viene visualizzato agli utenti prima dell'elaborazione delle richieste al servizio Web selezionato.
• Verifica richiesta - Utilizzare questo tipo di azione per la verifica della richiesta da un server.

Scheda Dettaglio Stati iniziali

Scheda Dettaglio Stati di risultati

Nella tabella seguente vengono illustrati gli stati dei risultati che è necessario configurare per tipi di azione e tipi di risposta diversi.

Elaborazione elettronica dei messaggi

L'elaborazione del messaggio elettronico è un concetto di base della funzionalità EM. Aggrega le azioni che devono essere valutate per il messaggio elettronico. Le azioni possono essere collegate tramite uno stato iniziale e uno stato di risultato. In alternativa, le azioni Elaborazione utente possono essere avviate indipendentemente. Per impostare l'elaborazione dei messaggi elettronici, andare a Imposta>Impostazione>Messaggi elettronici>Elaborazione messaggio elettronico.

La scheda Dettaglio Azione consente di aggiungere azioni predefinite all'elaborazione. È possibile specificare se un'azione deve essere eseguita separatamente o se può essere avviata dall'elaborazione. Per specificare che un'azione nell'elaborazione può essere inizializzata solo da un utente, impostare il campo Esegui separatamente su Sì per quell'azione. Se l'azione deve essere avviata elaborando i messaggi o gli elementi del messaggio nello stato definito come stato iniziale per l'azione, impostare Esegui separatamente su No. Le azioni di tipo Azione utente devono sempre essere eseguite separatamente.

Talvolta, più azioni devono essere aggregate in una sequenza, anche se la prima azione è configurata per essere eseguita separatamente. Ad esempio, un utente deve inizializzare la generazione di report. Tuttavia, subito dopo la generazione del report questo deve essere inviato a un servizio Web e la riposta del servizio Web deve essere riflessa nel sistema. In questo caso, è possibile creare una sequenza inseparabile per le azioni che devono essere sempre eseguite insieme. Nella Scheda dettaglio Azione, selezionare Sequenza inseparabile sopra la griglia e creare una sequenza. Quindi, per tutte le azioni da eseguire insieme in una sequenza, selezionare la sequenza nel campo Sequenza inseparabile. Per questo esempio, il campo Esegui separatamente può essere impostato su Sì per la prima azione nella sequenza e su No per tutte le altre azioni.

Le azioni dei tipi Esportazione creazione di report elettronici e Messaggio esportazione creazione di report elettronici eseguono un formato ER con parametri di input. Se l'elaborazione del messaggio elettronico include azioni di uno di questi tipi, è necessario specificare i valori per i parametri di input prima della generazione del report. In questo modo, il sistema può utilizzare un regime batch per generare il report. È possibile selezionare Parametri sopra la griglia per impostare i parametri per il tipo di azione selezionato (Esportazione creazione di report elettronici o Messaggio esportazione creazione di report elettronici). Selezionare la casella di controllo Usa parametri per l'azione che deve essere eseguita con i parametri specificati in un regime batch.

Utilizzare la Scheda dettaglio Campi aggiuntivi dell'elemento del messaggio per aggiungere ulteriori campi predefiniti correlati agli elementi del messaggio. È necessario aggiungere ulteriori campi per ogni tipo di elemento del messaggio a cui i campi sono correlati. È possibile specificare un valore predefinito assegnato al campo aggiuntivo durante l'elaborazione.

Utilizzare la Scheda dettaglio Campi aggiuntivi del messaggio per aggiungere ulteriori campi predefiniti correlati ai messaggi. È possibile specificare un valore predefinito assegnato al campo aggiuntivo durante l'elaborazione.

Utilizzare la Scheda dettaglio Ruoli di sicurezza per configurare i ruoli di sicurezza che sono predefiniti nel sistema per una specifica elaborazione. Gli utenti con un ruolo specifico vedono solo l'elaborazione definita per tale ruolo.

Utilizzare la Scheda dettaglio Batch per configurare l'elaborazione per l'utilizzo in un regime batch. Si consiglia di impostare un regime batch per l'elaborazione direttamente nella pagina Messaggi elettronici o Elementi di messaggi elettronici, quando si seleziona Esegui elaborazione nel riquadro Azioni per avviare l'elaborazione.