Classe di esempio dell'estrattore di errori

Il disassembler Microsoft BizTalk Accelerator for SWIFT (A4SWIFT) serializza gli errori in un oggetto XML e collega l'oggetto XML alla sezione di errore di un messaggio multipart. Il disassembler pubblica quindi il messaggio non riuscito nel database MessageBox così come sarebbe un messaggio valido. Di conseguenza, i messaggi non riusciti contengono i dettagli dell'errore nel database MessageBox. È possibile usare la classe di esempio error extractor per estrarre i dettagli dell'errore da un messaggio non riuscito e generare un file con i dettagli dell'errore e un altro file con il messaggio originale.

Importante

La classe di esempio Error Extractor è il codice di esempio nell'SDK. Non è destinato all'uso in produzione.

Per usare la classe di esempio error extractor, è necessario creare un'orchestrazione per elaborare il messaggio non riuscito. Questa orchestrazione include passaggi per estrarre il corpo del messaggio non riuscito, estrarre la parte di errore del messaggio non riuscito e quindi scrivere il corpo e la parte di errore per separare i file XML. L'orchestrazione rappresenta ognuno di questi passaggi in una fase di espressione che chiama uno o più dei metodi seguenti nella classe Di esempio dell'estrattore di errori:

Metodo GetBodyPartAsString

Questo metodo restituisce una stringa contenente il codice XML trovato nella parte del corpo del messaggio XLANG 'xm'. Il metodo prevede che il messaggio XLANG 'xm' contenga una parte del corpo denominata "BodySegment". Pertanto, è necessario dichiarare 'xm' nell'orchestrazione chiamante con questo nome della parte del corpo. Se "BodySegment" non esiste come parte di 'xm', GetBodyPartAsString genera un'eccezione.

SWIFTErrorExtractor.ErrorExtractor.GetBodyPartAsString(XLANGMessage xm);  

Metodo GetErrorPartAsString

Questo metodo restituisce una stringa contenente il codice XML trovato nella parte di errore del messaggio XLANG 'xm'. Il metodo prevede che il messaggio XLANG 'xm' contenga una parte di errore denominata "ErrorSegment". Pertanto, è necessario dichiarare 'xm' nell'orchestrazione chiamante con questo nome della parte di errore. Se "ErrorSegment" non esiste come parte di 'xm', GetErrorPartAsString genera un'eccezione.

SWIFTErrorExtractor.ErrorExtractor.GetErrorPartAsString(XLANGMessage xm);  

WriteToFile, metodo

Questo metodo scrive la stringa dal parametro del messaggio al file specificato dal parametro filePath .

SWIFTErrorExtractor.ErrorExtractor.WriteToFile(string filePath, string message);  

A4SWIFT setup installa la classe di esempio di estrattore di errore (SWIFTErrorExtractor.dll) come parte dell'SDK A4SWIFT nell'unità><:\Programmi\Microsoft BizTalk Accelerator for SWIFT\SDK\Tutorial\SWIFTErrorExtractor. Questa cartella include anche il codice sorgente per la classe di esempio (ErrorExtractor.cs).

Per chiamare SWIFTErrorExtractor.dll dall'orchestrazione, è necessario pubblicare il file di .dll nella global assembly cache.

Vedere anche

Strumenti