Welcome to the online validator for NEMSIS V3 XML file.

This application validates the EMS data submitted using NEMSIS V3 Web Service interface.

When the server receives a NEMSIS V3 XML file, XML validation and business rule checking (Schematron) will be executed.

1. Targeted audience:
     developers with knowledge of SOAP Web Service.
   
   
2. Resources:
   • The WSDL for this site's Web Service is generated by JAX-WS.
     Please note that the latest releases are located on the NEMSIS Official Web Site.
     Also note that this release fixes several typos and improper use of CamelCase in element naming convention (pointed out by Brandon Goldfedder).
     This release of WSDL doesn't include search function. The search WSDL is here.
   • A national EMS and Demographic Schematron rule Snapshot
   • A Latest V3 XSD Snapshot
   • A sample NEMSIS V3 XML is a valid XML file against the current V3 XSD snapshot. Most elements are populated with dummy data.
   • A sample SOAP message contains the sample XML file above.
   • A sample SOAP message contains a "bad" XML file which will violate one national Schematron rule.
     Please edit the username, password and schemaVersion elements in the sample SOAP message before using them!
     
     
   • ISO Schematron: the official release can be found at www.schematron.com.
   
   Note: When NEMSIS TAC releases new XSD and/or Schematron rule, this site will be updated accordingly.
   
   
3. Details:
   • The NEMSIS V3 release requires that all data submissions to NEMSIS TAC use published Web Services interface.
   • It is required to use HTTPS as the communication method.
   • This application only covers the first few steps in the overall workflow of a NEMSIS V3 submission: Web Service submission, XML validation and business rule (Schematron) validation. It DOES NOT indicate any tool preference by the NEMSIS TAC.
   • NEMSIS V3 WS interface defines three common interfaces (functions, or operations). Only SubmitData is implemented. You can send SOAP message to test the other functions. Only dummy responses are provided.
   • To submit test data, do the following:
     1. Contact NEMSIS TAC (Email: nemsis@hsc.utah.edu) or Karen Jacobson (Email: karen.jacobson@hsc.utah.edu) to open an account if you do not have a NEMSIS TAC account yet.
     2. Develop your Web Service client. Or, install soapUI if you just want to get a feeling. Get familiar with soapUI.
     3. In the Web Service client, reference this site's WSDL. (If using soapUI, create a soapUI project by referencing this site's WSDL. Then create test cases for SubmitData, RetrieveStatus and QueryLimit.)
     4. Generate the request SOAP message, fill in all required parameters and submit the WS request. You can use the sample SOAP messages as starting point. Make sure username and password are correct!
     5. Request Parameters for SubmitData(). (RetrieveStatus() will get an error message.)
        1. "username" and "password": clear text. Remember, the SOAP message is sent by HTTPS.
        2. "organization": could be anything. It does not matter.
        3. "requestType": only value of "SubmitData" is truly processed.
        4. "submitPayload": use payloadOfXmlElement to embed the NEMSIS XML file.
        5. "requestDataSchema": either "61" for NEMSIS EMS data or "62" for NEMSIS Demographics data.
        6. "schemaVersion": only "3.3.4" or "3.4.0" is accepted.
        To have fun, you can play with different combination of parameters to check out the error messages.
        
        
     6. Some versions of soapUI introduce non-UTF-8 character(s) when creating the skeleton SOAP message of a test case. Make sure that in requestData element, "<?xml" directly follows "<![CDATA[" if you use PayloadOfString to embed XML file. So the start of requestData should be something like "<![CDATA[<?xml" if you encounter error message like "Invalid byte 1 of 1-byte UTF-8 sequence...".
   • Response SOAP Messages
     It is required for the NEMSIS WS client to properly decode the response SOAP messages to find out the server's action for the submitted data.
     Since this is a site only for validation, we are not going to import any submission into database. Also, the "requestHandle" element in the response is populated with some string value instead of system unique ID. It cannot be used to retrieve processign status.
     Depends on the request SOAP message, you might get one of these response status code:
     • 1: XML validation passed. And no Schematron FATAL error is found. Thumbs up!!!!!
     • -1: Invalid username and/or password
     • -4: requestType not equals to "SubmitData"/"", or schemaVersion not equals to either 61 or 62
     • -5: schemaVersion not equals to "3.3.4" or "3.4.0"
     • -12: XML validation failed
     • -13: XML validation passed. But at least one Schematron FATAL error is found.
     • -101: NEMSIS XML payload is not included in the SOAP message, or something wrong when we try to save the payload to file system.
     • -20/-21/-22: something wrong with our server
     
     
     
   • If PayloadOfXmlElement is used to embed XML file, Java JAX_WS RI automatically loads and parses the embedded string to DOM tree. This means if your XML file is not well-formatted, JAX-WS will throw exceptions even before Web Service implementation codes are reached. The response message will be a SOAP fault message. If the XML file is well-formatted, this validator will write the DOM to an indented (pretty-print) XML file. A side effect is that the line/column number in this generated XML file will not be same as the original embedded file.