SAIF.Services.Printing business rules

This page captures business rules enforced by SAIF.Services.Printing.

BR-PRT-001 Package name extension normalization

Field	Value
Statement	A package name ending in .pkg is stored without the extension.
Trigger	Any assignment to Package (including via previewPDF, previewDocument, distributeDocument)
Enforcement	SAIF.Services.Printing/clsPrint.vb — Package setter
Outcome	xPression receives the bare package name it expects
Source	SAIF.Services.Printing/clsPrint.vb

---

BR-PRT-002 Environment label derivation

Field	Value
Statement	The print environment label is Prod when the environment service reports production, otherwise Dev.
Trigger	clsPrint construction
Enforcement	SAIF.Services.Printing/clsPrint.vb — New(envSvc)
Outcome	Environment exposes a two-valued environment label to callers
Source	SAIF.Services.Printing/clsPrint.vb

---

BR-PRT-003 Synchronous versus queued distribution

Field	Value
Statement	Distribution is queued through MSMQ when Asynchronous is true, and sent directly to the xPression service otherwise.
Trigger	distributeDocument
Enforcement	SAIF.Services.Printing/clsPrint.vb — private distributeDocument
Outcome	Caller is decoupled from the print service when asynchronous
Source	SAIF.Services.Printing/clsPrint.vb

---

BR-PRT-004 Transactional MSMQ send

Field	Value
Statement	Every MSMQ send occurs inside a transaction; if the caller did not start one, a transaction is started and committed for that single message.
Trigger	Asynchronous distributeDocument
Enforcement	SAIF.Services.Printing/clsPrint.vb — private distributeDocument, StartMQTransaction, EndMQTransaction
Outcome	The transactional queue always receives messages transactionally
Source	SAIF.Services.Printing/clsPrint.vb

---

BR-PRT-005 MSMQ failure rollback

Field	Value
Statement	A failure while queueing a distribution rolls back the MSMQ transaction and rethrows.
Trigger	Exception in the asynchronous branch
Enforcement	SAIF.Services.Printing/clsPrint.vb — Catch in private distributeDocument
Outcome	No partially queued print request survives a failure
Source	SAIF.Services.Printing/clsPrint.vb

---

BR-PRT-006 Fixed paper tray for synchronous distribution

Field	Value
Statement	Synchronous distribution always requests paper tray 2.
Trigger	Synchronous distributeDocument
Enforcement	SAIF.Services.Printing/clsPrint.vb — PaperTray.Tray2 argument
Outcome	Direct distributions print from a fixed tray regardless of caller intent
Source	SAIF.Services.Printing/clsPrint.vb

---

BR-PRT-007 Render result caching

Field	Value
Statement	A report is rendered only once unless the caller requests an overwrite.
Trigger	ReportBase.Render
Enforcement	SAIF.Services.Printing/Reporting/ReportBase.vb — Render
Outcome	Repeat calls reuse the cached ReportFile and avoid another xPression round trip
Source	SAIF.Services.Printing/Reporting/ReportBase.vb

---

BR-PRT-008 Render and distribute preconditions

Field	Value
Statement	A report can be rendered or distributed only when its XML document exists and a report package is assigned.
Trigger	ReportBase.Render, ReportBase.Distribute
Enforcement	SAIF.Services.Printing/Reporting/ReportBase.vb
Outcome	Incomplete reports return False instead of calling xPression
Source	SAIF.Services.Printing/Reporting/ReportBase.vb

---

BR-PRT-009 Default printer and security platform selection

Field	Value
Statement	The printer used for rendering is the current security principal's default printer, resolved for the Web platform when running in a web context (per EnvironmentServiceBase.IsWeb) and for Windows otherwise.
Trigger	ReportBase.Render
Enforcement	SAIF.Services.Printing/Reporting/ReportBase.vb — Render
Outcome	Output is targeted at the user's own default printer
Source	SAIF.Services.Printing/Reporting/ReportBase.vb

---

BR-PRT-010 Non-throwing render and distribute failures

Field	Value
Statement	Render and distribute failures are recorded as ErrorDetail entries rather than thrown.
Trigger	Exception during Render or Distribute
Enforcement	SAIF.Services.Printing/Reporting/ReportBase.vb
Outcome	Callers inspect Errors and the operation returns False
Source	SAIF.Services.Printing/Reporting/ReportBase.vb

---

BR-PRT-011 Rendered file extension fixed by format

Field	Value
Statement	The rendered file extension is fixed by the selected report format (CSV→csv, Excel→xls, HTML→html, Image→jpeg, PDF→pdf, Word→doc, XML→xml).
Trigger	Assignment to clsRSPrint.Format
Enforcement	SAIF.Services.Printing/clsRSPrint.vb — Format setter
Outcome	SSRS is asked for a format/extension pair that agree
Source	SAIF.Services.Printing/clsRSPrint.vb

