Session Audit File

Navigation:  eXite Core System > Communication >

Session Audit File

Previous pageReturn to chapter overviewNext page

General Information

At the end of every communication session eXite® provides a Session Audit File (SAF). This XML file includes general information about the file itself, detailed information about all transmitted interchanges and a session summary.

 

Examples

 

positive

The excerpt below shows an example of a SAF.

<?xml version="1.0" encoding="UTF-8"?>

<ProtocolInfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocat...

 <JobRef>

   <ProtocolDate>2007-09-20</ProtocolDate>

   <ProtocolTime>13:31:45</ProtocolTime>

   <SessionRef>734256</SessionRef>

   <SessionStatus>OK</SessionStatus>

 </JobRef>

 <ProtocolDescription>

   <Interchange>

     <ExiteICID>070920309324</ExiteICID>

     <CustomerICID>7845645</CustomerICID>

     <From>SYSADMIN01</From>

     <To>SYSADMIN01</To>

     <DateIn>2007-09-20</DateIn>

     <TimeIn>13:31:45</TimeIn>

     <SizeInBytes>2534</SizeInBytes>

     <GatewayData>N</GatewayData>

     <MessageClass>ORDERS</MessageClass>

   </Interchange>

   <Interchange>

     <ExiteICID>070920309323</ExiteICID>

     <CustomerICID>745675</CustomerICID>

     <From>SYSADMIN01</From>

     <To>SYSADMIN01</To>

     <DateIn>2007-09-20</DateIn>

     <TimeIn>13:31:44</TimeIn>

     <SizeInBytes>2000</SizeInBytes>

     <GatewayData>N</GatewayData>

     <MessageClass>ORDERS</MessageClass>

   </Interchange>

 </ProtocolDescription>

 <SessionAccounting>

   <SizeInBytes>4534</SizeInBytes>

   <NumberOfInterchanges>2</NumberOfInterchanges>

 </SessionAccounting>

 <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">

   <SignedInfo>

     <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#With...

     <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>

     <Reference URI="">

       <Transforms>

         <Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>

       </Transforms>

       <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>

       <DigestValue>OJNVYrhLeO7dhYFOAu5rnnCoGdk=</DigestValue>

     </Reference>

   </SignedInfo>

   <SignatureValue>Ix3cwJYKvO5m0uWfcuM4BoEm+0OA2I/xht+K5ygZeP8mz7VRNp96YRV8OKUKDN4pvqya0UEcS...

   <KeyInfo>

     <X509Data>

       <X509Certificate>MIIE4DCCA8igAwIBAgIDAuP5MA0GCSqGSIb3DQEBBQUAMIGfMQswCQYDVQQGEwJBVDFIM...

     </X509Data>

   </KeyInfo>

 </Signature>

</ProtocolInfo>

 

negative

The excerpt below shows a SAF example of a negative sending session. The receiver was unknown, so additional error tags were created. They show the error severity, error code and an error description. Additionally the session sum is 0, because nothing was successfully transmitted.

<?xml version="1.0" encoding="UTF-8"?>

<ProtocolInfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocat...

 <JobRef>

   <ProtocolDate>2007-09-20</ProtocolDate>

   <ProtocolTime>15:34:45</ProtocolTime>

   <SessionRef>767210</SessionRef>

   <SessionStatus>OK</SessionStatus>

 </JobRef>

 <ProtocolDescription>

   <Interchange>

     <ExiteICID>070920309576</ExiteICID>

     <CustomerICID>987654321</CustomerICID>

     <From>SYSADMIN01</From>

     <To>SYSADMIN02</To>

     <DateIn>2007-09-20</DateIn>

     <TimeIn>15:34:45</TimeIn>

     <SizeInBytes>0</SizeInBytes>

     <GatewayData>N</GatewayData>

     <MessageClass>ORDERS</MessageClass>

     <Error>

       <ErrorSeverity>70</ErrorSeverity>

       <ErrorType>EDI210D</ErrorType>

       <ErrorText>^INVALID RECIPIENT ADDRESS</ErrorText>

     </Error>

   </Interchange>

 </ProtocolDescription>

 <SessionAccounting>

   <SizeInBytes>0</SizeInBytes>

   <NumberOfInterchanges>0</NumberOfInterchanges>

 </SessionAccounting>

 <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">

   <SignedInfo>

     <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#With...

     <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>

     <Reference URI="">

       <Transforms>

         <Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>

       </Transforms>

       <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>

       <DigestValue>OJNVYrhLeO7dhYFOAu5rnnCoGdk=</DigestValue>

     </Reference>

   </SignedInfo>

   <SignatureValue>Ix3cwJYKvO5m0uWfcuM4BoEm+0OA2I/xht+K5ygZeP8mz7VRNp96YRV8OKUKDN4pvqya0UEcS...

   <KeyInfo>

     <X509Data>

       <X509Certificate>MIIE4DCCA8igAwIBAgIDAuP5MA0GCSqGSIb3DQEBBQUAMIGfMQswCQYDVQQGEwJBVDFIM...

     </X509Data>

   </KeyInfo>

 </Signature>

</ProtocolInfo>

 

Field Descriptions

 

Tag Name

Occurence

Description

Type

Codes

<ProtocolInfo>

1

head tag including namespace and schema definitions



<JobRef>

1

general session information



<ProtocolDate>

1

session audit file generation date

date


<ProtocolTime>

1

session audit file generation time

time


<SessionRef>

1

session reference number created by eXite®

an 6


<SessionStatus>

1

session status

an 5

OK, ERROR

</JobRef>





<ProtocolDescription>

1

includes all the transmitted interchanges



<Interchange>

1 - ∞

starting tag for each transmitted interchange



<ExiteICID>

1

eXite® internal interchange ID

an 12


<CustomerICID>

1

UNB Refererence number of the transmitted interchange

an 14


<From>

1

sender GLN of the transmitted interchange

an 15


<To>

1

receiver GLN of the transmitted interchange

an 15


<DateIn>

1

date, when the interchange was sent to eXite®

date


<TimeIn>

1

time, when the interchange was sent to eXite®

time


<DateOut>

0 - 1

date, when the interchange was received from eXite®

date


<TimeOut>

0 - 1

time, when the interchange was received from eXite®

time


<SizeInBytes>

1

size of the transmitted interchange in bytes

n unsignedInt


<GatewayData>

1

was the interchange sent / received via a gateway (non-eXite® partner)

an 1

Y…Yes, N…No

<MessageClass>

1

message class / type used in EDIFACT UNB envelope

an 15


<Error>

0 - 1

trigger if an error occured



<ErrorSeverity>

1

error severity

n 2


<ErrorType>

1

type of error as code

an 7


<ErrorText>

1

plain error text

an 512


</Error>





</Interchange>





</ProtocolDescription>





<SessionAccounting>

1

overall session information



<SizeInBytes>

1

sum of all successful interchange sizes in bytes within the session

n unsignedInt


<NumberOfInterchanges>

1

total number of all successful interchanges within the session

n unsignedInt


</SessionAccounting>





<Signature>

1

standard XML signature tags



</Signature>





</ProtocolInfo>





         

 

Terms

ointerchange: UNB-UNZ

oGLN: Global Location Number

oan: alphanumeric

on: numeric