This chapter lists how the service checks outputs for empty pages and what it stores about failed pages and render times.
Empty-page check
Property
Value
Checked outputs
Every page of each PDF file and every PNG image of report runs, display prints and the Vision Report Print symbol. Excel and CSV files are not checked
When
After the files are created and named, before the local copy, mail, Teams, printing and the approval draft
Resolution
PDF pages are rendered at 50 dpi; images are read at full size
Empty when
Less than 0.01 % of the measured area differs from the page's most frequent color by more than 48 of 255 in a color channel
Not measured
The top 75 pt and the bottom 40 pt of PDF pages, where the header and footer are drawn
Result
Error "Page <n> of '<file>' appears empty." (or "Image '<file>' appears empty."), annotation VRP.Error.EmptyPageDetected; the run ends Completed with Errors and an approval report does not start approval
Report field
HoldDeliveryOnEmptyPage (Hold delivery when a page appears empty), report JSON, default false
With the field on
No mail, Teams message or printing for that run; error "Email, Teams and printing were skipped because a page appears empty ...", annotation VRP.Error.DeliveryHeld. Local copy and stored files remain
Display prints
Report an empty page as a warning ("Printed with warnings"). The Vision Report Print symbol in report mode also holds its mail and printer delivery when the report has the field on
Failure evidence
Property
Value
Recorded for
The last failed attempt of a display render (PDF, image or table export), and every render that was running when the run reached Service:MaxExecutionMinutes
Files
evidence-page-<n>.jpg (screenshot of the browser viewport, JPEG quality 60) and evidence-page-<n>.txt (JSON record); collection items evidence-page-<n>-item-<m>; display prints page 0
Stored as
Annotation attachments of the execution event frame with the description Failure evidence from <execution>; never used as output
Record fields
Page, Item, PageTitle, PageType, Operation, FailedStep, DisplayUrl (without user name or password), StartTime, EndTime, TimeZone, Asset, ElapsedMs, Attempts, Error, CapturedAt, ScreenshotOmitted, ScreenshotError
Failed steps
wait for render slot, open browser, navigate, sign in, wait for display, page frames, fit, zoom, pdf, image, table export
Limits per run
10 records and 5 screenshots; a screenshot over 1.5 MB is left out (ScreenshotOmitted)
Later attempts
When the same execution is processed again, its earlier evidence and render times are replaced
Errors
Capturing or storing evidence never changes the result of the run; problems are logged as warnings
Page render times
Property
Value
Stored as
Annotation VRP.Diagnostics.PageRenderTimes of the report execution, JSON list of Page, Title (placeholders replaced), PageType, DurationMs, Files, Failed
Recorded for
Report runs (not display prints), up to 100 pages
Shown as
Page render times in the execution details of runs that failed or completed with errors (collapsed)
