Skip to content

SQL-306: Retrieve Subpoena

This statement retrieves ready-to-pay, certified-mail subpoenas from SUBPOENA (joined to SUBPOENA_SPECIAL_HANDLING_CODE), and a single subpoena by ID, via NHibernate LINQ over IUnitOfWork.GetRepository<Subpoena>(). It is executed by SubpoenaLabelService.GenerateBatchLabels and SubpoenaLabelService.GetSubpoena (Services/SAIF.Services/Legal/Subpoenas/SubpoenaLabelService.cs (L72, L149)) to produce certified-mail batch labels.

Classification

Field Value
SQL ID SQL-306
Operation type Read
Execution method ORM (NHibernate LINQ)
Database Oracle
Schema [unqualified]**
Command type N/A (ORM-generated)
Business object SubpoenaLabelService
Criteria property N/A — ORM
Lifecycle method GenerateBatchLabels, GetSubpoena

Parameters

Parameter Direction Type Max length Description
:subpoenaId Input Long N/A Subpoena identifier (subpoenaId) matched against SUBPOENA_SEQ_NUM in GetSubpoena

Tables

Table Access Columns used
SUBPOENA SELECT SUBPOENA_SEQ_NUM, UPDATE_NUM, SUBPOENA_TEXT, SUBPOENA_OPENING_TEXT, SHOW_APPEARANCE_FLAG, ISSUE_DATE, REQUESTED_BY_EMPLID, APPROVED_DATE, APPROVED_BY_EMPLID, APPEARANCE_DATE_TIME, COMPLIANCE_DATE, BODY_PART_DESC, RECORDS_REQUEST_FROM_DATE, RECORDS_REQUEST_THRU_DATE, PAGE_COUNT, SAIF_LOCATION_FLAG, ADDITIONAL_CLAIM_NUMBERS, ADDITIONAL_CASE_NUMBERS, AKA_NAME, SERVE_BY_DATE, SPECIFIC_LOCATION_TEXT, SPECIAL_DELIVERY_TEXT, FILE_NUMBER, CREATE_USER, CREATE_DATE, UPDATE_USER, UPDATE_DATE, LEGAL_CASE_SEQ_NUM, SUBPOENA_STATUS_CODE, SUBPOENA_TYPE_CODE, HEARING_LOCATION_SEQ_NUM, SPECIAL_HANDLING_CODE, PROCESS_SERVER_LOC_SEQ_NUM
SUBPOENA_SPECIAL_HANDLING_CODE JOIN (GenerateBatchLabels only) CODE, CLAIM_SPECIAL_HANDLING_CODE

LINQ statement

Source: Services/SAIF.Services/Legal/Subpoenas/SubpoenaLabelService.cs:71

// Services/SAIF.Services/Legal/Subpoenas/SubpoenaLabelService.cs:71-77
var approvedSubpoenas =
    _unitOfWork.GetRepository<SubpoenaData.Subpoena>()
        .Query()
        .Where(x => x.SubpoenaStatus.Code == SubpoenaData.SubpoenaStatus.ReadyToPayCode &&
                    x.SpecialHandling.ClaimSpecialHandlingCode == "CERT")
        .OrderBy(x => x.Id)
        .ToList();

// Services/SAIF.Services/Legal/Subpoenas/SubpoenaLabelService.cs:149-151
return _unitOfWork.GetRepository<SubpoenaData.Subpoena>()
    .Query()
    .FirstOrDefault(x => x.Id == subpoenaId);

Sample SQL

Inferred SQL: This SQL was inferred from the LINQ statement above and the NHibernate mappings. It is not concrete SQL from source code; NHibernate generates the executed statement at runtime, so aliases, column order, join syntax, and bind-parameter names may differ.

