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
DXP91xxcodes travel onReportExpressionException.DiagnosticCode: a failing expression is a result for the caller to handle.DXP92xxcodes are reported throughReportRunOptions.Diagnosticsand kept onReportInstance.Diagnostics. The ones that stop a run travel onReportProcessingException.DiagnosticCode.DXP93xxcodes are reported throughReportPaginationOptions.Diagnosticsand kept onReportPageModel.Diagnostics.