org.eclipse.birt.report.engine.api
Interface IRunAndRenderTask

All Superinterfaces:
IEngineTask

public interface IRunAndRenderTask
extends IEngineTask

an engine task that runs a report and renders it to one of the output formats supported by the engine.


Field Summary
 
Fields inherited from interface org.eclipse.birt.report.engine.api.IEngineTask
CANCEL_ON_ERROR, CONTINUE_ON_ERROR, STATUS_CANCELLED, STATUS_FAILED, STATUS_NOT_STARTED, STATUS_RUNNING, STATUS_SUCCEEDED, TASK_DATAEXTRACTION, TASK_GETPARAMETERDEFINITION, TASK_RENDER, TASK_RUN, TASK_RUNANDRENDER, TASK_UNKNOWN
 
Method Summary
 IRenderOption getRenderOption()
           
 void run()
          runs the task to generate report document or other output format
 void setEmitterID(java.lang.String id)
          sets a specific emitter to use when generate output.
 void setRenderOption(IRenderOption options)
          set the rendering options
 
Methods inherited from interface org.eclipse.birt.report.engine.api.IEngineTask
addScriptableJavaObject, cancel, cancel, close, getAppContext, getCancelFlag, getEngine, getErrors, getID, getLocale, getLogger, getParameterDisplayText, getParameterValue, getParameterValues, getReportRunnable, getStatus, getTaskType, getULocale, setAppContext, setDataSource, setErrorHandlingOption, setLocale, setLocale, setLogger, setParameter, setParameterDisplayText, setParameterValue, setParameterValues, validateParameters
 

Method Detail

setRenderOption

public void setRenderOption(IRenderOption options)
set the rendering options


getRenderOption

public IRenderOption getRenderOption()
Returns:
the render option

run

public void run()
         throws EngineException
runs the task to generate report document or other output format

Throws:
EngineException

setEmitterID

public void setEmitterID(java.lang.String id)
sets a specific emitter to use when generate output. Used when there are more than one emitters that support a single format. One example is the FO-based PDF emitter and the new PDF emitter added in BIRT2.0. If this function is not called when there are more than 1 emitters that support a format, engine may arbitrarily pick one.

Parameters:
id - the identifier for the emitter


Copyright © 2005 Actuate Corp. All rights reserved.