1. FileSender as application

The FileSender is a standalone program to monitor as many directories as you like and if files appear within, the sender will take them and

  1. send them either into a destination directory
  2. and/or to a certain shared printer queue
  3. and/or as an attachment via e-mail.
  4. and/or any external command line based application as a parameter

On success the source files are afterwards deleted.

FileSender supports as many projects as you like. The definitions are stored in the filesend.ini file in the W-ELP installation folder.

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


The default and general mode of operation:

Each matched file found in the monitored folder project can be

  • Send to a specific shared printer queue (which might be activated in ELP)
  • Moved into an other directory keeping the same file name
  • Send to a static e-mail address
  • Call any other software with the filename as parameter

Please define a source directory for monitoring. It is possible to specify a specific filename or use the wildcard character "*" (e.g. "D:\temp\*.txt"). To move all files from one directory to another the string "*.*" must be used (like "D:\temp\*.*") .

Valid source or destination paths can be defined using network share 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. A shared printer queue, where the file(s) is/are copied to.

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 from 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 and 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 includes an ELP command header to the sent file with this content:

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

2. Destination directory where the incoming files are stored 1:1 including an unchanged file name. Please note that existing files are not overwritten. Instead FileSender adds a version counter to the file.

3. E-mail settings:

Prerequisites: In order to use this feature e-mail must be configured. If you use a W-ELP version from March 2018 or prior then manual adjustments need to be made:

1. Download this file: MailConf_blat.txt

2. Go to the W-ELP Workpath folder (default: c:\ProgramData\Welp) and copy the MailConf_blat.txt to this folder.

3. Rename the file to "MailConf.ini".

4. Adjust the path in the key "EMailProg" to your blat folder.

5. Replace <MAILSERVER> with the IP address of your e-mail server.

6. Replace <FROM> with the e-mail address which is used for sending e-mails.

7. Replace <ADMINEMAIL> with the default e-mail recipient in case of any issues.

8. Save the edited file.

 

E-Mail: If at least one e-mail address is provided FileSender will send the file as an e-mail attachment. Multiple e-mail addresses can be entered separated by <BLANK><COMMA><BLANK>.

Subject: Enter here the e-mail subject which shall be used. You can use the variable #FILENAME#. If you leave this field empty the following default be used: "Ihr OCR-Scanauftrag <FILENAME>".

Body: E-mail body text. Only a single line of text is possible. Variables like #FILENAME# can be used. If this this field is left empty FileSender checks the filesend.ini´s GLOBAL section for the key "Bodytext" and will use it´s value. If this key is not defined a default text will be used: "Information is found in the attachment (c) www.stethos.com".

4. Call software

In the option field any available program call can 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.

If you want to batch print Office documents simply search the web or the link here and here might help you as well.

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 PDF-XChange Editor 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 PDF-XChange Editor 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 PDF-XChange Editor

rem call the reader with the following command line parameters
rem %1 is the first command line operator (Print file)
rem ELP_IN is the name of an existing Windows Printer Queue

"C:\Program Files\Tracker Software\PDF Editor\PDFXEdit.exe" /printto ELP_IN %1

 

The operation modes of FileSender as application are:

Timing: 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 checking the STOP event is 2 seconds, otherwise the button is checked every second.
In between the process is sleeping and does not take any system resources.

Auto start: run the FileSender.exe with the additional /R parameter and the application will start monitoring right after it is called.

 

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 package. Feel free to ask for it. The FileSender service uses the exact same configuration as the regular FileSender software.

So before you start the service ensure that you have configured the previously described FileSender application, and make sure that it works the way it´s needed.

Installing FileSender as service

  1. Run the FileSender-<VERSION>.msi. It will install the service into W-ELP installation directory (usually C:\Program Files (x86)\WELP\ )
  2. In addition the installer will register and start the service automatically.

Starting and stopping the service

  1. Start a command prompt as an administrator and navigate to the FileSender directory.
  2. Type: fs_service /s then press ENTER. The service is started.
  3. Start a command prompt as an administrator and navigate to the FileSender directory.
  4. Type: fs_service /q then press ENTER. The service is stopped.

Uninstalling the 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 simultaneously, but it is not recommended.
  • If both softwares 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 service.


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 "From Path" setting in the menu only allows to search for XML files, e.g. C:\DSS_ScanFolder\*.xml

Once this mode is activated, FileSender behaves quite different. The "Sent to" destinations "Printer Queue", "E-mail" and "Call Software" can not be populated. The FileSender processes 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 extension as *.PDF.

Now Filesender monitors all new XML files in the From Path, parses the XML file and if the two described tags 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 tags are found, the XML file is deleted and the corresponding PDF file send automatically to the users e-mail address.

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 extension 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 opened by e.g. notepad a new section called DSS. The section may contain as may SEARCHTAGS as needed. A SearchTag is a description of what the FileSender is looking up in the XML file and if found what action needed 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 differentiate the 2 poper action modes S2F and S2E.
It can be any expression.
The term is normally defined by the printers menu designer

FileExtention If not provided *.PDF is assumed. But if provided the to the xml file corresponding document file needs to have the same extension . Examples for the file EXAMPLE.XML
File Extension 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 extension *.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.