Table of Contents

Diagnostic codes

Every recoverable degradation DocWright reports carries one of these codes. They are constants on DocWright.Core.Diagnostics.DiagnosticCodes: match on the code, never on the message text. See Diagnostics and strict mode for how to collect them.

General

Code Meaning
DXP0001 Pipeline unavailable

Document structure

Code Meaning
DXP1001 Legacy compatibility mode in force
DXP1002 Missing style reference
DXP1003 Missing numbering definition
DXP1004 Placeholder with no value supplied

Unsupported and preserved content

Code Meaning
DXP2001 Unsupported element
DXP2002 Unsupported feature
DXP2003 Unknown part preserved
DXP2004 External resource not fetched
DXP2005 Structure collapsed on export
DXP2006 Layout approximated on export
DXP2007 Metafile picture not played; placeholder drawn
DXP2008 Metafile played with some record kinds skipped
DXP2009 A chart stated a value-axis scale that could not be drawn; the automatic scale was used

Fonts

Code Meaning
DXP3001 Font fallback applied
DXP3002 Font not found
DXP3003 Font data recovered
DXP3004 Font substitution summary
DXP3005 Glyph fallback applied
DXP3006 Symbol-font text kept its private-use codepoints

Limits

Code Meaning
DXP4001 Resource limit exceeded

Fields

Code Meaning
DXP5001 Field not evaluated
DXP5002 Field evaluation error
DXP5003 Field external resource skipped

Encryption, protection and signatures

Code Meaning
DXP6001 Document encrypted
DXP6002 Unsupported encryption scheme
DXP6003 Document decrypted
DXP6004 Protection not enforced
DXP6005 Signature present — saving will invalidate it

Conformance

Code Meaning
DXP7001 Conformance degraded

PDF input and assembly

Code Meaning
DXP8001 PDF operator not implemented
DXP8002 PDF feature not supported
DXP8003 PDF cross-reference rebuilt
DXP8004 PDF stream length recovered
DXP8005 PDF image not decoded
DXP8006 PDF font program not usable
DXP8007 PDF colour space approximated
DXP8008 PDF decrypted
DXP8009 PDF permissions denied
DXP8010 PDF annotation not painted
DXP8011 PDF assembly removed a source's encryption
DXP8012 PDF assembly dropped the structure tree
DXP8013 PDF assembly removed a link or destination
DXP8014 PDF assembly removed an outline entry
DXP8015 PDF assembly dropped an interactive form
DXP8016 PDF assembly dropped a document-level entry

Report definitions

Code Meaning
DXP9001 Report definition schema version not recognized
DXP9002 Report measurement clamped
DXP9003 Report measurement not a size
DXP9004 Report name used twice where it must be unique
DXP9005 Report refers to a dataset or data source it does not define

Report expressions

Code Meaning
DXP9101 Report expression not valid — the reference refuses the whole report
DXP9102 Report expression uses something DocWright does not evaluate
DXP9103 Report custom code not executed
DXP9104 Page number or page name read outside pagination
DXP9105 Report expression failed at run time — the reference's #Error
DXP9106 Report expression names something the context does not supply
DXP9107 Report expression names a scope that is not valid where it is used

Report processing

Code Meaning
DXP9201 Report dataset not supplied by the data provider; processed as empty
DXP9202 Report data provider returned a value its own schema does not allow; the run stops
DXP9203 Report parameter has no valid value, or a literal in its definition is not valid
DXP9204 Report parameter reads a parameter declared after it
DXP9205 Report field missing from the data the provider returned
DXP9206 Report sort, group or filter could not compare its values, or a filter's count is not a number
DXP9207 Report dataset collation not recognized; the report language's order is used
DXP9208 Report item not processed in this version: an RDL 2005 Table, Matrix or List
DXP9209 Report calculated field, variable or textbox depends on itself
DXP9210 Report expression uses something RDL forbids where it is written
DXP9211 A subreport was not run: no SubreportResolver was supplied, the resolver returned no definition, or the child's own run failed; its box is kept

Report pagination

Code Meaning
DXP9301 Report item not drawn by this version of pagination — a map, or a chart or gauge panel whose data was not processed; its place and size are kept
DXP9302 Report text has a character the run's face, and every fallback face, has no glyph for
DXP9303 Report style value not valid, such as a size or colour that does not parse; its default is used
DXP9304 Report page leaves no room for the body once margins, header, footer and columns are taken out
DXP9305 Report font family answered by a different face on this host, so text in that family is measured with the stand-in; reported once per family

Report items

Code Meaning
DXP9401 A report image's source did not resolve — an embedded image the report does not contain, a database value that is not image bytes, or a resolver that declined
DXP9402 A report image is External and no ImageResolver was supplied, so its reference was not fetched
DXP9403 A report image's bytes are not a PNG or a JPEG, so they are not drawn
DXP9404 A chart has no values to plot; its frame is drawn and its plot is empty
DXP9405 Part of a chart is not drawn — a scatter, bubble, range, stepped, polar, funnel, pyramid or three-dimensional plot, a stacked subtype drawn unstacked, or a plot too small to draw in
DXP9406 A custom report item was not drawn: no drawer is registered for its type, the drawer declined or failed, or its barcode could not be encoded
DXP9407 Part of a gauge panel is not drawn as the reference draws it — named once per gauge: frames, images, pins, thermometers, logarithmic or reversed scales, gradients (solid drawn), cap shading (flat disc drawn), rotated labels, parts left to the reference's designer defaults, numeric indicators and gauge images
DXP9408 A report border names a style Reporting Services will not render — DashDot, DashDotDot, Groove, Ridge, Inset, Outset or WindowInset. The border is drawn solid at its stated width and colour

Report viewer and export

Code Meaning
DXP9501 An action's URL was not written into an HTML projection because its scheme is not one a viewer may follow; it is in the region map, marked as not navigable
DXP9502 Part of a report reached an export in a reduced form, or not at all — an item a format cannot carry, a border style it cannot draw, or content outside the rows a data export describes
DXP9503 An image was not embedded in an HTML projection because its content type is not one a browser renders from a data: URL; its box and its region are kept
DXP9504 An interactive sort request was not applied — it names no textbox the report has, or one with no UserSort, or the UserSort names a scope or target the report does not have, or a target that does not contain the scope. The report keeps its authored order; StrictMode stops the run

Where report codes are reported

  • DXP91xx codes travel on ReportExpressionException.DiagnosticCode: a failing expression is a result for the caller to handle.
  • DXP92xx codes are reported through ReportRunOptions.Diagnostics and kept on ReportInstance.Diagnostics. The ones that stop a run travel on ReportProcessingException.DiagnosticCode.
  • DXP93xx codes are reported through ReportPaginationOptions.Diagnostics and kept on ReportPageModel.Diagnostics.