---
title: SAIF.Services.Printing configuration settings
summary: Configuration keys consumed by this library, retrieval methods, and runtime dependencies.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-07-24
library: SAIF.Services.Printing
reference_type: package
---

# Configuration settings

`SAIF.Services.Printing` reads four runtime settings through `EnvironmentServiceBase.GetConfigSetting` and also carries two generated `ApplicationSettingsBase` web-service URL defaults for its SOAP proxies. The environment-service values drive normal runtime behavior, while the generated settings act as design-time defaults for the Web Reference proxies.

## Configuration retrieval methods

| Method | Class / Interface | Namespace | Usage pattern |
| --- | --- | --- | --- |
| `GetConfigSetting(String)` | `EnvironmentServiceBase` | `SAIF framework assemblies` | `clsPrint` and `clsRSPrint` call the injected or defaulted environment service to resolve SOAP endpoint URLs, MSMQ path, and IDM path at runtime. |
| `ApplicationSettingsBase` (`My.Settings`) | `System.Configuration.ApplicationSettingsBase` | `System.Configuration` | Generated Web Reference proxies expose design-time URL defaults through `My.Settings` properties in `Settings.Designer.vb`. |

## Environment API settings

| Setting key | Method | Data type | Purpose | Consuming class | Source |
| --- | --- | --- | --- | --- | --- |
| `documentGeneratorServiceUrl` | `GetConfigSetting` | `String` | Supplies the xPression SOAP endpoint URL. | `clsPrint` | `Services\SAIF.Services.Printing\clsPrint.vb` |
| `documentMSMQPath` | `GetConfigSetting` | `String` | Supplies the MSMQ queue path used for asynchronous distribution. | `clsPrint` | `Services\SAIF.Services.Printing\clsPrint.vb` |
| `idmFilePath` | `GetConfigSetting` | `String` | Supplies the IDM/imaging path returned by `IDMPath`. | `clsPrint` | `Services\SAIF.Services.Printing\clsPrint.vb` |
| `sqlReportingServiceUrl` | `GetConfigSetting` | `String` | Supplies the SSRS `ReportExecutionService` endpoint URL. | `clsRSPrint` | `Services\SAIF.Services.Printing\clsRSPrint.vb` |

## ApplicationSettingsBase defaults

| Setting property | Default value | Purpose | Consuming class | Source |
| --- | --- | --- | --- | --- |
| `SAIF_Services_Printing_xpresso_clsGenerate` | `http://xpressionsdev:8000/wsDocuments/clsGenerate.asmx` | Default Web Reference URL for the generated xPression proxy. | Generated `xpresso.clsGenerate` proxy | `Services\SAIF.Services.Printing\My Project\Settings.Designer.vb` |
| `SAIF_Services_Printing_SharepointReporting_ReportExecutionService` | `http://reports.saif.com/_vti_bin/ReportServer/ReportExecution2005.asmx` | Default Web Reference URL for the generated SSRS proxy. | Generated `SharepointReporting.ReportExecutionService` proxy | `Services\SAIF.Services.Printing\My Project\Settings.Designer.vb` |

## Custom configuration sections

| Section name | Handler type | Purpose | Source |
| --- | --- | --- | --- |
| `applicationSettings` | `System.Configuration.ClientSettingsSection` | Stores the generated Web Reference URL defaults exposed through `My.Settings`. | `Services\SAIF.Services.Printing\app.config` |
| `oracle.manageddataaccess.client` | `OracleInternal.Common.ODPMSectionHandler, Oracle.ManagedDataAccess` | Registers the Oracle managed provider factory for host environments. | `Services\SAIF.Services.Printing\app.config`, `Services\SAIF.Services.Printing\Web.config` |

## Transitive configuration (from dependencies)

| Setting key | Method | Source dependency | Dependency type | Purpose |
| --- | --- | --- | --- | --- |
| `documentGeneratorServiceUrl` | `GetConfigSetting` | `AppGlobal.EnvironmentService` | Runtime service | Delivers the xPression endpoint value consumed by `clsPrint`. |
| `documentMSMQPath` | `GetConfigSetting` | `AppGlobal.EnvironmentService` | Runtime service | Delivers the MSMQ queue path consumed by `clsPrint`. |
| `idmFilePath` | `GetConfigSetting` | `AppGlobal.EnvironmentService` | Runtime service | Delivers the IDM path returned by `clsPrint.IDMPath`. |
| `sqlReportingServiceUrl` | `GetConfigSetting` | `AppGlobal.EnvironmentService` | Runtime service | Delivers the SSRS endpoint consumed by `clsRSPrint`. |

## Configuration dependencies

| Dependency | Type | Required at | Impact if missing |
| --- | --- | --- | --- |
| `AppGlobal.EnvironmentService` | Service | Object construction | `clsPrint` and `clsRSPrint` cannot resolve runtime settings. |
| `documentGeneratorServiceUrl` | Setting key | xPression preview, print, and distribution | xPression operations cannot reach the SOAP service. |
| `documentMSMQPath` | Setting key | Asynchronous distribution | Queue-backed distribution cannot create or send MSMQ messages. |
| `idmFilePath` | Setting key | Distribution | Distribution requests cannot supply the IDM path expected by xPression. |
| `sqlReportingServiceUrl` | Setting key | SSRS preview | `clsRSPrint` cannot reach the SSRS execution service. |

## Related documentation
- [Library index](index.md)
- [Overview](overview.md)
- [Architecture](architecture.md)
- [Dependencies](dependencies.md)
- [Operations and processes](operations-processes.md)
- [Business rules](business-rules.md)
- [API reference](api/index.md)

## Sources
- `Services\SAIF.Services.Printing\clsPrint.vb`
- `Services\SAIF.Services.Printing\clsRSPrint.vb`
- `Services\SAIF.Services.Printing\Reporting\ReportBase.vb`
- `Services\SAIF.Services.Printing\My Project\Settings.Designer.vb`
- `Services\SAIF.Services.Printing\app.config`
- `Services\SAIF.Services.Printing\Web.config`
- `Services\SAIF.Services.Printing\SAIF.BOF.Services.Printing.vbproj`