Skip to content

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.

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