Change log

Most recent changes first:

Date
yyyy-mm-dd
Description
2009-10-07 (None of these changes affect the structure of the request or response XML.)
  • Updated all test cases; added new test cases. See readme for current details.
  • Added new XML schema to documentation/test_cases/schema directory, specifically for validating test case SOAP messages that do not contain xsi:schemaLocation attributes.
  • Added COBOL copybooks as text files to new copybooks directory under documentation/mapping.
  • Updated description of COBOL copybooks in readme.
  • Added mapping notes to readme.
  • Updated the SOAP address in the sample WSDL file: changed cwbb to pdda.
  • Removed unused namespace declarations from exchange and extension schemas.
  • Moved this change log out of readme into a separate file, to meet the requirement of the NIEM Conformance Validation Tool.
2009-09-16 (None of these changes affect the structure of the request or response XML.)
  • Added test case (005) for error message response.
  • Added table to readme to describe each test case.
  • Corrected mapping PDF for response to reflect true length of date field (10 characters, not 8 characters).
  • Submitted this IEPD to the NIEM Conformance Validation Tool, and then inserted the following information in the exchange and extension schemas:
    • version attribute
    • i:ConformantIndicator element with content "true"
    • xsd:documentation element describing the schema

    The conformance report spreadsheet produced by the NIEM Conformance Validation Tool now reports the exchange and extension schemas as "validated for conformance".

    Also copied contents of metadata Summary field to Description (the NIEM website does not require the Description field, but the Conformance Tool highlights this field as required).

2009-09-14 (None of these changes affect the structure of the request or response XML.)
  • Added test cases.
  • Updated the mapping documentation PDF files to reflect minor changes in the organization of the COBOL copybooks.
  • Added mapping PDF for SOAP fault.
  • Updated indentation in all XML files from 4 to 2 spaces per indent, to match convention used in NIEM schema.
  • Updated catalog to refer to a single subset.zip file instead of multiple uncompressed subset schema files.
2009-09-11
  • Re-mapped the fields DDA-AKA-NAME and DDA-AKA-DOB to the elements nc:PersonName and nc:PersonBirthDate, respectively, in a new container extension element dns-ext:PersonPreviousRecord. This change affects the extension schema and the sample response XML instance.

    These changes were prompted by new information about the nature of the DDA-AKA-NAME and DDA-AKA-DOB fields. Rather than being "also known as" or "alternate" values, as we previously thought, these fields contain the previously recorded values of a person's name or birth date. For example, DDA-AKA-NAME might contain a value because a person marries (so it might contain the person's maiden name), or because there was a data input error (in which case, it contains a value that the person never used as an alternate name). If DDA-AKA-DOB contains a value, it is typically because of a data input error.

    We have submitted a question (reference #090906-000000) to the NISS help desk requesting their feedback on this approach. (Whatever their answer, the original mapping of DDA-AKA-NAME to nc:PersonAlternateName was clearly problematic.)

  • Updated the mapping documentation PDF files to reflect minor changes in the organization of the COBOL copybooks.
2009-09-01 (None of these changes affect the structure of the request or response XML.)
  • Updated the "Maps" comments in the sample XML instances to reflect the change in the prefix of the COBOL copybook fields from QDA- to DDA-.
  • Added PDF files that illustrate the mapping between sample XML instances and implementation-specific COBOL copybooks.
  • Updated the SOAP address in the sample WSDL file.
2009-08-27 (None of these changes affect the structure of the request or response XML.)
  • Enhanced readme with new information, including:
    • This change log.
    • An introduction to this IEPD.
    • Instructions about removing the xsi:schemaLocation attribute and corresponding xmlns:xsi namespace declaration attribute from SOAP messages.
    • An explanation of the "Maps" comments in the sample XML instances.
  • Annotated sample XML request and response instances (in exchange_files/sample) with comments referring to the names of corresponding COBOL copy book fields. (The corresponding SOAP-wrappered instances in documentation/soap/sample, except for the fault sample, have deliberately not been annotated.)
  • Corrected indentation in sample XML instances and extension schema (four spaces per indent level).
  • Fixed broken links in catalog.html.
  • Reworded documentation definitions in the exchange and extension schemas to conform to the NIEM Naming and Design Rules (NDR). For example, replaced "Type defining..." with "A data type for...".
  • Added nillable="true" attributes to element definitions in the exchange and extension schemas, to conform to the NDR.
  • Recoded the definition of the element dns-ext:PersonAlternativeBirthDate in the extension schema from an inline element definition to separate element definition, type definition, and element reference, to conform to the NDR.
2009-08-21 First draft.