DocumentDeferredService¶

Implements IDocumentDeferredService, supporting the certified-mail deferred print workflow: it reads XPression output-tracking XML to determine sheet counts, builds CertifiedLabelData for the ISimpleCertifiedMailServiceProxy from a DocumentLabelData payload, deserializes/normalizes label data (including splitting ZIP+4 codes) from JSON, and validates required certified-mail address fields.

Purpose¶

Determines the number of physical sheets in a generated document batch by reading an XPression-produced tracking XML file from the configured output directory.
Builds a CertifiedLabelData request for the certified-mail service from label data, normalizing ZIP/ZIP+4 formatting.
Deserializes and normalizes label data supplied as a JSON string (splitting combined 9-digit ZIPs into ZIP and ZIP+4).
Validates that all required certified-mail "from"/"to" address fields are present, returning the first missing-field message.

Context¶

Namespace: SAIF.Services.Documents
Assembly/package: SAIF.Services (packaged inside the SAIF.SAIFCode.Core NuGet package)

Public members¶

Member	Signature	Purpose
DocumentDeferredService(...)	`public DocumentDeferredService(Proxy.ISimpleCertifiedMailServiceProxy certifiedMailService, IEnvironmentService environmentService)`	Stores the certified-mail service proxy and environment collaborators, requiring both to be non-null.
SheetCount	`public long SheetCount(string itemXml)`	Locates the XPression `DC40-CertifiedSheetCount.ps.xml` tracking file in the configured output directory and returns the `TotalSheetsInPackage` attribute value found there, defaulting to `1` if no matching attribute is found, or `0` if no tracking file exists.
GetCertifiedLabel	`public CertifiedLabelData GetCertifiedLabel(DocumentLabelData documentLabelData)`	Builds a `CertifiedLabelData` request (from/to address, contact, credentials, and page count) from `documentLabelData` for submission to the certified-mail service, defaulting a blank ZIP+4 to four spaces.
GetDocumentLabel	`public DocumentLabelData GetDocumentLabel(string labelValues)`	Deserializes `labelValues` (JSON) into a `DocumentLabelData`, splitting any 9+ digit ZIP into a 5-digit ZIP and separate ZIP+4, and normalizing a literal `"0000"` ZIP+4 to blank spaces.
AddressErrorMessage	`public string AddressErrorMessage(DocumentLabelData certifiedLabelData)`	Returns the first descriptive error message for a missing required certified-mail "from"/"to" address field, or an empty string if all required fields are present.

Behavioral notes¶

SheetCount ignores its itemXml parameter's originally intended per-batch document key lookup (that logic is commented out) and instead always searches for the same fixed DC40-CertifiedSheetCount.ps.xml filename*.
AddressErrorMessage checks fields in a fixed order and returns on the first failure, so only one missing-field message is ever surfaced per call even if multiple fields are blank.

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¶

Services/SAIF.Services/Documents/DocumentDeferredService.cs