1. FileSender

The FileSender is a stand alone program to monitor as many directories you like and if files appear within, then the sender will take them and send them either into a destination directory and/or to a certain port and/or as an attachment via e-mail. On success, the source files are afterwards deleted.

Filesender supports as many projects as you like. The definitions are stored into the filesend.ini file in the W-ELP directory.

Every project has got a unique name which can be entered into the project field.


The default and general mode of operation:

Each matched file found in the surveiled folder project can be

  • Moved into an other directory keeping the same file name
  • Send to a special port, like an ELP activated windows queue
  • Send to a persons by provided static e-mail addresses
  • Call any other software and hand over the actual file

Please define a source directory, which is monitored. It is possible to specify a filename directly or groups of files by the "*"-char (e.g. "d:\temp\*.txt"). To move all files from one directory to another the string "*.*" must be used (like "c:\temp\*.*") .

Valid source or destination paths are as well full network addresses with two precedent backslashes (e.g. "\\192.168.0.1\directory"). Missing directories are automatically created.

Then you must define minimum one of the 4 possibilities.

1. Destination directory where the incoming files are stored 1:1 including an unchanged file name, existing files are not overwritten, ELP does add a version counter to the file.

2. A port name, where the file(s) is/are copied. Maybe a W-ELP monitored printer queue.

When a port name is entered, you can specify the amount of copies you want to have and any print file as copy separator. To generate the print file, simply print for example a MS Word document to file, drawing the paper form a specific (colored) paper tray.

If instead of a number the copy field contains a character, the software then will search in the first found filename for this provided character from left to right and convert the value behind this character into the copy counter. E.g. You enter - in the field, so if the first file in the directory will be aaa-2bbb.pdf, then the file sender will generate 2 copies.
The default counter is 1.

A cover page is printed in front of every first job per process ru per directory scanned

The separator job is printed after minimum one file was processed out of a scanned directory

The Port has to be ELP activated, as FileSender does include an ELP command header to the sent file with this content:

[GLOBAL]
Variable=#FS_COPYCOUNTER#:value
Variable=#FS_TOTALCOPYCOUNTER#:value
Variable=#FS_FILENAME#:FileName

3. addresses, separated by comma:

If one is provided, ELP will send out the file as an e-mail attachment. In order to use this, the e-mail client blat must be configured in the PPAdmin control center: PPAdmin - Admin - Configure and after that enter some e-mail addresses in the field and test the correct sending out the test mail. Don't forget to Apply the changes.

The Body text can be variable and the text itself can be define din the filesender.ini file, section Main key Bodytext=aaaaaaaa.

4. call software

option field can be any available program call be added. The processed file name, including its full path will be added at the end of the command line. If needed within a command line, please call a batch file and within the requested application.
Cover and separator pages can be generated by simply printing a job to file. However, you may need to set the paper tray settings if needed before printing the page.

 

The internal order of processing for the 4 different "Send to" options is:

  1. e-mail
  2. call software
  3. send to directory
  4. send to shared printer queue


Example: Monitor a directory, and call for each stored PDF the acrobat reader and print the PDF to a requested queue:

1. The configuration file of FileSender. filesender.ini

[MAIN]

; Main filesender settings for logging and sleep time

Debug=ON
Sleep=10

[Notarissen]

