Tenere traccia delle comunicazioni B2B in Microsoft Operations Management Suite (OMS)

Dopo avere configurato la comunicazione B2B tra due processi o applicazioni aziendali in esecuzione tramite l'account di integrazione, tali entità possono scambiarsi messaggi. Per controllare se questi messaggi vengono elaborati correttamente, è possibile tenere traccia dei messaggi AS2, X12 ed EDIFACT con Azure Log Analytics in Operations Management Suite (OMS). È ad esempio possibile usare queste funzionalità di rilevamento basate sul Web per tenere traccia dei messaggi:

  • Conteggio e stato dei messaggi
  • Stato degli acknowledgment
  • Correlare i messaggi con i riconoscimenti
  • Descrizione dettagliata degli errori
  • Funzionalità di ricerca

Requisiti

Nota

Dopo avere soddisfatto i requisiti precedenti, sarà presente un'area di lavoro in Operations Management Suite (OMS). È consigliabile usare la stessa area di lavoro di OMS per tenere traccia delle comunicazioni B2B in OMS.

Se non si ha un'area di lavoro di OMS, vedere come crearne una.

Aggiungere la soluzione B2B di App per la logica a Operations Management Suite (OMS)

Per fare in modo che OMS tenga traccia dei messaggi B2B per l'app per la logica, è necessario aggiungere la soluzione App per la logica B2B al portale di OMS. Informazioni sull'aggiunta di soluzioni a OMS.

  1. Nel portale di Azure scegliere Altri servizi. Cercare "Log Analytics" e quindi scegliere Log Analytics, come illustrato qui:

    Trovare Log Analytics

  2. In Log Analytics trovare e selezionare l'area di lavoro di OMS.

    Selezionare l'area di lavoro di OMS

  3. In Gestione scegliere Portale di OMS.

    Scegliere Portale di OMS

  4. Quando si apre la home page di OMS, scegliere Raccolta soluzioni.

    Scegliere Raccolta soluzioni

  5. In Tutte le soluzioni trovare e scegliere App per la logica B2B.

    Scegliere App per la logica B2B

  6. In App per la logica B2B scegliere Aggiungi.

    Scegliere Aggiungi

    Nella home page di OMS viene ora visualizzato il riquadro Messaggi per le app per la logica B2B. Questo riquadro aggiorna il numero di messaggi B2B quando vengono elaborati.

    Home page di OMS, riquadro Messaggi per le app per la logica B2B

Tenere traccia dello stato e dei dettagli dei messaggi in Operations Management Suite

  1. Dopo che i messaggi B2B sono stati elaborati, è possibile visualizzarne lo stato e i dettagli. Nella home page di OMS scegliere il riquadro Messaggi per le app per la logica B2B.

    Numero di messaggi aggiornato

    Nota

    Per impostazione predefinita, il riquadro Messaggi per le app per la logica B2B visualizza i dati relativi a un solo giorno. Per impostare l'ambito dei dati su un intervallo diverso, scegliere il controllo dell'ambito nella parte superiore della pagina di OMS:

    Modificare l'ambito dei dati

  2. Quando viene aperto il dashboard con lo stato dei messaggi, è possibile visualizzare altri dettagli per un tipo di messaggio specifico, con i dati relativi a un solo giorno. Scegliere il riquadro AS2, X12 o EDIFACT.

    Visualizzare lo stato dei messaggi

    Un elenco di messaggi viene visualizzato per il riquadro scelto. Per altre informazioni sulle proprietà di ogni tipo di messaggio, vedere queste descrizioni delle proprietà dei messaggi:

    Ecco, ad esempio, come può risultare un elenco di messaggi AS2:

    Visualizzare i messaggi AS2

  3. Per visualizzare o esportare gli input e gli output di messaggi specifici, selezionare i messaggi e scegliere Scarica. Quando richiesto, salvare il file ZIP nel computer locale e quindi estrarre il file.

    La cartella estratta include una cartella per ogni messaggio selezionato. Se si configurano gli acknowledgement, la cartella del messaggio include anche i file con i dettagli degli acknowledgement. Ogni cartella di messaggio include almeno questi file:

    • File leggibili con i dettagli dei payload di input e dei payload di output
    • File codificati con gli input e gli output

    Per ogni tipo di messaggio, è possibile trovare i formati dei nomi di file e cartelle qui:

    Scaricare i file dei messaggi

  4. Per visualizzare tutte le azioni con lo stesso ID esecuzione, nella pagina Ricerca log scegliere un messaggio dall'elenco di messaggi.

    È possibile ordinare queste azioni per colonna o cercare risultati specifici.

    Azioni con lo stesso ID esecuzione

