QueueSystem.ReadProjectJobStatus Method

Gets the status of jobs for the specified projects, job types, and completion states from the Project Server Queuing Service.

Namespace:  [QueueSystem Web service]
Service reference: http://ServerName:32843/[Project Service Application GUID]/PSI/QueueSystem.svc
Web service reference: http://ServerName/ProjectServerName/_vti_bin/PSI/QueueSystem.asmx?wsdl

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/QueueSystem/ReadProjectJobStatus", RequestNamespace := "https://schemas.microsoft.com/office/project/server/webservices/QueueSystem/",  _
    ResponseNamespace := "https://schemas.microsoft.com/office/project/server/webservices/QueueSystem/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function ReadProjectJobStatus ( _
    projectGUIDs As Guid(), _
    messageTypes As QueueMsgType(), _
    JobCompletionStates As JobState(), _
    fromDate As DateTime, _
    toDate As DateTime, _
    maxRows As Integer, _
    includeWaitTime As Boolean, _
    sortColumn As SortColumn, _
    sortOrder As SortOrder _
) As QueueStatusDataSet
'Usage
Dim instance As QueueSystem
Dim projectGUIDs As Guid()
Dim messageTypes As QueueMsgType()
Dim JobCompletionStates As JobState()
Dim fromDate As DateTime
Dim toDate As DateTime
Dim maxRows As Integer
Dim includeWaitTime As Boolean
Dim sortColumn As SortColumn
Dim sortOrder As SortOrder
Dim returnValue As QueueStatusDataSet

returnValue = instance.ReadProjectJobStatus(projectGUIDs, _
    messageTypes, JobCompletionStates, _
    fromDate, toDate, maxRows, includeWaitTime, _
    sortColumn, sortOrder)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/QueueSystem/ReadProjectJobStatus", RequestNamespace = "https://schemas.microsoft.com/office/project/server/webservices/QueueSystem/", 
    ResponseNamespace = "https://schemas.microsoft.com/office/project/server/webservices/QueueSystem/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public QueueStatusDataSet ReadProjectJobStatus(
    Guid[] projectGUIDs,
    QueueMsgType[] messageTypes,
    JobState[] JobCompletionStates,
    DateTime fromDate,
    DateTime toDate,
    int maxRows,
    bool includeWaitTime,
    SortColumn sortColumn,
    SortOrder sortOrder
)

Parameters

  • projectGUIDs
    Type: []
    Array of project GUIDs.
  • messageTypes
    Type: []
    Array of QueueMsgType enumeration values.
  • JobCompletionStates
    Type: []
    Array of JobState enumeration values.
  • maxRows
    Type: System.Int32
    Maximum number of job status rows to return.
  • includeWaitTime
    Type: System.Boolean
    If true, include the expected job wait time.

Return Value

Type: [QueueSystem Web service].QueueStatusDataSet
Status of the requested jobs, with the QueueStatusDataSet.StatusRow data for each job.

Remarks

For examples of job status requests and resulting data, see ReadJobStatus and ReadJobStatusSimple.

Project Server Permissions

One of the following permissions is required.

Permission

Description

ManageQueue

Allows the user to manage the Project Server queue. Global permission.

CleanupProjectServerDatabase

Allows the user to delete or move projects. Global permission.

DeleteProject

Allows the user to delete the specified projects. Category permission.

PublishProject

Allows the user to publish the specified projects. Category permission.

SaveProject

Allows the user to save the specified projects. Category permission.

BuildTeamOnProject

Allows the user to assign resources from the resource pool to the specified project. Category permission.

ManageResourcePlan

Allows the user to edit a resource plan. Category permission.

EditProjectProperties

Allows the user to edit the specified projects. Category permission.

See Also

Reference

QueueSystem Class

QueueSystem Members

QueueSystem Web Service

ReadJobStatus

ReadJobStatusSimple