---
title: Contract
summary: The WSDL-declared operations, message types, faults, and binding of the called service.
status: draft
owner: SAIF.Core documentation
last_reviewed: 2026-09-24
---

# Contract

This page documents the contract of `ConnectInfo` as the WSDL declares it. It is the page a reader uses to answer "what can this service be asked to do, and in what shape".

| Field | Value |
| --- | --- |
| **Service** | `ConnectInfo` |
| **WSDL document** | `Services/SAIF.Services.Web.Proxies/Service References/DbConnection/connectinfo.wsdl` |
| **SOAP namespace** | `http://saifonline/WebServices/wsDBConnections/` |
| **Port type / binding name** | `ConnectInfoSoap` |
| **Binding** | SOAP 1.1 (`ConnectInfoSoap`) and SOAP 1.2 (`ConnectInfoSoap12`) both declared |
| **Encoding style** | Document / Literal |
| **Parameter style** | Wrapped |
| **Operations declared** | 6 |

## Contract source

The authoritative source for this page is the checked-in WSDL document at `Services/SAIF.Services.Web.Proxies/Service References/DbConnection/connectinfo.wsdl`. Every operation, message shape, and SOAP action below is read directly from that file.

## Operations

| Operation | SOAP action | Input message | Output message | Faults | Called in this repository |
| --- | --- | --- | --- | --- | --- |
| `GetOracleConnectString` | `http://saifonline/WebServices/wsDBConnections/GetOracleConnectString` | `ConnectRequestInfo inConnectRequestInfo` | `string` | None declared | No |
| `GetODPConnectString` | `http://saifonline/WebServices/wsDBConnections/GetODPConnectString` | `ConnectRequestInfo inConnectRequestInfo` | `string` | None declared | Yes — [details](reference.md#getodpconnectstring) |
| `GetDB2ConnectString` | `http://saifonline/WebServices/wsDBConnections/GetDB2ConnectString` | `ConnectRequestInfo inConnectRequestInfo` | `string` | None declared | No |
| `GetSQLConnectString` | `http://saifonline/WebServices/wsDBConnections/GetSQLConnectString` | `ConnectRequestInfo inConnectRequestInfo` | `string` | None declared | Yes — [details](reference.md#getsqlconnectstring) |
| `ClearCache` | `http://saifonline/WebServices/wsDBConnections/ClearCache` | None | None | None declared | No |
| `GetCache` | `http://saifonline/WebServices/wsDBConnections/GetCache` | `string inCacheType` | `string` | None declared | No |

## Messages and types

| Type | Kind | Members | Used by |
| --- | --- | --- | --- |
| `ConnectRequestInfo` | Complex type | `OSUserid` (`string`), `Code` (`string`), `Database` (`string`), `Server` (`string`) | `GetOracleConnectString`, `GetODPConnectString`, `GetDB2ConnectString`, `GetSQLConnectString` |

### ConnectRequestInfo

| Member | Type | Required | Purpose |
| --- | --- | --- | --- |
| `OSUserid` | `string` | Not stated in the WSDL | The Windows identity of the calling process, sent as an unverified claim* |
| `Code` | `string` | Not stated in the WSDL | A SAIF pool code (for example `CLM`, `IMG`, `AGNT`, `CRYPT`), never a database schema — see [Business rules](business-rules.md) |
| `Database` | `string` | Not stated in the WSDL | The database instance name |
| `Server` | `string` | Not stated in the WSDL | The SQL Server host name (used by `GetSQLConnectString` only) |

## Faults

The WSDL declares no faults. A failure reaches this repository as a generic SOAP fault surfaced by the proxy; see [Consumption](consumption.md) for how the call sites handle it.

## Binding details

| Aspect | Value |
| --- | --- |
| Transport | HTTP |
| Message version | SOAP 1.1 (as configured; SOAP 1.2 is also declared) |
| Security mode | None declared in the WSDL — set in code, see [Architecture](architecture.md) |
| Declared message size limits | None declared in the WSDL |

## Contract drift risk

| Aspect | Finding |
| --- | --- |
| WSDL captured at | Not determined from source |
| Live service documented by this run | No |
| Verification possible | No — the remote `ConnectInfo` service is outside this run's scope and its live contract cannot be compared |
| Consequence of drift | A remote change to `GetODPConnectString` or `GetSQLConnectString` would not be detected until a call fails at runtime |

## Related documentation
- [Client index](index.md)
- [Overview](overview.md)
- [Architecture](architecture.md)
- [Operation map](operation-map.md)
- [Client reference](reference.md)
- [Consumption](consumption.md)
- [Dependencies](dependencies.md)
- [Business rules](business-rules.md)
- [Tech debt](tech-debt.md)

> **Note:** Statements marked with `*` were inferred from code structure or contextual
> evidence. Statements marked with `**` could not be confirmed; treat as unknown until
> verified.

## Sources
- `Services/SAIF.Services.Web.Proxies/Service References/DbConnection/connectinfo.wsdl`