Windward Engine API Reference
ReportText Class Members
See Also  Properties  Methods  Send comments on this topic.
net.windward.api.csharp Namespace : ReportText Class


Glossary Item Box

The following tables list the members exposed by ReportText.

Public Constructors

 NameDescription
Public ConstructorReportText ConstructorOverloaded.   
Top

Public Properties

 NameDescription
Public PropertyBaseDirectoryThe base directory used for relative files in the import tag. (Inherited from net.windward.api.csharp.Report)
Public PropertyBreakPageReturns true if a Ctrl-L is in the report for each page break. The default is false.  
Public PropertyCopyMetadataGet/set if the Windward metadata will be copied to the generated report. This can only occur if the template and generated report are both OpenXML files. The default is IF_NO_DATASOURCE. (Inherited from net.windward.api.csharp.Report)
Public PropertyDataModeAs the report is run, the data for each tag can also be placed in an associated data.xml file. This xml will have a node for each tag and depending on the settings, the node will contain the tag attributes and/or the data extracted from the datasource for that tag. This data file can be returned to the caller and/or embedded in the generated report. The embed option is only for OpenXML and PDF reports. (Inherited from net.windward.api.csharp.Report)
Public PropertyDataStreamThe stream to write the data.xml file to. As the report is run, the data for each tag can also be placed in an associated data.xml file. This xml will have a node for each tag and depending on the settings, the node will contain the tag attributes and/or the data extracted from the datasource for that tag. You may not set this if the DataMode includes DATA_MODE_EMBED. Setting this has no impact if DataMode == 0. You can only get the if DataMode != 0. If you did not set DataStream this will return a MemoryStream with the generated data.xml file in UTF-8. You should only call this after calling processComplete. (Inherited from net.windward.api.csharp.Report)
Public PropertyDebugHandlerThe debug handler assigned to this report if debugging. (Inherited from net.windward.api.csharp.Report)
Public PropertyDebugModeSet debug mode on or off. If debug mode is on, common user errors will be written to the report rather than throwing an exception. (Inherited from net.windward.api.csharp.Report)
Public PropertyDescriptionThe description of the document. For Windward Scout reports only, this will be written to the run entry in the database. (Inherited from net.windward.api.csharp.Report)
Public PropertyFontNameThe font used when formatting txt output. The default is Courier New.  
Public PropertyFontSizeGet the font size used when formatting txt output. This is set in TWIPS or 20ths of a point. So a value of 240 (the default) is 12 points.  
Public PropertyHyphenateGet/set if the generated report will be hyphenated (for PDF output only). (Inherited from net.windward.api.csharp.Report)
Public PropertyImportInfoGet all imports in the processed template. This must be called after processData as that is what finds the imports. You must set TrackImports = true; before processing for this value to be populated. (Inherited from net.windward.api.csharp.Report)
Public PropertyKeywordsThe keywords of the document. This are delimited by a ','. In html this will set the keywords meta-tag. (Inherited from net.windward.api.csharp.Report)
Public PropertyLocaleThis call set's the locale used in creating a report. If not set, the default is not the system locale - it is the locale of the report template. This affects; 1) The output report locale for html and rtf reports, 2) The charset used for txt reports, 3) The rules used for soft line breaks (this mostly affects Thai), and 4) the locale used for <wr:out>. The passed in value can be any locale or the values LOCALE_DEFAULT or LOCALE_SYSTEM. LOCALE_DEFAULT will use the locale in the report template. LOCALE_DEFAULT will use the system locale. (Inherited from net.windward.api.csharp.Report)
Public PropertyNumPagesReturns how many pages long a report is. Can only be called after process completes. For html and text reports (which by definition are 1 page long) it will return the number of pages it would be if it was a paged report. (Inherited from net.windward.api.csharp.Report)
Public PropertyOutputBuilderDataData to pass to the output builder. For the embedded Windward builder this is either null or the Office Application object. (Inherited from net.windward.api.csharp.Report)
Public PropertyParametersAdds a map that is used for ${variable} substitution. The key values cannot have any of the characters ${} in them. When ${key} is found in any tag, it is replaced with the matching value. The key and value are not evaluated in any way, it is just a text substitution. This replace occurs before any other evaluation of a tag so the value can have ${variable} values that will then be evaluated. This call sets the map so calling it a second time replaces the map passed in the first time. The map is copied so on return changes to the passed in map will not affect the data source. (Inherited from net.windward.api.csharp.Report)
Public PropertyPreservePodFramingTrue if UDT framing should be preserved for UDTs in the document. This is only valid for an OpenXML output format. (Inherited from net.windward.api.csharp.Report)
Public PropertyRemoveUnusedFormatsTrue if unused styles, fonts, etc. are not included in the generated report. Default is true. (Inherited from net.windward.api.csharp.Report)
Public PropertyRenderExtent (Inherited from net.windward.api.csharp.Report)
Public PropertyRenderPages (Inherited from net.windward.api.csharp.Report)
Public PropertyReportCharsetHtml and txt files are generated using a charset (the rest use unicode). Normally html files are generated using utf-8 (unicode) except for HTML_1 which uses the native charset. Txt files are normally generated using the native charset. The native charset is not the .NET native charset, it is the default charset set in the template document. This call allows you to force to charset the report is written in. The passed in value is the Windows codepage (Western Europe is 1252). This has nothing to do with reading in the template, it only affects the charset the output report is written in. The special enums CHARSET_* allow you to set this to values other than a specific charset. (Inherited from net.windward.api.csharp.Report)
Public PropertyReportTypeGet the report format of the output stream. (Inherited from net.windward.api.csharp.Report)
Public PropertyShowHeadersReturns true if the header and footers are printed in the report. False and they will not be printed. The default is false.  
Public PropertySubjectThe subject of the document. In html this will set the description meta-tag. (Inherited from net.windward.api.csharp.Report)
Public PropertyTagStyleThe style unprocessed tags are written out as. (Inherited from net.windward.api.csharp.Report)
Public PropertyTemplateDrillDownInfoThis is not part of the public API. The base directory used for template files in the drill-down tag. (Inherited from net.windward.api.csharp.Report)
Public PropertyTemplateVersionThe version of Windward/AutoTag this template was created for. The default is the latest major version number. (Inherited from net.windward.api.csharp.Report)
Public PropertyTimeoutGet/set the number of seconds to timeout generating a report. If the report takes longer than this amount of time, it will throw a TimeoutException. A time of 0 means there is no timeout. The default is 0. The count starts when you call processSetup but will only throw the exception in processData and processComplete. (Inherited from net.windward.api.csharp.Report)
Public PropertyTitleThe title of the document. In html this will set both the TITLE tag and the title meta-tag. (Inherited from net.windward.api.csharp.Report)
Public PropertyTrackErrorsEnable or disable the error handling and verify features. If they are enabled you can call getErrorInfo() to get a list of errors encounterred during the report generation. By default these features are turned off (disabled). Use a combination of ERROR_HANDLING bits to set a value for the property. (Inherited from net.windward.api.csharp.Report)
Public PropertyTrackImportsTrue if you want to call getImports after processing datasources. Default is false. (Inherited from net.windward.api.csharp.Report)
Public PropertyUseExternalOutputBuilderReturns true if it will use the external output builder. The external output builder must be loaded and be capable of rendering from the template type to the output type, using all properties set in the ProcessReport object. (Inherited from net.windward.api.csharp.Report)
Public PropertyUseMarginsIf true, then the left page margin will be included in the output, creating leading spaces for each line. If false, the page margins will be ignored and any paragraph with no left indent will start at the begining of a line. The default is false.  
Public PropertyUseSoftEolnIf true, then then soft line breaks will be inserted and paragraphs will wrap to the next line. If false then all paragraphs will be placed on a single line of output. The default is true.  
Top

