Transcript www.eccma.org

eOTD Web Services
Doug Erickson, Partnet
doug.erickson ○ partnet.com
© 2006 Partnet, Inc. All Rights Reserved
What’s a Web Service?
“A web service is a software system
designed to support interoperable
machine-to-machine interaction over a
network.” — W3C
© 2006 Partnet, Inc. All Rights Reserved
Underlying Technology
SOAP 1.1
Message envelope
WSDL 1.1
Interface description
WS-I 1.1
Clarification of WSDL/SOAP
© 2006 Partnet, Inc. All Rights Reserved
What can eOTD services do?
 Find concepts to encode data
 Lookup terminology to decode data
© 2006 Partnet, Inc. All Rights Reserved
Encoding Catalog Items
EYE BOLT
= 0161-1-01-014159
EYE STOCK THICKNESS
0.125
INCH
NOMINAL
…
= 0161-1-02-003830
= 0.125
= 0161-1-05-000798
= 0161-1-06-000001
© 2006 Partnet, Inc. All Rights Reserved
Query
Use keyword search to find terms and
the concepts to which they belong.
Specify filters, sorting, and other
options.
© 2006 Partnet, Inc. All Rights Reserved
Keyword search syntax
 Logical intersection of results
 Keywords “stemmed”
 Further developments ahead
© 2006 Partnet, Inc. All Rights Reserved
Exact matching
 No stemming
 Sensitive to whitespace and
punctuation
 Case insensitive
 For when you “know” the term exists
© 2006 Partnet, Inc. All Rights Reserved
Language
 Ignored for “exact” matching
 Otherwise, used for:
– tokenization, spaces aren’t always used
– stemming, lemma, i.e., mechanical = machine
– comparison, i.e., Turkic I = ı, German SS = ß
© 2006 Partnet, Inc. All Rights Reserved
Filtering results
Filtering can improve relevance and
performance.
© 2006 Partnet, Inc. All Rights Reserved
Concept type
Concepts have types; you have to find
the right kind.
Specify the concept type identifier for
class, property, unit of measure,
property value, …
© 2006 Partnet, Inc. All Rights Reserved
Standards conformance
Terms conform to standards for spelling,
structure, review, etc.
Specify the identifier ECCMA has
assigned to the standard you prefer.
© 2006 Partnet, Inc. All Rights Reserved
Limit and offset
 Limit the maximum number of terms to
retrieve
 Skip some number of terms in the
result
 Supports “paging” through a lot of
matches
© 2006 Partnet, Inc. All Rights Reserved
Searcher info
 Information about the service’s
capabilities
 Enumerates concept types
 Enumerates conformance standards
 Lists languages supported for sorting
© 2006 Partnet, Inc. All Rights Reserved
Response
Carries all of the information about
concepts with terms that match your
keywords and search options.
© 2006 Partnet, Inc. All Rights Reserved
Matching terms
 Each result item is a pair: the concept,
and a reference to one of that
concept’s terms.
 Concepts have many terms; the term
identifier highlights the match.
© 2006 Partnet, Inc. All Rights Reserved
Hits
The total number of matches; what you
would get if there were no limit.
The service may impose its own limit.
© 2006 Partnet, Inc. All Rights Reserved
Decoding
0161-1-01-014159 = BOULON, A OEIL
0161-1-02-003830 = EPAISSEUR DU MATERIAU DE L'OEIL
…
© 2006 Partnet, Inc. All Rights Reserved
Request
 Lookup the concept identifier
 That’s all!
© 2006 Partnet, Inc. All Rights Reserved
Response
All of the terminology associated with
the concept in the eOTD: terms,
definitions, images.
Terminology for all available locales,
standards, etc.
© 2006 Partnet, Inc. All Rights Reserved
How do I use the services?
 eOTD Viewer
 Application development
© 2006 Partnet, Inc. All Rights Reserved
Caveats
Likelihood of interface changes.
Clients can expect continued support of
old versions for some time.
Implementors will have to support
multiple versions concurrently.
© 2006 Partnet, Inc. All Rights Reserved
Future
 Enhanced query syntax
 Definition search
 Definition similarity
 Image support
© 2006 Partnet, Inc. All Rights Reserved