r3 - 2015-10-14 - 00:30:18 - NickCrossleyYou are here: TWiki >  LinkedData Web > BestPractices > PublishRdfVocabularies
This wiki: The development wiki is a work area where Jazz development teams plan and discuss technical designs and operations for the projects at Jazz.net. Work items often link to documents here. You are welcome to browse, follow along, and participate. Participation is what Jazz.net is all about! But please keep in mind that information here is "as is", unsupported, and may be outdated or inaccurate. For information on released products, consult IBM Knowledge Center, support tech notes, and the Jazz.net library. See also the Jazz.net Terms of Use.

New product names: The CE/CLM products were renamed in version 7.0. For details on the name change, see Renaming the IBM Continuous Engineering Portfolio. Some content might continue to use the previous names or contain a combination of the previous and current names.

Best Practice: Publish RDF Vocabularies

State: Approved

Contact: Nick Crossley

Scope

RDF resource representations contain vocabulary terms for properties, types, and individuals. These terms are themselves HTTP URIs. When you use HTTP GET to dereference a vocabulary term URI, you should get a document that describes the term. The vocabulary document should be available as HTML for humans and as RDF for programs, e.g. Lifecycle Query Engine (LQE) and report builders.

The human-readable version of a vocabulary is useful to people who need to develop Linked Data applications, or who need to use data provided by Linked Data applications.

The machine-readable version of a vocabulary is useful by report builders for providing user-assistance to query authors. It is also useful at query execution time so that human-readable labels can be associated with RDF term URIs such as those for enumerated values.

This recommendation contains best practices for publishing RDF vocabularies.

This Best Practice is closely related to Best Practice: Make RDF Vocabulary Documents Available For Use in Queries which discusses making vocabulary documents indexable by query engines.

Recommendation

Standard vocabularies defined by Rational tools should be published on jazz.net. Refer to Publishing RDF Vocabularies at jazz.net for detailed information about creating RDF vocabularies and publishing them on jazz.net.

Many tools support customization. For example, Rational Team Concert (RTC) allows project area administrators to customize work item types by adding new attributes and enumerations. These attributes and enumeration values appear in the RDF representation of work items as RDF properties and individuals. In general, tools should enable administrators to specify external vocabulary URIs used for these RDF terms. In the absence of external URIs, the tool must automatically generate local vocabulary URIs that are hosted by the tool. The generated local vocabulary URIs should follow the same guidelines as for external vocabulary URIs.

The best practices are described in the attached presentation, which was presented to the Rational Development Council, 2012-01-25.

These best practices are based on the W3C Best Practice Recipes for Publishing RDF Vocabularies.

See Also

Topic attachments
I Attachment Action Size Date Who Comment
Pptppt publishing-rdf-vocabularies.ppt manage 1280.5 K 2014-12-29 - 19:30 UnknownUser Publishing RDF Vocabularies
Edit | WYSIWYG | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r3 < r2 < r1 | More topic actions
 
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use
Ideas, requests, problems regarding TWiki? Send feedback