Condividi tramite

Configurare un canale e-mail per Office 365 Exchange Online

Se la funzionalità di Fatturazione elettronica creata importa fatture fornitore elettroniche da file allegati ricevuti tramite posta elettronica, è consigliabile configurare un canale di account e-mail.

Aggiungere le autorizzazioni IMAP alla tua applicazione Microsoft Azure AD

  1. Nel portale di Microsoft Azure, seleziona il servizio Registrazioni app.

  2. Seleziona Nuova registrazione per creare una registrazione dell'app.

  3. Immettere un nome.

  4. Nella sezione Tipi di account supportati, seleziona l'opzione Solo account in questa directory organizzativa.

  5. Dopo aver creato la registrazione dell'app, seleziona Autorizzazioni API.

  6. Seleziona Aggiungi autorizzazione.

  7. Nella scheda API utilizzate dalla mia organizzazione, cerca Office 365 Exchange Online.

  8. Seleziona Autorizzazione dell'applicazione.

  9. Per l'accesso IMAP (Internet Message Access Protocol), seleziona l'autorizzazione IMAP.AccessAsApp .

    Screenshot che mostra le autorizzazioni IMAP.AccessAsApp aggiunte per la registrazione dell'app.

  10. Seleziona Aggiungi autorizzazioni.

  11. Per accedere alle cassette postali di Exchange tramite IMAP, l'applicazione Azure Active Directory (Azure AD) deve ottenere il consenso dell'amministratore del tenant per ogni tenant. Per ulteriori informazioni, vedi Introduzione alle autorizzazioni e al consenso.

    1. Nella vista di gestione della tua applicazione Azure AD, seleziona Autorizzazioni API.
    2. In Autorizzazioni configurate, seleziona Concedi consenso amministratore per <nome>.

    Screenshot che mostra il consenso dell'amministratore concesso per le autorizzazioni selezionate.

  12. Selezionare Panoramica.

  13. Copia i valori ID applicazione (client) e ID directory (tenant) .

  14. Seleziona Certificati e segreti.

  15. Nella scheda Segreti client , seleziona Nuovo segreto client e annota il valore nel campo Scadenza. Quando un segreto scade, non può più essere utilizzato e deve essere creato un nuovo segreto.

  16. Dopo aver creato un segreto, copia il valore Value e salvalo nell'Azure Key Vault associato all'ambiente del servizio di fatturazione elettronica.

    Screenshot che mostra il valore del segreto dell'applicazione da copiare.

  17. Aggiungi un collegamento al segreto nell'ambiente del servizio Regulatory Configuration Service (RCS). Per ulteriori informazioni, vedi Certificati e segreti del cliente.

  18. Salva il valore ID applicazione (client) come un segreto nello stesso Key Vault e aggiungi un collegamento al segreto nell'ambiente del servizio di fatturazione elettronica in RCS.

  19. Nel portale di Azure seleziona il servizio Applicazioni aziendali.

  20. Trova l'applicazione con lo stesso nome della registrazione dell'app che hai creato nel passaggio 2.

  21. Selezionare Panoramica.

  22. Copia il valore di ID oggetto.

Registrare entità servizio in Exchange

Dopo che un amministratore tenant ha acconsentito all'applicazione Azure AD, deve registrare l'entità servizio dell'applicazione in Exchange eseguendo una serie di frammenti di codice PowerShell tramite Exchange Online PowerShell. Alcuni di questi frammenti di codice utilizzano valori che hai copiato nella procedura precedente:

  • <ORGANIZATION_ID> è il valore ID directory (tenant) che hai copiato.
  • <APPLICATION_ID> è il valore ID applicazione (tenant) che hai copiato.
  • <OBJECT_ID> è il valore ID oggetto (tenant) che hai copiato.

Segui questi passaggi per registrare le entità servizio in Exchange.

  1. Installa il modulo ExchangeOnlineManagement.

    Install-Module -Name ExchangeOnlineManagement -allowprerelease
Import-module ExchangeOnlineManagement

    Nota

    Il modulo ExchangeOnlineManagement deve essere installato una sola volta sul computer dell'amministratore di Exchange.

  2. Connettiti a Exchange Online.

    Connect-ExchangeOnline -Organization <ORGANIZATION_ID>

  3. L'esempio seguente mostra come registrare l'entità servizio dell'applicazione Azure AD in Exchange.

    New-ServicePrincipal -AppId <APPLICATION_ID> -ServiceId <OBJECT_ID> -Organization <ORGANIZATION_ID>

    Nota

    Se viene visualizzato un errore quando esegui il cmdlet New-ServicePrincipal, probabilmente non disponi di autorizzazioni sufficienti in Exchange Online per eseguire l'operazione. Oppure stai tentando di utilizzare un account guest per eseguire l'operazione.

  4. L'esempio seguente mostra come concedere all'entità servizio dell'applicazione l'accesso a una cassetta postale.

    Add-MailboxPermission -Identity "john.smith@contoso.com" -User <OBJECT_ID> -AccessRights FullAccess

