Skip to content

Latest commit

 

History

History
150 lines (118 loc) · 5.4 KB

README.md

File metadata and controls

150 lines (118 loc) · 5.4 KB
Raw

TypeBToMail

A simple tool to parse and send type b messages to email.

Getting Started

In case you have never heard of type b messaging, this is a good start! In case you do, this tool will help you a lot.

Prerequisites

You will need the following to have the application running

  • A type b client (which supports STX format)
  • An email account
  • AutoIT

Installing

  1. Use AutoIT to compile typebtomail.au3 to a windows executable.

  2. Copy all files in a folder. E.g C:\typebtomail

  3. Create 4 folders under the folder described in step 2:

    • PARSED e.g C:\typebtomail\PARSED
    • UNPARSED e.g C:\typebtomail\UNPARSED
    • LOG e.g C:\typebtomail\LOG
    • IN e.g C:\typebtomail\IN

Configuring

To configure the application you have to edit the configuration.ini accordingly. This is a sample of the configuration.ini:

[Directories]
IncomingDir=C:\typebtomail\IN
IncomingDirFilter=*.rcv
LogDir=C:\typebtomail\LOG
ParsedDir=C:\typebtomail\PARSED
UnParsedDir=C:\typebtomail\UNPARSED
[TypeB]
AllowedIdentifiers=MVT,LDM,PSM
SmartParser=1
[MailCommunication]
MailServer=smtp.gmail.com
MailPort=465
MailSSL=1
AccountUsername=your@email.com
AccountPassword=youremailpassword
[MailContent]
Importance=Normal
Destination=theemail@destination.com
CCDestination=thecc@destination.com
BCCDestination=
FromName=My Messaging
FromAddress=theemail@sender.com

A description of the elements folows:

Element Description Example(s)
IncomingDir The folder where incoming type b files are produced from your type b client. C:\typebtomail\IN
IncomingDirFilter The wildcard for matching files in IncomingDir. For more information check $sFilter remarks here. *.txt or *.rcv
LogDir The folder where logs of the applications will be stored. C:\typebtomail\LOG
ParsedDir The folder where parsed and transmitted files will be stored. C:\typebtomail\PARSED
UnParsedDir The folder where unparsed and not transmitted files will be stored. C:\typebtomail\UNPARSED
AllowedIdentifiers The comma delimited message identifiers you want to send to email. If you want all messages to be transmitted, then leave this element blank MVT,LDM,PSM
SmartParser A boolean switch for smart removal of headers and subjects before identifier parsing 1 or 0
MailServer The host name of ip of your email server smtp.gmail.com
MailPort The port of your email server 465
MailSSL A boolean switch for your email server's SSL 1 or 0
AccountUsername Your email's account username georgeroubis@gmail.com
AccountPassword The password of your email's account myp@$$w0rd!
Importance The importance of the transmitted email. High/Low/Normal
Destination The email recipient. someone@gmail.com
CCDestination The cc recipient. someoneelse@gmail.com
BCCDestination The bcc recipient. ahidden@gmail.com
FromName The email "From". MyMessagingSvc
FromAddress The email "From Address". georgeroubis@gmail.com

Running

Run your compliled executable (typebtomail.exe). This can be done directly from windows explorer or from cmd or even from a scheduled task manager tool!

If for example you have received a file called incomingtest.rcv under C:\typebtomail\IN with the following content:

=HEADER
RCV,2017/07/21 11:40
=PRIORITY
QK
=DESTINATION TYPE B
STX,TSTXXXX
STX,TSTYYXX
STX,TSTZZXX
=ORIGIN
TSTXXSS
=DBLSIG
XX
=MSGID
123456
=SMI
MVT
=TEXT




XX006/12.SXTST.ATH
ED211140
DL00

run the application and you will see something similar to this in the log files:

2017-07-21 08:45:41;TypeBToMail.v.1.3.au3;0;1 files were found under directory C:\typebtomail\IN.
*****************************************************************************************************************************
2017-07-21 08:45:41;TypeBToMail.v.1.3.au3;0;Attemtping to read file C:\typebtomail\IN\incomingtest.rcv.
2017-07-21 08:45:41;TypeBToMail.v.1.3.au3;0;File C:\typebtomail\IN\incomingtest.rcv is a valid type b message.
2017-07-21 08:45:41;TypeBToMail.v.1.3.au3;0;File C:\typebtomail\IN\incomingtest.rcv parsed. Data were the following:
                    Received On      -> 2017-07-21 11:40
                    COR Indicator    -> 0
                    PDM Indicator    -> 0
                    Originator       -> TSTXXSS
                    Destination(s)   -> TSTXXXX, TSTYYXX, TSTZZXX
                    Message ID       -> 123456
                    Double Signature -> XX
                    Priority         -> QK
                    Identifier       -> MVT
                    Message Matched  -> Identifier matches system configuration.
                    Text             -> [001] -> MVT
                                        [002] -> XX006/12.SXTST.ATH
                                        [003] -> ED211140
                                        [004] -> DL00
2017-07-21 08:45:41;TypeBToMail.v.1.3.au3;0;Starting email transmission.
2017-07-21 08:45:44;TypeBToMail.v.1.3.au3;0;Email message sent successfully.
2017-07-21 08:45:44;TypeBToMail.v.1.3.au3;0;Attemtping to move file C:\typebtomail\IN\incomingtest.rcv to directory C:\typebtomail\PARSED\2017\07\21.
2017-07-21 08:45:44;TypeBToMail.v.1.3.au3;0;File C:\typebtomail\IN\incomingtest.rcv moved to directory C:\typebtomail\PARSED\2017\07\21.

Credits

The following udf has been used:

AutoIT SMTP Mailer by Jos