Preparing and Submitting Data to the NeCODP Node

In order to submit data to the NeCODP Exchange Network node, you will need to follow a few key steps. We have developed some guidelines that should help you get started with the process. Please do not hesitate to contact us (iogilvie@gmri.org, rmorse@gmri.org) if you need additional help getting started.

Register for a NAAS Account

Contact Ian Ogilvie (iogilvie@gmri.org) to get a NAAS (Network Authorization and Authorization Service) account. This is an Exchange Network authorized account and is what the server node uses to verify you as a user.

Download and Install Node Client - NodeClientLite2

The NodeClientLite2 application, developed by Windsor Solutions, provides a simple and user-friendly interface to the Exchange Network. You will need to install this windows-based client onto your computer and configure the settings so that you can communicate with and submit to the NeCODP server node.

We have developed a tutorial for downloading and installing the node client software and getting connected to the NeCODP server node.

 

Map data to the ODPX XML Schema

The NeCODP partners working on this Exchange Network project have developed a schema for exchanging environmental monitoring data. We have developed a Data Exchange Template (DET), schema and example files to help partners map their data to the schema. Please take the time to familiarize yourself with the Data Exchange Template, ODPX Schema and example files and code.

Partners can generate ODPX compliant XML files using the DET and example files as guidelines:

 

Generate XML file of your data

The Exchange Network utilizes the eXtensible Markup Language (XML) for transmitting data through the network. You will need to have a machine or process capable of generating XML files in order to submit to the node.  The example files listed above will help provide guidance in mapping and developing your ODPX XML file. You might find it easier to configure some of the organizational and monitoring location information manually for the initial submission, while the data that changes more frequently could potentially be automated with scripts. If you need additional guidance for this step, please contact Ian Ogilvie (iogilvie@gmri.org) for assistance in generating your XML files.

  1. Query your database or data source and format the output into ODPX XML
  2. Configure the resulting XML to match the ODPX schema
  3. Run your test XML files through a validation tool to identify whether your XML file conforms to the XML schema.
  4. Send your XML file to Ian (iogilvie@gmri.org) so he can review it/test it before submitting to the node. (*This will be an initial step while we are getting the node fully configured. Until we get regular submissions going, we want to make sure we can handle submissions from each partner's unique data sets).

 

Submit XML file(s) to NeCODP Node

Once you have generated your ODPX compliant XML file, you can submit to the NeCODP Server Node using the NodeClientLite2 application. The NodeClientLite2 tutorial will provide information on how to submit a file to the node.

NodeClientLite2 Tutorial

You may find it easier to create multiple XML files. You may still use the NodeClientLite2 to do a single submission of all your files.

Submitting multiple files with a single submission.

Tools and Resources

Working with XML files can be challenging, fortunately there are plenty of tools to help you validate against the ODPX schema before submitting your file. Here are few recommendations:

 

  • Oxygen XML editor - this is the tool we are using at GMRI. It allows you to hand-edit an XML file and validate against the ODPX schema before submitting. Cost - $64 (academic/non commercial rate), available for Mac and Windows.
  • Microsoft XML notepad 2007 - A free download from Microsoft. XML Notepad 2007 provides a simple intuitive user interface for browsing and editing XML documents. Windows only.
  • Altova XML Spy - This program is not free ($189), but they offer a 30 day free trial which may be useful in getting your data ready to submit. Available for Mac and Windows.

 

*If you are new to the Exchange Network Project, you will also need to download and sign a Trading Partner Agreement. Signed TPAs can be returned via email or regular post to:

Riley Young Morse
350 Commercial St
Portland, ME 04101
rmorse@gmri.org