---
title: SOAP client proxy documentation
summary: Entry point for the PDFService consumed SOAP service proxy documentation.
status: draft
owner: SAIF.Core documentation
last_reviewed: 2026-09-24
---

# SOAP client proxy documentation

`PDFService` is a svcutil-generated proxy for the WCF `PDFService` cache/imaging service (`WCFHost PDFService`†), carried in the `SAIF.Services.Web.Proxies` class library and wrapped by the authored `PdfServiceProxy`. The wrapper exposes a single `GetImage` method that calls the contract's one operation, `LoadCache`, but no source file in this repository constructs `PdfServiceProxy` or the generated client, so the integration is present and compiled but not reached end-to-end in this repository.

| Field | Value |
| --- | --- |
| **Proxy name** | `PDFService` |
| **Mechanism** | Service Reference (svcutil) |
| **Generated namespace** | `SAIF.Services.Web.Proxies.PDFService` |
| **Generated artifacts** | `Services/SAIF.Services.Web.Proxies/Service References/PDFService/` |
| **WSDL document** | `Services/SAIF.Services.Web.Proxies/Service References/PDFService/PDFService.wsdl` |
| **Proxy base type** | `System.ServiceModel.ClientBase<T>` (`internal`) |
| **Hand-written wrapper** | `PdfServiceProxy` (`Services/SAIF.Services.Web.Proxies/PDFServiceProxy.cs`) |
| **Consuming project** | `SAIF.Services.Web.Proxies` |
| **Target service** | `WCFHost PDFService`† |
| **Endpoint source** | Constructor argument (`serviceUrl`), supplied by the caller of `PdfServiceProxy` |
| **Binding** | `BasicHttpBinding` constructed in code, with `MaxReceivedMessageSize` and `MaxArrayLength` raised to `int.MaxValue` |
| **Operations present** | 1 |
| **Wrapper-level SOAP invocations** | 1 — `PdfServiceProxy.GetImage` invokes `LoadCache` on the generated client |
| **Operations reached by an in-repository caller** | 0 — no repository source constructs or calls `PdfServiceProxy` end-to-end (see [Operation map](operation-map.md)) |

## Documentation sections

| Section | Description |
| --- | --- |
| [Overview](overview.md) | Which service is called, who consumes the proxy, and capability summary |
| [Architecture](architecture.md) | How the proxy is constructed, configured, and invoked |
| [Contract](contract.md) | The WSDL-declared operations, messages, faults, and binding |
| [Operation map](operation-map.md) | Operations present in the proxy versus operations actually called |
| [Client reference](reference.md) | One section per operation called from repository source |
| [Consumption](consumption.md) | Construction, disposal, resilience, and endpoint configuration |
| [Dependencies](dependencies.md) | Packages, framework components, and the called service |
| [Tech debt](tech-debt.md) | CRITICAL and HIGH severity findings |

## Called service

| Attribute | Value |
| --- | --- |
| Service name | `WCFHost PDFService`† |
| Documented by this run | No |
| Service documentation | `WCFHost PDFService`† |
| Endpoint address | Unresolved** — supplied by whoever constructs `PdfServiceProxy(serviceUrl, database)`; no repository source does so |
| Address source | `Services/SAIF.Services.Web.Proxies/PDFServiceProxy.cs:14-27` (constructor argument); generation-time address `http://webdev01/WebServices/WCFHost/PDFService.svc` recorded in `Service References/PDFService/Reference.svcmap:21` |
| SOAP namespace | `http://tempuri.org/` (WSDL); data-contract namespace `http://schemas.datacontract.org/2004/07/SAIF.Services.WCF.Contracts.PDF` |

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

> **Note:** Statements marked with `†` are derived from dependency library
> documentation via the Legends CLI. Statements marked with `**` could
> not be confirmed; treat as unknown until verified.

## Sources
- `Services/SAIF.Services.Web.Proxies/SAIF.Services.Web.Proxies.csproj`
- `Services/SAIF.Services.Web.Proxies/PDFServiceProxy.cs`
- `Services/SAIF.Services.Web.Proxies/Service References/PDFService/Reference.cs`
- `Services/SAIF.Services.Web.Proxies/Service References/PDFService/Reference.svcmap`
- `Services/SAIF.Services.Web.Proxies/Service References/PDFService/PDFService.wsdl`
- `Services/SAIF.Services.Web.Proxies/app.config`