Contents 1 BioCASe Monitor 2.0 Administrator Manual 1.1 User Registration, Authentication & Rights: 1.2 Typical Workflow 1.2.1 Login 1.2.2 Main Metadata 1.2.3 Count Concepts 1.2.4 Data Source Access Points (DSAs) 1.2.5 Useful Links 1.2.6 Logout 1.3 Webservices 1.3.1 Direct Call 1.3.2 GUI 1.3.3 BioDiversity catalogue

BioCASe Monitor 2.0 Administrator Manual

thomas.pfuhl@mfn-berlin.de, Oct 2015, last updated April 2016

---

User Registration, Authentication & Rights:

• every administrator needs to be registered: username, password, full name, email address
• the administrator's rights are individually set for each provider : crud (create, read, update, delete)
  • no access: ----
  • read only: -r--
  • read+update: -ru-
  • crud : crud

Typical Workflow

1. login
2. select Provider
3. edit the Provider's Main Metadata
4. edit Data Sources and Data Sets
5. edit Useful Links
6. logout

Login

• login
• type in username and password
• select provider

Main Metadata

• edit the provider's Main Metadata

Count Concepts

• example: /DataSet/Units/Unit/MultiMediaObjects/MultiMediaObject/FileURI
• modify a concept: autocompletion from all concepts defined in ABCD2
• sort: move a concept up and down, using the handle
• save
• add
• delete

Data Source Access Points (DSAs)

• Data Sources are presented in tabs: a tab for each data source, one data source visible
• operations: add, delete, save
• edit required fields
  • status: active/inactive
  • data-source: select select a specific Data Source in the dropdown list
  • title: type a human readable full title
  • data-set: select a specific Data Set in the dropdown list
  • landing-page: select type of landingpge:
    • automatically generated: this is the default landingpage, based on a scan request for the concept /DataSets/DataSet/Units/Unit/MultiMediaObjects/MultiMediaObject/FileURI.
    • user-defined URL: enter an URL
• for advanced users only:
  • filter is applied as is (not validated) to the request sent to the pywrapper

Useful Links

• add an arbitrary list of links
  • a link is a fqdn (full qualified domain name) and should be one of the following types:
    • BioCASe Query Tool
    • BioCASe Archive
    • GBIF
    • Europaeana
    • Deutsche Digitale Bibliothek
    • GeoCASe
    • BiNHum
    • Pangaea
    • GFBio
  • example: http://www.gbif.org/dataset/71f03224-f762-11e1-a439-00145eb45e9a (GBIF)
  • special case: BioCASe Archive
    • recommendation: BioCASe Archives should always be provided and placed first. In the case of multiple Archives, one of them can be marked as "latest".
    • remark: please note that an URL for a BioCASe Archive is arbitrary, i.e. it need not to be hosted on the biowikifarm.

Logout

• 

---

Webservices

output: JSON

Direct Call

You have to supply some of the following GET-Parameters: provider (provider ID), name (provider Name), dsa (Data Source Access Point), url (pywrapper)

• http://bms.gfbio.org/services/providers/ (gets Providers)
• http://bms.gfbio.org/services/providers/?provider=1
• http://bms.gfbio.org/services/providers/?name=SNSB
• http://bms.gfbio.org/services/data-sources/ (gets DSA Points)
• http://bms.gfbio.org/services/data-sources/?provider=1
• http://bms.gfbio.org/services/useful-links/?provider=1 (gets Useful Links)
• http://bms.gfbio.org/services/useful-links/?provider=1&dsa=1
• http://bms.gfbio.org/services/xml-archives/?provider=1 (gets XML Archives)
• http://bms.gfbio.org/services/capabilities/?localId=0&url=http%3A%2F%2Fww3.bgbm.org%2Fbiocase%2Fpywrapper.cgi%3Fdsa%3DHerbar (gets Capabilities, localId is a dummy value)

GUI

• http://bms.gfbio.org/services/

BioDiversity catalogue

These Webservices are registered in the BioDiversity Catalogue: https://www.biodiversitycatalogue.org/services/101