Output To: Settings

When you print to Miraplacid Text Driver, Preview window pops up. If you click on "Settings" button on the Preview Window toolbar, Settings dialog will open. Settings dialog has several tabs discussed here. This document describes Output Settings.
Miraplacid Text Driver can do multiple things with extracted text. Moreover, it can do they all at the same time. It can save text to a hard drive, upload it to a server, copy to Windows Clipboard, send by Email, and print to a real printer.
Check output options you need and specify Output Settings on the right.
  1. File Plug-in is the most important one. It saves output data to disk.

    Miraplacid Text Driver Output To: File

    File plug-in has following parameters:
    • Output path - where output file will be saved. Output Path supports special tags
    • File Name - output file name. File Name supports special tags. They will be replaced with appropriate values
    • Append - If output file exists, append extracted text to the end of file. If you uncheck the box, file will be overwrited.
    • OpenWith - You can open result text with some application, let's say, with text viewer, or process them with post-processor. To open every individual page with some software, check "Open with" checkbox.
    • Application - Full path to the "Open With" application unless application pash is included to system PATH. For example, "Notepad" will open result text file in Notepad. Supports special tags.
      To start the postprocessor for each page just add {{PAGE}} to output filename. Each page will be saved to individual file. Postprocessor will be called for each file. If all the pages are saved to a single file, postprocessor will be called once per document.
    • Parameters - Parameters for the "Open With" application. Supports special tags.
    • Hide Window - Hide "Open With" application window
    • Wait - Wait for application close to continue further processing.

  2. Clipboard - copy output text to clipboard.

    Miraplacid Text Driver Output To: Clipboard

    Clipboard settings are simple. They only included "OpenWith" settings explained above (see Output To: File). The difference between File and Clipboard output style is Clipboard post-processor shall get processed text from clipboard rather than from file. Passing text through clipboard is mode secure because text is not get saved to disk.

  3. FTP plug-in sends text file to FTP server.

    Miraplacid Text Driver Output To: FTP

    FTP plug-in has following settings:
    • URL - URL to the resource; should contain server name and optional folder, without filename.
      Example: ftp://www.yourcompany.com/publications. Supports special tags.
    • File name - filename for the saved file. It may contain special tags to be expanded.
    • Passive mode checkbox. Check it if your PC is behind a firewall.
    • User name and Password - login to your server. If not specified, plug-in will try to connect as anonimous.

  4. HTTP plug-ins uploads extracted text to web server.

    Miraplacid Text Driver Output To: HTTP

    HTTP plug-in uses Basic authorization level.
    If you use password protected saving, plug-in may sometimes send the file twice because most of servers decline the first connection attempt to protected resource.
    URL and File name fields have different meanings in PUT and POST modes:

    PUT mode. URL should contain only server name and destination folder, as in FTP plug-in. File name is a name of destination file, optionally with special tags included. To use this mode, Web server should support it, and it must be allowed (turned on) on the server.

    POST mode. In this mode, URL should contain path to a script (ASP, ASPX, PHP, Perl, CGI or some other kind of active web page), which will receive POST web form from the plug-in. Example: http://www.yourcompany.com/publications/post.asp.
    Content of the form is encoded according multipart/form-data form rules. Form consists of the following two fields:
    • File in expanded form is submitted under filename name as usual form field.
    • User name and Password - login to your server if your serer require authorisation.

    Server-side web application should receive content and save it under filename name.
    Please, note that writing to the web folder usually forbidden for scripts. Script should save content in location with special permissions (write allowed for web server virtual user).

    Here is an example of form receiving script in asp with MSCUpload component:
    <%@ LANGUAGE=JScript %>
    <title>Test POST feature</title>
    var oUpload = Server.CreateObject("Miraplacid.MSCUpload");
    var folder = Server.mapPath("/post");
    var oBlob = Server.CreateObject("Miraplacid.MSCBlob");
    URL and File name parameters support special tags.

  5. Mail is for sending output text to a email recipient. You have to have email software like Outlook or Outlook Express with some email account to be installed and configured on your PC.

    Miraplacid Text Driver Output To: Mail

    • To - email address email will be sent to. If you hav e multiple recipients, please separate email adresses with ; character.
    • Subject - email subject line. Supports special tags.
    • Message - Email body - some message to be added above the extracted text. Supports special tags.
    • Send as attachment - Allows to send generated text as an attachment.
    • Filename - Name of file which will be used as an attachment. Supports special tags.

  6. Printer You can print the text file to a real printer, specific or default.

    Miraplacid Text Driver Output To: Printer

    • Printer - list of printers installed in your system. Choose one you want to print to.
    • Settings buttons - choose settings for printer which will be used on output. To return back to default settings, press "Use default" button.
    • Font - font family name. Text will be printed with specified font.
    • Charset - character set.
    • Weight - font weight, from Thin to Extra Bold.
    • Hight - Height of characters to be used in print output.
    • Italic, Strikeout, Underline - text decoration

