---
title: Configuration settings
summary: Configuration keys consumed by this library, retrieval methods, and runtime dependencies.
status: draft
owner: Technical Writer
last_reviewed: 2026-07-31
library: SAIF.Business.Policy.Correspondence
reference_type: package
---

# Configuration settings

`SAIF.Business.Policy.Correspondence` reads one direct runtime setting, `ImagingApiUrl`, through `AppGlobal.EnvironmentService.GetConfigSetting(...)`. The value is used to construct a shared `ImagingClient` for endorsement-image reconciliation and is cached for the lifetime of the process.*

## Configuration retrieval methods

| Method | Class / Interface | Namespace | Usage pattern |
| --- | --- | --- | --- |
| `GetConfigSetting` | `IEnvironmentService` via `AppGlobal.EnvironmentService` | `SAIF.Framework.Security` | Resolves the imaging API base URL the first time `clsEndorsementCollection.ImagingApiClient` is accessed. |
| `GetSecureConfigSetting` | `IEnvironmentService` | `SAIF.Framework.Security` | Not used. |
| `ConfigurationManager.AppSettings` | — | `System.Configuration` | Not used. |
| `DbConnectionManager` | — | SAIF BOF framework | Not used; Oracle access comes from caller-supplied `IDataPortalInfo`. |
| `ApplicationSettingsBase` (`My.Settings`) | `MySettings` | `SAIF.Business.Policy.Correspondence.My` | Designer scaffolding only; no runtime settings are consumed. |

## Environment API settings

| Setting key | Method | Data type | Purpose | Consuming class | Source |
| --- | --- | --- | --- | --- | --- |
| `ImagingApiUrl` | `GetConfigSetting` | String | Base URL for the Imaging API client used during image reconciliation. | `clsEndorsementCollection` | `Business\SAIF.Business.Policy.Correspondence\clsEndorsementCollection.vb` |

## AppSettings (Web.config)

| Setting key | Default value | Purpose | Consuming class | Source |
| --- | --- | --- | --- | --- |
| — | — | This library defines and consumes no `appSettings` keys. | — | `Business\SAIF.Business.Policy.Correspondence\app.config`; `Business\SAIF.Business.Policy.Correspondence\Web.config` |

## Database connection configuration

| Connection name | Provider | Retrieval method | Purpose | Source |
| --- | --- | --- | --- | --- |
| — | Oracle.ManagedDataAccess | Caller-supplied `IDataPortalInfo` | Provides the Oracle context used by BOF SQL and stored-procedure calls. | `Business\SAIF.Business.Policy.Correspondence\clsCorrespondence.vb`; `Business\SAIF.Business.Policy.Correspondence\clsOutputDocumentInserter.vb` |

## Secure settings

| Setting key | Encryption method | Purpose | Consuming class | Source |
| --- | --- | --- | --- | --- |
| — | — | No secure configuration keys are read directly by this library. | — | `Business\SAIF.Business.Policy.Correspondence\clsEndorsementCollection.vb` |

## Transitive configuration (from dependencies)

| Setting key | Method | Source dependency | Dependency type | Purpose |
| --- | --- | --- | --- | --- |
| `Oracle portal configuration`** | BOF data portal | SAIF.BOF.Framework | NuGet | Supplies the runtime Oracle portal used by `IDataPortalInfo`. |
| `Imaging client HTTP plumbing`* | Internal client setup | SAIF.Web.API.Clients | NuGet | Supports the `ImagingClient` stack after `ImagingApiUrl` is resolved. |
| `Environment-service bootstrap`** | Ambient framework initialization | SAIF.Framework.Security / SAIF.Framework.Common | NuGet | Makes `AppGlobal.EnvironmentService` available to the library. |

## Configuration dependencies

| Dependency | Type | Required at | Impact if missing |
| --- | --- | --- | --- |
| `ImagingApiUrl` | Environment-service key | First use of image reconciliation | `ImagingClient` cannot be constructed and imaging reconciliation fails.* |
| `oracle.manageddataaccess.client` | Config section registration | Process startup | Oracle provider registration may fail. |
| `DbProviderFactories` registration for `Oracle.ManagedDataAccess.Client` | Config-file element | Process startup | BOF Oracle connectivity cannot initialize correctly. |


## Related documentation
- [Index](index.md)
- [Overview](overview.md)
- [Architecture](architecture.md)
- [Dependencies](dependencies.md)
- [Operations and processes](operations-processes.md)
- [Business rules](business-rules.md)
- [Database tables](database-tables.md)
- [SQL catalog](sql/index.md)
- [API reference](api/index.md)


> **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
- `Business\SAIF.Business.Policy.Correspondence\clsEndorsementCollection.vb`
- `Business\SAIF.Business.Policy.Correspondence\app.config`
- `Business\SAIF.Business.Policy.Correspondence\Web.config`
- `Business\SAIF.Business.Policy.Correspondence\packages.config`
- `Business\SAIF.Business.Policy.Correspondence\My Project\Settings.settings`
- `Business\SAIF.Business.Policy.Correspondence\My Project\Settings.Designer.vb`