Public Methods

 NameDescription
Public MethodAbortCall to abort the report processing. The report will throw a TimeoutException shortly after this is called. (Inherited from net.windward.api.csharp.Report)
Public MethodBatchNextGenerates the next document in the batch and returns the results of that document. Returns null if no more to run. Performs the equivilent of processData(), processComplete() for each generated report. (Inherited from net.windward.api.csharp.Report)
Public MethodBatchSetupPrepares the object to run batch reports. Call processSetup() before calling this method. Do not call processData() or processComplete() after calling this method.After this setup batchNext() can be called repetitively for each batched report. (Inherited from net.windward.api.csharp.Report)
Public MethodBuildSchemaCreate a UDT schema file for this template. (Inherited from net.windward.api.csharp.Report)
Public MethodCleanSelectsOverloaded. This is not part of the official API. This will convert selects to the parameter syntax. (Inherited from net.windward.api.csharp.Report)
Public MethodCloseCall when you are done with this object, including done with the OutputStream returned by getReport if that stream was created by ProcessReport. (Inherited from net.windward.api.csharp.Report)
Public MethodDisposePerforms application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. (Inherited from net.windward.api.csharp.Report)
Public MethodDuplicateOverridden. Creates and returns a copy of this object. You may call this before or after calling processData(). You may then call processData() on the created object. You must call this after calling processSetup() and before calling processComplete(). While this mostly does a deep copy, it does not do a deep copy of image data.  
Public MethodFindPodsFinds Pods Located in this document. You need to call setup and then this method. (Inherited from net.windward.api.csharp.Report)
Public MethodGetErrorInfoGet an object containing a set of errors encounterred during the report generation. To enable the errors tracking you have to turn this feature on by a call to setTrackErrors(true). (Inherited from net.windward.api.csharp.Report)
Public MethodGetReportReturn the final report. In the case of the ProcessReport(template) constructor, this is gauranteed to be of type MemoryStream. If an output stream was passed in on construction, this will return that stream. This can only be called after process() or processData(). For a ReportHtml with split pages enabled, the Pages property should be accessed instead. (Inherited from net.windward.api.csharp.Report)
Public MethodProcessCompleteProcess the final report and create the output. This must be called after processData and before getReport. This should only be called once for a given ProcessReport object! This method can only be called by objects create with Report(template) or Report(template, report). (Inherited from net.windward.api.csharp.Report)
Public MethodProcessDataOverloaded. Process a set of data for the report. This method can be called multiple times - but only once for each datasource. This method can only be called by objects create with ProcessReport(template) or ProcessReport(template, report). Do not pass in buffered streams if you have the option. ProcessReport wraps all streams in buffers, generally BufferedReader and BufferedWriter. (Inherited from net.windward.api.csharp.Report)
Public MethodProcessSetupOverloaded. Process the template and get the report ready to process data files. This should only be called once for a given Report object! This method can only be called by objects create with Report(template) or Report(template, report). (Inherited from net.windward.api.csharp.Report)
Public MethodUpdatePodsUpdate the framed UDTs in this template. You need to call setup, this method, and then complete. (Inherited from net.windward.api.csharp.Report)
Top

See Also

© 2019 All Rights Reserved.