You are here: Available Utilities > R > RTF2FAP

RTF2FAP

Use this utility to convert Rich Text Format (RTF) files into section (FAP) or form (FOR) files. These RTF files can be standard RTF files produced by a word processor or IStream Migration RTF files produced by the IStream Migration Utility.

Note

This utility converts RTF files into sections (FAP files) by default. Include the
/F parameter if you want it to convert RTF files into forms (FOR files).

Program names

UNIX/Linux: rtf2fap
Windows: RTF2FAP.EXE

Syntax

RTF2FAP /I /X /D /F /INI /L /M /N /O /P /S /W

Parameter	Description
/I	Enter the name of the RTF file you want to convert. If the name of the FAP file includes spaces, enclose it in quotation marks, as shown here: /I="forms/form name with spaces.fap"
/X	Enter the name of the FXR file you want the utility to use during the conversion.
/D	(Optional) Include this parameter to specify a directory for the output files.
/F	(Optional) Include this parameter and a file name to create a form (FOR) file for use with Documaker Studio. If you omit the file name, the utility appends the FOR extension to the input file name. If you omit this parameter, the system creates sections instead of forms.
/INI	(Optional) Include this parameter to specify an INI file to load. The default is the FSISYS.INI file.
/L	(Optional) Include this parameter to create LOG files for all bitmaps in the input file.
/M	(Optional) Include this parameter to specify what kind of FAP file the utility will create. You have these options: /M=1 creates a FAP file with separate sections and separate headers and footers /M=2 creates a FAP file with separate sections and merges headers and footers onto the page The default is one (1).
/N	(Optional) Include this parameter if you have multiple Documaker documents that use the same section. This parameter tells the utility to prepend the input file name to the output file to make sure the output file name is unique. Here ire some examples: Form01_Section1.FAP Form03_Section1.FAP Form05_Section1.FAP
/O	(Optional) Enter the name you want the utility to assign to the FAP file.
/P	(Optional) Include this parameter to parse text for field names. You have these options: /P=0 - No field parsing /P=1 - <fieldname> /P=2 - «fieldname» /P=3 - <<fieldname>> /P=4 - {fieldname} /P=5 - [fieldname] /P=6 - \|-fieldname-\| /P=10 - Parse IStream migration fields When you include this parameter, the utility treats the text between the field identifiers as fields on the converted form and optional section. If it finds duplicates, it appends a counter to the field name. The default is zero (0). Note: Be sure to include /P=10 if you are converting RTF files created by the The IStream Migration Utility.
/S	(Optional) Use this parameter to specify how you want the utility to number pages. For instance, /S=_ results in: image.fap, image_2.fap, image_3.fap If you include the /M parameter but omit the /S parameter or its mask, the utility numbers the pages in this manner: image.fap, image2.fap, image3.fap
/W (Windows only)	(Optional) Include this parameter if the input file (/I) is Word document. For instance, enter /W=1 - if the Word document is s standard Word DOC or DOCX file. /W=2 - if the Word document was created using the Documaker Add-In for Microsoft Word. The default is one (1).

When using this utility, keep in mind...

You can import polyline or vector drawings.
Unicode support includes paragraphs containing mixed single- and multibyte characters.
Hyphenation settings are retained.
The utility converts bitmaps in the original document into external Documaker graphics (LOG) file references.

Also keep in mind these RTF2FAP Limitations.

Examples

Here are some examples:

To get a	Include these parameters
Form (FOR) file with separate sections	/F /M
Form (FOR) file with separate sections and separate graphics	/F /M /L
Legacy style image (FAP) file	/M=2

You can direct output using these parameters:

To specify a	Include this parameter
Destination directory	/D=.\mydir\
Graphic-only destination directory	/L=.\mydir\
Word file created using the Documaker Add-In for Microsoft Word	/W=2

Here are some additional examples:

If you want	Enter this command
Forms with embedded content	rtf2fap.exe /i=*.rtf /x=my.fxr /d=.\destination\ /L=.\LOGs\ /S=_ /F
Forms with separate sections (headers, footers, and body)	rtf2fap.exe /i=*.rtf /x=my.fxr /d=.\destination\ /L=.\LOGs\ /S=_ /F /M
Legacy-style FAP files	rtf2fap.exe /i=*.rtf /x=my.fxr /d=.\destination\ /L=.\LOGs\ /S=_ /M=2