This file requires modification to work with your application
File Layout
Node: openas2
Node: certificates
Attributes
classname
describes the Java class to process the certificate file. for example:
com.helger.as2.cert.CertificateFactory
type
defines the file type of the file containing the certificates for example:
pkcs12 or jks or
filename
defines the file name containing the certificates for example:
%home%\certs.p12
password
opens the file using this password for example: test
interval
describes how often the file should be check up for updates. Specified in seconds. for
example: 300
Node: partnerships Describes the OpenAS2 classes to handle the trading partner
identifications.
Attributes
classname
describes the Java class to process the partnerships file for example:
com.helger.as2.partner.XMLPartnershipFactory
defines the file name containing the partnerships definitions
describes for example: %home%\partnerships.xml
Node: commands Describes the OpenAS2 command classes to use
Attributes
classname
describes the Java class to process the command file for more information see Command File for example:
com.helger.as2.app.XMLCommandRegistry
filename
defines the name of the file command all possible commands for example:
%home%\commands.xml
Node: processor Describes the OpenAS2 class to handle the message processors.
Attributes
classname
describes the default Java class to handle outgoing message for example:
com.helger.as2.processor.DefaultProcessor
Node: module Module that sends out AS2 messages.
Attributes
classname
describes the Java class to send outgoing Messages for example:
com.helger.as2.processor.sender.AS2SenderModule
retry
defines the number of attempts for sending a message,default is -1 aka infinite. for
example retries="3" will stop sending the message after 3 failures.
connecttimeout
defines the millisecond count before a connection times out. default value is 30000 or 30 seconds.
for example connecttimeout="60000" will time out after 60 seconds.
readtimeout
defines the millisecond count before a read times out. default value is 30000 or 30 seconds. for
example readtimeout="60000" will time out after 60 seconds.
Node: module Module that sends out AS2 MDNs asynchronously.
Attributes
classname
describes the Java class to send asynch MDN for example:
com.helger.as2.processor.sender.AsynchMDNSenderModule
retry
defines the number of attempts for sending a message, default value is -1 (infinite.) for
example retries="3" will stop sending the message after 3 failures.
connecttimeout
defines the millisecond count before a connection times out. default value is 30000 or 30 seconds.
for example connecttimeout="60000" will time out after 60 seconds.
readtimeout
defines the millisecond count before a read times out. default value is 30000 or 30 seconds. for
example readtimeout="60000" will time out after 60 seconds.
Node: module The following will describe a module to process outgoing message
placed in a generic directory. The module determines the receiver and send from the file name placed in
the directory (see format attribute). This module will look for files in
specified directory and file names to send to the default message processor.
Attributes
classname
describes the Java class to process files to be sent to the AS2SenderModule for its delivery
process. for example:
com.helger.as2.processor.receiver.AS2DirectoryPollingModule
outboxdir
defines the directory where files are to be found. for example:
%home%\toAny
errordir
defines directory where files containing errors are redirected to. for example:
%home%\toAny\error
interval
describes how often the directory is to be checked for work. Specified in seconds. Default is 30
seconds. for example: 5
delimiters
defines the characters used to parse the incoming file name. Characters are separate the tokens:
sender, receiver and file id. for example: -.
describes the file name by the tokens sender, receiver and file id. May be in any order. Sender id
and receiver id are as defined in the partnership.xml file. for example:
sender.as2_id, receiver.as2_id, attributes.fileid or attributes.mimetype,
attributes.mimesubtype, sender.name, receiver.name
mimetype
describes the outgoing message mime message type. for example:
application/EDI-X12
Node: module
Attributes
classname
describes the Java class to process files for a particular trading partner that are sent to the
AS2SenderModule for its delivery process. for example:
com.helger.as2.processor.receiver.AS2DirectoryPollingModule
outboxdir
defines the directory where outgoing message are defined. for example:
%home%\toOpenAS2A\
errordir
defines the directory where erroneous messages are left. for example:
%home%\toOpenAS2A\error
interval
describes how often the incoming directory is searched. Defined in seconds, default is 30 seconds.
for example: 5
defaults
describes the AS2 sender and receiver ids as defined in the partnership.xml file. for
example: defaults="sender.as2_id=OpenAS2A, receiver.as2_id=OpenAS2B"
protocol
describes the AS2 protocol, which is AS2. for example: as2
mimetype
describes the outgoing message mime message type. for example:
application/EDI-X12
Node: module
Attributes
classname
describes the Java class to process incoming MDNs for example:
com.helger.as2.processor.storage.MDNFileModule
filename
describes for example:
%home%\mdn\$date.uuuu$\$date.MM$\$mdn.msg.sender.as2_id$-$mdn.msg.receiver.as2_id$-$mdn.msg.headers.message-id$
protocol
describes for example: as2
tempdir
describes for example: %home%\temp
Node: module Defines the module to handle messages.
Attributes
classname
describes the Java class to process and store incoming messages for example:
com.helger.as2.processor.storage.MessageFileModule
filename
describes the location and formatted filename of the stored MDNs. for example:
%home%\inbox\$msg.sender.as2_id$-$msg.receiver.as2_id$-$msg.headers.message-id$
protocol
describes the AS2 protocol for example: as2
tempdir (Optional)
defines temporary directory used to store MDNs during message processing. for example:
%home%\temp
Node: module
Attributes
classname
describes the Java class to process handle incoming modules for example:
com.helger.as2.processor.receiver.AS2ReceiverModule
port
defines the port the server listens on. for example: 10080
errordir
defines directory where invalid incoming messages are stored. for example:
%home%\inbox\error
errorformat
defines the format of filenames for invalid incoming messages. for example:
sender.as2_id, receiver.as2_id, headers.message-id
Node: module
Attributes
classname
describes the Java class to rehandle messages for example:
com.helger.as2.processor.resender.DirectoryResenderModule
resenddir
defines the directory to find message to resend for example: %home%\resend
errordir
defines the director to store resend messages that are in error. for example:
%home%\resend\error
resenddelay
defines the wait time between resends. Defined in seconds. Default is 60. for example:
600
This file requires modification to work with your application
File Layout
Node: partnerships The root node.
Node: partner partner definition Attributes
name
partner name as defined in OpenAS2 configuration file. OpenAS2A
as2_id
partner name as defined in partnership node OpenAS2A
x509_alias
Alias as defined in certificate file OpenAS2A
email
E-mail address of partner as2a@MySillyMailerServer.com
Node: partnership defines partner relationships between sender and receiver
Node: partnership Attributes
name
Unique name of partnership relation. See filename parsing above.
OpenAS2A-OpenAS2B
Node: sender Attributes
name
Unique name of Sender OpenAS2A
Node: receiver Attributes
name
Unique name of receiver OpenAS2B
The following is a list of nodes that use the node name of attribute. The subnodes of
attribute use a name/value node naming pair structure.
Node: attribute name is protocol defines the protocol to
use with this partner. value is as2
name="protocol" value="as2"
Node: attribute name is subject defines text used in E-mail
subject line value name="subject" value="From OpenAS2A to
OpenAS2B"
Node: attribute name is as2_url defines partners AS2
server's URL value name="as2_url"
value="http://www.MyPartnerAS2Machine.com:10080"/>
Node: attribute name is as2_mdn_to defines MDN server's
URL value name="as2_url"
value="http://www.MyPartnerAS2Machine.com:10080" name="as2_mdn_to"
value="http://www.MyAS2Machine.com:10081"
Node: attribute name is as2_receipt_option
defines asynchronous MDN server's URL value
name="as2_receipt_option" value="http://www.MyAS2Machine.com:10081"
Node: attribute name is as2_mdn_options
defines MDN option values for E-mail header value
name="as2_mdn_options" value="signed-receipt-protocol=optional, pkcs7-signature;
signed-receipt-micalg=optional, sha1"
Node: attribute name is encrypt defines
encrypting algorithm name for E-mail header value
name="encrypt" value="3des"
Node: attribute (optional) name is
content_type_encoding defines what the header field should display
value 8bit (default), binary, ...
name="content_transfer_encoding" value="binary"