Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

NOTE: Protocols can only be bulk loaded by FedRAMP authorized users.

The primary function of the Add Protocol tool is to add a new protocol to the AKN database. It will also add it to whatever project you have selected. If your protocol already exists in the AKN just not in your project, please use Project Leader to add it to your project.
https://data.pointblue.org/apps/projectleaders

To use the tool:

  1. Login to Bulk Uploader (https://data.pointblue.org/science/projectmanager/bulk_uploader) and select the project to which you wish to add the new protocol.

  2. Populate a yaml file with any/all of the following fields. See below for yaml “tips and tricks”. If your protocol is similar to an existing one, you may download the yaml for that as a starting point from the Protocol Search page: https://data.pointblue.org/science/projectmanager/protocol_search

    ***TODO: Expand on yaml “rules” for protocols (e.g., required fields, etc)

  3. Choose the yaml file to upload; after successfully selecting a file, the name of the file will appear on the screen.

  4. Click the Process button. Errors, successes, and information about the batch run will be shown.*

* At present, there is a known issue pertaining to extended fields in the yaml.

YAML tips and tricks

  1. New extended fields cannot be created via yaml. You must submit a ZenDesk ticket requesting the new field be created before it can be referenced in the yaml.

  2. New dictionary fields and code sets CAN be created by leaving the DictionaryID field blank ('') and populating the Dictionary section. (see example below)

  3. To reuse an existing dictionary field and code set, populate the DictionaryID field. If you do not know this, you have two options:

    1. Download the yaml for an existing protocol that uses the dictionary field you need; this will include the DictionaryID number.

    2. Submit a ZenDesk ticket with the details so someone can look it up for you.

  4. To create new CodeSets in Site Condition protocols, type in the groups and labels you want; the bulk uploader will determine if new sets need to be created.

  5. If a description, text before or after label, dictionary value, etc has spaces or special values, enclose the string in quotes.

  6. To hide “Breeding” in Biologists, put “BreedingEvidence” in the SuppressedColumns section of the yaml.

  7. Point Count protocols must have at least one time bin, one distance bin, and one detection cue.

  8. If only binned distances are being used, do not include the ExactDistance rows in the yaml at all. If they are submitted without values, an extra null distance bin will be created and mess up the display in Biologists.

Example yaml subset showing a new dictionary code set for Sky:

  • No labels