; Settings for project Notarissen (No Separator Jobs, no copies, no cover page

CoverPage=
SepJob=
Copies=

; Monitor all files appearing in directory Source=D:\notarissen\incoming\ with the name pattern 2011_*.pdf

Source=D:\notarissen\incoming\2011_*.pdf

; Call a batch file to call Acrobat Reader to print the PDF.
; Note FileSender adds automatically the processed file name after the given command line

CallCommand=D:\notarissen\printme.bat

; Finally move the PDF file into a storage folder

Destination=D:\notarissen\archive\2011


2. The configuration of the batch file D:\notarissen\printme.bat calling Acrobat reader

rem call the reader with the following command line parameters
rem /N Open a PDF file in a new instance of Adobe Reader
rem /T Print a PDF file silently
rem %1 is the first command line operator (Print file)
rem ELP_IN is the printer driver

"C:\Program Files\Adobe\Reader 11.0\Reader\AcroRd32.exe" /N /T %1 ELP_IN

The Operation modes of FileSender are:

Timeing: The sleep time in seconds is the time between two times of checking within all projects, if their the source path contain any files.
If the interval is larger the 9 seconds then the sleep for cheking the STOP event is 2 seconds, otherwise the button is checked every second.
In between the process is slepping and does not take any system resources.

Autostart: Add to the command line the switch /R and FileSender will start directly when called.

Autoexit: (not jet described)

2. The software is also available on request as a service: FileSender Service

The FileSender is also available as a windows service, but it is not included in the standard delivery. Feel free to ask for it. The FileSender service does use the exact same configuration as the regular filesender software.

So before you start the service, be sure that you have configured the previously described FileSender application, and be sure that it works the way its needed.

Installing filesender as service

  1. Extract the filesender_service.zip to a folder
  2. Copy the filesend.ini file from the WELP directory into this new directory.
  3. Start a command prompt as an administrator and navigate to this directory.
  4. Type: fs_service /i then press ENTER. The service is installed.

Starting and stopping the service

    1. Start a command prompt as an administrator and navigate to the filesender directory.
      Type: fs_service /s then press ENTER. The service is started.

 

  1. Start a command prompt as an administrator and navigate to the filesender directory.
    Type: fs_service /q then press ENTER. The service is stopped.

Uninstalling filesender service

  1. Start a command prompt as an administrator and navigate to the filesender directory.
  2. Type: fs_service /u then press ENTER. The service is stopped and uninstalled.

Notes:

  • After registration, the filesender service is set to AUTOSTART, but not STARTED. Use fs_service /s or the windows service software to start it, or simply restart the PC
  • You can run both versions simulatinously, but it is not really recommended.
  • If both software use the same ini-file, then you can use the FileSender software to modify the inifile. The modification is then immediately used, after the next wait time is over. Either with the software or by the sender.


3. Filesender in the DSS Workflow folder operation mode:

Most HP MFP printers can scan and store the pages as PDF files in a server directory. The file comes along with a XML index file, which holds the information, who did scan and which operation mode is requested.

For both described modes below, the "Form Path" setting in the menu does only allow to search for XML files, e.g. C:\DSS_ScanFolder\*.xml

Once this mode is activated, FileSender behaves quite different. The fields ports and e-mail are not active and FileSender performs up to those 2 modes which are without any additional configuration detected by those 2 entries in the XML file:

1. Destination Name="HOME" for Send2Folder (S2F) in the users home folder
2. Destination Name="EMAIL" for Send2eMail (S2E) sending it to the users e-mail account.


The search tags can be freely defined, which is described below that document.

3.1. Sending the stored file to a user directory S2F.

The user name is always taken from the XML file, tag: <Sender Name="Name">.

The move destination is defined in the menu Directory field. The field must contain this variable definition: $USERNAME$, which then is automatically replaced by the username (Sender name) from the XML file.

A possible entry of the directory field is: \\SRV1\Home\$USERNAME$\Scans

In order to activate the file move from the menu "From Path", the XML file must contain by default without any configuration the tag: Destination Name="HOME" and FileSender assumes the document extention as *.PDF.

Now Filesender monitors all new XML files in the From Path, opens the XML file and if the two described tages are found, the XML file is deleted and the corresponding PDF file is stored in the Users Home directory.

Again, this are the default requirements for S2F mode:

  1. *.XML searching in the from path,
  2. the two entries in the XML file
    Destination Name="HOME" and
    <Sender Name="Name">
  3. and the $USERNAME$ definition in the directory path.

3.2. Sending the stored file to a user by e-mail. S2E

The user name e-mail address is taken from the XML file, tag <SenderAddress="Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein!">.

In order to activate the file e-mail sending, the XML file must contain if no additional configuration is made the tag: Destination Name="EMAIL"

Now Filesender monitors all new XML files in the From Path, opens the XML file and if the 2 described tages are found, the XML file is deleted and the corresponding PDF file send automatically to the users e-mail asdress.

Note: Like described in operation mode Standard, the e-mail client must be setup in the PPAdmin Control Center!

Again, this are the default requirements for S2E mode:

  1. *.XML searching in the from path,
    the two entries in the XML file
    Destination Name="EMAIL" and
    <SenderAddress="Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein!">


3.3 Triggering for your own file types and trigger terms.

As described above, by default the file extention is liked always to *.PDF and the default triggers are the terms Destination Name="HOME" and "email".

This can be freely changed and more types can be added.

Therefore generate in the filesend.ini file opend by e.g. notepad a new section called DSS. The section may contain as may SEARCHTAGS as needed. A SearchTag is a descrition of what the FileSender is looking up in the XM file and if fount what actionneeded to be done a S2F or S2E.
Syntax:
SEARCHTAG=Searchedterm[;FileExtention | ;email[;;FileExtention]]

Searchterm This is what term is searched in the XML file, in order to differenciate the 2 poperationmodes S2F and S2E.
It can be any expression.
The term is normally defined by the printers menue designer

FileExtention If not provided *.PDF is assumed. But if provided the to the xml file corresponding document file needs to have the same extention . Examples for the file EXAMPLE.XML
File Extention Document filename
.PDF EXAMPLE..PDF
.HTML EXAMPLE.HTML
.RTF EXAMPLE..RTF
25.xxx EXAMPLE.25.xxx
E-mail if after the first semicolon the term e-mail is used, then FileSender switches to the S2E mode.

Examples or entries in the DSS section of the FileSend.ini file:

[DSS]
SEARCHTAG=DESTINATION NAME="HOME";.pdf
SEARCHTAG=DESTINATION NAME="EMAIL";email
This representing exactly the default operation, like done, if the section DSS would have not been provided in the infiile

SEARCHTAG=DESTINATION NAME="HOME"
SEARCHTAG=DESTINATION NAME="HOME";.pdf
Is the same, as by default the file extention *.PDF is added

SEARCHTAG=DESTINATION NAME="EMAIL";email
SEARCHTAG=DESTINATION NAME="EMAIL";email;.pdf
Is the same, as by default the file extention *.PDF is added

SEARCHTAG=DESTINATION NAME="HOMERTF";.rtf
Sending an *-.RTF file into the users home folder

SEARCHTAG=DESTINATION NAME="EMAILRTF";email;.rtf
Sending an *.RTF file by e-mail to the user

SEARCHTAG=SENTTIMESTAMP="2006-06;.pdf
Sending a *.PDF file to the User Home directory if the time stamp is June 2006.
Additional notes for DSS Section configuration:

1. You can define as many tags as you like. In the matter 2 for each file type, S2F and S2E.

2. If one tag is performed, the files are moved / send. No second operation will apply on that file.