Skip to content

Cocoda ‐ List of Features

Stefan Peters edited this page Nov 27, 2024 · 2 revisions

Last updated: 2024-11-27 - work in progress

General and Interface

  • Select interface language and vocabulary language(s) (separately)
  • Components/cards can be resized (drag on ...) or hidden (click - in the top right)
  • Keyboard shortcuts for certain actions are available
  • </> icon in many places allows access to JSKOS source data and (if available) API links/sources
  • Mapping Trash
    • Trash can icon in the top right
    • Deleted mappings can be restored
  • Favorite concepts
    • Star icon in the top right
    • Concepts can be favorited for quick access (via star or drag-and-drop)

Login

  • To be able to create or assess mappings, a user account is needed
  • Login via different providers (GitHub, ORCID, Wikidata, StackExchange)
    • Custom providers are possible for a self-hosted instance
  • Identity used for saving mappings can be chosen (custom name, select provider URI or generic URI)

Vocabulary Selection

  • Choose source/target vocabularies that are used for mapping
  • Search list of available vocabularies
  • Filter by source, language, and type

Scheme Details

  • Show details for selected vocabulary
  • License, publisher, URIs, languages, type, created/modified date, source
  • Search for concepts inside a vocabulary
    • Setting: Copy selected concept label from opposite side into search field

Scheme Browser

  • Access to vocabularies through a uniform interface
  • For classifications: Browse concepts via hierarchy
    • Structural concepts
    • Built concepts
    • Details not loaded
  • Add a concept to the current mapping (see Mapping Editor)
  • Custom lists of concepts can be added
  • Indicator for each concept whether a mapping exists in the currently selected mapping registry

Concept Details

  • Show concept details and metadata
    • Concept label and notes
    • Translations of label and notes (if applicable)
    • Metadata (URI, type, created/modified)
    • (External) links
    • DDC only: coli-ana analysis
  • Broader/ancestor/narrower concepts
  • Favorite a concept
  • Setting: Always show all ancestors in concept details (will be collapsed by default if there are too many)

Mapping Editor

  • Create new mappings or edit existing
  • Consists of source concept and target concept(s)
  • Multiple ways to add concepts to Mapping Editor
  • Choose SKOS mapping relation
  • Swap directions
  • Save
  • Delete
  • Hint whether current mapping is saved or not
  • Link to mapping guidelines
    • Only available for selected combinations of vocabularies
  • Settings:
    • Clear on save (saving a mapping will clear Mapping Editor)
    • Only allow 1-to-1 mappings

Mapping Browser

Concordances

  • List of existing concordances with source/target vocabulary, description, creator, date, and number of mappings
  • Filter by source/target vocabulary and creator
  • Display total number of mappings in concordances
  • Creation of new concordances
    • Requires privilege
    • Source/target scheme, description
    • Additional contributors are allowed to add/edit mappings in the concordance

Search

  • List mappings from different mapping registries (sources for existing mappings)
    • Default is: all mappings, sorted descending by creation date (note that some registries do not support sorting by date or listing all mappings)
  • Main filters: source vocabulary, source concept (notation/URI), target vocabulary, target concept (notation/URI)
  • Additional filters (hidden by default): creator (name/URI), mapping relation, cardinality (1-to-1, 1-to-n), assessment, concordance, bidirectional search
  • Hide unneeded registries
  • Swap directions
  • Change target mapping registry (for saving mappings via Mapping Editor)
  • Show mapping details
  • Edit/delete mappings
  • Mapping assessment
    • See below

Navigator

  • List mappings from different mapping registries, both existing mappings and mapping suggestions, related to the currently selected concept(s)
  • Copy mapping suggestion into Mapping Editor
  • Show mapping details
  • Edit/delete mappings
  • Mapping assessment
    • See below

Mapping Assessment (in Search/Navigator)

  • Vote on mappings (positive/+1 or negative/-1)
  • Specify reason for negative assessment
  • Confirm a mapping (only privileged user accounts)
  • Feedback via email (no account required)

Settings (Mapping Browser)

  • Results per page
  • Auto refresh (in seconds)
  • Show results for all concept schemes (Navigator)
  • Results related to selected concept on the left/right side (Navigator)

Settings (general)

  • Account/login (see above)
  • Available data sources
    • Sources can be disabled
  • User interface settings (language selection, settings for specific components)
  • List of keyboard shortcuts
  • My Data
    • API URLs for data (mappings, concordances, assessments) that the user created
    • Local mappings (import, export, delete all, rewrite creator)
  • Info about current version of Cocoda