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