Catalogue Howtos

21
BiodiversityCatalogue How-Tos Robert Haines

Transcript of Catalogue Howtos

Page 1: Catalogue Howtos

BiodiversityCatalogue How-Tos

Robert Haines

Page 2: Catalogue Howtos

BiodiversityCatalogue Home

• Hover over the ‘s for more information!

Page 3: Catalogue Howtos

BiodiversityCatalogue Home

• Lots of information feeds

Subscribe toupdates withan RSS reader:

Page 4: Catalogue Howtos

Service discovery

• You do not need an account to

– Browse Services

– Search the Catalogue

• Search from the Home Page:

Search Browse Search by data

Page 5: Catalogue Howtos

Service discovery: Browsing

Tags

Services

Filters

Page 6: Catalogue Howtos

Service discovery: Faceted browsing

Filtered services

Filters: applied (top)and available (below)

Subscribe to these filtersFurther searching

Page 7: Catalogue Howtos

Service discovery: Search

• Search for “workflow”

4 Services

11 Soap Operations

1 REST Endpoint

Page 8: Catalogue Howtos

Service discovery: DetailService names

Provider information.

Supplementary annotations.

Monitoring status

Service URIs

Page 9: Catalogue Howtos

Become a member and sign in

• The “Sign up” and “Sign in” buttons are in the top-right hand corner of the home page:

Click here to create an account.

Click here to sign in if you already have an account.

Page 10: Catalogue Howtos

Create an account (Sign up) 1

Your email address is used as your login name. It is kept private and will never be disclosed to anyone else.

Choose a secure password.

Page 11: Catalogue Howtos

Create an account (Sign up) 2Your name as you want people to see it.

Finish the sign up process.

Only give a public email address if you are happy for people to see it (and possibly use it).

Optional information about you.

Tick here for site and service updates via email.

Page 12: Catalogue Howtos

Your user profile

Name and badge (if appropriate).

Private information.Not seen by others.

Edit profileFrom here.

Page 13: Catalogue Howtos

Registering a service

Register a SOAP (WSDL) based Web Service

Register a REST based Web Service

Page 14: Catalogue Howtos

Registering a service: SOAP 1

• Submit the Service WSDL

• Hit “Preview” to check (and add to) the information provided by the WSDL

Page 15: Catalogue Howtos

Registering a service: SOAP 2

• Lots of information is gathered from the WSDL

And so on …

Page 16: Catalogue Howtos

Registering a service: SOAP 3

• Lots more can be added …

Alternative names.

Links to documentation.

Categories (for Service filtering).

Tags.

Free-text description.

Page 17: Catalogue Howtos

Registering a service: REST

Alternative names.

Links to documentation.

Categories (for Service filtering).

Tags.

Free-text description.

Base URL or Endpoint.

Service name.

Page 18: Catalogue Howtos

Annotating services 1

• Add tags …

Start typing and tags are suggested.

Ontology support.(BioVeL domain ontologiesare in development)

More (relevant) tags makes aservice easier to find for others.

Page 19: Catalogue Howtos

Annotating services 2

• You can add:

– Documentation links

– High level descriptions

– Usage conditions

– Costs

– Licencing

– Contact information

– Publications

– Citations

Page 20: Catalogue Howtos

Annotating services 3

• Add example data to input/output ports …

Page 21: Catalogue Howtos

Summary

• Anyone can browse and search

• Members can

– Register services

– Annotate any part of any service

• Names, Categories, Tags

• Descriptions

• Example data

– Get service monitoring updates