---
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
reference_type: package
---

# Configuration settings

`SAIF.Business.Policy` performs no programmatic configuration retrieval of its own. Its direct configuration surface is limited to Oracle provider registration, assembly binding redirects, and empty VB application-settings scaffolding, while runtime connection and environment settings are inherited from the BOF hosting stack.

## Configuration retrieval methods

| Method | Class / Interface | Namespace | Usage pattern |
| --- | --- | --- | --- |
| `GetConfigSetting` | `IEnvironmentService` | `SAIF.Core.Services` | Not used directly in live code. |
| `GetSecureConfigSetting` | `IEnvironmentService` | `SAIF.Core.Services` | Not used directly in live code. |
| `ConfigurationManager.AppSettings` | `ConfigurationManager` | `System.Configuration` | Not used directly in live code. |
| `My.Settings` | `SAIF.Business.Policy.My.MySettings` | `SAIF.Business.Policy.My` | Auto-generated settings class exists, but no typed settings are declared. |
| `DbProviderFactories` registration | Oracle managed driver | `System.Data` | Declarative provider registration in `app.config` and `Web.config`. |

## Environment API settings

| Setting key | Method | Data type | Purpose | Consuming class | Source |
| --- | --- | --- | --- | --- | --- |
| _(none)_ | — | — | No direct Environment API settings are retrieved by this library. | — | `Business\SAIF.Business.Policy\PolicyInformation.vb` |

## AppSettings (Web.config)

| Setting key | Default value | Purpose | Consuming class | Source |
| --- | --- | --- | --- | --- |
| _(none)_ | — | No `appSettings` keys are declared or read by this library. | — | `Business\SAIF.Business.Policy\Web.config` |

## Database connection configuration

| Connection name | Provider | Retrieval method | Purpose | Source |
| --- | --- | --- | --- | --- |
| Portal-based Oracle connection | Oracle.ManagedDataAccess | Caller-supplied `IDataPortalInfo.PortalID` | Lets the BOF framework resolve the runtime Oracle connection outside this library.* | `Business\SAIF.Business.Policy\PolicyInformation.vb` |

## Secure settings

| Setting key | Encryption method | Purpose | Consuming class | Source |
| --- | --- | --- | --- | --- |
| _(none)_ | — | No secure settings are retrieved directly by this library. | — | `Business\SAIF.Business.Policy\packages.config` |

## Transitive configuration (from dependencies)

| Setting key | Method | Source dependency | Dependency type | Purpose |
| --- | --- | --- | --- | --- |
| `EnvironmentApiUrl` | `GetConfigSetting` | SAIF.BOF.Framework / SAIF.Framework.Security.EnvironmentApi | NuGet | Required by the broader BOF hosting stack when environment-backed framework services are active* |
| `workCalendarServiceUrl` | `GetConfigSetting` | SAIF.BOF.Framework / SAIF.Framework.Core | NuGet | Supports `clsSmartDate` work-calendar behavior used by the hazard-group model* |
| Portal-to-connection mapping | Framework-specific | SAIF.BOF.Framework / SAIF.Framework.Connection | NuGet | Maps the caller's portal id to an environment-specific Oracle connection* |

## Configuration dependencies

| Dependency | Type | Required at | Impact if missing |
| --- | --- | --- | --- |
| Oracle managed provider registration | service/file/section | startup | The BOF host cannot construct the Oracle provider. |
| Portal-id connection mapping | service/configuration | runtime | Policy and hazard-group lookups cannot reach Oracle.* |
| Environment API host settings | service/configuration | runtime | Framework features that rely on environment-backed configuration cannot resolve their endpoints* |

## 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)
- [Procedures](procedures/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\app.config`
- `Business\SAIF.Business.Policy\Web.config`
- `Business\SAIF.Business.Policy\My Project\Settings.settings`
- `Business\SAIF.Business.Policy\My Project\Settings.Designer.vb`
- `Business\SAIF.Business.Policy\SAIF.BOF.Business.Policy.vbproj`
- `Business\SAIF.Business.Policy\packages.config`
- `Business\SAIF.Business.Policy\clsHazardGroup.vb`
