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 Reserved: nothing reports it. An input no reader recognises throws InvalidDocumentException, and an output extension with no writer throws UnsupportedFeatureException.

Document structure

Code Meaning
DXP1001 Legacy compatibility mode in force
DXP1002 Missing style reference
DXP1003 Missing numbering definition
DXP1004 Placeholder with no value supplied
DXP1005 A workbook cell refers to a shared string, cell format or shared formula the workbook does not define (XlsxDocument; reported once per sheet and kind)

Unsupported and preserved content

Code Meaning
DXP2001 Unsupported element
DXP2002 Unsupported feature
DXP2003 A part or markup DocWright does not read, kept as it was and saved back
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 Reserved: nothing reports it. Exceeding a limit throws ResourceLimitExceededException (LimitName, ObservedValue) instead.

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 Reserved: nothing reports it. Protection settings are read, preserved on save and never enforced. Read WordDocument.Settings.Protection to see whether a document asks to be protected.
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 chart or gauge panel whose data was not processed, or a tablix nested in a data region's cell; 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
DXP9306 A report property is read but not applied as the reference applies it: a NoRowsMessage on an empty chart or gauge panel (the empty item is drawn), or right-to-left text (drawn in logical order, unshaped); reported once per item
DXP9307 A report property holds a constant Reporting Services doesn't accept for it — bold for a font weight (it compares exactly), DashDot for a text box's border. Raised by ReportValidator; Reporting Services refuses to render the report
DXP9308 A schema upgrade kept part of a report definition in its old shape — a 2005 chart or custom report item. Raised by ReportDefinitionUpgrade.Upgrade; nothing is dropped, but the definition isn't valid in the new schema until that part is rebuilt

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 range, polar, funnel, pyramid or three-dimensional plot, values of zero or below on a logarithmic axis, a plot too small to draw in, or what Reporting Services itself refuses: a marker on a series rather than its data point (not drawn), a data label positioned Outside (placed as Auto) From Phase 95 also, once per chart, the decoration it states and DocWright does not draw: a hatch type that isn't one of GDI+'s, PaletteHatchBehavior Always on series other than columns, bars and slices, the border skin, the chart area's border, and gradients, hatches and shadows on range, stock, radar and polar series, strip lines, data labels, axis titles, the legend's title, the no-data message and empty points.
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: the 47 custom frame shapes, AutoShape round a radial scale, the glass's darkening of the parts on a face, images, logarithmic or reversed scales, a hatch type that isn't one of GDI+'s (background colour drawn), a gradient with no end colour (start colour drawn), the eight shaded cap styles (flat disc drawn) and a cap's reflection, turned labels on a linear scale (drawn level), 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
DXP9409 Part of a map is not drawn as the reference draws it — a tile layer, a shapefile, spatial data from a data region, the Optimal distribution (drawn as equal intervals), the Random palette, size, marker and centre-point rules, a legend, colour scale, distance scale or border skin that would show, a custom view, or a shape whose spatial data is not WKB or WKT. One diagnostic per map; a map the reference refuses to draw keeps its box From Phase 95 also: a hatch type that isn't one of GDI+'s, a title's background, gradients, hatches and shadows on legends and scales, and the map item's own decoration.

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.