edits.seer.internal.rules.IF289.xml Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of validation-edits-seer Show documentation
Show all versions of validation-edits-seer Show documentation
Java implemenation of the SEER edits.
<rule id="IF289" name="CS Items - SEER Required - SSF 2 (CS)" tag="N2368" java-path="lines.line" category="inter-field" depends="CS_Version_Input_Current,CS_Version_Input_Original,Year_of_Diagnosis">
<expression><![CDATA[if (line.dateOfDiagnosisYear == null || (line.csVersionInputCurrent == null && line.dateOfDiagnosisYear < '2016') ||
(line.csVersionInputOriginal == null && line.dateOfDiagnosisYear < '2016') || line._csSchemaId == null)
return true
if (Functions.matches(line.registryId, /^000000156[2356]$/))
return true
if ((line.behaviorCodeIcdO3 == '0' || line.behaviorCodeIcdO3 == '1') && !['brain','intracranial_gland','cns_other'].contains(line._csSchemaId))
return true
// condition 1
if (line.dateOfDiagnosisYear >= '2004' && line.dateOfDiagnosisYear <= '2017' && line.csSiteSpecificFactor2 == null)
return false
Integer csInputOrig = Functions.asInt(line.csVersionInputOriginal)
Integer csInputCurr = Functions.asInt(line.csVersionInputCurrent)
Integer yearDx = Functions.asInt(line.dateOfDiagnosisYear)
String schemaMatch = ((List)((Map)Context.CS_SSF).get(line._csSchemaId))?.get(1)//ssf2
// R = Required, N = Not required after CSv0204
if (!['N','R'].contains(schemaMatch))
return true
// condition 2
if (yearDx > 2015 && line.csExtension == null) {
if (schemaMatch == 'R') {
if (!['appendix','carcinoid_appendix','colon','net_colon','net_rectum','rectum','small_intestine'].contains(line._csSchemaId))
return line.csSiteSpecificFactor2 != '988'
}
return true
}
// condition 3
if ((yearDx >= 2014 && yearDx <= 2015) || ((yearDx == 2016 || yearDx == 2017) && line.csExtension != null) || (yearDx >= 2004 && yearDx <= 2015 && csInputOrig >= 20550)) {
if (schemaMatch == 'R' && line.csSiteSpecificFactor2 == '988')
return false
return true
}
// condition 4
if ((yearDx >= 2011 && yearDx <= 2013) ||
csInputOrig >= 20302) {
if (line.csSiteSpecificFactor2 == '988')
return false
return true
}
// skip if schema is MyelomaPlasmaCellDisorder
if (line._csSchemaId == 'myeloma_plasma_cell_disorder')
return true
// condition 5
if (yearDx == 2010 || Functions.matches(line.csVersionInputOriginal, /(^0201\d\d$)/) || Functions.matches(line.csVersionInputOriginal, /(^0202\d\d$)/)) {
if (line.csSiteSpecificFactor2 == '988')
return false
}
// condition 6
if (yearDx > 2003 && yearDx < 2010 && csInputOrig < 20000) {
if (csInputCurr == 20510) {
if (((List)Context.IF289_Schemas_1).contains(line._csSchemaId)) {
if (line.csSiteSpecificFactor2 != '988')
return false
return true
}
else {
if (['appendix','carcinoid_appendix','net_colon','colon','net_rectum','rectum'].contains(line._csSchemaId))
return true
}
if (line.csSiteSpecificFactor2 == '988')
return false
}
else if (csInputCurr > 20510) {
if (((List)Context.IF289_Schemas_1).contains(line._csSchemaId) || ['appendix','carcinoid_appendix','net_colon','colon','net_rectum','rectum'].contains(line._csSchemaId))
return true
if (line.csSiteSpecificFactor2 == '988')
return false
}
}
return true]]></expression>
<message>CS Site-Specific Factor 2 requirements conflict for this schema</message>
<description><![CDATA[The purpose of this edit is to verify that CS Site-Specific Factor 2 is entered for the schemas for which it is required by SEER.
This edit is skipped if any of the following conditions are true:
1. CS Version Input Current is blank and year of diagnosis < 2016
2. CS Version Input Original is blank and year of diagnosis < 2016
3. Behavior Code ICD-O-3 = 0 (benign) or 1 (borderline) and
schema is not Brain, CNSOther, or IntracranialGland
4. CS schema is invalid
5. Date of Diagnosis is blank or invalid
6. Registry ID = 0000001562 (New York), 0000001563 (Massachusetts), 0000001565 (Illinois), or 0000001566 (Texas)
The logic is as follows:
1. For all schemas, if year of Diagnosis is 2004-2017, CS Site-Specific Factor 2 cannot be blank.
2. If year of Diagnosis > 2015 and CS Extension is blank (CS items NOT collected ):
A. CS Site-Specific Factor 2 must not be 988 (not applicable) for the schemas in List 1, "Schemas for which CS Site-Specific Factor 2 is Required for CSv0205 by SEER"
EXCEPT for the following schemas: Appendix, Carcinoid Appendix, Colon, NETColon, NETRectum, Rectum, and SmallIntestine which can be 988.
3. For cases diagnosed in 2014-15 OR (year of Diagnosis=2016-2017 and CS Extension is not blank (CS items collected)) OR (year of diagnosis in 2004-2015 and originally coded in CSv0205):
If year of Diagnosis is 2014-15 OR (year of Diagnosis=2016-2017 and CS Extension is not blank(CS items collected)) OR (year of diagnosis=2004-2015 and CS Version Input Original is 020550 (originally entered in CSv0205) or higher), then CS Site-Specific Factor 2 must not be 988 (not applicable) for the schemas in List 1, "Schemas for which CS Site-Specific Factor 2 is Required for CSv0205 by SEER".
Note: List 2 includes the schemas for which CS Site-Specific Factor 2 was required for earlier versions of CSv02, but no longer required for CSv0205. The code 988 is allowed for these particular schemas.
4. For cases diagnosed 2011-2013 OR originally coded in CSv0203-CSv0204:
If year of Diagnosis is 2011-2013 OR CS Version Input Original is 020302 or higher:
then
CS Site-Specific Factor 2 must not be 988 for the
schemas for which CS Site-Specific Factor 2 is required (see List 3 below).
Note: For remaining conditions, skip if schema is MyelomaPlasmaCellDisorder, since CS Site-Specific Factor 2 is required only for cases diagnosed 2011 or later OR entered originally in CSv0203 or higher
5. For cases diagnosed 2010 OR originally coded in CSv0201xx or CSv0202xx:
If year of Diagnosis is 2010 OR CS Version Input Original is 0201xx or 0202xx:
then
CS Site-Specific Factor 2 must not be 988 for the schemas
for which CS Site-Specific Factor 2 is required (see List 3 below).
6. For cases diagnosed 2004-2009 AND originally coded in CSv01:
If year of Diagnosis is 2004-2009, then CS Site-Specific Factor 2 must not be 988 (not applicable) for the schemas for which CS Site-Specific Factor 2 is required (see List 3 below), with the following exceptions:
A. If CS Version Input Current = 020510 (not changed since conversion from CSv01 to CSv02):
1. If CS Site-Specific Factor 2 was not defined in CSv01xxxx
(List 4 below), then CS Site-Specific Factor 2 must be coded 988.
2. If schema is = Appendix, CarcinoidAppendix, or NETColon (all three
based on Colon schema), Colon, NETRectum (based on Rectum schema),
or Rectum (schemas that were added after the initial implementation
of CSv01)
then
CS Site-Specific Factor 2 can be any valid code including 988.
B. If CS Version Input Current > 020510 (indicating record was at least
partially updated in CSv02xxxx:
1. If CS Site-Specific Factor 2 was not defined in CSv01 (see
List 4 below),or schema is Appendix, CarcinoidAppendix, Colon,
NETColon, NETRectum, or Rectum - schemas that were added after
the initial implementation of CSv01, CS Site-Specific Factor 2
can be any valid code including 988.
List 1: List of Schemas for which CS Site-Specific Factor 2 is required for CSv0205 by SEER
- "Required" means CS Site-Specific Factor 2 cannot = 988
----------------------------------------------------------------------------------------
Appendix
Bladder
Breast
CarcinoidAppendix
Colon
CorpusAdenosarcoma
CorpusCarcinoma
CorpusSarcoma
KidneyParenchyma
Lung
Lymphoma
LymphomaOcularAdnexa
MelanomaChoroid
MelanomaCiliaryBody
MelanomaConjunctiva
MelanomaSkin
MyelomaPlasmaCellDisorder (required only for cases diagnosed 2011+
or entered originally in CSv0203 or later)
NETColon
NETRectum
Pleura
Prostate
Rectum
SmallIntestine
List 2: Schemas for which CS Site-Specific Factor 2, although required for CSv0200-CSv0204, is no longer required as of CSv0205 and 988 is allowed
-----------------------------------------------------------------------------------------
BileDuctsIntraHepat
KidneyRenalPelvis
Liver
Ovary
PeritoneumFemaleGen
Placenta
Vagina
List 3: List of Schemas for which CS Site-Specific Factor 2 is required for CSv0200-CSv0204 by SEER
- "Required" means CS Site-Specific Factor 2 cannot = 988
----------------------------------------------------------------------------------------
Appendix
BileDuctsIntraHepat
Bladder
Breast
CarcinoidAppendix
Colon
CorpusAdenosarcoma
CorpusCarcinoma
CorpusSarcoma
KidneyParenchyma
KidneyRenalPelvis
Liver
Lung
Lymphoma
LymphomaOcularAdnexa
MelanomaChoroid
MelanomaCiliaryBody
MelanomaConjunctiva
MelanomaSkin
MyelomaPlasmaCellDisorder (required only for cases diagnosed 2011+
or entered originally in CSv0203 or later)
NETColon
NETRectum
Ovary
PeritoneumFemaleGen
Placenta
Pleura
Prostate
Rectum
SmallIntestine
Vagina
List 4: List of schemas for which CS Site-Specific Factor 2, although required for CSv02, was not defined in CSv01:
---------------------------------------------------------------------------------
Bladder
CorpusAdenosarcoma
CorpusCarcinoma
CorpusSarcoma
KidneyParenchyma
KidneyRenalPelvis
Lung
MelanomaChoroid
MelanomaCiliaryBody
MelanomaConjunctiva
Ovary
PeritoneumFemaleGen
Placenta
Pleura
SmallIntestine
Vagina]]></description>
<history>
<event version="SE12-002-01" user="murphyr" date="2010-03-02">Edit created.</event>
<event version="SE12-002-01" user="murphyr" date="2010-03-23">Changed logic. Added year of diagnosis into edit.</event>
<event version="SE12-004-01" user="murphyr" date="2011-02-15">Edit updated for CSv2 version 02.03.02.</event>
<event version="SE12-004-01" user="murphyr" date="2011-02-23">Added a skip condition for MyelomaPlasmaCellDisorder.</event>
<event version="SE12-004-02" user="murphyr" date="2011-03-18" ref="66447">Refined behavior skip condition (made it not skip for certain schemas) and refactored code.</event>
<event version="SE12-006-01" user="murphyr" date="2011-12-20" ref="66587">Updated for CSv0204 versioning.</event>
<event version="SE13-010-01" user="murphyr" date="2013-06-14" ref="66888">Fixed logic for condition 'If year of Diagnosis is 2011 or later OR CS Version Input Original is 020302 or higher'.</event>
<event version="SE13-010-01" user="murphyr" date="2013-07-12" ref="66905">MyelomaPlasmaCellDisorder was in the wrong IF289 table.</event>
<event version="SE14-011-01" user="murphyr" date="2013-10-30" ref="67006">Update for CSv0205.</event>
<event version="SE16-015-01" user="kirbyk" date="2016-04-05" ref="67267">Updated logic for 2016 cases.</event>
<event version="SE16-015-01" user="kirbyk" date="2016-05-04" ref="67370">Changed edit to use schema IDs instead of schema names</event>
<event version="SE16-015-01" user="kirbyk" date="2016-05-24" ref="67422">Changed edit to not force 988 when DX year is 2016+ and schema is not defined.</event>
<event version="SE16-016-01" user="kirbyk" date="2016-12-08" ref="67566">Updated logic to include 2017 cases that collect CS.</event>
<event version="SE16-016-08" user="depryf" date="2017-11-22" ref="67674">Edit syntax updated to allow pre-compilation optimization; no change in behavior.</event>
<event version="SE18-017-01" user="kirbyk" date="2018-04-02" ref="67723">Updated logic to allow blank SSF 2 for 2018+ cases.</event>
<event version="SE18-019-03" user="beverung" date="2019-07-18" ref="68203">Added skip condition for New York.</event>
<event version="SE18-020-01" user="depryf" date="2020-02-04" ref="68281">Changed property names to align with NAACCR XML IDs.</event>
<event version="SE18-020-02" user="beverung" date="2020-03-25" ref="68292">Added skip condition for Massachusetts</event>
<event version="SE21-021-08" user="beverung" date="2021-08-18" ref="68715">Added skip condition for Illinois and Texas.</event>
<event version="SE24-024-06" user="kirbyk" date="2024-07-22" ref="69326">Removed some edit dependencies.</event>
</history>
</rule>