-- Inferred from LINQ (NHibernate mapping translation); not concrete SQL
-- GenerateBatchLabels (L72)
SELECT
  S.SUBPOENA_SEQ_NUM,
  S.UPDATE_NUM,
  S.SUBPOENA_TEXT,
  S.SUBPOENA_OPENING_TEXT,
  S.SHOW_APPEARANCE_FLAG,
  S.ISSUE_DATE,
  S.REQUESTED_BY_EMPLID,
  S.APPROVED_DATE,
  S.APPROVED_BY_EMPLID,
  S.APPEARANCE_DATE_TIME,
  S.COMPLIANCE_DATE,
  S.BODY_PART_DESC,
  S.RECORDS_REQUEST_FROM_DATE,
  S.RECORDS_REQUEST_THRU_DATE,
  S.PAGE_COUNT,
  S.SAIF_LOCATION_FLAG,
  S.ADDITIONAL_CLAIM_NUMBERS,
  S.ADDITIONAL_CASE_NUMBERS,
  S.AKA_NAME,
  S.SERVE_BY_DATE,
  S.SPECIFIC_LOCATION_TEXT,
  S.SPECIAL_DELIVERY_TEXT,
  S.FILE_NUMBER,
  S.CREATE_USER,
  S.CREATE_DATE,
  S.UPDATE_USER,
  S.UPDATE_DATE,
  S.LEGAL_CASE_SEQ_NUM,
  S.SUBPOENA_STATUS_CODE,
  S.SUBPOENA_TYPE_CODE,
  S.HEARING_LOCATION_SEQ_NUM,
  S.SPECIAL_HANDLING_CODE,
  S.PROCESS_SERVER_LOC_SEQ_NUM
FROM SUBPOENA S
  INNER JOIN SUBPOENA_SPECIAL_HANDLING_CODE SSHC
    ON SSHC.CODE = S.SPECIAL_HANDLING_CODE
WHERE S.SUBPOENA_STATUS_CODE = 'PAY'
  AND SSHC.CLAIM_SPECIAL_HANDLING_CODE = 'CERT'
ORDER BY S.SUBPOENA_SEQ_NUM

-- GetSubpoena (L149)
SELECT *
FROM (
  SELECT
    S.SUBPOENA_SEQ_NUM,
    S.UPDATE_NUM,
    S.SUBPOENA_TEXT,
    S.SUBPOENA_OPENING_TEXT,
    S.SHOW_APPEARANCE_FLAG,
    S.ISSUE_DATE,
    S.REQUESTED_BY_EMPLID,
    S.APPROVED_DATE,
    S.APPROVED_BY_EMPLID,
    S.APPEARANCE_DATE_TIME,
    S.COMPLIANCE_DATE,
    S.BODY_PART_DESC,
    S.RECORDS_REQUEST_FROM_DATE,
    S.RECORDS_REQUEST_THRU_DATE,
    S.PAGE_COUNT,
    S.SAIF_LOCATION_FLAG,
    S.ADDITIONAL_CLAIM_NUMBERS,
    S.ADDITIONAL_CASE_NUMBERS,
    S.AKA_NAME,
    S.SERVE_BY_DATE,
    S.SPECIFIC_LOCATION_TEXT,
    S.SPECIAL_DELIVERY_TEXT,
    S.FILE_NUMBER,
    S.CREATE_USER,
    S.CREATE_DATE,
    S.UPDATE_USER,
    S.UPDATE_DATE,
    S.LEGAL_CASE_SEQ_NUM,
    S.SUBPOENA_STATUS_CODE,
    S.SUBPOENA_TYPE_CODE,
    S.HEARING_LOCATION_SEQ_NUM,
    S.SPECIAL_HANDLING_CODE,
    S.PROCESS_SERVER_LOC_SEQ_NUM
  FROM SUBPOENA S
  WHERE S.SUBPOENA_SEQ_NUM = :subpoenaId
)
WHERE ROWNUM <= 1

Translation notes: - Constants from Data/SAIF.Data/Model/Legal/Subpoenas/SubpoenaStatus.cs: ApprovedCode = "APPR" (L6), ReadyToPayCode = "PAY" (L7), PaidCode = "PAID" (L8). - approvedSubpoenas.Sum(...) (L79) runs in memory. - First/FirstOrDefault → Oracle10 dialect row limit SELECT * FROM (...) WHERE ROWNUM <= 1. - SUBPOENA_STATUS_CODE is not joined — SubpoenaStatus.Code is its identifier and short-circuits to FK SUBPOENA.SUBPOENA_STATUS_CODE. SUBPOENA_SPECIAL_HANDLING_CODE is joined because ClaimSpecialHandlingCode is a non-identifier member. - References (LegalCase, SubpoenaStatus, SubpoenaType, HearingLocation, SpecialHandling, ProcessServerLocation) contribute FK columns only; HasMany(Recipients) is lazy — subpoena.Recipients.Any() after materialization triggers a separate lazy collection load that is not part of this statement.

Operations and processes

Sources

  • Services/SAIF.Services/Legal/Subpoenas/SubpoenaLabelService.cs (L72, L149)