Descrizioni delle proprietà e formati di nome per i messaggi AS2, X12 ed EDIFACT

Per ogni tipo di messaggio, di seguito sono elencate le descrizioni delle proprietà e i formati dei nomi per i file di messaggi scaricati.

Descrizioni delle proprietà dei messaggi AS2

Ecco le descrizioni delle proprietà per ogni messaggio AS2.

Proprietà Descrizione
Mittente Partner guest specificato in Impostazioni di ricezione o partner host specificato in Impostazioni di invio di un accordo AS2
Ricevitore Partner host specificato in Impostazioni di ricezione o partner guest specificato in Impostazioni di invio di un accordo AS2
App per la logica App per la logica in cui sono configurate le azioni AS2
Stato Stato dei messaggi AS2
Operazione completata = ricevuto o inviato un messaggio AS2 valido. Non sono configurate notifiche sulla ricezione del messaggio.
Operazione completata = ricevuto o inviato un messaggio AS2 valido. La notifica sulla ricezione del messaggio è stata configurata e ricevuta o è stata inviata.
Operazione non riuscita = ricevuto un messaggio AS2 non valido. Non sono configurate notifiche sulla ricezione del messaggio.
In sospeso = ricevuto o inviato un messaggio AS2 valido. La notifica sulla ricezione del messaggio è stata configurata ed è prevista.
Ack Stato dei messaggi di notifica sulla ricezione del messaggio
Accettato = ricevuto o inviato un messaggio di notifica sulla ricezione del messaggio positivo.
In sospeso = in attesa di ricevere o inviare un messaggio di notifica sulla ricezione del messaggio.
Rifiutato = ricevuto o inviato un messaggio di notifica sulla ricezione del messaggio negativo.
Non richiesto = notifica sulla ricezione del messaggio non configurata nell'accordo.
Direzione Direzione dei messaggi AS2
ID correlazione ID che correla tutti i trigger e le azioni in un'app per la logica
ID del messaggio ID del messaggio AS2 dalle intestazioni del messaggio AS2
Timestamp Ora in cui l'azione AS2 ha elaborato il messaggio

Formati dei nomi AS2 per i file di messaggi scaricati

Ecco i formati dei nomi per ogni cartella e file di messaggi AS2 scaricati.

File o cartella Formato del nome
Cartella del messaggio [mittente]_[destinatario]_AS2_[ID-correlazione]_[ID-messaggio]_[timestamp]
File di input, output e, se configurati, acknowledgement Payload di input: [mittente]_[destinatario]_AS2_[ID-correlazione]_input_payload.txt

Payload di output: [mittente]_[destinatario]_AS2_[ID-correlazione]_output_payload.txt

Input: [mittente]_[destinatario]_AS2_[ID-correlazione]_inputs.txt

Output: [mittente]_[destinatario]_AS2_[ID-correlazione]_outputs.txt

Descrizioni delle proprietà dei messaggi X12

Ecco le descrizioni delle proprietà per ogni messaggio X12.

Proprietà Descrizione
Mittente Partner guest specificato in Impostazioni di ricezione o partner host specificato in Impostazioni di invio di un accordo X12
Ricevitore Partner host specificato in Impostazioni di ricezione o partner host specificato in Impostazioni di invio di un accordo X12
App per la logica App per la logica in cui sono configurate le azioni X12
Stato Stato dei messaggi X12
Operazione completata = ricevuto o inviato un messaggio X12 valido. Non sono configurati ack funzionali.
Operazione completata = ricevuto o inviato un messaggio X12 valido. L'ack funzionale è stato configurato e ricevuto o inviato.
Operazione non riuscita = ricevuto o inviato un messaggio X12 non valido.
In sospeso = ricevuto o inviato un messaggio X12 valido. L'ack funzionale è stato configurato ed è previsto.
Ack Stato ACK funzionale (997)
Accettato = ricevuto o inviato un ack funzionale positivo.
Rifiutato = ricevuto o inviato un ack funzionale negativo.
In sospeso = in attesa di un ack funzionale non ricevuto.
In sospeso = ack funzionale generato, ma impossibile inviarlo al partner.
Non richiesto = ack funzionale non configurato.
Direzione Direzione dei messaggi X12
ID correlazione ID che correla tutti i trigger e le azioni in un'app per la logica
Tipo di messaggio Tipo di messaggio EDI X12
ICN Numero di controllo interscambio del messaggio X12
TSCN Numero di controllo del set di transazioni del messaggio X12
Timestamp Ora in cui l'azione X12 ha elaborato il messaggio

