---
title: "SQL-017: Retrieve chapter as of a date"
summary: Retrieve chapter as of a date
status: draft
owner: Technical Writer
last_reviewed: 2026-07-31
library: SAIF.Business.Policy.Group
reference_type: package
---

# SQL-017: Retrieve chapter as of a date

`SQL-017` retrieve chapter as of a date in support of `clsChapter`.

## Classification

| Field | Value |
| --- | --- |
| **SQL ID** | SQL-017 |
| **Operation type** | Read |
| **Execution method** | Inline SQL via BOF data portal |
| **Database** | Oracle |
| **Schema** | `[unqualified]**` |
| **Command type** | Text |
| **Business object** | `clsChapter` |
| **Criteria property** | `RetrieveSQL` (+ const `RETRIEVE_CHAPTER`) |
| **Lifecycle method** | `BeforeRetrieve` / `AfterRetrieve` |

## Parameters

| Parameter | Direction | Type | Max length | Description |
| --- | --- | --- | --- | --- |
| `:GroupAssociationCode` | In | String | not specified | Criteria property — owning group code. |
| `:Code` | In | String | not specified | Criteria property — chapter code. |
| `:SelectDate` | In | Date | not specified | Criteria property — as-of date; bound twice ([BR-008](../business-rules.md#br-008-chapter-retrieval-is-as-of-date-effective)). |

## Tables

| Table | Access | Columns used |
| --- | --- | --- |
| [GROUP_CHAPTER](../database-tables.md#group_chapter) | SELECT | GROUP_ASSOCIATION_CODE, CODE, CODE_DESCR, CHAPTER_EFF_DATE, CHAPTER_EXP_DATE, PMS_CHAPTER_CODE, CREATE_DATE, CREATE_USER, UPDATE_DATE, UPDATE_USER, CHAPTER_ENROLL_FORM, PHONE_NUM |

## Sample SQL

```sql
Select
  GROUP_CHAPTER.GROUP_ASSOCIATION_CODE as GroupAssociationCode,
  GROUP_CHAPTER.CODE as Code,
  GROUP_CHAPTER.CODE_DESCR as CodeDescription,
  GROUP_CHAPTER.CHAPTER_EFF_DATE as EffectiveDate,
  GROUP_CHAPTER.CHAPTER_EXP_DATE as ExpirationDate,
  GROUP_CHAPTER.PMS_CHAPTER_CODE as PmsChapterCode,
  GROUP_CHAPTER.CREATE_DATE as CreateDate,
  GROUP_CHAPTER.CREATE_USER as CreateUser,
  GROUP_CHAPTER.UPDATE_DATE as UpdateDate,
  GROUP_CHAPTER.UPDATE_USER as UpdateUser,
  GROUP_CHAPTER.CHAPTER_ENROLL_FORM as EnrollmentForm,
  GROUP_CHAPTER.PHONE_NUM as PhoneNumber
From
  GROUP_CHAPTER
Where
  GROUP_CHAPTER.GROUP_ASSOCIATION_CODE = :GroupAssociationCode
  AND GROUP_CHAPTER.CODE = :Code
  AND :SelectDate >= GROUP_CHAPTER.CHAPTER_EFF_DATE
  AND :SelectDate < NVL(GROUP_CHAPTER.CHAPTER_EXP_DATE, '01-Jan-2199')
```

## Operations and processes
- [Create and persist a chapter](../operations/create-and-retrieve-chapter.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.Group\clsChapter.vb`