Difference between revisions of "Submitting observations to the InfoEx via the CAAML 3.0.3 API"

From InfoEx Help Information
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{Requirements|UserLevel=Operation Administrator or higher|Connectivity=Online only}} This document describes how to submit observations from an external database s...")
 
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
{{Requirements|UserLevel=Operation Administrator or higher|Connectivity=Online only}}
+
{{Requirements|UserLevel=Op Admin or higher|Connectivity=Online only}}
  
 
This document describes how to submit observations from an external database system to the InfoEx via its CAAML 3.0.34 API. This document is aimed at IT system administrators who are setting up the exchange between the two systems on behalf of the InfoEx subscriber.  
 
This document describes how to submit observations from an external database system to the InfoEx via its CAAML 3.0.34 API. This document is aimed at IT system administrators who are setting up the exchange between the two systems on behalf of the InfoEx subscriber.  
Line 6: Line 6:
 
==Background==
 
==Background==
 
To submit to the InfoEx system via the CAAML 3.0.3 API, the operator needs two pieces of information from the CAA:
 
To submit to the InfoEx system via the CAAML 3.0.3 API, the operator needs two pieces of information from the CAA:
* ''API Key''<br/>A secret token that uniquely identifies the submitting system and provides it with administration privileges for the operation.
+
* '''API Key'''<br/>A secret token that uniquely identifies the submitting system and provides it with administration privileges for the operation.
* ''Operation UUID''<br/>The universally unique identifier of the operation used in the InfoEx system.
+
* '''Operation UUID'''<br/>The universally unique identifier of the operation used in the InfoEx system.
  
 
Please connect with the InfoEx manager at the Canadian Avalanche Association to get this information for your operation.
 
Please connect with the InfoEx manager at the Canadian Avalanche Association to get this information for your operation.
Line 36: Line 36:
  
 
==Functionality tested by==
 
==Functionality tested by==
* Date: Tester / Server / Application version (e.g., Oct. 23: Pascal Haegeli / QA Server / Test Version 0.28.00)
+
* Dec. 22, 2013: Pascal Haegeli
  
[[Category:Help Files]]
+
[[Category:Super User]][[Category:Operation Administrator]][[Category:Administration]][[Category:Observations]][[Category:Version 3.4.0]]
[[Category:Super User]][[Category:Operation Administrator]][[Category:Submission Moderator]][[Category:User]]
 
[[Category:Offline]]
 
[[Category:Administration]][[Category:Locations]][[Category:Observations]][[Category:Workflows]][[Category:Reports]]
 
[[Category:Software Issues]][[Category:Version 0.32.00]]
 

Revision as of 19:28, 22 December 2013

REQUIREMENTS
Permission Op Admin or higher
Connectivity Online only

This document describes how to submit observations from an external database system to the InfoEx via its CAAML 3.0.34 API. This document is aimed at IT system administrators who are setting up the exchange between the two systems on behalf of the InfoEx subscriber.

Background

To submit to the InfoEx system via the CAAML 3.0.3 API, the operator needs two pieces of information from the CAA:

  • API Key
    A secret token that uniquely identifies the submitting system and provides it with administration privileges for the operation.
  • Operation UUID
    The universally unique identifier of the operation used in the InfoEx system.

Please connect with the InfoEx manager at the Canadian Avalanche Association to get this information for your operation.

The CAAML 3.0.3 API is intended to make the transition of existing data systems that directly submit observations to the new InfoEx as easy as possible. By supporting the submission via the legacy CAAML 3.0.3 file format, the submission procedure of these systems only has to be adjusted minimally for the 2013/14 winter season. As a consequence, however, the InfoEx CAAML 3.0.3 API only supports observation types what were used in the legacy InfoEx system during the 2012/13 winter season. Any of the new functionalities that the new InfoEx system offers (e.g., hazard assessments, PWL tracking) is not supported by this API.

NOTE The CAAML 3.0.3 API will only be made accessible to data systems that already submitted observation directly to the legacy InfoEx system. Any new developments should be using the more advanced JSON API that is used internally by the new InfoEx system or the future CAAML 5.0 API which will both support the full functionality of the new system.

Step-by-step description

Submission of observations via CAAML 3.0.3 API

1. Description of first step.
2. Description of second step.
3. ...

Related documents

  • Link to relate document 1
  • Link to relate document 2

Functionality tested by

  • Dec. 22, 2013: Pascal Haegeli