Formati dei nomi X12 per i file di messaggi scaricati

Ecco i formati dei nomi per ogni cartella e file di messaggi X12 scaricati.

File o cartella Formato del nome
Cartella del messaggio [mittente]_[destinatario]_X12_[numero-controllo-interscambio]_[numero-controllo-globale]_[numero-controllo-set-transazioni]_[timestamp]
File di input, output e, se configurati, acknowledgement Payload di input: [mittente]_[destinatario]_X12_[numero-controllo-interscambio]_input_payload.txt

Payload di output: [mittente]_[destinatario]_X12_[numero-controllo-interscambio]_output_payload.txt

Input: [mittente]_[destinatario]_X12_[numero-controllo-interscambio]_inputs.txt

Output: [mittente]_[destinatario]_X12_[numero-controllo-interscambio]_outputs.txt

Descrizioni delle proprietà dei messaggi EDIFACT

Ecco le descrizioni delle proprietà per ogni messaggio EDIFACT.

Proprietà Descrizione
Mittente Partner guest specificato in Impostazioni di ricezione o partner host specificato in Impostazioni di invio di un accordo EDIFACT
Ricevitore Partner host specificato in Impostazioni di ricezione o partner guest specificato in Impostazioni di invio di un accordo EDIFACT
App per la logica App per la logica in cui sono configurate le azioni EDIFACT
Stato Stato dei messaggi EDIFACT
Operazione completata = ricevuto o inviato un messaggio EDIFACT valido. Non sono configurati ack funzionali.
Operazione completata = ricevuto o inviato un messaggio EDIFACT valido. L'ack funzionale è stato configurato e ricevuto o inviato.
Operazione non riuscita = ricevuto o inviato un messaggio EDIFACT non valido
In sospeso = ricevuto o inviato un messaggio EDIFACT valido. L'ack funzionale è stato configurato ed è previsto.
Ack Stato ACK funzionale (997)
Accettato = ricevuto o inviato un ack funzionale positivo.
Rifiutato = ricevuto o inviato un ack funzionale negativo.
In sospeso = in attesa di un ack funzionale non ricevuto.
In sospeso = ack funzionale generato, ma impossibile inviarlo al partner.
Non richiesto = ack funzionale non configurato.
Direzione Direzione dei messaggi EDIFACT
ID correlazione ID che correla tutti i trigger e le azioni in un'app per la logica
Tipo di messaggio Tipo di messaggio EDIFACT
ICN Numero di controllo interscambio del messaggio EDIFACT
TSCN Numero di controllo del set di transazioni del messaggio EDIFACT
Timestamp Ora in cui l'azione EDIFACT ha elaborato il messaggio

Formati dei nomi EDIFACT per i file di messaggi scaricati

Ecco i formati dei nomi per ogni cartella e file di messaggi EDIFACT scaricati.

File o cartella Formato del nome
Cartella del messaggio [mittente]_[destinatario]_EDIFACT_[numero-controllo-interscambio]_[numero-controllo-globale]_[numero-controllo-set-transazioni]_[timestamp]
File di input, output e, se configurati, acknowledgement Payload di input: [mittente]_[destinatario]_EDIFACT_[numero-controllo-interscambio]_input_payload.txt

Payload di output: [mittente]_[destinatario]_EDIFACT_[numero-controllo-interscambio]_output_payload.txt

Input: [mittente]_[destinatario]_EDIFACT_[numero-controllo-interscambio]_inputs.txt

Output: [mittente]_[destinatario]_EDIFACT_[numero-controllo-interscambio]_outputs.txt

Passaggi successivi