DATA MANAGEMENT

From AnitraWiki
Jump to: navigation, search


(IN) Inbound DATA flows

A possibility of plugging to external telemetry data sources and having them fed into Anitra

Note the devices imported from the data source are imported to your profile and listed in the device list. A unified metadata structure can be then created on top of the imported data (Device - Tracking - Animal). Ultimately data from various sources can be browsed and visualized side by side in a unified metadata-rich structure

Connectors for the following data sources currently exist:

  • Movebank
  • Ecotone
  • Ornitela

Inbound connections are managed in the "Integrations In" section. The overview of existing connections allows adding, editing/removal and running/scheduling the connection
Inbound connection overview.jpg

Use the "+create new" button to launch the connector creation wizard and enter the information required for running the feed

Note each of the connectors works differently and hence also the information needed for running the data flow and scheduling the run slightly differs.

Ecotone

  • details needed: Ecotone panel name (=URL of CSV files storage), user name, and password
  • user can manage this connector fully i.e. create, edit, run (once or schedule regular run), and delete
    Ecotone2Anitra setup wizard.JPG

Ornitela

  • details needed: Ornitela user name and password
  • for Ornitela the data integration relies on Ornitela SFTP functionality.
  • i.e. in this case user creates, edits the data connector, and requests activation (or requests deactivation) of the data flow
  • by requesting activation user also requests to have the SFTP configuration in his Ornitela pannel configured by us.
    Ornitela2Anitra setup wizard.JPG
  • Note some related aspects using SFTP:
    • only new data are integrated once the data flow is activated.
    • for importing older data (records created before the feed activation) use import functionality (any duplicate records are merged or skipped so you can import the same period repeatedly).
    • only the devices marked for SFTP export in the Ornitela panel will be automatically updated into Anitra
    • make sure you also update the connector definition anytime you are changing your Ornitela user password
    • also bear in mind that modifying the list of devices marked for SFTP (unchecking and checking again) will result in the data flow interruption and thus to some possible gaps in the data.

Movebank to Anitra

  • configuring this connector a Movebank data + Movebank metadata are connected
  • Movebank API is employed for accessing the records
  • in this case user is supposed to enter a movebank username and password in combination with Movebank Study ID and request the data flow activation
    Movebank2Anitra setup wizard.JPG

(IN) Manual data import

Import dialog can be accessed in the left-side application menu using the "Import" icon

It allows importing tracking data in the original file structure and format (e.g. Ecotone or Ornitela CSV) - useful when uploading older data files not available anymore for automated flow e.g. adding older records after having activated Ornitela SFTP data flow (which only generated new records).

You can also use our basic format with a simplified structure (type "Basic") to quickly populate any tracking data on the map. Columns:

  • device
  • GPSDateTime
  • latitude
  • longitude
  • note

Note while importing data the "context" matters - you can switch between "profiles" available for your user account

  • any user (even those not involved in any Customer account) can upload data under his private user profile
    • in this case devices created are stored in users profile only and have no relationship with any Customer/Organisation entity
    • the user who uploaded the data becomes "Device Owner"
  • for importing data in the particular customer profile (not in personal profile) make sure you chose one of your organization accounts in the "Upload in profile" selection
    • in this case data imported will be incorporated under the selected "Customer/Organisation" entity


Manual customer import.JPG

  • Also note the import procedure performs append and merge data operations i.e.
    • Not existing devices found in the imported files will be created
    • New datasets for already existing devices are appended to these devices (e.g. you can update your data in the system by monthly update files..)
    • Any existing records (a combination of DeviceId + GPSTime matches) are compared and merged (any previously blank or different values are overridden by the new records) - this is particularly useful while working with data with staged updates (i.e. simplified data are available first and full record sometime later - e.g. shortened data delivered by SMS are filled later on by GPRS)

(OUT) Anitra API data & metadata access

  • allows grabbing Anitra DATA and METADATA from external tools such as from GIS systems API interface
  • curent version of API offers access to the following items:
    • Device List (=Device metadata)
    • Device Data
    • Tracking List (=Tracking and Animal metadata)
    • Tracking Data
  • for detailed documentation and examples of API implementation refer to Anitra Public API documentation
  • note the API is currently linked to user access rights. Therefore your API credentials can be managed down in your user profile "API keys" section. You can generate new keys or revoke existing here.
    Api credentials.JPG


(OUT) Anitra to Movebank data feed

  • Anitra to Movevebank data feed can be set up in the "integration out" section of the customer profile using the "+create new" button
    Movebank customer profile integrationOUT.JPG
  • a Movebank data owner username needs to be specified.
  • the account provided will be used to host all the synchronized data in Movebank
    Movebank customer profile integrationOUT setup.JPG
  • you can switch ON/OFF particular tag data synchronization by the "Export to Movebank" checkbox in the device profile.
  • by default the synchronization is inactive for all the new devices
    Movebank check deviceprofile.JPG
  • you can review the status of the check and the last time of synchronization of each of your devices at the device list


Movebank device list columns.JPG

(OUT) Manual DATA Export

  • allows manually exporting data from Anitra to CSV, XLSX, KML, and GPX formats for offline use
  • export feature can be launched in various contexts / places of the platform:
  1. Customer level (data integration section of customer profile) - full data for all ANITRA devices owned by Customer are bulk exported in this case.
    Export customer profile.JPG
    Note having collected lot of data, this type of export is prone to fail - for mass downloading all your data we strongly recomend using our API functionality instead!.
  2. Device level - the "Export" button in Device profile or using context menu in Device grid.
    Export device grid.JPG
  3. Tracking level - the "Export" button in Animal/Tracking profile or using context menu in Tracking grid
    Export tracking profile.JPG
  • exported data can be filtered by a date range
  • the column editor feature allows modifying output columns in terms of columns list, column order, and naming of exported columns (a user preference)
    Export edit columns.JPG
  • Note the data export functionality is typicaly only available for device admins users (Customer/Device Owner/Admins). Users with shared access ("view only") are not supposed to download and store the shared records outside of the system. In case of need a "share with data export" can be used.
    Share with export.JPG

(OUT) Manual METADATA Export

  • allows manually exporting Device, Tracking and Animal metadata from Anitra to CSV and XLSX formats
  • this export feature can be launched in Device and Tracking list using items from the context dialogue
    Export meta tracking grid.JPG
  • you can modify the columns that will be exported (column list, order, names) using "column editor"
  • use the item "edit columns" from context dialogue over the Device or Tracking grid header line and switch to "export grid" configuration
    Export meta edit columns.JPG