E_CITATION Service Producer Schema
2024-11-22T09:45:55.546079-06:00
e_citation Producer schema generated on 2024-11-22T09:45:19.762124-06:00 against version #FLT16-1310
General notes on this schema:
EXTERNAL SPEC REFERENCES
The e-citation spec contains a data element listing which identifies a DDN number. This corresponds to the data elements in the ADR spec (6/18/2013 version of ADR spec). This can be used to locate data items in this schema: to find ADR data element #60, search for 'DDN 60'
All e-citation spec/std. references herein are from the 5/14/2014 version of the e-citation spec
NOT ALL SCHEMA DATA IS NECESSARILY IN USE
The presence of a data element in the this schema doesn't necessarily mean that it is used by Judici.com.
DATA SECRITY AND PRIVACY RESTRICTIONS
Judici courts implement a variety of restrictions on what data is shown to the public. Some of these restrictions are required and others are at the court's discretion. For a list of all data subject to possible restriction as Secure Data or Private Data, see https://www.judici.com/agreements/Exhibit_D_to_Web_Service_Subscriber_Agreement
NOTICE: DERIVED DATA VALUES
All data defined herein as "Derived Data" is set by court, and is for internal Judici.com use only. It is derived by the court from one or more underlying case data elements, which can be quite complex. Derived Data may control restrictions on whether case data will be made public under the data security and privacy restrictions (see previous note) and/or applicable statutes or regulations such as the federal Fair Credit Reporting Act (FCRA) requirements on reporting past non-convictions. Derived Data might not, at any given time, be calculated in accordance with applicable statutes and regulations and it is subject to change. Derived Data is shown on an "as is" basis, given the relevant underlying case data. In the event of any conflict between such data and the underlying data, the latter shall govern and the conflict should be brought to the attention of the court.
Retention in Compiled Index Record not allowed for any Derived Data.
CODE, DESCRIPTION AND TEXT ATTRIBUTES
Enumerations are used when the code/value list is modest in size and fairly static. If the code is meaningful text (e.g. BLK, BLU...) it will be used as the enumeration Otherwise, the enum will contain the VALUE. This is because most codes are sequence/ordinal numbers which can be effectively be derived from the ordinal position in the enum (and even when the number sequences have GAPS, the right code can still be derived).
When there is no enum:
-Code can be required
-Value should be optional (unless there is a write-in value such as with 999999 offenses)
-Schema may include enumerations, if the codes meaningless numerics and the list of values is not long.
MORE ON CODES
- Courts often use "standard" codes in different ways (e.g. indicating modified judgments using a different sequence of dispositions). So while Service Provider may provide guidance on interpreting court offense data, it is recommended that any user of this data work directly with the court for a full, complete and correct interpretation of that court's data.
BOOLEAN
In order to be able to convey explicit "Unknown" value, the schema uses an enumeration (Yes/No/Unknown) rather than Boolean.
DATE FORMAT
Producers have to supply Date type attributes (omitting any of the optional time zone info), while Consumer schemas will continue to be text.
CODES FOR STATES, PROVINCES, TERRITORIAL POSSESSIONS AND COUNTRIES
Wherever the schema calls for a state/province code for the U.S., Canada or Mexico, use one of the applicable two-character codes in Appendix A in ADR spec. Note that the state/province codes for Mexico and Canada used by the AOIC don't always match international standards.
Wherever the schema calls for a country code, only the following countries need be indicated: US = United States, MX = Mexico, CA = Canada.
For most data values associated with table lookups, Judici can OUTPUT any combination of the following:
- An attribute containing "Code" contains the code value (e.g. a value of "405" for the <CriminalDisposition> Code attribute)
- An attribute containing "Name", or "Description" holds the exact text corresponding to the code (e.g. "Withhold Judgment/720 ILCS 5/12-4.3").
- An optional third attribute containing "Text"- this exists to give courts the option to provide more human-readable content. But practically speaking, courts rarely do this. So this last attribute is typically just a concatenation of teh other two.
- AddressTOP
Attributes:
City |
---|
Per ADR spec (DDN 31), this is 20 char. CMS will truncate. |
use: | required | |
type: | xs:string | |
State |
---|
Ref. ADR spec (DDN 32). See note on state/province codes, in comments at top of schema
'empty string' = Other/Unknown |
type: | xs:string | |
maxLength: | 2 | |
| 0 | |
| ([A-Z]{2})? | |
PostalCode |
---|
Ref. ADR spec (DDN 33). In in U.S. addresses, this is zip code. |
type: | xs:string | |
Country |
---|
Ref. ADR spec (DDN 32 and DDN 327). See note on state/province/country codes, in comments at top of schema
Producers are required to always include a two letter country code.
US = United States
MX = Mexico
CA = Canada
'empty string' = Other/Unknown Non-US |
use: | required | |
type: | xs:string | |
maxLength: | 2 | |
| 0 | |
| ([A-Z0-9]{2})? | |
Type |
---|
Distinguishes home address from work, etc. |
type: | xs:string | |
Children:
Parents:
- AddressLineTOP
Attributes:
Number |
---|
An ordinal number for each street address segment provided. |
type: | xs:int | |
use: | required | |
Line |
---|
The street address text segment. Per ADR spec (DDN 29/30), this is A/N 60. CMS will truncate. |
type: | xs:string | |
use: | required | |
Parents:
- BMVInfoTOP
Attributes:
HazardousMaterialsFlag |
---|
Ref. ADR spec (DDN 145). Not required, since the citation might not even concern a vehicle. But if it IS provided, the e-citation spec requires a definitve answer. That is why the Unknown option isn't allowed for e-citation. |
type: | xs:NMTOKEN | |
enumeration: | Yes | |
| No | |
CommercialVehicleFlag |
---|
Not required, since the citation might not even concern a vehicle. But if it IS provided, the e-citation spec requires a definitve answer. That is why the Unknown option isn't allowed for e-citation. |
type: | xs:NMTOKEN | |
enumeration: | Yes | |
| No | |
VehicleMake |
---|
See ADR spec (DDN 150). This is just text, as there are no Illinois standard codes for vehicle make |
type: | xs:string | |
PlateNumber |
---|
Per ADR spec (DDN 148) |
type: | xs:string | |
maxLength: | 9 | |
PlateState |
---|
Per ADR spec, DDN 149. See note on state/province codes, in comments at top of schema
'empty string' = Other/Unknown |
type: | xs:string | |
maxLength: | 2 | |
| 0 | |
| ([A-Z]{2})? | |
DriverPassenger |
---|
Per ADR spec (DDN 146). Indicates whether the violator was a driver or passenger. ADR-allowed values don't quite match e-citation spec, so some values may have to be mapped to U (Unknown). Not required, because the offense may not even involve a vehicle. |
type: | xs:string | |
enumeration: | D | |
| P | |
| U | |
Parents:
- ChargeTOP
For any traffic stop that results in multiple offenses including OVs, vendors are required to split these OV charges out onto separate cases/XML files, as AOIC rules do not permit OVs to be put onto any case that isn't an OV.
Attributes:
Code |
---|
Per ADR spec (DDN 55): N-7. Indicates the relevant criminal offense, based on the standards used in the court. In Illinois, these standard values are mandated by, and distributed by, the Administrative Office of the Illinois Courts.
Must be zero padded.
Retention in Compiled Index Record not allowed.
If the offense is a non-traffic local ordinance, for which there is no offense code, provide a value of 0000000. Though this can't be enforced by schema, a code of 0000000 will be rejected in pre-processing if the StatuteReferenceSource is not "Local" (which indicates a non-traffic local ordinance).
No code, 9999999 or otherwise, shall be used when the a citation is written for an offense not in AOIC's standard list of offenses. A code of 9999999 cannot be prevented by schema, but will be rejected in pre-processing. |
use: | required | |
gal:xpath: | (. = '0000000' and @StatuteReferenceSource = 'Local') or (. = '9999999' and @StatuteReferenceSource != 'Local') or (. != '0000000' and . != '9999999') |
type: | xs:string | |
pattern: | \d\d\d\d\d\d\d | |
Description |
---|
Reference ADR spec (DDN 56). This should be used to convey descriptions on non-traffic ordinance violations, which have no offense code. When a data Producer provides this WITH an offense code, the court's CMS will ignore it and rely SOLELY upon the Code attribute- the description will not be checked against the AOIC offense table. This is for a variety of reasons, including the fact that the AOIC is requiring e-citation vendors to use verbose descriptions which aren't even IN the offense table). |
type: | xs:string | |
Qualifier |
---|
Distinguishes committed offenses from "attempted", or "conspiracy". |
use: | required | |
type: | xs:token | |
enumeration: | Attempted | |
| Conspired | |
| Solicited | |
| Committed | |
| None | |
StatuteReferenceSource |
---|
Judici uses a list of values matching the requirements of ADR spec (DDN 53), but the values are shortened. IRS is no longer in effect, so Producers cannnot use those. |
use: | required | |
type: | xs:NMTOKEN | |
enumeration: | StateILCS | This is for regular state statute violations. |
| LocalILCS | This is for local ordinance which are equivalent to state statute violations. Typically, these are traffic violations which have been adopted into local ordinances. |
| Local | This is for local ordinance which are NOT equivalent to state statute violations. For example: Failure to Mow Property. |
Children:
Parents:
- CountTOP
The most severe charge must be first in the e-citation xml, as that will determine which traffic case the bond goes on if there is more than one offense. This should be no problem because officers have to be aware which charge is most severe to set bond [see SCR 503(a)(2)] and they typically input the most severe charge first. It is best if multiple offenses in the e-citation xml are in descending class order.
Attributes:
XID |
---|
The data producer's ID for this charge, which Judici may or may not retain/use. Optional, for diagnostic purposes. |
type: | xs:string | |
TicketNumber |
---|
The Administrative Office of the Illinois Courts has indicated that the ticket numbers should not contain the officer's badge ID. So if the badge ID is a part of the ticket number, it should be removed before e-citation data is reported. When the ticket number is too long, the presence of the badge ID is often the reason. So the AOIC's restriction may prove helpful in meeting the maximum length constraint as well.
A/N 10, per ADR spec, DDN 64. In traffic cases, this will be the ticket number issued by law enforcement. In non-traffic cases, some courts might use it for other kinds of data. |
use: | required | |
type: | xs:string | |
maxLength: | 10 | |
PersonalInjury |
---|
Per ADR spec (DDN 60): A-1, with allowed values which essentially match those in the e-citation std. Indicates whether injury, death or damages occurred. |
type: | xs:NMTOKEN | |
enumeration: | I | |
| P | |
| D | |
| V | |
OffenseDateTyped |
---|
The date on which the criminal offense occurred. Apparently, this is not required in many participating Judici courts. See also ADR spec, DDN 41. |
use: | required | |
type: | xs:date | |
UrbanDistrict |
---|
There is no ADR Per ADR spec for this, but the courts use it and it is required by the e-citation spec. The e-citation spec only asks for it when it is affirmative, so this is another situation where booleans won't work (see note above on Booleans) |
type: | xs:NMTOKEN | |
enumeration: | Yes | |
| No | |
| Unknown | |
Children:
Parents:
- CourtTOP
This is the root element for any data that is associated with a court (e.g. Judges, Cases, Incidents, Holiday events)
Attributes:
NCIC |
---|
Per ADR spec (DDN 4): A/N 9. The ORI number for the court, as issued by the federal government. Follow ADR std. |
use: | required | |
type: | xs:ID | |
pattern: | IL\d{6}J | |
Name |
---|
Common name of the court. Required, for diagnostic reasons. |
type: | xs:string | |
use: | required | |
Children:
Parents:
- DocumentDataTOP
Content Type
xs:base64BinaryAttributes:
encoding |
---|
The encoding format of the documnent data |
use: | required | |
type: | xs:string | |
enumeration: | BASE64 | |
mimeType |
---|
The encoding format of the documnent data |
use: | required | |
type: | xs:string | |
enumeration: | application/pdf | |
Parents:
- EventTOP
These can be on cases (e.g. a hearing), or on a court (e.g. a court holiday).
Notice: While courts may have event data indicating past dates, it isn't possible to know whether an event actually occured or not.
E-citation will provide the hearing date and time indicated on the ticket. E-citation standard does allow for this to be determined later, so this cannot be required for e-citations.
Attributes:
Location |
---|
One of the courtroom numbers used by the court (e.g. 2, or B). Because it is court-specific, no enum is available. But incoming data from Producers, if any, will be validated by JIMS. E-citation spec says to provide courtroom, "where available". No ADR DDN provided. |
type: | xs:string | |
Code |
---|
There may be a Code/Description pair, if the event is table-driven. The hearing type is not required in e-citation, but will be accepted if known. |
type: | xs:string | |
Parents:
- IncidentTOP
Attributes:
NCIC |
---|
This is the NCIC ORI code for the law enforcement agency which is reporting the incident. |
use: | required | |
type: | xs:string | |
pattern: | IL\d{7} | |
ID |
---|
This is the incident ID or police report number for the incident. |
use: | required | |
type: | xs:string | |
minLength: | 1 | |
XID |
---|
A Producer's internal ID (e.g. compound database key) for this data item. Judici may not use this for anything other than diagnostic purposes |
type: | xs:string | |
TownshipRoadFlag |
---|
Per ADR spec DDN 174. |
gal:xpath: | . = 'No' or . = 'Unknown' or (. = 'Yes' and string-length(../@TownshipCode)!=0) |
type: | xs:NMTOKEN | |
enumeration: | Yes | |
| No | |
| Unknown | |
TownshipCode |
---|
There is no universal standard (such as NCIC code) for townships. So this code is assigned by the Clerk their arresting agency table in their case management system. The only time that a township NEEDS to be set up in this way is when the township is supposed to get some money from the ticket. Not all townships have this deal with local law enforcement. But in those that do, the TownshipRoadFlag should be set and TownshipName/TownshipCode should be provided. |
type: | xs:int | |
Children:
Parents:
- PaymentTOP
Attributes:
Amount |
---|
This is the amount of cash bond paid, if any. Corresponds to ADR spec, DDN 49. |
type: | xs:int | |
use: | required | |
Type |
---|
The Audit value is used on records which correspond to the change/deletion of a previous payment. NOTE: In courts using the JIMS case management system- payments originally receipted by a collection agency will have a Type value of "Collect agn chk" or "Collect agn EFT", depending upon how the funds were conveyed to the court by the agency. Becuase it takes a couple of days to actually have the money "in hand", Clerk staff would have trouble knowing whether to input th ebond or not. So for now, the Clerk's interface won't all credit card payments. |
use: | required | |
type: | xs:string | |
enumeration: | Cash | |
Parents:
- PersonIdentifierTOP
Attributes:
Type |
---|
Indicates the type of ID (e.g. SID code, state/DLN). |
use: | required | |
type: | xs:NMTOKEN | |
enumeration: | StateAndDriversLicense |
A concetantation of the issuing state code (see note on state/province codes, in comments at top of schema) and the driver's license number. Ref. ADR spec (DDN 37 and DDN 36)
If not supplying a US state, Mexican state or Canadian province, use blanks for the first two characters in the DLN. |
ID |
---|
The actual identifier. Driver's licenses are represented as a concatenation of a "state" code (if any) and the driver's license number. Ref. ADR spec (DDN 37/36). For Illinois data, the non-U.S. "state" codes are based on a standard set by the Administrative Office of the Illinois Courts. ID shall never have punctuation in it (e.g. dashes in a DLN or SSN) |
type: | xs:string | |
use: | required | |
Parents:
- RelatedActorTOP
Each arresting officer is represented by a RelatedActor associated with the court data transfer file. For more on how to represent an ArrestingOfficer, see general notes following.
These are individuals not associated with cases. Some are associated with a Court (e.g. judges), while others are even higher-level (e.g. law enforcement agents). Since the attributes used depend on what role the individual plays, and because the structure of some attributes is dictated for performance reasons, a few examples will best illustrate what is required:
Examples:
INDIVIDUALS DIRECTLY ASSOCIATED WITH THE COURT
Judge- <RelatedActor Type="Judge" ActorId="IL001025JWAPNER" Name="WAPNER" Id="IL001025JWAPNER" OrganizationCode="IL001025J"/>
Court reporter- <RelatedActor Type="CourtReporter" ActorId="IL001025JCRLP" Name="LP" Id="IL001025JLP" OrganizationCode="IL001025J"/>
OrganizationCode- NCIC from Court
ID- a composite value with a required structure using special delimiters
NCIC from Court
The court's internal ID for the individual
ActorID- a composite value with a required structure using special delimiters
- NCIC from Court
- If it is a court reporter, add CR
- The court's internal ID for the individual
INDIVIDUALS NOT DIRECTLY ASSOCIATED WITH THE COURT
Arresting officer- <RelatedActor Type="LawEnforcementAgent" ActorId="IL001025JO9N791" Name="GUNDERSON" Id="791" OrganizationCode="9" OrganizationName="MAPLETON PD" NCIC="IL001013A"/>
ID- the officer's badge number
NCIC- the ORI code assigned to the law enforcement agency with whom the officer is associated.
OrganizationCode-the court's internal ID for the officer's agency
OrganizationName- if OrganizationCode is provided
ActorID is a composite value with a required structure using special delimiters
- NCIC code for the officer
- O (Officer)
- OrganizationCode
- N (Number)
- ID (badge number)
Attorney- <RelatedActor Type="Attorney" ActorId="IL001025JA1234567" Name="DARROW, CLARENCE" Id="1234567" OrganizationCode="123"/>
ID- ideally, courts use the attorney registration number under which the attorney practices in the court
OrganizationCode-the court's internal ID for the firm with which the attorney is associated. If attorney is a solo practitioner, use the court's internal ID for the attorney, or attorney registration number again.
OrganizationName- if OrganizationCode is provided
ActorID is a composite value with a required structure using special delimiters
- NCIC from Court
- A (Attorney)
- ID (attorney registration number)
Attributes:
Id |
---|
Among other things, this attribute is used for an officer's badge number (ADR spec DDN 142). For badge numbers, the value should be numeric, up to five digits. Letters (if any) probably represent the jurisdiction, and should be stripped. |
type: | xs:string | |
use: | required | |
NCIC |
---|
Ref. ADR spec (DDN 59). This is the NCIC ORI code for the arresting officer's agency.
There are other valid NCIC codes as well, and this field should be to indicate them, if available. |
use: | required | |
type: | xs:string | |
pattern: | [A-Z]{2}\d{6,7}[A-Z]? | |
Name |
---|
Ref. ADR spec (DDN 323), though CMS requires "Lastname, Firstname" format. Warning: This feature means that failure to match EXACTLY the value in the court's CMS will result in the creation of a duplicate officer in the CMS. The same thing will occur if you provide the wrong agency NCIC code for an officer. |
type: | xs:string | |
use: | required | |
Type |
---|
use: | required | |
type: | xs:NMTOKEN | |
enumeration: | LawEnforcementAgent | |
Parents: