edits.seer.internal.rules.IF290.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="IF290" name="CS Items - SEER Required - SSF 3 (CS)" tag="N2369" 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.csSiteSpecificFactor3 == 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(2)//ssf3
// 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 (!['lacrimal_gland','melanoma_skin','merkel_cell_penis','merkel_cell_scrotum','merkel_cell_skin','merkel_cell_vulva','prostate','skin_eyelid'].contains(line._csSchemaId))
return line.csSiteSpecificFactor3 != '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.csSiteSpecificFactor3 == '988')
return false
return true
}
// condition 4
if ((yearDx >= 2011 && yearDx <= 2013) ||csInputOrig >= 20302) {
if (line.csSiteSpecificFactor3 == '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.csSiteSpecificFactor3 == '988')
return false
}
// condition 6
if (yearDx > 2003 && yearDx < 2010 && csInputOrig < 20000) {
if (csInputCurr == 20510) {
if (((List)Context.IF290_Schemas_1).contains(line._csSchemaId)) {
if (line.csSiteSpecificFactor3 != '988')
return false
return true
}
if (line.csSiteSpecificFactor3 == '988')
return false
}
else if (csInputCurr > 20510) {
if (((List)Context.IF290_Schemas_1).contains(line._csSchemaId))
return true
if (line.csSiteSpecificFactor3 == '988')
return false
}
}
return true]]></expression>
<message>CS Site-Specific Factor 3 requirements conflict for this schema</message>
<description><![CDATA[The purpose of this edit is to verify that CS Site-Specific Factor 3 is entered for the schemas 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 3 cannot be blank.
2. If year of Diagnosis > 2015 and CS Extension is blank (CS items NOT collected):
A. CS Site-Specific Factor 3 must not be 988 (not applicable) for the schemas in List 1, "Schemas for which CS Site-Specific Factor 3 is Required for CSv0205 by SEER"
EXCEPT for the following schemas: Lacrimal Gland, Melanoma Skin, MerkelCell Penis, MerkelCell Scrotum, MerkelCell Skin, MerkelCell Vulva, Prostate, and Skin Eyelid which can be 988.
3. For cases diagnosed in 2014-2015 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-2015 OR (year of Diagnosis=2016-2017 and CS Extension is not blank (CS items collected)) OR (year of diagnosis in 2004-2015 and CS Version Input Original is 020550 (originally entered in CSv0205) or higher), then CS Site-Specific Factor 3 must not be 988 (not applicable) for the schemas in List 1, "Schemas for which CS Site-Specific Factor 3 is Required for CSv0205 by SEER".
Note: List 2 includes the schemas for which CS Site-Specific Factor 3 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 3 must not be 988 for the
schemas for which CS Site-Specific Factor 3 is required (see List 3 below).
Note: For remaining conditions, skip if schema is MyelomaPlasmaCellDisorder, since CS Site-Specific Factor 3 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 3 must not be 988 for the schemas
for which CS Site-Specific Factor 3 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 3 must not be 988 (not applicable) for the schemas for which CS Site-Specific Factor 3 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):
CS Site-Specific Factor 3 must not be 988.
Exceptions:
1. If CS Site-Specific Factor 3 was not defined in CSv01 (see List 4
below)
then
CS Site-Specific Factor 3 must be coded 988.
B. If CS Version Input Current > 020510 [indicating record was at least
partially updated in CSv02 (any version)]:
CS Site-Specific Factor 3 must not be 988.
Exceptions:
1. If CS Site-Specific Factor 3 was not defined in CSv01
(see List 4 below),
then
CS Site-Specific Factor 3 can be any valid code including 988.
List 1: List of Schemas for which CS Site-Specific Factor 3 is required for CSv0205 by SEER
- "Required" means CS Site-Specific Factor 3 cannot = 988
----------------------------------------------------------------------------------------
Bladder
Breast
BuccalMucosa
CorpusAdenosarcoma
CorpusCarcinoma
CorpusSarcoma
EpiglottisAnterior
FloorMouth
GumLower
GumOther
GumUpper
HeartMediastinum
Hypopharynx
KidneyParenchyma
LarynxGlottic
LarynxOther
LarynxSubglottic
LarynxSupraglottic
LipLower
LipOther
LipUpper
MelanomaBuccalMucosa
MelanomaChoroid
MelanomaCiliaryBody
MelanomaEpiglottisAnterior
MelanomaFloorMouth
MelanomaGumLower
MelanomaGumOther
MelanomaGumUpper
MelanomaHypopharynx
MelanomaIris
MelanomaLarynxGlottic
MelanomaLarynxOther
MelanomaLarynxSubglottic
MelanomaLarynxSupraglottic
MelanomaLipLower
MelanomaLipOther
MelanomaLipUpper
MelanomaMouthOther
MelanomaNasalCavity
MelanomaNasopharynx
MelanomaOropharynx
MelanomaPalateHard
MelanomaPalateSoft
MelanomaPharynxOther
MelanomaSinusEthmoid
MelanomaSinusMaxillary
MelanomaSinusOther
MelanomaSkin
MelanomaTongueAnterior
MelanomaTongueBase
MerkelCellPenis
MerkelCellScrotum
MerkelCellSkin
MerkelCellVulva
MiddleEar
MouthOther
MyelomaPlasmaCellDisorder (required only for cases diagnosed 2011+
or entered originally in CSv0203)
NasalCavity
Nasopharynx
Oropharynx
Ovary
PalateHard
PalateSoft
ParotidGland
PeritoneumFemaleGen
PharyngealTonsil
PharynxOther
Prostate
SalivaryGlandOther
SinusEthmoid
SinusMaxillary
SinusOther
SkinEyelid
SoftTissue
SubmandibularGland
TongueAnterior
TongueBase
List 2: Schemas for which CS Site-Specific Factor 3, although required for CSv0200-CSv0204, is no longer required as of CSv0205 and 988 is allowed
----------------------------------------------------------------------------------------
Appendix
Bone
Colon
Liver
Lymphoma
LymphomaOcularAdnexa
Rectum
SmallIntestine
Vagina
List 3: List of Schemas for which CS Site-Specific Factor 3 is required for CSv0200-CSv0204 by SEER
- "Required" means CS Site-Specific Factor 3 cannot = 988
----------------------------------------------------------------------------------------
Appendix
Bladder
Bone
Breast
BuccalMucosa
Colon
CorpusAdenosarcoma
CorpusCarcinoma
CorpusSarcoma
EpiglottisAnterior
FloorMouth
GumLower
GumOther
GumUpper
HeartMediastinum
Hypopharynx
KidneyParenchyma
LarynxGlottic
LarynxOther
LarynxSubglottic
LarynxSupraglottic
LipLower
LipOther
LipUpper
Liver
Lymphoma
LymphomaOcularAdnexa
MelanomaBuccalMucosa
MelanomaChoroid
MelanomaCiliaryBody
MelanomaEpiglottisAnterior
MelanomaFloorMouth
MelanomaGumLower
MelanomaGumOther
MelanomaGumUpper
MelanomaHypopharynx
MelanomaIris
MelanomaLarynxGlottic
MelanomaLarynxOther
MelanomaLarynxSubglottic
MelanomaLarynxSupraglottic
MelanomaLipLower
MelanomaLipOther
MelanomaLipUpper
MelanomaMouthOther
MelanomaNasalCavity
MelanomaNasopharynx
MelanomaOropharynx
MelanomaPalateHard
MelanomaPalateSoft
MelanomaPharynxOther
MelanomaSinusEthmoid
MelanomaSinusMaxillary
MelanomaSinusOther
MelanomaSkin
MelanomaTongueAnterior
MelanomaTongueBase
MerkelCellPenis
MerkelCellScrotum
MerkelCellSkin
MerkelCellVulva
MiddleEar
MouthOther
MyelomaPlasmaCellDisorder (required only for cases diagnosed 2011+
or entered originally in CSv0203)
NasalCavity
Nasopharynx
Oropharynx
Ovary
PalateHard
PalateSoft
ParotidGland
PeritoneumFemaleGen
PharyngealTonsil
PharynxOther
Prostate
Rectum
SalivaryGlandOther
SinusEthmoid
SinusMaxillary
SinusOther
SkinEyelid
SmallIntestine
SoftTissue
SubmandibularGland
TongueAnterior
TongueBase
Vagina
List 4: List of schemas for which CS Site-Specific Factor 3, although required for CSv02, was not defined in CSv01:
---------------------------------------------------------------------------------
Appendix
Bladder
Bone
Colon
CorpusAdenosarcoma
CorpusCarcinoma
CorpusSarcoma
HeartMediastinum
KidneyParenchyma
Liver
MelanomaChoroid
MelanomaCiliaryBody
MelanomaIris
MerkelCellPenis
MerkelCellScrotum
MerkelCellSkin
MerkelCellVulva
Ovary
PeritoneumFemaleGen
Rectum
SkinEyelid
SmallIntestine
SoftTissue
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-006-01" user="murphyr" date="2011-12-20" ref="66591">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="66904">Added blank schema skip condition.</event>
<event version="SE14-011-01" user="murphyr" date="2013-10-31" ref="67012">Updated for CSv0205</event>
<event version="SE16-015-01" user="kirbyk" date="2016-04-07" ref="67268">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="67423">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="67567">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 3 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>