Special tags

These tags allows you to include some useful information to file names and paths.
{{DATE}} and {{TIME}} tags
These tags include date and time information in various formats into filename. They could be represented in two main forms: Date format string elements:
Element Meaning
d Day of month as digits with no leading zero for single-digit days.
dd Day of month as digits with leading zero for single-digit days.
ddd Day of week as a three-letter abbreviation.
dddd Day of week as its full name.
M Month as digits with no leading zero for single-digit months.
MM Month as digits with leading zero for single-digit months.
MMM Month as a three-letter abbreviation.
MMMM Month as its full name.
y Year as last two digits, but with no leading zero for years less than 10.
yy Year as last two digits, but with leading zero for years less than 10.
yyyy Year represented by full four digits.
gg Period/era string. This element is ignored if the date to be formatted does not have an associated era or period string.

Time format string elements:
Element Meaning
h Hours with no leading zero for single-digit hours; 12-hour clock.
hh Hours with leading zero for single-digit hours; 12-hour clock.
H Hours with no leading zero for single-digit hours; 24-hour clock.
HH Hours with leading zero for single-digit hours; 24-hour clock.
m Minutes with no leading zero for single-digit minutes.
mm Minutes with leading zero for single-digit minutes.
s Seconds with no leading zero for single-digit seconds.
ss Seconds with leading zero for single-digit seconds.
t One character time-marker string, such as A or P.
tt Multicharacter time-marker string, such as AM or PM.
{{PAGE}}, {{JOB}} and {{IDENTITY}} tags
These tags include page namber, print job ID and some unique integer value into filename. They could be represented in two main forms:
{{USER}} and {{MACHINE}} tags
These tags will be replaced with default (NetBIOS) forms of current user and computer names.
This tag is a placeholder for some well-known system folders which will replace the tag. Because these folders are absolute, they may happen only in the beginning of path. Format of this tag is: {{SYSFOLDER(Name_of_Folder)}}.
Below is the table of allowed names for this tag.

Name Meaning
Personal folders
PROFILE User's root folder.
DESKTOP User's desktop.
PROGRAMS User's programs folder.
PERSONAL User's personal (My Documents) folder.
FAVORITES User's favorites folder.
STARTUP User's startup folder.
RECENT User's recent documents folder.
SENDTO User's sendto folder.
STARTMENU User's start menu folder.
NETHOOD User's network neighborhood folder.
TEMPLATES User's templates folder.
APPDATA User's application data folder.
PRINTHOOD User's print neighborhood folder.
LOCAL_APPDATA User's local application data folder (%USER%\Local Settings\Application Data).
INTERNET_CACHE User's temporary internet files folder.
COOKIES User's internet cookies folder.
HISTORY User's history folder.
MYPICTURES User's pictures folder.
ADMINTOOLS User's administrative tools folder.
Common (All Users) folders
COMMON_STARTMENU Common start menu folder.
COMMON_PROGRAMS Common programs folder.
COMMON_STARTUP Common startup folder.
COMMON_DESKTOP Common desktop folder.
COMMON_FAVORITES Common favorites folder.
COMMON_APPDATA Common application data folder.
COMMON_TEMPLATES Common templates folder.
COMMON_DOCUMENTS Common documents folder.
COMMON_ADMINTOOLS Common administrative tools folder.
System folders
WINDOWS Windows root folder.
SYSTEM Windows system folder.
FONTS System fonts folder.
PROGRAM_FILES Windows program files folder.
PROGRAM_FILES_COMMON Common section of program files folder (%PROGRAMFILES%\Common).

Please, note that some folders may be absent in particular system and the tag may produce empty value.
Tag {{SYSFOLDER}} will work only with File transport plug-in.
{{DOCNAME}} tag
This is a placeholder for document name extracted from print job name.
{{TERMINAL}} tag
This tag will work only in Text Driver Terminal Server Edition and will be replaced with a name of client machine.
{{EXT}} tag
This is a placeholder for file extension provided by currently used rendering plug-in (txt, xml, rss). If you will not use this tag, file will be saved without extension.

See also: