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 folder.
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 monitored 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 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 does include an ELP command header to the sent file with this content:
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:
- call software
- send to directory
- 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:
; Main filesender settings for logging and sleep time
; Settings for project Notarissen (No Separator Jobs, no copies, no cover page
; Monitor all files appearing in directory Source=D:\notarissen\incoming\ with the name pattern 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
; Finally move the PDF file into a storage folder
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:
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: Add to the command line the switch /R and FileSender will start directly when called.
Auto exit: (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
Extract the filesender_service.zip to a folder
Copy the filesend.ini file from the WELP directory into this new directory.
Start a command prompt as an administrator and navigate to this directory.
Type: fs_service /i then press ENTER. The service is installed.
Starting and stopping the service
Start a command prompt as an administrator and navigate to the filesender directory.Type: fs_service /s then press ENTER. The service is started.
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
Start a command prompt as an administrator and navigate to the filesender directory.
Type: fs_service /u then press ENTER. The service is stopped and uninstalled.
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 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 extension as *.PDF.
Now Filesender monitors all new XML files in the From Path, opens 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:
*.XML searching in the from path,
the two entries in the XML file
Destination Name="HOME" and
and the $USERNAME$ definition in the directory path.
3.2. Sending the stored file to a user by e-mail. S2E
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:
*.XML searching in the from path,
the two entries in the XML file
Destination Name="EMAIL" and
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 fount what action needed to be done a S2F or S2E.
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
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:
This representing exactly the default operation, like done, if the section DSS would have not been provided in the infiile
Is the same, as by default the file extention *.PDF is added
Is the same, as by default the file extension *.PDF is added
Sending an *-.RTF file into the users home folder
Sending an *.RTF file by e-mail to the user
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.