13 Web View Export Java Classes
This chapter covers the following classes:
13.1 Annotation Class
Annotation is an abstract base class for the Annotation objects.
Namespace
com.oracle.outsidein.annotations
Accessors
-
Height (long) Height of area in coordinates or rows
void setHeight(long) long getHeight()
-
Left (long) Leftmost coordinate or column
void setLeft(long) long getLeft()
-
Opacity (float) Opacity of the annotation. Range 0.0 - 1.0; setting opacity to 0 makes the annotation invisible
void setOpacity(float) throws Exception float getOpacity()
-
SectionIndex (long) 0-based page/sheet/image/slide index
void setSectionIndex(long) long getSectionIndex()
-
Top (long) Top coordinate or row
void setTop(long) long getTop()
-
Units (Annotation.UnitTypeValue) Type of units in which Height, Width, Left and Top are described in
void setUnits(Annotation.UnitTypeValue) Annotation.UnitTypeValue getUnits()
-
UserId (long) User Data
void setUserId(long) long getUserId()
-
Width (long) Width of area in coordinates or columns
void setWidth(long) long getWidth()
Annotation.UnitTypeValue Enumeration
The UnitTypeValue is an enumeration of the various unit types that annotation positions can be described in.
-
PIXELS: Units specified in Pixels
-
TWIPS: Units specified in Twips (1/1440th of an inch)
-
CELLS: Units specified in cell positions
13.2 ArchiveNode Class
ArchiveNode provides information about an archive node. This is a read-only class where the technology fills in all the values.
Namespace
com.oracle.outsidein
Accessors
-
boolean isFolder() - A value of true indicates that the record is an archive node.
-
int getFileSize() - File size of the archive node
-
java.util.Date getTime() - Time the archive node was created
-
int getNodeNum() - Serial number of the archive node in the archive
-
String getNodeName() - The name of the archive node
13.3 Callback Class
Callback messages are notifications that come from Outside In during the export process, providing information and sometimes the opportunity to customize the generated output.
Namespace
com.oracle.outsidein
To access callback messages, your code must create an object that inherits from Callback and pass it through the API's setCallbackHandler method. Your object can implement methods that override the default behavior for whichever methods your application is interested in.
Callback has two methods that you can override: createNewFile and newFileInfo.
13.3.1 createNewFile
CreateNewFileResponse createNewFile( FileFormat parentOutputId, FileFormat outputId, AssociationValue association, String path) throws IOException
This callback is made any time a new output file needs to be generated. This gives the developer the chance to affect where the new output file is created, how it is named, and the URL (if any) used to reference the file.
Parameters
-
parentOutputId: File format identifier of the parent file
-
outputId: File format identifier of the file created
-
association: An AssociationValue that describes relationship between the primary output file and the new file.
-
path: Full path of the file to be created
Return Value
To take action in response to this notification, return a CreateNewFileResponse object with the new file information. If you wish to accept the defaults for the path and URL, you may return null.
CreateNewFileResponse Class
This is a class to define a new output file location in response to a CreateNewFile callback. If you do not wish to change the path to the new output file, you may use the path as received. If you do not wish to specify the URL for the new file, you many specify it as null.
Constructor
CreateNewFileResponse(File file, String url)
-
file: File object containing the full path to new file
-
url: A new URL that references the newly created file. This parameter can be null.
CreateNewFileResponse(SeekableByteChannel6 redirect, String url) throws IOException
-
redirect: Object that will be written to as the destination of the transform
-
url: A new URL that references the newly created file.This parameter can be null.
AssociationValue Enumeration
This enumeration defines, for a new file created by an export process, the different possible associations between the new file and the primary output file. Its value may be one of the following:
-
ROOT - indicates the primary output file
-
CHILD - a new file linked (directly or indirectly) from the primary output file
-
SIBLING - indicates new files not linked from the primary output file
-
COPY - the file was copied as a part of a template macro operation.
-
REQUIREDNAME - not used
Note that some of these relationships will not be possible in all Outside In Export SDKs.
13.3.2 newFileInfo
void newFileInfo( FileFormat parentOutputId, FileFormat outputId, AssociationValue association, String path, String url) throws IOException
This informational callback is made just after each new file has been created.
Parameters
-
parentOutputId: File format identifier of the parent file
-
outputId: File format identifier of the file created
-
association: An AssociationValue that describes relationship between the primary output file and the new file.
-
path: Full path of the file created
-
url: URL that references the newly created file
Example
Here is a basic callback handler that notifies an application that it has received newFileInfo notifications.
public static class CallbackHandler extends Callback { myApplication m_theApp; public CallbackHandler( myApplication app ) { m_theApp = app; } @Override public void newFileInfo(FileFormat parentOutputId, FileFormat outputId, AssociationValue association, String path, String url) throws IOException { if( association == AssociationValue.ROOT ) m_theApp.primaryOutputIsReady(true); m_theApp.newOutputFile(path); } }
13.3.3 openFile
OpenFileResponse openFile(FileTypeFalue fileType, String fileName) throws IOException
This callback is made any time a new file needs to be opened.
Parameters
-
fileType: Type of file being requested to be opened
-
fileName: Name of the file to be opened
Return Value
To take action in response to this method, return an OpenFileResponse object.
FileTypeValue Enumeration
This enumeration defines the type of file being requested to be opened. Its value may be one of the following:
-
INPUT: File to be opened (path unknown)
-
TEMPLATE: Template file to be opened
-
PATH: Full file name of the file to be opened
-
OTHER: Not used
13.3.3.1 OpenFileResponse Class
This is a class to define a new file or redirected I/O object in response to an openFile() callback.
Constructors
OpenFileResponse(File file)
-
file: File object with full path to the new file
OpenFileResponse(SeekableByteChannel6 redirect)
-
redirect: A redirected I/O object to which the file data will be written
13.3.4 createTempFile
CreateTempFileResponse createTempFile() throws IOException
This callback is made any time a new temporary file needs to be generated. This gives the developer the chance to handle the reading and writing of the temporary file.
Return Value
To take action in response to this notification, return a CreateTempFileResponse object with the temporary file information.
13.4 ColorInfo Class
ColorInfo is a class to define a color or to use a default color in appropriate cases.
Namespace
com.oracle.outsidein
Constructors
ColorInfo()
Initializes a ColorInfo object to use the default color.
public ColorInfo(byte red, byte green, byte blue)
Initializes a ColorInfo object with the specified RGB values.
Accessors
-
byte getBlue() - Blue component of the color
-
byte getGreen() - Green component of the color
-
byte getRed() - Red component of the color
-
boolean isDefaultColor() - Returns true if the default color is used
13.5 Exporter Interface
This section describes the properties and methods of Exporter.
All of Outside In's Exporter functionality can be accessed through the Exporter Interface. The object returned by OutsideIn class is an implementation of this interface. This class derives from the Document Interface, which in turn is derived from the OptionsCache Interface.
Namespace
com.oracle.outsidein
Methods
-
getExportStatus
ExportStatus getExportStatus()
This function is used to determine if there were conversion problems during an export. The ExportStatus object returned may have information about sub-document failures, areas of a conversion that may not have high fidelity with the original document. When applicable the number of pages in the output is also provided.
-
newSubDocumentExporter
Exporter newSubDocumentExporter( int SubDocId, SubDocumentIdentifierTypeValue idType ) throws OutsideInException
Create a new Exporter for a subdocument.
SubDocId: Identifier of the subdocument
idType: Type of subdocument
SubDocumentIdentifierTypeValue: This is an enumeration for the type of subdocument being opened.
-
XMLEXPORTLOCATOR: Subdocument to be opened is based on output of XML Export (SubdocId is the value of the object_id attribute of a locator element.)
-
ATTACHMENTLOCATOR: Subdocument to be opened is based on the locator value provided by the one of the Export SDKs.
-
EMAILATTACHMENTINDEX: Subdocument to be opened is based on the index of the attachment from an email message. (SubdocId is the zero-based index of the attachment from an email message file. The first attachment presented by OutsideIn has the index value 0, the second has the index value 1, etc.)
Returns: A new Exporter object for the subdocument
-
-
newSubObjectExporter
Exporter newSubObjectExporter( SubObjectTypeValue objType, int data1, int data2, int data3, int data4 ) throws OutsideInException
Create a new Exporter for a subobject.
objType: Type of subobject
data1: Data identifying the subobject from SearchML
data2: Data identifying the subobject from SearchML
data3: Data identifying the subobject from SearchML
data4: Data identifying the subobject from SearchML
Returns: A new Exporter object for the subobject
SubObjectTypeValue: An enumeration to describe the type of SubObject to open.
-
LinkedObject
-
EmbeddedObject
-
CompressedFile
-
Attachment
-
-
newArchiveNodeExporter
Exporter newArchiveNodeExporter( int dwRecordNum ) throws OutsideInException
Create a new Exporter for an archive node. You may get the number of nodes in an archive using getArchiveNodeCount. The nodes are numbered from 0 to getArchiveNodeCount -1.
dwRecordNum: The number of the record to retrieve information about. The first node is node 0 and the total number of nodes may be obtained from getArchiveNodeCount.
Returns: A new Exporter object for the archive node
-
newArchiveNodeExporter with Search Export Data
Exporter newArchiveNodeExporter( int flags, int params1, int params2 ) throws OutsideInException
Create a new Exporter for an archive node. To use this function, you must first process the archive with Search Export and save the Node data for later use in this function.
Flags: Special flags value from Search Export
Params1: Data1 from Search Export
Params2: Data2 from Search Export
Returns: A new Exporter object for the archive node
-
export
void export() throws OutsideInException
Perform the conversion and close the export process keeping the source document open.
void export(boolean bLeaveSourceOpen) throws OutsideInException
Perform the conversion and keep the source document open or close it based on the value of bLeaveSourceOpen.
bLeaveSourceOpen: If set to true, keeps the source document open for next export process.
Note:
Before Release 8.5.3, calling Export() with no parameters, would leave the source document open. The default behavior starting with Release 8.5.3 is to close the document after exporting the file. If you would like to keep the file open for other conversions, use this method with "bLeaveSourceOpen" set to true.setDestinationFile
OptionsCache setDestinationFile( String filename ) throws OutsideInException
Set the location of the destination file
filename: Full path to the destination file
Returns: The updated options object
-
setExportTimeout
OptionsCache setExportTimeout(int millisecondsTimeout)
This method sets the time that the export process should wait for a response from the Outside In export engine to complete the export of a document, setting an upper limit on the time that will elapse during a call to export(). If the specified length of time is reached before the export has completed, the export operation will be terminated and an OutsideInException will be thrown. If this option is not set, the default timeout is 5 minutes.
-
newLocalExporter
static Exporter newLocalExporter(Exporter source)
This method creates and returns an instance of an Exporter object based on the source Exporter. All the options of source are copied to the new Exporter. The source and destination file information will not be copied.
13.5.1 Annotatable Interface
All of the Outside In annotation-related methods are accessed through the Annotatable Interface.
NameSpace
com.oracle.outsidein.annotations
Methods
-
addStampAnnotation
void addStampAnnotation( StampAnnotation StampAnno )
Add a stamp annotation to the exported document.
StampAnno: A StampAnnotation object with information about the stamp to add.
-
addStampAnnotation Properties
void addStampAnnotation( StampAnnotation StampAnno, Map<String, String> Properties)
Add a stamp annotation to the exported document and add properties associated with the annotation.
StampAnno: A StampAnnotation object with information about the stamp to add.
Properties: Key value pairs of name/value of properties associated with this annotation.
-
addStampAnnotation Comment
void addStampAnnotation( StampAnnotation StampAnno, String Comment)
Add a stamp annotation to the exported document and associate a comment with the annotation.
StampAnno: A StampAnnotation object with information about the stamp to add
Comment: Comment text to associate with the annotation
-
addStampAnnotation Comment and Properties
void addStampAnnotation( StampAnnotation StampAnno, String Comment, Map<String, String> Properties)
Add a stamp annotation to the exported document and associate a comment and properties with the annotation.
StampAnno: A StampAnnotation object with information about the stamp to add
Comment: Comment text to associate with the annotation
Properties: Key value pairs of name/value of properties associated with this annotation
-
addStampImageFile
void addStampImageFile( Map<String, File> stamps )throws OutsideInException
This method maps a stamp name to an image file. Stamp images specified as files are usable in the output from the Image Export SDK.
stamps: Key value pairs of stamp names and image files
-
addStampImageURL
void addStampImageURL( Map<String, URI> stamps )
This method maps a stamp name to an image URL. Stamp images specified as URLs are usable in the browser-displayed output from the Web View Export SDK
stamps: Key value pairs of stamp names and image URLs
-
applyHighlights
void applyHighlights( String HighlightJsonData )
This method applies a set of highlights from a JSON-encoded text stream previously generated from the Web View Export Javascript library.
HighlightJsonData: stream of highlight (and comment) information that was obtained via the Web View Export Javascript API function OIT.highlights.serialize.
-
addAreaHighlight
void addAreaHighlight( HighlightAreaAnnotation HighlightAreaAnno )
Highlight an area on a page in a document.
HighlightAreaAnno: A HighlightAreaAnnotation object with information about the area to highlight
-
addAreaHighlight and Add Annotation Properties
void addAreaHighlight( HighlightAreaAnnotation HighlightAreaAnno, Map<String, String> Properties)
Add an area highlight to a document and associate properties with the annotation.
HighlightAreaAnno: A HighlightAreaAnnotation object with information about the area to highlight
Properties: Key value pairs of name/value of properties associated with this annotation
-
addAreaHighlight and Associate Comment with Annotation
void addAreaHighlight( HighlightAreaAnnotation HighlightAreaAnno, String Comment )
Add an area highlight to a document, and associate a comment.
HighlightAreaAnno: A HighlightAreaAnnotation object with information about the area to highlight
Comment: Comment text to associate with the annotation
-
addAreaHighlight with Comment and Properties
void addAreaHighlight( HighlightAreaAnnotation HighlightAreaAnno, String Comment, Map<String, String> Properties )
Add an area highlight to a document, including associated comment text and properties.
HighlightAreaAnno: A HighlightAreaAnnotation object with information about the area to highlight
Comment: Comment text to associate with the annotation
Properties: Key value pairs of name/value of properties associated with this annotation
-
addTextHighlight
void addTextHighlight( HighlightTextAnnotation textanno )
Highlight text in a document.
textanno: A HighlightTextAnnotation object with information about the text to highlight
-
addTextHighlight and Add Annotation Properties
void addTextHighlight( HighlightTextAnnotation textanno, Map<String, String> Properties )
Highlight text in a document and associate properties with the annotation.
textanno: A HighlightTextAnnotation object with information about the text to highlight
Properties: Key value pairs of name/value of properties associated with this annotation
-
addTextHighlight and Associate a Comment
void addTextHighlight( HighlightTextAnnotation textanno, String Comment )
Highlight text in a document and associate a comment with the highlight.
textanno: A HighlightTextAnnotation object with information about the text to highlight
Comment: Comment text to associate with the annotation
-
addTextHighlight with Comment and Properties to Annotation
void addTextHighlight( HighlightTextAnnotation textanno, String Comment, Map<String, String> Properties )
Highlight text in a document and provide comment text and properties to be associated with the annotation.
textanno: A HighlightTextAnnotation object with information about the text to highlight
Comment: Comment text to associate with the annotation
Properties: Key value pairs of name/value of properties associated with this annotation
13.5.2 Document Interface
All of the Outside In document-related methods are accessed through the Document Interface.
Namespace
com.oracle.outsidein
Methods
-
close
void close()
Closes the currently open document.
-
getArchiveNodeCount
int getArchiveNodeCount() throws OutsideInException
Retrieves the number of nodes in an archive file.
Returns the number of nodes in the archive file or 0 if the file is not an archive file.
-
getFileId
FileFormat getFileId(FileIdInfoFlagValue dwFlags) throws OutsideInException
Gets the format of the file based on the technology's content-based file identification process.
dwFlags: Option to retrieve the file identification pre-Extended or post-Extended Test
Returns the format identifier of the file.
-
getObjectInfo
ObjectInfo getObjectInfo() throws OutsideInException
Retrieves the information about an embedded object.
Return: An ObjectInfo object with the information about the embedded object
-
getArchiveNode
ArchiveNode getArchiveNode(int nNodeNum) throws OutsideInException
Retrieves information about a record in an archive file
nNodeNum: The number of the record to retrieve information about. The first node is node 0.
Return Value: An ArchiveNode object with the information about the record
-
saveArchiveNode
void saveArchiveNode( int nNodeNum, File file) throws OutsideInException
Extracts a record in an archive file to disk.
nNodeNumType: The number of the record to retrieve information about. The first node is node 0.
file: The destination file to which the file will be extracted.
-
saveArchiveNode with Search Export Flags
void saveArchiveNode( int flags, int params1, int params2, File file) throws OutsideInException
Extracts a record in an archive file to disk without reading the data for all nodes in the archive in a sequential order. To use this function, you must first process the archive with Search Export and save the Node data for later use in this function.
flagsType: Special flags value from Search Export
params1: Data1 from Search Export+
params2: Data2 from Search Export
file: The destination file to which the file will be extracted
-
setSourceFile
OptionsCache setSourceFile( File file) throws OutsideInException
Set the source document.
file: The source file to export
Returns: The options cache object associated with this document
13.5.3 SeekableByteChannel6 Interface
Enables API users to handle I/O for the source and destination documents. Implement this interface to control I/O operations such as reading, writing, and seeking. This interface mimics the java.nio.channels.SeekableByteChannel interface which is only available in Java 7 and later. Note that SeekableByteChannel6 will be removed in favor of java.nio.channels.SeekableByteChannel if support for Java 6 is dropped in a future release of the Outside In Java API. Until then, this interface must be used if redirected I/O is required.
Namespace
com.oracle.outsidein
Methods
-
Get position
long position()
Returns this channel's position.
-
Set position
SeekableByteChannel6 position(long newPosition)
Sets this channel's position.
-
read
int read(java.nio.ByteBuffer dst)
Reads a sequence of bytes from this channel into the given buffer. Bytes are read starting at this channel's current position, and then the position is updated with the number of bytes actually read.
-
size
long size()
Returns the current size of the entity to which this channel is connected.
-
truncate
SeekableByteChannel6 truncate(long size)
Truncates the entity, to which this channel is connected, to the given size. Never invoked by Outside In and may be implemented by just returning this.
-
write
int write(java.io.nio.ByteBuffer src)
Writes a sequence of bytes to this channel from the given buffer. Bytes are written starting at this channel's current position. The entity to which the channel is connected is grown, if necessary, to accommodate the written bytes, and then the position is updated with the number of bytes actually written.
-
close
void close()
Closes this channel. If this channel is already closed then invoking this method has no effect.
-
isOpen
boolean isOpen()
Tells whether or not this channel is open.
13.5.4 OptionsCache Class
This section describes the OptionsCache class.
The options that configure the way outputs are generated are accessed through the OptionsCache class.
All of the options described in the following subsections are available through this interface. Other methods in this interface are described below.
Namespace
com.oracle.outsidein.options
Methods
-
OptionsCache setSourceFile(File file) throws OutsideInException
Sets the source document to be opened.
file: Full path to source file
-
OptionsCache setSourceFile(SeekableByteChannel6 redirect) throws OutsideInException
Sets an object that implements SeekableByteChannel6 to be used as the source document. Exporting a file using this method may have issues with files that require the original name of the file (examples: if the extension of the file is needed for identification purposes or if the name of a secondary file depends on the name/path of the original source file).
redirect: Object implementing SeekableByteChannel6 to be used to read the source data containing the input file
-
OptionsCache setSourceFile(SeekableByteChannel6 redirect, String filename) throws OutsideInException
Sets an object that implements SeekableByteChannel6 to be used as the source document and provides information about the filename.
redirect: Object implementing SeekableByteChannel6 to be used to read the source data containing the input file
filename: A fully qualified path or file name that may be used to derive the extension of the file or name of a secondary file that is dependent on the name/path of the source file
-
OptionsCache addSourceFile(File file) throws OutsideInException
Sets the next source document file to be exported in sequence. This allows multiple documents to be exported to the same output destination.
file: Full path to source file
-
OptionsCache addSourceFile(SeekableByteChannel6 redirect)
Set a redirected channel as the next source document to be exported to the original destination file. This method has the same limitations as the similar setSourceFile(SeekableByteChannel6 redirect) method.
-
OptionsCache addSourceFile(SeekableByteChannel6 redirect, String Filename)
Set a redirected channel as the next source document to be exported to the original destination file. The file name provided is used as in the method setSourceFile(SeekableByteChannel6 redirect, String Filename)
-
OptionsCache setSourceFormat(FileFormat fileId)
Sets the source format to process the input file as, ignoring the algorithmic detection of the file type.
fileId: the format to treat the input document as.
-
OptionsCache setDestinationFile(File file) throws OutsideInException
Sets the location of the destination file.
file: Full path to the destination file
-
OptionsCache setDestinationFile(SeekableByteChannel6 redirect) throws OutsideInException
Sets an object that implements SeekableByteChannel6 to be used as the destination document. An Exporter.export() operation will write the output data to the provided SeekableByteChannel6 object.
redirect: Object implementing SeekableByteChannel6 to be used as the destination document written during an Exporter.export() operation
-
OptionsCache setDestinationFormat(FileFormat fileId)
Sets the destination file format to which the file should be converted.
fileId: the format to convert the input document(s) to.
-
FileFormat getDestinationFormat()
Sets the destination file format to which the file will be converted.
-
OptionsCache setCallbackHandler(Callback callback)
Sets the object to use to handle callbacks.
callback: the callback handling object.
-
OptionsCache setPasswordsList(List<String> Passwords)
Provides a list of strings to use as passwords for encrypted documents. The technology will cycle through this list until a successful password is found or the list is exhausted.
Passwords: List of strings to be used as passwords.
-
OptionsCache setLotusNotesId(String NotesIdFile)
Sets the Lotus Notes ID file location.
NotesIdFile: Full path to the Notes ID file.
13.5.4.1 BiDiReorderMethod
OIT Option ID: SCCOPT_REORDERMETHOD
This option controls how the technology reorders bidirectional text.
Data Type
BiDiReorderMethodValue
BiDiReorderMethodValue Enumeration
-
UNICODEOFF: This disables any processing for bidirectional characters. This option is the default.
-
UNICODELTOR: Characters displayed using the Unicode bidirectional algorithm assuming a base left-to-right order. Use this option to enable bidirectional UNICODERTOL.
-
RIGHTTOLEFT: Characters displayed using the Unicode bidirectional algorithm assuming a base right-to-left order. Use this option to force starting bidirectional rendering in the right-to-left order.
Default
BiDiReorderMethodValue.UNICODEOFF
13.5.4.2 DefaultInputCharacterSet
OIT Option ID: SCCOPT_DEFAULTINPUTCHARSET
This option is used in cases where Outside In cannot determine the character set used to encode the text of an input file. When all other means of determining the file's character set are exhausted, Outside In will assume that an input document is encoded in the character set specified by this option. This is most often used when reading plain-text files, but may also be used when reading HTML or PDF files.
Data Type
DefaultInputCharacterSetValue
DefaultInputCharacterSetValue Enumeration
DefaultInputCharacterSetValue can be one of the following enumerations:
SYSTEMDEFAULT
UNICODE
BIGENDIANUNICODE
LITTLEEENDIANUNICODE
UTF8
UTF7
ASCII
UNIXJAPANESE
UNIXJAPANESEEUC
UNIXCHINESETRAD1
UNIXCHINESEEUCTRAD1
UNIXCHINESETRAD2
UNIXCHINESEEUCTRAD2
UNIXKOREAN
UNIXCHINESESIMPLE
EBCDIC37
EBCDIC273
EBCDIC274
EBCDIC277
EBCDIC278
EBCDIC280
EBCDIC282
EBCDIC284
EBCDIC285
EBCDIC297
EBCDIC500
EBCDIC1026
DOS437
DOS737
DOS850
DOS852
DOS855
DOS857
DOS860
DOS861
DOS863
DOS865
DOS866
DOS869
WINDOWS874
WINDOWS932
WINDOWS936
WINDOWS949
WINDOWS950
WINDOWS1250
WINDOWS1251
WINDOWS1252
WINDOWS1253
WINDOWS1254
WINDOWS1255
WINDOWS1256
WINDOWS1257
ISO8859_1
ISO8859_2
ISO8859_3
ISO8859_4
ISO8859_5
ISO8859_6
ISO8859_7
ISO8859_8
ISO8859_9
MACROMAN
MACCROATIAN
MACROMANIAN
MACTURKISH
MACICELANDIC
MACCYRILLIC
MACGREEK
MACCE
MACHEBREW
MACARABIC
MACJAPANESE
HPROMAN8
BIDIOLDCODE
BIDIPC8
BIDIE0
RUSSIANKOI8
JAPANESEX0201
Default
DefaultInputCharacterSetValue.SYSTEMDEFAULT
13.5.4.3 DefaultPageMargins
This option specifies the top, left, bottom and right margins in twips from the edges of the page. For instance, setting all the values to 1440 creates a 1-inch margin on all sides. Page margins will only be applied when formatting word processing, database and spreadsheet files.
Please note all margins are applied before scaling with the PageFitMode option. This option is overridden when the UseDocumentPageSettings option is set to true and print margins are specified in the input document. This option does not affect the output of bitmap, presentation, vector or archive files.
Data Type
Margins
Data
A Margins object with the margins on the 4 sides defined.
Default
1 inch for all margins
13.5.4.4 DefaultPageSize
This option allows the developer to specify the size of each page in the generated output file. The size may be specified in inches, points, centimeters or picas. This option is only valid when UseDocumentPageSettings is set to false. 1 inch = 6 picas = 72 points = ~ 2.54 cm.
Data Type
PageInfo
Data
A PageInfo object with the page size information.
Default
8.5 inches by 11 inches
13.5.4.5 DefaultRenderFont
OIT Option ID: SCCOPT_DEFAULTPRINTFONT
This option sets the font to use when the font specified by the filter is not available on the system.
Data Type
FontInfo
Data
The default font to be used
Default
None
13.5.4.6 DocumentMemoryMode
OIT Option ID: SCCOPT_DOCUMENTMEMORYMODE
This option determines the maximum amount of memory that the internal storage may use to store the document's data, from 4 MB to 1 GB. The more memory the internal storage has available to it, the less often it needs to re-read data from the document.
Data
-
SMALLEST: 1 - 4MB
-
SMALL: 2 - 16MB
-
MEDIUM: 3 - 64MB
-
LARGE: 4 - 256MB
-
LARGEST: 5 - 1 GB
Default
DocumentMemoryModeValue.LARGE
13.5.4.7 EmailAttachmentHandling
This option determines whether email attachments are converted or extracted.
Data Type
EmailAttachmentHandlingValue
EmailAttachmentHandlingValue Enumeration
EmailAttachmentHandlingValue can be one of the following enumerations:
-
NONE: Attachments will not be converted or extracted.
-
EXPORT: The attachments to this email will be converted.
-
EXPORTRECURSIVE: The attachments to this email will be converted; if any are emails, they will also have their attachments converted, and so on.
-
EXTRACT: Attachments will be extracted in their native form, stored alongside the Web View output files.
Default
EmailAttachmentHandlingValue.NONE
13.5.4.8 EnableAlphaBlending
This option allows the user to enable alpha-channel blending (transparency) in rendering vector images. This is primarily useful to improve fidelity when rendering with a slower graphics engine, such as X-Windows over a network when performance is not an issue.
Data
Boolean
Default
False
13.5.4.9 ExternalStylesheets
String option for specifying the url of a user supplied stylesheet to be included in the output html file. Values specified through this option will appear in output HTML files as linked stylesheets.
Example
<script src="oit.css"> <link rel="stylesheet" href="/some/path/myStylesheet.css"/>
Data Type
List<String>
Default
None
13.5.4.10 FallbackFormat
This option controls how files are handled when their specific application type cannot be determined. This normally affects all plain-text files, because plain-text files are generally identified by process of elimination, for example, when a file isn't identified as having been created by a known application, it is treated as a plain-text file. It is recommended that None be set to prevent the conversion from exporting unidentified binary files as though they were text, which could generate many pages of "garbage" output.
Data Type
FallbackFormatValue
FallbackFormatValue Enumeration
FallbackFormatValue can be one of the following enumerations:
-
TEXT: Unidentified file types will be treated as text files.
-
NONE: Outside In will not attempt to process files whose type cannot be identified.
Default
FallbackFormatValue.TEXT
13.5.4.11 FontAliasList
This option enables the capability to specify which font on the system should be used when a specific font referenced in the original file is not available. A different alias can be set for each font desired to be mapped.
Data Type
FontAliases
Data
A FontAliases object with a list of font matchings
Default
Please refer to the section "SCCOPT_PRINTFONTALIAS" in the C-API for the default font alias list.
13.5.4.12 FontBaseURL
This option allows the developer to specify the base URL used in the Web View Export output when referencing a non-exported font as a downloadable font. (Exported fonts will be placed in the exported output location.)
Data Type
String
Default
None
13.5.4.13 FontDirectories
This option allows the developer to specify one or more font directories where fonts are located for use by Web View Export. If multiple font directories are specified, they should be delimited by a colon on Linux and UNIX systems and a semi-colon on Windows systems. Please note that Web View Export supports single TrueType fonts (*.ttf, *.TTF) and TrueType collections (*.ttc, *.TTC), not Windows bitmap fonts (*.fon, *.FON), or any other type of font. Also, Web View Export does not require case-sensitive font filenames on UNIX systems.
Data Type
List<File>
Default
None
13.5.4.14 FontFilter
This option allows the developer to specify a list of fonts to be included or excluded during the export process.
Data Type
FontList
Data
A FontFilter object describing the inclusion or exclusion list.
Default
None
13.5.4.15 FontReferenceMethod
This option controls the way embedded fonts are presented (or not) in the HTML5 output.
Data Type
FontReferenceMethodValue
FontReferenceMethodValue Enumeration
-
REFERENCEBYNAME: The font is referenced in the output file by name only
-
REFERENCEEXPORTED: The font is subsetted, exported during document conversion, and referenced in the output by file name
-
REFERENCEBYBASEURL: The full font is referenced in the output using the font file name and the base URL supplied by the FontBaseURL option.
Default
FontReferenceMethodValue.REFERENCEBYNAME
13.5.4.16 GraphicHeightLimit
OIT Option ID: SCCOPT_GRAPHIC_HEIGHTLIMIT
Note that this option differs from the behavior of setting the height of graphics in that it sets an upper limit on the image height. Images larger than this limit will be reduced to the limit value. However, images smaller than this height will not be enlarged when using this option. Setting the height using GraphicHeight causes all output images to be reduced or enlarged to be of the specified height.
A value of zero is equivalent to no limit, which causes this option to be ignored.
Data Type
long
Default
0
13.5.4.17 GraphicOutputDPI
OIT Option ID: SCCOPT_GRAPHIC_OUTPUTDPI
This option allows the user to specify the output graphics device's resolution in DPI and only applies to images whose size is specified in physical units (in/cm). For example, consider a 1" square, 100 DPI graphic that is to be rendered on a 50 DPI device (GraphicOutputDPI is set to 50). In this case, the size of the resulting TIFF, BMP, JPEG, GIF, or PNG will be 50 x 50 pixels.
In addition, setting this option to 0(Maintain Source Image DPI), can be used to suppress any dimensional changes to an image. In other words, a 1" square, 100 DPI graphic will be converted to an image that is 100 x 100 pixels in size. This value indicates that the DPI of the output device is not important. It extracts the maximum resolution from the input image with the smallest exported image size.
Setting this option to 0 may result in the creation of extremely large images. Be aware that there may be limitations in the system running this technology that could result in undesirably large bandwidth consumption or an error message. Additionally, an out of memory error message will be generated if system memory is insufficient to handle a particularly large image.
Also note that setting this option to 0 will force the technology to use the DPI settings already present in raster images, but will use the current screen resolution as the DPI setting for any other type of input file.
For some output graphic types, there may be a discrepancy between the value set by this option and the DPI value reported by some graphics applications. The discrepancy occurs when the output format uses metric units (DPM, or dots per meter) instead of English units (DPI, or dots per inch). Depending on how the graphics application performs rounding on meters to inches conversions, the DPI value reported may be 1 unit more than expected. An example of a format which may exhibit this problem is PNG. The maximum value that can be set is 2400 DPI.
Data Type
long
Default
96
13.5.4.18 GraphicSizeLimit
OIT Option ID: SCCOPT_GRAPHIC_SIZELIMIT
This option is used to set the maximum size of the exported graphic in pixels. It may be used to prevent inordinately large graphics from being converted to equally cumbersome output files, thus preventing bandwidth waste.
This setting takes precedence over all other options and settings that affect the size of a converted graphic.
When creating a multi-page TIFF file, this limit is applied on a per page basis. It is not a pixel limit on the entire output file.
Data Type
long
Default
0
13.5.4.19 GraphicWidthLimit
OIT Option ID: SCCOPT_GRAPHIC_WIDTHLIMIT
This option allows a hard limit to be set for how wide in pixels an exported graphic may be. Any images wider than this limit will be resized to match the limit. It should be noted that regardless whether the GraphicHeightLimit option is set or not, any resized images will preserve their original aspect ratio.
Note that this option differs from the behavior of setting the width of graphics by using GraphicWidth in that it sets an upper limit on the image width. Images larger than this limit will be reduced to the limit value. However, images smaller than this width will not be enlarged when using this option. Setting the width using GraphicWidth causes all output images to be reduced or enlarged to be of the specified width.
Data Type
long
Default
0
13.5.4.20 IECondCommentMode
OIT Option ID: SCCOPT_HTML_COND_COMMENT_MODE
Some HTML input files may include "conditional comments", which are HTML comments that mark areas of HTML to be interpreted in specific versions of Internet Explorer, while being ignored by other browsers. This option allows you to control how the content contained within conditional comments will be interpreted by Outside In's HTML parsing code.
Data Type
IECondCommentFlagValues
IECondCommentFlagValues Enumeration
IECondCommentFlagValues can be one or more of the following enumerations ORed together:
-
NONE: Don't output any conditional comment
-
IE5: Include the IE5 comments
-
IE6: Include the IE6 comments
-
IE7: Include the IE7 comments
-
IE8: Include the IE8 comments
-
IE9: Include the IE9 comments
-
ALL: Include all conditional comments
Default
IECondCommentFlagValues.NONE
13.5.4.21 IgnorePassword
OIT Option ID: SCCOPT_IGNORE_PASSWORD
This option can disable the password verification of files where the contents can be processed without validation of the password. If this option is not set, the filter will return an error.
Currently only the PST and MDB Filters support this option.
Data Type
boolean
Default
false
13.5.4.22 ISODateTimes
OIT Option ID: SCCOPT_FORMATFLAGS
When this flag is set, all Date and Time values are converted to the ISO 8601 standard. This conversion can only be performed using dates that are stored as numeric data within the original file.
Data Type
boolean
Default
false
13.5.4.23 LotusNotesDirectory
OIT Option ID: SCCOPT_LOTUSNOTESDIRECTORY
This option allows the developer to specify the location of a Lotus Notes or Domino installation for use by the NSF filter. A valid Lotus installation directory must contain the file nnotes.dll.
Either Lotus Notes version 8 or Lotus Domino version 8 must be installed on the same machine as OIT. A 32-bit version of the Lotus software must be used if you are using a 32-bit version of OIT. A 64-bit version of the Lotus software must be used if you are using a 64-bit version of OIT.
Data Type
String
Default
None
13.5.4.24 MarginText
This option lets you specify a text string for margin text.
Data Type
MarginText
Default
None
13.5.4.25 MarginTextFont
This option lets you set the font and font size for margin text.
Data Type
FontInfo
Default
Arial, 9 pt.
13.5.4.26 OutputRawtext
An option controlling whether raw text output is generated on the server side. This option must be enabled in order to enable in-browser searching via the Outside In API. This does not affect the search capabilities of the browser itself. Raw text generation is enabled by default.
Data Type
boolean
Default
true
13.5.4.27 PageRange
OIT Option ID: SCCOPT_WHATTOPRINT
OIT Option ID: SCCOPT_PRINTSTARTPAGE
OIT Option ID: SCCOPT_PRINTENDPAGE
This option indicates whether the whole file or a selected range of pages should be rendered. When selecting a range, the start and ending pages are specified.
Data Type
PageRange
Data
The page range to be exported.
Default
All pages are printed
13.5.4.28 PDFInputMaxEmbeddedObjects
This option allows the user to limit the number of embedded objects that are produced in a PDF file.
Data Type
long
Data
The maximum number of embedded objects to produce in PDF output. Setting this to 0 would produce an all embedded objects in the input document.
Default
0 – produce all objects.
13.5.4.29 PDFInputMaxVectorPaths
This option allows the user to limit the number of vector paths that are produced in a PDF file.
Data Type
long
Data
The maximum number of paths to produce in PDF output. Setting this to 0 would produce an all vector objects in the input document.
Default
0 – produce all vector objects.
13.5.4.30 PDFReorderBiDi
OIT Option ID: SCCOPT_PDF_FILTER_REORDER_BIDI
This option controls whether or not the PDF filter will attempt to reorder bidirectional text runs so that the output is in standard logical order as used by the Unicode 2.0 and later specification. This additional processing will result in slower filter performance according to the amount of bidirectional data in the file.
Data Type
PDFReorderBiDiValue
PDFReorderBiDiValue Enumeration
This enumeration defines the type of Bidirection text reordering the PDF filter should perform.
-
STANDARDBIDI: Do not attempt to reorder bidirectional text runs.
-
REORDEREDBIDI: Attempt to reorder bidirectional text runs.
Default
PDFReorderBiDiValue.STANDARDBIDI
13.5.4.31 PDFWordSpacingFactor
This option controls the spacing threshold in PDF input documents. Most PDF documents do not have an explicit character denoting a word break. The PDF filter calculates the distance between two characters to determine if they are part of the same word or if there should be a word break inserted. The space between characters is compared to the length of the space character in the current font multiplied by this fraction. If the space between characters is larger, then a word break character is inserted into the text stream. Otherwise, the characters are considered to be part of the same word and no word break is inserted.
Data Type
float
Data
A value representing the percentage of the space character used to trigger a word break. Valid values are positive values less than 2.
Default
0.85
13.5.4.32 PerformExtendedFI
OIT Option ID: SCCOPT_FIFLAGS
This option affects how an input file's internal format (application type) is identified when the file is first opened by the Outside In technology. When the extended test flag is in effect, and an input file is identified as being either 7-bit ASCII, EBCDIC, or Unicode, the file's contents will be interpreted as such by the export process.
The extended test is optional because it requires extra processing and cannot guarantee complete accuracy (which would require the inspection of every single byte in a file to eliminate false positives.)
Data Type
boolean
Data
One of the following values:
-
false: When this is set, standard file identification behavior occurs.
-
true: If set, the File Identification code will run an extended test on all files that are not identified.
Default
-
true
13.5.4.33 PostLibraryScripts
List of strings specifying the relative URL of the customer's initialization script. Scripts specified via this option will load after the Outside In libraries, and may access the Outside In Javascript API. The scripts will be referenced in the same order as the list used to set this option.
Example:
<script src="oit.js"> <script src="/config/oitinit.js">
Data Type
List<String>
Default
None
13.5.4.34 PreLibraryScripts
List of strings specifying the URL of a script file to be referenced via a <script> tag in the output file. Scripts specified via this option will load before the Outside In libraries. The scripts will be referenced in the same order as the list used to set this option.
Example:
<script src="/jQuery/jQuery-min.js"> <script src="/shims/customstuff.js"> <script src="oit.js">
Data Type
List<String>
Default
None
13.5.4.35 RedactionColor
This option provides the ability to specify the color used for a redaction rectangle (black or white) as well as the color used (black or white) for the redaction code. When the colors match, the redaction code is effectively invisible. Settings should default to Black redactions with White codes if not explicitly set. The values may be set on each redaction individually, both in the UI and in the rendered output.
Value
ColorInfo
Data
Any valid CSS color
13.5.4.36 RedactionLabelFont
This option sets the name and size of font to use for redaction labels. The font size may be reduced to allow text to fit within a redaction rectangle.
Data Type
FontInfo
Default
Default display font, 9 pt.
13.5.4.37 RedactionLabelsVisible
This option allows you to display redaction labels in your output.
Data Type
boolean
Default
False (no labels)13.5.4.38 RedactionsEnabled
This option tells the export to format the output to be redaction-capable. In practical terms what this means is that all embeddings will be rasterized (routed through sccimg) so that a rectangle in an embedding is consistent across all output formats.
Data Type
boolean
Default
False
13.5.4.39 RenderEmbeddedFonts
This option allows you to disable the use of embedded fonts in PDF input files. If the option is set to true, the embedded fonts in the PDF input are used to render text; if the option is set to false, the embedded fonts are not used and the fallback is to use fonts available to Outside In to render text.
Data Type
boolean
Default
true
13.5.4.40 ShowArchiveFullPath
This option causes the full path of a node to be returned in "GetArchiveNodeInfo" and "GetObjectInfo".
Data Type
boolean
Default
false
13.5.4.41 StrokeOutText
This option is used to stroke out (display as graphical primitives) text in an AutoCAD file. Setting this option to false would improve performance, but the visual fidelity may be compromised.
-
If the export for the conversion is text only, text is never stroked out.
-
If the export is not text only, and the drawing is perspective, text will always be stroked out (regardless of this option). This is due to the fact that in non-text only situations visual fidelity is of importance, and handling of textual objects in perspective drawings is more accurate with stroked out text. If the conversion is non-text only and the drawing is not perspective, this option determines if text should be stroked.
Note that when this option is true, some special characters appear as asterisks or question marks due to limited support of characters for stroking out text.
Data Type
boolean
Default
true
13.5.4.42 TempDirectory
From time to time, the technology needs to create one or more temporary files. This option sets the directory to be used for those files.
It is recommended that this option be set as part of a system to clean up temporary files left behind in the event of abnormal program termination. By using this option with code to delete files older than a predefined time limit, the OEM can help to ensure that the number of temporary files does not grow without limit.
If a developer would like to manage temporary files using redirected IO to completely take over responsibility for the low level IO calls of the temp file , they can set the option value to null and every time a new temporary file needs to be created, a callback method "createTempFile" shall be called.
Note:
It is mandatory to support this callback if the option is set to null.Data Type
String
Default
The system default directory for temporary files. On Windows systems, it is the value of environment variable %TMP%. On UNIX systems, this is the value of environment variable $TMP.
13.5.4.43 TimeZoneOffset
OIT Option ID: SCCOPT_TIMEZONE
This option allows the user to define an offset to GMT that will be applied during date formatting, allowing date values to be displayed in a selectable time zone. This option affects the formatting of numbers that have been defined as date values. This option will not affect dates that are stored as text.
Note:
This option does not apply for spreadsheet files. Daylight savings is not supported. The sent time in msg files when viewed in Outlook can be an hour different from the time sent when an image of the msg file is created.
Data Type
long
Default
-
0: GMT time
13.5.4.44 UnmappableCharacter
This option selects the character used when a character cannot be found in the output character set. This option takes the Unicode value for the replacement character. It is left to the user to make sure that the selected replacement character is available in the output character set.
Data Type
int
Default
42
13.5.4.45 URLPathOutput
String option for specifying the base URL for output files generated during the export process. The value of this option is used as a prefix for references to those resources in the primary output file. If the output base URL is "/exports/", an image tag in an exported document would look like this:
<img src="/exports/doc01.doc.jpg" />
and URLs to the exported files within content.js would be of this form:
{id:"page.1",name:"Page 1",type:"page",oid:"overlay.1",w:"816px",h:"1056px",src:"/exports/output.3.html"}
By default, the output file base URL is empty, and all output will be specified without path information.
Data Type
String
Default
None
13.5.4.46 URLPathResources
String option for specifying the base URL for Web View Export scripts, css files and other resources that do not vary with the converted file. The value of this option is used as a prefix for references to those resources in the primary output file. For example, if the resources' base URL is "/oit/", the script reference in the output file would look like this:
<script src="/oit/oit.js"></script>
By default, this value is empty, meaning all resources must be present in the same directory as the generated output.
Data Type
String
Default
None
13.5.4.47 UseDocumentPageSettings
OIT Option ID: SCCOPT_USEDOCPAGESETTINGS
This option is used to select the document's page layout information when rendering.
If TRUE the document's native (or author selected) page margins, paper size, page scaling and page orientation are used when available from the filter.
The values of the DefaultPrintMargins, SSPrintGridlines, SSPrintHeadings, SSPrintDirection, and SSPrintFitToPage options are overridden if this option is set to TRUE and the properties associated with those options are specified in the input document. Additionally, print area and page breaks in spreadsheet documents are ignored unless this option is set to true.
If false, the page margins, size, orientation and scaling are set to specific values rather than those in the native document. The page size is forced to 8 1/2" x 11" in portrait orientation, but this may be changed by setting the GraphicHeight and/or GraphicWidth options. The margins are forced 1" all around, but may be changed by setting the defaultMargins option. The scaling for the document will be set to 100%, although this may be changed by setting any of the various scaling options.
It should be noted that this option also affects page orientation for both input spreadsheets and word processing documents.
Data Type
boolean
Default
true
13.5.4.48 VectorObjectLimit
This value sets a limit on the number of objects that will be generated in an SVG drawing so that browser capabilities will not be exceeded. A value of 0 indicates no limit.
Web View Export renders vector-based graphics from source documents as SVG drawings. SVG is part of the HTML5 specification and provides native browser-based support for vector graphics, and usually results in superior visual fidelity. However, while HTML5 browsers generally support SVG vector graphics very well, this native support can be pushed past its limits with highly complex source documents. To avoid overtaxing a browser, this option allows a limit to be placed on the complexity of SVG graphics created from such source documents. Once the specified number of objects has been added to an SVG drawing, no further graphic objects will be added.
This limit is reset for each page of output; hitting the limit on the first page of the document doesn't prevent SVG objects from being created for subsequent pages of the Web View Export output.
An application can detect if an input document triggered this limit by using the EXExportStatus API function.
Data Type
long
Default
5000
13.5.4.49 WebFontPermissions
This option controls the use of "embedded" fonts (see FontReferenceMethod) in the Web View Export output; specifically, whether or not a downloadable (web font) version of the font should be made available to Web View Export output, based on the licensing restrictions indicated within the font itself.
Data Type
WebFontPermissionValues
WebFontPermissionValues Enumeration
WebFontPermissionValues can be one or more of the following enumerations ORed together:
-
DEFAULTPERMISSIONS
-
REQUIREINSTALLABLE
-
REQUIREPREVIEWPRINT
-
REQUIREEDITABLE
Default
WebFontPermissionValues.DEFAULTPERMISSIONS
13.5.4.50 WebViewLibraryName
String option specifying the file name of the Web View Javascript library, which will be written into a <script> tag in the generated HTML files for a Web View. If this option is not set, the value "oit.js" will be used. This option allows the Web View Javascript library to be renamed for versioning or other purposes. This option works in combination with the URLPathResources option.
Data Type
String
Default
oit.js
13.5.4.51 WebViewOutputStructure
This option controls the structure of the output files created by Web View Export.
Data Type
WebViewStructureValue
WebViewStructureValue Enumeration
WebViewStructureValue can be one of the following enumerations:
-
FLAT: HTML content is exported in a single HTML file.
-
AJAXCHUNKED: HTML content is spread among multiple output pages.
-
AJAXSTREAMED: HTML content is spread among multiple output pages and the browser may begin viewing the document before the entire output has been produced.
-
PAGESTREAMING: HTML content is spread among multiple independent output files
Default
WebViewStructureValue.FLAT
13.5.4.52 WebViewStylesheetName
String option specifying the file name of the Web View stylesheet, which will be written into a <link> tag in the generated HTML files for a Web View. If this option is not set, the value "oit.css" will be used. This option allows the Web View stylesheet to be renamed for versioning or other purposes. This option works in combination with the URLPathResources option.
Data Type
String
Default
oit.css
13.6 ExportStatus Class
The ExportStatus class provides access to information about a conversion. This information may include information about sub-document failures, areas of a conversion that may not have high fidelity with the original document. When applicable the number of pages in the output is also provided.
Namespace
com.oracle.outsidein
Accessors
-
long getPageCount() - A count of all of the output pages produced during an export operation.
-
EnumSet<ExportStatusFlags> getStatusFlags() - Gets the information about possible fidelity issues with the original document.
-
long getSubDocsFailed() - Number of sub documents that were not converted.
-
long getSubDocsPassed() - Number of sub documents that were successfully converted.
ExportStatusFlags Enumeration
This enumeration is the set of possible known problems that can occur during an export process.
-
NOINFORMATIONAVAILABLE: No Information is available.
-
MISSINGMAP: A PDF text run was missing the toUnicode table.
-
VERTICALTEXT: A vertical text run was present.
-
TEXTEFFECTS: A run had unsupported text effects applied. One example is Word Art.
-
UNSUPPORTEDCOMPRESSION: A graphic had an unsupported compression.
-
UNSUPPORTEDCOLORSPACE: A graphic had an unsupported color space.
-
FORMS: A subdocument had forms.
-
RIGHTTOLEFTTABLES: A table had right to left columns.
-
EQUATIONS: A file had equations.
-
ALIASEDFONT: The desired font was missing, but a font alias was used.
-
MISSINGFONT: The desired font wasn't present on the system.
-
SUBDOCFAILED: A subdocument was not converted.
-
TYPETHREEFONT: A type 3 font was encountered.
-
UNSUPPORTEDSHADING: An unsupported shading pattern was encountered.
-
INVALIDHTML: An HTML parse error, as defined by the W3C, was encountered.
-
VECTOROBJECTLIMIT: The vector object limit was reached.
-
INVALIDANNOTATIONNOTAPPLIED: Unsupported annotation/redaction wasn't rendered.
13.7 FileFormat Class
This class defines the identifiers for file formats.
Namespace
com.oracle.outsidein
Methods
-
GetDescription
String GetDescription()
This method returns the description of the format.
-
GetId
int GetId()
This method returns the numeric identifier of the format.
-
ForId
FileFormat ForId(int id)
This method returns the FileFormat object for the given identifier.
id: The numeric identifier for which the corresponding FileFormat object is returned.
13.8 FontAliases Class
FontAliases is a class for providing font matching of unknown fonts.
Namespace
com.oracle.outsidein.options
Constructor
FontAliases(boolean clearDefaults, Map<String, String> aliasList) useDefaults Option whether to initialize the list to a set of platform-specific default aliases (true) or to an empty list (false) aliasList Aliases list as a key-value pair with original name as key
Accessors
-
Map<String, String> getAliasList() - List of font aliases set.
-
Map<String, String> getDefaultAliases() - List of platform-specific default font aliases that are applied when "true" is passed as the first argument of the constructor.
13.9 FontInfo Class
FontInfo is a class to define a font for use in the OutsideIn API.
Namespace
com.oracle.outsidein.options
Constructors
FontInfo(String fontface, int height) fontface The name of the font height Size of the font in half points
FontInfo()
Constructs a FontInfo object with a 10 point Arial Font.
Accessors
-
String getFontface() - The name of the font
-
int getHeight() - Size of the font in half points
13.10 FontList Class
FontList is a class for inclusion or exclusion of fonts in exported documents.
Namespace
com.oracle.outsidein.options
Constructor
FontList(boolean isExclusion, String[] fonts) IsExclusion If set then accompanying list is an exclusion list fonts List of fonts to include or exclude
Accessors
-
boolean isExcludeList() - If set, then accompanying list is an exclusion list.
-
String[] getFontsList - List of fonts to include or exclude.
13.11 HighlightAreaAnnotation Class
The HighlightAreaAnnotation class defines the characteristics of a highlighted area annotation. This class derives from the Annotation class.
Namespace
com.oracle.outsidein.annotations
Constructors
HighlightAreaAnnotation(long userId, long sectionIx, long Top, long Left, long Width, long Height, Annotation.UnitTypeValue units, float opacity, ColorInfo fillColor, HighlightAreaAnnotation.AnnoBorder border, HighlightAreaAnnotation.BorderStyleValue borderStyle) userId User Data sectionIx 0-based page/sheet/image/slide index Top Top coordinate or row Left Leftmost coordinate or column Width Width of area in coordinates or columns Height Height of area in coordinates or rows Units Unit type Opacity Opacity of the annotation. Range 0.0 - 1.0; 0==invisible fillColor The fill color for the annotation border The color and thickness of the borders for the highlighted area. borderStyle Style of border lines surrounding the highlighted area.
Accessors
-
BorderStyle: The style of the border. (Note: in the initial release of Web View Export, only solid borders are supported)
void setBorderStyle(HighlightAreaAnnotation.BorderStyleValue) HighlightAreaAnnotation.BorderStyleValue getBorderStyle()
-
FillColor: Color to be used to fill the area
void setFillColor(ColorInfo) ColorInfo getFillColor()
-
BottomBorder
void setBottomBorder(HighlightAreaAnnotation.AnnoBorder) HighlightAreaAnnotation.AnnoBorder getBottomBorder()
-
LeftBorder
void setLeftBorder(HighlightAreaAnnotation.AnnoBorder) HighlightAreaAnnotation.AnnoBorder getLeftBorder()
-
RightBorder
void setRightBorder(HighlightAreaAnnotation.AnnoBorder) HighlightAreaAnnotation.AnnoBorder getRightBorder()
-
TopBorder
void setTopBorder(HighlightAreaAnnotation.AnnoBorder) HighlightAreaAnnotation.AnnoBorder getTopBorder()
Methods
void setBorder(HighlightAreaAnnotation.BorderSideValue side, HighlightAreaAnnotation.AnnoBorder)
side: The side to which this border shall be applied. HighlightAreaAnnotation.BorderSideValue is an enumeration of the sides of the annotation.
border: The type of border to be used
13.12 HighlightTextAnnotation Class
HighlightTextAnnotation is a class for defining Text highlighted Annotations. This class derives from the Annotation class.
Note:
the application of character attributes through highlighting is not supported in the initial release of Web View Export.
Namespace
com.oracle.outsidein.annotations
Constructors
HighlightTextAnnotation(long StartCharCount, long EndCharCount, EnumSet<CharAttributeValues> CharAttrs, Enumset<CharAttributeValues> CharMask) HighlightTextAnnotation(long StartCharCount, long EndCharCount, ColorInfo Foreground, ColorInfo Background) HighlightTextAnnotation(long StartCharCount, long EndCharCount, ColorInfo Foreground, ColorInfo Background, EnumSet<CharAttributeValues> CharAttrs, EnumSet<CharAttributeValues> CharMask) StartCharCount The character count of the starting position EndCharCount The character count of the end position Foreground The text color of the highlight Background The background color of the highlight CharAttrs the character attributes to use CharMask character attributes to change
Initializes a new instance of the HighlightTextAnnotation class.
Accessors
-
StartCharCount: The character count of the starting position
-
EndCharCount: The character count of the end position
-
Foreground: The text color of the highlight
-
Background: The background color of the highlight
-
CharAttrs: The character attributes to use
-
CharMask: Character attributes to change
CharAttributeValues Enumeration
This enumeration is the list of all character attributes to apply for the text highlight.
-
NORMAL: Normal text - All attributes off
-
UNDERLINE: Underline attribute
-
ITALIC: Italic attribute
-
BOLD: Bold attribute
-
STRIKEOUT: Strike out text
-
SMALLCAPS: Small caps
-
OUTLINE: Outline Text
-
SHADOW: Shadow text
-
CAPS: All Caps
-
SUBSCRIPT: Subscript text
-
SUPERSCRIPT: Superscript text
-
DUNDERLINE: Double Underline
-
WORDUNDERLINE: Word Underline
-
DOTUNDERLINE: Dotted Underline
-
DASHUNDERLINE: Dashed Underline
13.13 Margins Class
The Margins Class is used to describe the page margins.
Namespace
com.oracle.outsidein.options
Constructors
Margins()
Constructs a Margins object with a 1 inch margins for top, bottom, left and right margins.
Margins(long top, long bottom, long left, long right) top Margin from the top edge of the page (in twips) bottom Margin from the bottom edge of the page (in twips) left Margin from the left edge of the page (in twips) right Margin from the right edge of the page (in twips)
Accessors
-
long getTop() - Margin from the top edge of the page (in twips)
-
long getBottom() - Margin from the bottom edge of the page (in twips)
-
long getLeft() - Margin from the left edge of the page (in twips)
-
long getRight() - Margin from the right edge of the page (in twips)
13.14 Option Interface
The Option Interface provides the methods and properties to retrieve information about an Outside In Option.
Package
com.oracle.outsidein.options
Accessors
-
String getName() — Gets the name of the option
-
String getDescription() — Gets the description of the option
-
Class<?> getDataType() — Gets the type of the option value.
-
Class<?>[] getItemTypes() — Gets the type parameters for option values that are generics
-
EnumSet<Option.OutsideInProducts> getSupportingProducts() — Gets the list of products that support this option
Methods
void set(OptionsCache exporter, Object objValue) throws OutsideInException;
This method sets the option to the exporter object and returns the exporter object itself.
-
exporter — The exporter object
-
objValue — Value of the option
Note:
If the type of objValue cannot be converted to the data type the option is expecting, an OutsideInException is thrown.
Object get(OptionsCache exporter)
This method gets the currently set value for the option.
-
exporter: The exporter object who’s option value is requested.
OutsideInProducts Enumeration
-
HTMLEXPORT — Outside In HTML Export
-
IMAGEEXPORT — Outside In Image Export
-
PDFEXPORT — Outside In PDF Export
-
SEARCHEXPORT — Outside In Search Export
-
WEBVIEWEXPORT — Outside In Web View Export
-
XMLEXPORT — Outside In XML Export
13.15 Options
This Enum describes all the options that Outside In supports. This implements the Option interface.
Namespace
com.oracle.outsidein.options
13.16 OutsideIn Class
This is a utility class that creates an instance of an Exporter object on request.
Namespace
com.oracle.outsidein
Methods
static Exporter newLocalExporter()
This method creates an instance of an Exporter object. It returns a newly created Exporter object.
static Exporter newLocalExporter(Exporter source)
This method creates and returns an instance of an Exporter object based on the source Exporter. All the options of source are copied to the new Exporter. The source and destination file information will not be copied.
OutsideInVersion getCoreVersion()
This static method returns an OutsideInVersion object with information describingthe Outside In Core Technology used.
void setLocation(File oilinkDir)
Sets an explicit path to the native Outside In libraries and oilink.exe. If used, this method must be called prior to any other Outside In method or this method will throw an exception. If setLocation() is not used, the location will be determined by searching for the Outside In libraries in the following order:
-
the location specified in the 'OILinkLocation' Java property
-
the 'oit' subdirectory under the directory containing oilink.jar
-
the directory containing oilink.jar
13.17 OutsideInVersion Class
The OutsideIn Class is used to describe the version of the Outside In Core Module.
Namespace
com.oracle.outsidein
Methods
String GetVersion()
This method returns the version information as a string in the format of “MajorVersion.MinorVersion.DotVersion”.
int getMajorVersion()
The major version component.
int getMinorVersion()
The minor version component.
int getDotVersion()
The dot version component.
13.18 OutsideInException Class
This is the exception that is thrown when an Outside In Technology error occurs.
This class derives from the Exception class. This class has no public methods or properties except those of the parent Exception class.
Namespace
com.oracle.outsidein
13.19 PageInfo Class
PageInfo is a class for defining page dimensions.
Namespace
com.oracle.outsidein.options
Constructor
PageInfo(PageInfo.PageSizeUnitsValue units, float width, float height) units Units used to specify width and height width Width of the page height Height of the page
Accessors
-
PageInfo.PageSizeUnitsValue getUnits() - Units used to specify width and height
-
float getWidth() - Width of the page
-
float getHeight() - Height of the page
PageInfo.PageSizeUnitsValue Enumeration
PageSizeUnitsValue is an enumeration of the various units that can be used to specify the width and height of a page.
-
INCHES: Units are in Inches
-
POINTS: Units are in Points (1/72th of an inch)
-
CENTIMETERS: Units are in Centimeters
-
PICAS: Units are in Picas (1/6th of an inch)
13.20 PageRange Class
PageRange is a class for defining page ranges for exporting purposes.
Namespace
com.oracle.outsidein.options
Constructors
PageRange()
Creates an instance of the PageRangeObject for printing all pages.
PageRange(long StartPage) StartPage Starting page number of the print range
Creates an instance of the PageRangeObject for printing from a page until end of document.
PageRange( long StartPage, long StopPage) throws OutsideInException StartPage Starting page number of the print range StopPage End page number of the print range
Creates an instance of the PageRangeObject for printing a range of pages.
Accessors
-
boolean getPrintAll() - If set to true, all pages of the document will be printed
-
long getStartPage() - The start page of the print range. 0 indicates printing will begin with the first page of the document.
-
long getStopPage() - The last page of the print range. 0 indicates the last page at the end of the document.
13.21 StampAnnotation Class
StampAnnotation is the class for defining stamp annotations. This class derives from the Annotation class.
The StampAnnotation type exposes the following members.
Namespace
com.oracle.outsidein.annotations
Constructors
StampAnnotation(long userId, long sectionIx, long Top, long Left, long Width, long Height, Annotation.UnitTypeValue units, float opacity, StampAnnotation.SizingMethodValue sizemode, String stampName) userId User Data sectionIx 0-based page/sheet/image/slide index Top Top coordinate or row Left Leftmost coordinate or column Width Width of area in coordinates or columns Height Height of area in coordinates or rows Units Unit type Opacity Opacity of the annotation. Range 0.0 - 1.0; 0==invisible Sizemode Image sizing method stampName Name of the stamp
Accessors
SizeMode: Sizing method of the source image
void setSizeMode(StampAnnotation.SizingMethodValue) StampAnnotation.SizingMethodValue getSizeMode()
StampName: Registered name of stamp image
void setStampName(String) String getStampName()
SizingMethodValue Enumeration
The SizingMethodValue is an enumeration of the sizing methods that can be applied to the image.