Makes the render observable. The document itself is streamed straight to the
browser as a download and is not stored anywhere, so there is nothing to hand
back — what the host page is missing is only whether the render started,
finished, or failed.
Practical Application
'started' — disable the export button and show a spinner; a server-side
render is not instant and a second click starts a second render.
'ready' — re-enable it; the download has been handed to the browser.
'failed' — surface an error instead of leaving the user waiting forever.
AI Coding Best Practices
Drive UI state off this and nothing else — there is no document handle to wait
for. Keep a timeout of your own too: a configurator without this event will
never report. Failure detail, when the configurator supplies any, arrives on
statusMessageChanged rather than here.
Lifecycle of a GetPdf render.
What does it unlock?
Makes the render observable. The document itself is streamed straight to the browser as a download and is not stored anywhere, so there is nothing to hand back — what the host page is missing is only whether the render started, finished, or failed.
Practical Application
'started'— disable the export button and show a spinner; a server-side render is not instant and a second click starts a second render.'ready'— re-enable it; the download has been handed to the browser.'failed'— surface an error instead of leaving the user waiting forever.AI Coding Best Practices
Drive UI state off this and nothing else — there is no document handle to wait for. Keep a timeout of your own too: a configurator without this event will never report. Failure detail, when the configurator supplies any, arrives on
statusMessageChangedrather than here.