SummaryΒΆ
Commenting Open Service Interface Definitions commenting version 3.0.0
The Commenting OSID provides a means of relating user comments and ratings to OSID Objects.
The Commenting OSID may be used as an auxiliary service orchestrated
with other OSIDs to either provide administrative comments as well as
create a social network-esque comment and rating service to various
OsidObjects
.
Comments
Comments
contain text entries logged by date and Agent
. A
Comment
may also include a rating represented by a Grade
defined
in a GradeSystem
. The RatingLookupSession
may be used to query
cumulative scores across an object reference or the entire Book
.
Comments
are OsidRelationships
between a commentor and a
reference Id. The relationship defines dates for which the comment
and/or rating is effective.
Commentors
An Agent
comments on something. As a person is represented by a
Resource
in the Resource OSID, the Comments provide access to both
the commenting Agent
and the related Resource
to avoid the need
of an additional service orchestration for resolving the Agent
.
Cataloging
Comments
are cataloged in Books
which may also be grouped
hierarchically to federate multiple collections of comments.
Sub Packages
The Commenting OSID includes a Commenting Batch OSID for managing
Comments
and Books
in bulk.