resources/timeline/scope

Provides current and historical information for the first document and segment level comments in the scope.

URL

(POST) /resources/timeline/scope

PARAMETERS

The parameters are a JSON object included in the request body:

scope	The scope object. The segment must be within the scope.	Mandatory
query	An optional query object. This allows to constrain the segments to fetch comments for.	Mandatory
locales	Optional filter on languages of comments. If null then comments will be retrieved for all scope languages.	Optional
skip	Used for pagination. 0 = get comments from the start. If not specified, value will be 0.	Optional
take	Used for pagination. Number of pages to retrieve. If not set, value will be 30.	Optional
knownPersons	Optional array of person/user ids for which we do not need name and company, since we already have this information. Try to provide the person ids if you already have details as this will speed up performance.	Optional
asc	Optional sort order. False (default) = sort with most recent comments on top. True = Oldest comments on top.	Optional

RESULTS

A JSON with these properties:

scomments	An array of segment level comments. See Comment (Object) for details.
scommentsHasMore	True if there are more segment level comments. Find more elements using this method: resources/comments/list and set skip to the value of "take" used with this call.
dcomments	An array of document level comments. See Comment (Object) for details. Find more elements using this method: resources/comments/list and set skip to the value of "take" used with this call.
dcommentsHasMore	True if there are more document level comments. Find more elements using this method: resources/comments/list and set skip to the value of "take" used with this call.
persons	An object containing the persons referred to by comments or revisions. Note: Excludes persons contained in parameter knownpersons. Excludes persons that the user cannot see. There is an access right to prevent a user from viewing user and company names. See Persons List (Object) for details.
locales	A list of all locales available for this segment and which are within the scope. You can use these in a comments/revisions language filter.
rights	A few access rights that are specifically useful when working with the results: canSendEmail: When a user adds/edits a comment, this boolean tells if the user can notify the comment by email or not. canAdd: Tells if the user can add a new comment in one of the locales. Note: When using the APIs to add/edit/delete comments, you may obtain a not authorized information even when the edit, canAdd or canSendEmail properties are true. The reason for this is that further detailed access rights check are done upon those advanced operations.

ACCESS RIGHTS

When working with the timeline of a segment, you should always read out these properties:

comments.[].edit: Tells if a comment can be edited or deleted.
rights.canAdd: Tells if a new comment can be added to the segment.
rights.canSendEmail: Tells if a newly added comment can be notified by email to people involved with this segment.

EXAMPLE

-