Creare una configurazione di funzionalità in RCS

  1. In RCS, seleziona la funzionalità di Fatturazione elettronica che hai creato. Seleziona la versione che ha lo stato Bozza.

  2. Nella scheda Configurazioni, seleziona Aggiungi.

  3. Nella finestra di dialogo a discesa Crea configurazione funzionalità, nel gruppo di campi Nuovo, selezionare l'opzione Configurazione personalizzata.

  4. Nel gruppo di campi Tipo di configurazione, seleziona l'opzione Canale dati.

  5. Nel campo Seleziona canale dati, immetti Posta elettronica in arrivo in Exchange.

  6. Seleziona Crea.

  7. Seleziona la riga che hai creato e seleziona Modifica.

  8. Nella scheda Canale dati, nella sezione Parametri, imposta i seguenti campi obbligatori.

    Campo Description
    Canale dati Immetti un nome univoco per identificare il canale dati. Il nome può contenere un massimo di 10 caratteri. Verrà fatto riferimento nelle regole di applicabilità e nell'applicazione Dynamics 365 Finance durante il processo di comunicazione.
    Indirizzo server Immetti l'indirizzo del server di Exchange Online. Ad esempio, il valore predefinito per Office 365 Exchange Online è outlook.office365.com .
    Porta server Immetti il numero della porta utilizzata dal provider dell'account e-mail. Ad esempio, il valore predefinito per Office 365 Exchange Online è 993.
    Segreto nome utente Immetti il nome del segreto del Key Vault che contiene l'ID dell'account utente di posta elettronica. Questo segreto deve essere creato in Key Vault e configurato nell'ambiente del servizio.
    ID client Immetti il nome del segreto del Key Vault che contiene il valore ID applicazione (client) per la registrazione dell'app.
    Segreto client Immetti il nome del segreto del Key Vault che contiene il valore Valore del segreto client per la registrazione dell'app.
    Timeout Il limite di tempo massimo, in millisecondi (ms), che il sistema deve attendere per una risposta. Il valore predefinito è pari a 10.000 ms (10 secondi).
    Cartella principale Specifica l'origine dell'importazione dell'e-mail o la cartella da cui il servizio deve elaborare i messaggi e-mail.
    Cartella di archiviazione Specifica la cartella in cui devono essere archiviati i messaggi e-mail elaborati. Se non imposti un valore, una cartella verrà creata automaticamente.
    Cartella di errore Specifica la cartella in cui devono essere spostati i messaggi e-mail se l'elaborazione non riesce. Se non imposti un valore, una cartella verrà creata automaticamente.
    Dimensione massima messaggio Immetti la dimensione massima, in byte, di un singolo messaggio che viene elaborato. Il valore predefinito è 20.000,000 byte.
    Numero massimo messaggi Immetti il numero massimo di messaggi da elaborare per una singola azione. Se non vuoi limitare il numero di messaggi, imposta il valore su 0 (zero).
    Filtro Da Immetti una stringa da filtrare per indirizzo del mittente. Verranno elaborati solo i messaggi e-mail in cui l'indirizzo del mittente corrisponde al filtro. Questo campo è facoltativo. Per specificare più indirizzi di mittente, utilizza i punti e virgola (;) come separatori.
    Filtro oggetto Immetti una stringa da filtrare per oggetto. Verranno elaborati solo i messaggi e-mail in cui l'oggetto corrisponde al filtro. Questo campo è facoltativo. È supportata una maschera semplice come *smth*.ext. Qui ogni asterisco (*) rappresenta zero o più occorrenze di qualsiasi carattere.
    Filtro data Specifica una data per definire la durata massima, in giorni, dei messaggi elaborati. Questo campo è facoltativo. Il valore predefinito è 30 giorni.
    Modalità di elaborazione

    Seleziona una delle seguenti opzioni per specificare se tutti gli allegati di un messaggio e-mail possono essere elaborati insieme o se ogni allegato deve essere elaborato separatamente:

    • Per allegato – Verrà creato un nuovo documento elettronico per ogni allegato nel messaggio e-mail. Ad esempio, se un messaggio e-mail include più file che contengono dati di una fattura elettronica, ogni file sarà considerato una nuova fattura elettronica.
    • Per e-mail – Un allegato sarà considerato un allegato di base e una fattura elettronica verrà creata nel sistema. Altri allegati possono essere utilizzati come file di supporto.

  9. Nella sezione Filtro allegati, aggiungi le informazioni sul filtro dei file. Vengono elaborati solo gli allegati che soddisfano il filtro definito. Ad esempio, *.xml filtra gli allegati con estensione del nome file .xml. Il nome dell'allegato viene utilizzato in Dynamics 365 Finance o Dynamics 365 Supply Chain Management durante la configurazione.

    • Se imposti il campo Modalità di elaborazione su Per e-mail nel passaggio precedente, puoi aggiungere più filtri qui. Il nome identifica il documento specifico.
    • Se imposti il campo Modalità di elaborazione su Per allegato, puoi aggiungere un solo filtro.

  10. Nella scheda Regole di applicabilità, esaminare e aggiornare i criteri in base alle necessità. Il valore del campo Canale deve essere uguale al valore che hai inserito nel campo Canale dati nel passaggio 8.

  11. Selezionare Salva, quindi chiudere la pagina.