ReportService

Retrieves reports for Deployment or Control Tasks A User must have a REPORT_VIEW permission to be able to run these operations. A User must have at least READ permission on the environment or application for Deployment Task report to contain data for them. A User must have at least CONTROLTASK_EXECUTE permission on target CI for Control Task report to contain data for them.

GET	/report/applications	Find all Application CIs availble in reporting for given user This will include both names of existing CIs user has permissions for and a list of CIs that are existing in reports but are deleted or renamed.
POST	/report/controltasks	Find all archived Control Tasks, optionally filtered by parameters.
POST	/report/download/controltasks	Find all archived Control Tasks, optionally filtered by parameters.
POST	/report/download/tasks	Find all archived Deployment Tasks, optionally filtered by parameters.
GET	/report/environments	Find all Environment CIs availble in reporting for given user.
POST	/report/tasks	Find all archived Deployment Tasks, optionally filtered by parameters.

GET /report/applications

Find all Application CIs availble in reporting for given user This will include both names of existing CIs user has permissions for and a list of CIs that are existing in reports but are deleted or renamed. Deleted CIs are visible only to user with ADMIN rights.

Response body: List of ConfigurationItemId - a list of com.xebialabs.deployit.engine.api.dto.ConfigurationItemId objects; Content type: application/xml

POST /report/controltasks

Find all archived Control Tasks, optionally filtered by parameters.

Parameters

Query	users	List of String	(Optional) filter tasks belonging to users
Query	states	List of String	(Optional) filter on tasks in states
Query	taskName	String	(Optional) filter on task name
Query	begin	Date	(Optional) filter by time interval beginning with date
Query	end	Date	(Optional) filter by time interval ending with date
Request body	application/xml	Paging	Which page and how many results per page to retrieve
Query	order	List of Ordering	Which ordering to use when listing results
Request body	application/xml	Set of String	filter by list of target CIs
Query	fetchMode	FetchMode	toggle to fetch FULL task with blocks or just task SUMMARY

Response body: Stream of ControlTaskReportLine - a list of ControlTaskReportLine objects; Content type: application/xml

POST /report/download/controltasks

Find all archived Control Tasks, optionally filtered by parameters.

Parameters

Query	users	List of String	(Optional) filter tasks belonging to users
Query	states	List of String	(Optional) filter on tasks in states
Query	taskName	String	(Optional) filter on task name
Query	begin	Date	(Optional) filter by time interval beginning with date
Query	end	Date	(Optional) filter by time interval ending with date
Query	order	List of Ordering	Which ordering to use when listing results
Request body	application/xml	Set of String	filter by list of target CIs

Response body: String - a {java.util.String} containing CSV report; Content type: application/xml

POST /report/download/tasks

Find all archived Deployment Tasks, optionally filtered by parameters.

Parameters

Query	taskId	String	(Optional) filter task with exact taskId
Query	onlySuccessful	boolean	(Optional) filter only successfully finished tasks
Query	users	List of String	(Optional) filter tasks belonging to users
Query	states	List of String	(Optional) filter on tasks in states
Query	types	List of String	(Optional) filter on tasks types
Query	begin	Date	(Optional) filter by time interval beginning with date
Query	end	Date	(Optional) filter by time interval ending with date
Query	order	List of Ordering	Which ordering to use when listing results
Request body	application/xml	List of ConfigurationItemId	filter by list of CIs - environment and application correlated to the Deployment task

Response body: String - a {java.util.String} containing CSV report; Content type: application/xml

GET /report/environments

Find all Environment CIs availble in reporting for given user. This will include both names of existing CIs user has permissions for and a list of CIs that are existing in reports but are deleted or renamed. Deleted CIs are visible only to user with ADMIN rights.

Response body: List of ConfigurationItemId - a list of com.xebialabs.deployit.engine.api.dto.ConfigurationItemId objects; Content type: application/xml

POST /report/tasks

Find all archived Deployment Tasks, optionally filtered by parameters.

Parameters

Query	taskId	String	(Optional) filter task with exact taskId
Query	onlySuccessful	boolean	(Optional) filter only successfully finished tasks
Query	users	List of String	(Optional) filter tasks belonging to users
Query	states	List of String	(Optional) filter on tasks in states
Query	types	List of String	(Optional) filter on tasks types
Query	begin	Date	(Optional) filter by time interval beginning with date
Query	end	Date	(Optional) filter by time interval ending with date
Request body	application/xml	Paging	Which page and how many results per page to retrieve
Query	order	List of Ordering	Which ordering to use when listing results
Query	fetchMode	FetchMode	toggle to fetch FULL task with blocks or just task SUMMARY
Request body	application/xml	List of ConfigurationItemId	filter by list of CIs - environment and application correlated to the Deployment task

Response body: Stream of DeploymentTaskReportLine - a list of DeploymentTaskReportLine objects; Content type: application/xml