Interface PlanningWebService
- All Superinterfaces:
Remote
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addPlanAllowedType
(String uri, EnumOptionId workItemType) Adds specified work item type to allowed types in Plan.void
addPlanItems
(String uri, String[] items) Adds plan records to the planvoid
addProjectToPlanProjectSpan
(String uri, String projectId) Adds specified Project to project span of the Plan.Creates a new plancreatePlanTemplate
(String projectId, String name, String id, String templateId) Creates a new plan templatevoid
deletePlans
(String projectId, String[] ids) Delete plansgetPlanById
(String projectId, String id) Returns a specific plangetPlanByUri
(String uri) Returns a specific plangetPlanStatistics
(String uri) Get statistics of the plangetPlanWikiContent
(String uri) Returns the wiki content of plan with given urivoid
removePlanAllowedType
(String uri, EnumOptionId workItemType) Removes all occurrences of specified work item type from allowed types in Plan.void
removePlanItems
(String uri, String[] items) Remove plan records to the planvoid
removeProjectFromPlanProjectSpan
(String uri, String projectId) Removes all occurrences of specified Project from project span of the Plan.Plan[]
searchPlans
(String query, String sort, int resultsLimit) Search plans.Plan[]
searchPlansWithFields
(String query, String sort, int resultsLimit, String[] fields) Search plans with only fields specified filled with values.Plan[]
searchPlanTemplates
(String query, String sort, int resultsLimit) Search plan templates.Plan[]
searchPlanTemplatesWithFields
(String query, String sort, int resultsLimit, String[] fields) Search plan templates with only fields specified filled with values.void
setPlanWikiContent
(String uri, Text text) Sets the wiki content of plan with given urivoid
updatePlan
(Plan content) Updates a plan.boolean
wasPlanStarted
(String uri) Checks if the plan was started
-
Method Details
-
addPlanAllowedType
Adds specified work item type to allowed types in Plan.- Parameters:
uri
- URI of the Plan (not null)workItemType
- work item type to add (not null)- Throws:
RemoteException
- Since:
- 3.9.0
-
addPlanItems
Adds plan records to the plan- Parameters:
uri
- the SubterraURI of the plan to add the items toitems
- an array containing the uris of all the work items to be added- Throws:
RemoteException
- Since:
- 3.8.0
-
addProjectToPlanProjectSpan
Adds specified Project to project span of the Plan.- Parameters:
uri
- URI of the Plan (not null)projectId
- project ID (not null)- Throws:
RemoteException
- Since:
- 3.9.0
-
createPlan
String createPlan(String projectId, String name, String id, String parentId, String templateId) throws RemoteException Creates a new plan- Parameters:
projectId
- The project the plan will be created inname
- The name of the planid
- The id of the planparentId
- The id of the parent plan (can be null)templateId
- The id of the template used for this plan- Returns:
- URI of the created plan.
- Throws:
RemoteException
- Since:
- 3.8.0
-
createPlanTemplate
String createPlanTemplate(String projectId, String name, String id, String templateId) throws RemoteException Creates a new plan template- Parameters:
projectId
- The project the plan template will be created inname
- The name of the planid
- The id of the plantemplateId
- The id of the template used for this template (can be null)- Returns:
- URI of the created plan.
- Throws:
RemoteException
- Since:
- 3.8.0
-
deletePlans
Delete plans- Parameters:
projectId
- the project the plans will be deleted inids
- the array of ids to be deleted- Throws:
RemoteException
- Since:
- 3.8.0
-
getPlanById
Returns a specific plan- Parameters:
projectId
- ID of the project that contains the specific planid
- ID of the plan- Returns:
- the plan
- Throws:
RemoteException
- Since:
- 3.8.0
-
getPlanByUri
Returns a specific plan- Parameters:
uri
- the SubterraURI of the plan to load- Returns:
- the plan
- Throws:
RemoteException
- Since:
- 3.8.0
-
getPlanStatistics
Get statistics of the plan- Parameters:
uri
- the SubterraURI of the plan to get the statistics from- Returns:
- the statistics of plan with given SubterraURI
- Throws:
RemoteException
- Since:
- 3.8.0
-
getPlanWikiContent
Returns the wiki content of plan with given uri- Parameters:
uri
- the SubterraURI of the plan- Returns:
- the wikipage content of the plan with given id
- Throws:
RemoteException
- Since:
- 3.8.0
-
removePlanAllowedType
Removes all occurrences of specified work item type from allowed types in Plan.- Parameters:
uri
- URI of the Plan (not null)workItemType
- work item type to remove (not null)- Throws:
RemoteException
- Since:
- 3.9.0
-
removePlanItems
Remove plan records to the plan- Parameters:
uri
- the SubterraURI of the plan to delete the items fromitems
- an array containing the uris of all the work items to be removed- Throws:
RemoteException
- Since:
- 3.8.0
-
removeProjectFromPlanProjectSpan
Removes all occurrences of specified Project from project span of the Plan.- Parameters:
uri
- URI of the Plan (not null)projectId
- project ID (not null)- Throws:
RemoteException
- Since:
- 3.9.0
-
searchPlanTemplates
Search plan templates.- Parameters:
query
- the query used to find plan templates (can be null)sort
- the format is same as forIIndexSearch.sort(String)
.resultsLimit
- the maximum number of records to be returned, -1 for no limit.- Returns:
- the found plan templates.
- Throws:
RemoteException
- Since:
- 3.8.0
-
searchPlanTemplatesWithFields
Plan[] searchPlanTemplatesWithFields(String query, String sort, int resultsLimit, String[] fields) throws RemoteException Search plan templates with only fields specified filled with values. All other fields are not transmitted.- Parameters:
query
- the query used to find plan templates (can be null)sort
- the format is same as forIIndexSearch.sort(String)
.resultsLimit
- the maximum number of records to be returned, -1 for no limit.fields
- plan template fields that should be initialized, all other fields will benull
.- Returns:
- the found plan templates with filled specified fields.
- Throws:
RemoteException
- Since:
- 3.8.0
-
searchPlans
Search plans.- Parameters:
query
- the query used to find plans (can be null)sort
- the format is same as forIIndexSearch.sort(String)
.resultsLimit
- the maximum number of records to be returned, -1 for no limit.- Returns:
- the found plans.
- Throws:
RemoteException
- Since:
- 3.8.0
-
searchPlansWithFields
Plan[] searchPlansWithFields(String query, String sort, int resultsLimit, String[] fields) throws RemoteException Search plans with only fields specified filled with values. All other fields are not transmitted.- Parameters:
query
- the query used to find plans (can be null)sort
- the format is same as forIIndexSearch.sort(String)
.resultsLimit
- the maximum number of records to be returned, -1 for no limit.fields
- plan fields that should be initialized, all other fields will benull
.- Returns:
- the found plans with filled specified fields.
- Throws:
RemoteException
- Since:
- 3.8.0
-
setPlanWikiContent
Sets the wiki content of plan with given uri- Parameters:
uri
- the SubterraURI of the plantext
- the new content for plans wikipage- Throws:
RemoteException
- Since:
- 3.8.0
-
updatePlan
Updates a plan.- Parameters:
content
- a plan object containing the updates, the content must contain the uri of the plan to be update or else the update will fail- Throws:
RemoteException
- Since:
- 3.8.0
-
wasPlanStarted
Checks if the plan was started- Parameters:
uri
- the SubterraURI of the plan- Returns:
- true if plan exists and is started, false otherwise
- Throws:
RemoteException
- Since:
- 3.8.0
-