---
title: SQL-007: Provider collection by dynamic filter
summary: Provider collection by dynamic filter retrieval query.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-07-24
library: SAIF.Business.View.Provider
reference_type: package
---

# SQL-007: Provider collection by dynamic filter

This statement supports the ``clsProviderCollection`` retrieval path by reading provider-domain data from Oracle tables and projecting the result into business objects or DTO lists.

## Classification

| Field | Value |
| --- | --- |
| **SQL ID** | SQL-007 |
| **Operation type** | Read |
| **Execution method** | Inline SQL (dynamic) |
| **Database** | Oracle |
| **Schema** | [unqualified]** |
| **Command type** | Text |
| **Business object** | ``clsProviderCollection`` |
| **Criteria property** | ``RetrieveSQL`` |
| **Lifecycle method** | `BeforeRetrieve` |

## Parameters

| Parameter | Direction | Type | Max length | Description |
| --- | --- | --- | --- | --- |
| `—` | — | — | — | No bind variables. `BuildSQLWhere()` appends either a caller-supplied `WHERE` clause or an `IN (...)` list built from `m_PrimaryTaxIDs`. |

## Tables

| Table | Access | Columns used |
| --- | --- | --- |
| [PROVIDER](../database-tables.md#provider) | SELECT | PROVIDER_SEQ_NUM, PRIMARY_TAX_ID |
| [PROVIDER_TAX_ID](../database-tables.md#provider_tax_id) | SELECT | PROVIDER_SEQ_NUM, TAX_ID, REGISTERED_NAME |

## Sample SQL

```sql
SELECT
  PRV.PRIMARY_TAX_ID AS PrimaryTaxID,
  PRV.PROVIDER_SEQ_NUM AS ProviderID,
  PRV.UPDATE_DATE AS UpdateDate,
  PRV.UPDATE_NUM AS UpdateNum,
  PRV.UPDATE_USER AS UpdateUser,
  TAX.TAX_ID_DISPLAY_DESCR AS FormattedPrimaryTaxID,
  TAX.REGISTERED_NAME AS RegisteredName
FROM PROVIDER PRV
LEFT OUTER JOIN PROVIDER_TAX_ID TAX ON TAX.TAX_ID = PRV.PRIMARY_TAX_ID
/* BuildSQLWhere() appends one of two live forms:
   1) a caller-supplied WHERE/ORDER fragment (`m_WhereClause`), or
   2) WHERE prv.primary_tax_id IN ('literal tax IDs assembled from m_PrimaryTaxIDs').
*/
```

## Operations and processes
- [Retrieve provider collection](../operations/provider-retrieval.md)

## 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 `**` could not be confirmed; treat as unknown until verified.
## Sources
- `Business\SAIF.Business.View.Provider\clsProviderCollection.vb`