Registering Resources in TeSS

Training resources (events and materials) may be added to TeSS to reach bigger audiences, increase impact and bolster event attendance. Registering events and training materials makes them more findable in a variety ways to various user bases.

...In TeSS
Be seen by thousands of visitors to TeSS
...Embedded in other sites
Be seen across all the websites that display TeSS resources through our widgets
...In search engines
Be seen in search results more owing to our search-engine optimisation

There are two ways to register training materials or events for display in TeSS:

  1. Arrange for an automatic registration solution;
  2. Use our form to register them manually.

Automatic Registration

The TeSS team can write scripts ('scrapers') to automatically register resources from target websites. The scrapers run each night, adding any new resources to TeSS or updating any that have changed. We can write a scraper to include your resources in TeSS, if your site:

Contains more than 3 resources
Has some structured data
Is relevant to life scientists
Structured Data Types

To register resources in TeSS automatically, our scrapers need to be able to extract data from target websites reliably. To this end, it is helpful if these websites include some structured data.

The following are examples of the kinds of structured data that we can work with. If your website contains one or more of these, and satisfies the criteria above, contact us and we will create a scraper.

If your website includes no structured data, and you’d like your resources added to TeSS, we recommend using Bioschemas to structure your site.

Schema.org / Bioschemas

schema.org is a project run by a consortium of search engines. Schema.org has created an extensive library of simple, lightweight schemas that web-masters can use to explicitly define their websites content in order to improve search engine visibility and interoperability.

For events, you can use the schema.org Event type; and for training materials: schema.org CreativeWork Type.

The schemas provided by schema.org are convoluted, and lack some important training-specific fields. As such, a life science community group, called Bioschemas, has created schema.org extensions with life science-specific vocabularies, which add additional fields relevant to the discipline.

The Bioschemas group is producing tools, documents and training to facilitate adoption of standard metadata mark-up.

View Events Biochema View Materials Bioschema


Examples of sites using Bioschemas parsed by TeSS
API

Application Programming Interfaces, or APIs, typically have endpoint URLs that, when accessed, return raw, unstyled data in a common exchange format, such as XML or JSON.

If your website has an API that programmatically displays data for your training or event content, the TeSS team can write an API client to interface with it.


Examples of sites with APIs included in TeSS
Calendar

Many organisations use calendar applications to organise and display their events. These may be custom-made or, more likely, utilise applications like Google Calendar. Calendar applications maintain an underlying file for event storage and retrieval, typically in the .ics format.

If your website has a calendar application, the TeSS team can write a scraper to extract from it the date, location and event descriptions, and upload the data to TeSS.


Examples of calendar files parsed by TeSS
Other types
  • RSS Feed: an RSS feed is a type of news format. Many websites have such feeds, which list recent posts in a standard format. We can write scripts to parse this format;
  • Git Repository: a git repository is a directory containing files that can be edited collaboratively. If you are using GitHub (or similar) to develop your training resources, and/or use GitHub Pages to render them, we can write a script that clones the repository and extracts resource information. We may a sk you to create a metadata file in YAML format to help us extract the metadata;
  • SOLR server (or similar): a SOLR server is a search engine that many sites use for their internal search functionality. If you have a publicly accessible SOLR server, we can write a script to interface with it;
  • Other: if you have training metadata in another structured format (e.g., an XML or JSON dump, a CSV file, a YAML file, or other format), we would be happy to write a script to parse it.
If your website contains any of the above, or you'd like advice about annotating with Bioschemas, you can contact us via e-mail at support@tess.elixir-europe.org
Manual Registration

Resources may be added manually to TeSS.

To do so, first register for a free account. Members of ELIXIR can use ELIXIR AAI to register and login.

Once registered and logged in, the 'register event' and 'register material' buttons will become visible on the events and materials tabs. Alternatively click here:

Register event Register material

If you have resources that change frequently, we recommended that you establish an automatic registration solution.