---

BR-PRT-012 SSRS distribution not supported

Field	Value
Statement	SSRS distribution is not supported.
Trigger	clsRSPrint.DistributeDocument
Enforcement	SAIF.Services.Printing/clsRSPrint.vb
Outcome	NotImplementedException is thrown
Source	SAIF.Services.Printing/clsRSPrint.vb

---

BR-PRT-013 Print and distribute report unconditional success

Field	Value
Statement	The xPression print and distribute entry points always report success.
Trigger	printPDF, distributeDocument
Enforcement	SAIF.Services.Printing/clsPrint.vb
Outcome	Return value is True regardless of downstream outcome; failures surface only as exceptions
Source	SAIF.Services.Printing/clsPrint.vb

---

BR-PRT-014 Destination file overwrite protection

Field	Value
Statement	An existing destination file is not replaced unless the caller requests an overwrite, and saving requires a destination file name.
Trigger	ReportBase.Save
Enforcement	SAIF.Services.Printing/Reporting/ReportBase.vb — Save
Outcome	Existing output files are protected from accidental replacement
Source	SAIF.Services.Printing/Reporting/ReportBase.vb

---

BR-PRT-015 Draft versus final output profile

Field	Value
Statement	Draft output uses the PDF_Draft_Watermark profile and final output uses the PDF profile.
Trigger	SetDraftProfile / SetDefaultProfile
Enforcement	SAIF.Services.Printing/Reporting/ReportBase.vb
Outcome	Draft renderings carry a watermark
Source	SAIF.Services.Printing/Reporting/ReportBase.vb

---

BR-PRT-016 Key propagation for nested repeating sections

Field	Value
Statement	Every primary key on an element, and every foreign key it inherited, is repeated as a foreign key on each descendant element that itself has children.*
Trigger	First (top-level) call to ToXpression
Enforcement	SAIF.Services.Printing/Reporting/XDesignXElement.vb — PropagateKeys
Outcome	xPression receives the key context it needs to associate nested repeating sections with their parents*
Source	SAIF.Services.Printing/Reporting/XDesignXElement.vb

---

BR-PRT-017 Empty-value self-closing elements

Field	Value
Statement	An element with an empty value is emitted as a self-closing tag.
Trigger	ToXpression rendering of a leaf element
Enforcement	SAIF.Services.Printing/Reporting/XDesignXElement.vb — RenderElement
Outcome	Empty data points are represented without an empty text node
Source	SAIF.Services.Printing/Reporting/XDesignXElement.vb

---

BR-PRT-018 XML value escaping

Field	Value
Statement	Element values are XML-escaped before emission.
Trigger	ToXpression rendering of a non-empty leaf
Enforcement	SAIF.Services.Printing/Reporting/XDesignXElement.vb — RenderElement
Outcome	Data containing markup characters cannot corrupt the xPression document
Source	SAIF.Services.Printing/Reporting/XDesignXElement.vb

---

BR-PRT-019 Empty serialization for malformed documents

Field	Value
Statement	A document with no root, or whose root is not an xPression element, serializes to an empty string.
Trigger	XDesignXDocument.ToXpression
Enforcement	SAIF.Services.Printing/Reporting/XDesignXDocument.vb
Outcome	Malformed documents produce no xPression payload instead of an error
Source	SAIF.Services.Printing/Reporting/XDesignXDocument.vb

---

BR-PRT-020 SSRS execution under hosting process identity

Field	Value
Statement	SSRS reports execute under the hosting process's default Windows credentials.
Trigger	clsRSPrint.PreviewDocument
Enforcement	SAIF.Services.Printing/clsRSPrint.vb
Outcome	Report-level data authorization is delegated to the SSRS server and the process identity
Source	SAIF.Services.Printing/clsRSPrint.vb

Notes

Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts. Statements marked with ** could not be confirmed; treat as unknown until verified.

Related documentation

• Index
• Overview
• Architecture
• Dependencies
• Operations and processes
• Configuration
• API reference

Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts. Statements marked with ** could not be confirmed; treat as unknown until verified.

Sources

• SAIF.Services.Printing/clsPrint.vb
• SAIF.Services.Printing/clsRSPrint.vb
• SAIF.Services.Printing/Reporting/IReport.vb
• SAIF.Services.Printing/Reporting/ReportBase.vb
• SAIF.Services.Printing/Reporting/XDesignXDocument.vb
• SAIF.Services.Printing/Reporting/XDesignXElement.vb
• SAIF.Services.Printing/clsPrint.vb
• SAIF.Services.Printing/clsRSPrint.vb
• SAIF.Services.Printing/Reporting/ReportBase.vb
• SAIF.Services.Printing/Reporting/XDesignXDocument.vb
• SAIF.Services.Printing/Reporting/XDesignXElement.vb