Difference between revisions of "Help:Providing operators with necessary credentials for submitting to the InfoEx via the CAAML 3.0.3 API"
Jump to navigation
Jump to search
(→Background) |
(→Retrieving the UUID of an opperation) |
||
Line 43: | Line 43: | ||
|} | |} | ||
− | ===Retrieving the UUID of an | + | ===Retrieving the UUID of an operation=== |
[[File:OpMngJSConsole.png|300px|thumb|right|Fig. 3: Operation management page with JS console]] | [[File:OpMngJSConsole.png|300px|thumb|right|Fig. 3: Operation management page with JS console]] | ||
{|class="TblSteps" | {|class="TblSteps" |
Latest revision as of 18:17, 24 January 2014
REQUIREMENTS | |
Permission | Super users |
Connectivity | Online only |
This document describes how a CAA InfoEx administrator can retrieve the necessary information that will allow subscribers with their own database system to directly submit their observations via the CAAML 3.0.3 API of the InfoEx system.
Background
An operator needs two pieces of information for submitting observations to the InfoEx from a database system via the API:
- 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
This document describes how to generate or retrieve this information.
NOTE | It is essential for an operation submitting their observation via the CAAML 3.0.3 API that their location catalog in the InfoEx system contains ALL of the locations that observations are submitted for and that their records have the correct External ID. See Submitting observations to the InfoEx via the CAAML 3.0.3 API for more information. |
Step-by-step description
Creating and setting the API Key for an operation
Retrieving the UUID of an operation
1. | Log into the InfoEx system with your super user account. |
2. | Go to the admin menu (cog wheel) in the top right concern of the application next to your user name and select 'Manage Operations'. This will get you to the Operation Management page that lists all the operations that are in the InfoEx system (Fig. 1). Click on the header of any column to sort the table by the particular column. |
3. | Open the JavaScript Console of your Google Chrome browser by clicking on the button in the top right corner of the browser application and selecting 'Tools' and 'JavaScript console'. This will open the console window at the bottom of the browser (Fig. 3). You can also press Ctrl+Shift+J on your keyboard to open the console. |
4. | Type $("#opTable").jqGrid().showCol("uuid"); into the console (Fig. 3). This will add the UUID column to the operation table.
|
5. | Retrieve the Operation UUID directly from the operation table. |
Related documents
Functionality tested by
- Jan. 3, 2014: Pascal Haegeli