Contributions > Service Genres > Dictionary 1.11 Login
  Minimize

 
      Minimize
Name
 
  • Name: Dictionary
  • Alternate Name: Define, Lookup
Rationale
 

This Service Genre describes the functionalities of Dictonary Services. Services of this Genre provide natural language definitions of words provided by a requester.

Classification
 
Domain(s) [ ] Learning & Teaching [ ] Research
[ ] Libraries
[ ] Administration
[ ] IT Services
[X] Common
Maturity [ ] Immature [X] Mature
Development Scale [ ] Isolated [X] Ubiquitous
Status [X] Approved [ ] Placeholder
[ ] Unapproved
[ ] Superseded
[ ] Withdrawn
Confidence Level [ ] High [X] Medium [ ] Low
Version
 
  • e-Framework Service Genre Version: v1.11
Version History
 
Version Date Author Description Organisation / Project
v1.11
2007-02-28
Phil Nicholls
reviewed by eFIG
JISC
Description
 

This Service Genre accepts a term from a requester and provides a definition of that term. There MAY be more than one definition for a particular term. Dictionary services operate in the same natural language as the source term. A Dictionary is an organised collection of definitions and uses of terms.

Dictionary Services MAY be constrained to offer definitions from specific domains. For example, a legal dictionary service offers legal definitions for words; such definitions MAY differ from those generated by other domain specific dictionaries.

The genre does not specify the internals of the dictionary, such as the matching algorithms to use, the store for words and definitions, whether separate word-definition lists can be aggregated etc.

Resources (collections of definitions) offer a “dictionary” interface, defined in the service expressions that specialise this service genre. Clients may send requests to this interface to discover definitions stored or managed by the resource.

As defined, the dictionary service genre is not access controlled: i.e. any client may attempt to contact a dictionary service end point. The service end point for the resource is responsible for determining which results it will return and from which clients it will accept requests.

Functionality
 

The Dictionary Service Genre provides one function:

  • Define: This function is used to present a term to the interface and obtain the resulting definition(s).

No other functionality is defined. The functionality that is defined MAY be extended.

Usage Scenarios
 

 

Applicability
 

The dictionary genre SHOULD NOT be used when alternative terms with the same definitions as the source term are required. Instead a thesaurus service SHOULD be consulted.

The dictionary genre SHOULD NOT be used when translating the source term into a different natural language is desired. Instead a translation service SHOULD be consulted.

A Dictionary MAY be used as a glossary (i.e. provide terms and definitions from a single domain).

Requests & Behaviours
 

Requests and Behaviours SHALL meet the following conditions:

At least one request providing a define function SHALL be defined.

Define SHALL meet the following conditions:

  • The request SHOULD specify:
    • A term defined in a natural language
  • Responses SHALL include error messages or other needed control information.
Use & Interactions
 

The model for a client to interact with a service implementation end point SHALL be defined by the Service Expression that specialises this Service Genre.

Structure
 

 

Applicable Standards
 

There are no technical standards that apply to the genre as a whole. Standards should be used to ensure that any Service Instance uses accurate definitions for any defined term.

Design Decisions and Tradeoffs
 

At the Genre level, dictionaries SHOULD NOT offer the facilities for the management of terms and definitions that they contain. Individual Expressions MAY contain facitlites for the management of terms and defintions.

Implementation Guidance and Dependencies
 

 

Known Uses
 

 

Related Service Usage Models (SUMs)
 

 

Related CORE SUMs
 

None


Intellectual Property Rights: This document is governed by the e-Framework Intellectual Property Rights Statement [http://www.e-framework.org/Default.aspx?tabid=738]. © Copyright, JISC, DEST & e-Framework Partners 2007. This document may be used under the Creative Commons Attribution-ShareAlike 2.5 Australia License [http://creativecommons.org/licenses/by-sa/2.5/au/].


The words MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL in this document are to be interpreted as described in [RFC 2119].

The Service Genre description uses e-Framework Service Genre description elements as of 2006-12-09, updated to include draft e-Framework service classifications. Other terms, e.g., client, provider, and resource, are used as defined in the e-Framework.

 
    Minimize
Unless otherwise noted material from the e-Framework website can be downloaded for your own use under a Creative Commons Attribution-ShareAlike 2.5 Australia License
CreativeCommons-by-sa.png
 
Thursday, August 28, 2008
Copyright e-Framework Partners 2006 - 2008

Terms and Conditions

Privacy Statement