@PublicApi
public interface WorklogManager
Modifier and Type | Field and Description |
---|---|
static int |
WORKLOG_UPDATE_DATA_PAGE_SIZE |
Modifier and Type | Method and Description |
---|---|
Worklog |
create(ApplicationUser user,
Worklog worklog,
Long newEstimate,
boolean dispatchEvent)
Creates a worklog based on the passed in
Worklog object and associates
it with the given issue. |
boolean |
delete(ApplicationUser user,
Worklog worklog,
Long newEstimate,
boolean dispatchEvent)
Deletes the specified worklog and updates the issue's remaining estimate and time spent fields.
|
void |
deleteWorklogsForIssue(Issue issue)
Removes all worklogs which are associated with a given issue.
|
Worklog |
getById(Long id)
Used to get a worklog by its id.
|
List<Worklog> |
getByIssue(Issue issue)
Returns all child worklogs of a specified issue
|
PagedList<Worklog> |
getByIssue(Issue issue,
int pageSize)
Returns all child worklogs of a specified issue, in a PagedList
|
long |
getCountForWorklogsRestrictedByGroup(String groupName)
Returns the count of all
Worklog 's that have a visibility restriction
of the provided group. |
long |
getCountForWorklogsRestrictedByRole(Long roleId)
Returns the count of all
Worklog 's that have a visibility restriction
of the provided role. |
ProjectRole |
getProjectRole(Long projectRoleId)
This is a convenience method to allow us to easily get a ProjectRole.
|
List<DeletedWorklog> |
getWorklogsDeletedSince(Long sinceInMilliseconds)
Returns
WORKLOG_UPDATE_DATA_PAGE_SIZE of worklog ids and removal dates,
which were removed after (inclusive) provided time in milliseconds. |
Set<Worklog> |
getWorklogsForIds(Set<Long> idsOfWorklogs)
Returns a set of worklogs for provided ids.
|
List<Worklog> |
getWorklogsUpdatedSince(Long sinceInMilliseconds)
Returns
WORKLOG_UPDATE_DATA_PAGE_SIZE of worklogs,
which were updated or created after (inclusive) provided time in milliseconds. |
int |
swapWorklogGroupRestriction(String groupName,
String swapGroup)
Updates
Worklog 's such that worklogs that have a visibility
restriction of the provided groupName will be changed to have a visibility restriction of the
provided swapGroup. |
int |
swapWorklogRoleRestriction(Long roleId,
Long swapRoleId)
Updates
Worklog 's such that worklogs that have a visibility
restriction of the provided role will be changed to have a visibility restriction of a role with the
provided swapRoleId. |
Worklog |
update(ApplicationUser user,
Worklog worklog,
Long newEstimate,
boolean dispatchEvent)
Updates the provided
Worklog . |
static final int WORKLOG_UPDATE_DATA_PAGE_SIZE
boolean delete(ApplicationUser user, Worklog worklog, Long newEstimate, boolean dispatchEvent)
user
- the user who is performing the actionworklog
- the value to remove in the databasenewEstimate
- the value to set the Issue
's remainig estimate. If null the value will be left alone.dispatchEvent
- if true then an event of type EventType.ISSUE_WORKLOG_DELETED_ID
will be dispatched and any notifications listening for that event will be triggered. If false no event will be
dispatched.Worklog update(ApplicationUser user, Worklog worklog, Long newEstimate, boolean dispatchEvent)
Worklog
. This method will
adjust the issue's remaining estimate to be the new value which has been passed to this method, the old
remaining estimate value will be lost.
If you have provided a groupLevel then the worklog visibility will be restricted to the provided group, it is assumed that validation to insure that the group actually exists has been performed outside of this method. If you have provided a roleLevelId then the worklog visibility will be restricted to the provided role, it is assumed that validation to insure that the role actually exists has been performed outside of this method.
NOTE: this method does not do any permission checks to see if the user can perform the requested operation.
user
- the user who is performing the actionworklog
- the value to update in the databasenewEstimate
- the value to set the Issue
's remainig estimate. If null the value will be left alone.dispatchEvent
- if true then an event of type EventType.ISSUE_WORKLOG_UPDATED_ID
will be dispatched and any notifications listening for that event will be triggered. If false no event will be
dispatched.Worklog create(ApplicationUser user, Worklog worklog, Long newEstimate, boolean dispatchEvent)
Worklog
object and associates
it with the given issue.
If you have provided a groupLevel then the worklog visibility will be restricted to the provided group, it is assumed that validation to insure that the group actually exists has been performed outside of this method. If you have provided a roleLevelId then the worklog visibility will be restricted to the provided role, it is assumed that validation to insure that the role actually exists has been performed outside of this method.
NOTE: this method does not do any permission checks to see if the user can perform the requested operation.
user
- is the user who is trying to create the worklog, this can be different than the user identified by
Worklog.getAuthor()
.worklog
- the object used to provide the parameters that will be used to create the worklog.newEstimate
- will be used to set the time estimate for this worklog.dispatchEvent
- if true then an event of type EventType.ISSUE_WORKLOGGED_ID
will be dispatched and any notifications listening for that event will be triggered. If false no event will be
dispatched.Worklog
object that represents the newly created worklog.Worklog getById(Long id)
id
- uniquely identifies the worklogList<Worklog> getByIssue(Issue issue)
issue
- the specified parent issue (not null)PagedList<Worklog> getByIssue(Issue issue, int pageSize)
issue
- the specified parent issue (not null)long getCountForWorklogsRestrictedByGroup(String groupName)
Worklog
's that have a visibility restriction
of the provided group.groupName
- identifies the group the worklogs are restricted by, this must not be null.int swapWorklogGroupRestriction(String groupName, String swapGroup)
Worklog
's such that worklogs that have a visibility
restriction of the provided groupName will be changed to have a visibility restriction of the
provided swapGroup.
Note: There is no validation performed by this method to determine if the provided swapGroup is a valid group with JIRA. This validation must be done by the caller.
groupName
- identifies the group the worklogs are restricted by, this must not be null.swapGroup
- identifies the group the worklogs will be changed to be restricted by, this must not be null.long getCountForWorklogsRestrictedByRole(Long roleId)
Worklog
's that have a visibility restriction
of the provided role.roleId
- identifies the role the worklogs are restricted by, this must not be null.int swapWorklogRoleRestriction(Long roleId, Long swapRoleId)
Worklog
's such that worklogs that have a visibility
restriction of the provided role will be changed to have a visibility restriction of a role with the
provided swapRoleId.
Note: There is no validation performed by this method to determine if the provided swapGroup is a valid group with JIRA. This validation must be done by the caller.
roleId
- identifies the role the worklogs are restricted by, this must not be null.swapRoleId
- identifies the role the worklogs will be changed to be restricted by, this must not be null.ProjectRole getProjectRole(Long projectRoleId)
ProjectRole
.
NOTE: If you are trying to retrieve a ProjectRole
then you should be using the
ProjectRoleManager
.
projectRoleId
- the id to the ProjectRole
object you would like returned.List<Worklog> getWorklogsUpdatedSince(Long sinceInMilliseconds)
WORKLOG_UPDATE_DATA_PAGE_SIZE
of worklogs,
which were updated or created after (inclusive) provided time in milliseconds.
Returned worklogs are ordered by the update time.sinceInMilliseconds
- the time in unix timestamp format.
since which the modified worklogs will be returned.List<DeletedWorklog> getWorklogsDeletedSince(Long sinceInMilliseconds)
WORKLOG_UPDATE_DATA_PAGE_SIZE
of worklog ids and removal dates,
which were removed after (inclusive) provided time in milliseconds.sinceInMilliseconds
- the time in unix timestamp format.Set<Worklog> getWorklogsForIds(Set<Long> idsOfWorklogs)
WORKLOG_UPDATE_DATA_PAGE_SIZE
.idsOfWorklogs
- set of worklog ids.void deleteWorklogsForIssue(Issue issue)
WorklogDeletedEvent
for each worklog deleted.issue
- issue for which worklogs will be removed.Copyright © 2002-2017 Atlassian. All Rights Reserved.