QueueSystem.ReadJobStatusSimple método

Obtém informações de status sobre os trabalhos especificados na fila do Project Server.

Namespace:  WebSvcQueueSystem
Assembly:  ProjectServerServices (em ProjectServerServices.dll)

Sintaxe

'Declaração
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/QueueSystem/ReadJobStatusSimple", 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 ReadJobStatusSimple ( _
    jobUIDs As Guid(), _
    includeWaitTime As Boolean _
) As QueueStatusDataSet
'Uso
Dim instance As QueueSystem
Dim jobUIDs As Guid()
Dim includeWaitTime As Boolean
Dim returnValue As QueueStatusDataSet

returnValue = instance.ReadJobStatusSimple(jobUIDs, _
    includeWaitTime)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/QueueSystem/ReadJobStatusSimple", 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 ReadJobStatusSimple(
    Guid[] jobUIDs,
    bool includeWaitTime
)

Parâmetros

• jobUIDs
  Tipo: []

  Matriz de GUIDs trabalhos na fila.

• includeWaitTime
  Tipo: System.Boolean

  Se true, incluem o tempo de espera de trabalho esperadas.

Valor retornado

Tipo: WebSvcQueueSystem.QueueStatusDataSet
Status dos trabalhos solicitados, com os dados QueueStatusDataSet.StatusRow para cada trabalho.

Comentários

ReadJobStatusSimple não usa uma ID de controle para grupos de trabalho. Para obter um exemplo de obter o status de todos os trabalhos com a mesma ID de rastreamento, consulte ReadJobStatus.

Permissões do Project Server

Uma das seguintes permissões é necessária.

Permissão	Descrição
Não padrão	O usuário atual é o proprietário do trabalho.
ManageQueue	Permite ao usuário gerenciar a fila do Project Server. Permissão global.

Exemplos

O método GetStatusOfQueueJobs no exemplo a seguir está em uma classe denominada QueueSystemUtilities. GetStatusOfQueueJobs é uma sobrecarga do mesmo nome do método no exemplo para ReadJobStatus. QueueSystemWS é um nome arbitrário de QueueSystem referência da Web.

public WebSvcQueueSystem.QueueStatusDataSet GetStatusOfQueueJobs(
    WebSvcQueueSystem.QueueSystem q,
    Guid[] jobGuids,
    bool includeWaitTime)
{
    WebSvcQueueSystem.QueueStatusDataSet dsQStatus = 
        q.ReadJobStatusSimple(jobGuids, includeWaitTime);
    return dsQStatus;
}

O fragmento de código a seguir cria uma matriz de GUIDs de trabalho para os métodos QueueCreateProject e QueuePublish e, em seguida, chama GetStatusOfQueueJobs, que por sua vez, chama ReadJobStatusSimple.

using System.Threading;
using PSLibrary = Microsoft.Office.Project.Server.Library;
. . .
private static ProjectWS.Project project = 
            new ProjectWS.Project();
private static QueueSystemWS.QueueSystem queueSystem =
    new QueueSystemWS.QueueSystem(); 
private static QueueSystemUtils queueSystemUtils = new QueueSystemUtils();
. . .
ProjectWS.ProjectDataSet dsProject =
    new ProjectWS.ProjectDataSet();
ProjectWS.ProjectDataSet.ProjectRow projectRow =
    dsProject.Project.NewProjectRow();

Guid projectGuid = Guid.NewGuid();
projectRow.PROJ_UID = projectGuid;
projectRow.PROJ_NAME = this.txtProjectName.Text;
projectRow.PROJ_TYPE =
    Convert.ToInt32(PSLibrary.Project.ProjectType.Project);

dsProject.Project.AddProjectRow(projectRow);

// Create GUIDs for the queue job and for tracking multiple jobs.
Guid jobGuidCreateProject = Guid.NewGuid();
Guid trackingGuid = Guid.NewGuid();

bool validateOnly = false;
string queueStatus = "";
// Create and save project to the Draft database.

project.QueueCreateProject(jobGuidCreateProject, dsProject, validateOnly);
// Wait a few seconds, or create a WaitForQueue method.
Thread.Sleep(3000);

ProjectWS.ProjectRelationsDataSet dsProjectRelations =
    new ProjectWS.ProjectRelationsDataSet();
Guid jobGuidPublish = Guid.NewGuid();

string wssUrl = "" // Default SharePoint project workspace. 
bool fullPublish = true;

// Publish the project to the Published database.
dsProjectRelations = project.QueuePublish(jobGuidPublish, projectGuid, fullPublish, wssUrl);

Thread.Sleep(500);

Guid[] jobGuids = { jobGuidCreateProject, jobGuidPublish };

WebSvcQueueSystem.QueueStatusDataSet dsQStatus =
    queueSystemUtils.GetStatusOfQueueJobs(queueSystem, jobGuids, includeWaitTime);
. . .

A tabela de QueueStatusDataSet.Status lista o status de todos os trabalhos na matriz jobGuids . A tabela a seguir mostra alguns dos campos na tabela Status após executar o código anterior.

[QUEUE] ID	Mensagem Tipo	Trabalho Conclusão State	[QUEUE] Posição	Por cento Completa	[QUEUE] Hora da Entrada	[QUEUE] Processamento Time	[QUEUE] Concluído Time	Espera Time
1	22	4	-1	100	28/6/2011 2:42 PM	28/6/2011 2:42 PM	28/6/2011 2:42 PM	0
1	24	1	4	0	28/6/2011 2:42 PM			1

QueueMessageType 22 é ProjectCreate. O trabalho não está mais na fila; JobState 4 é Success.

QueueMessageType 24 é ProjectPublish. O trabalho é o quarto na fila; JobState 1 é ReadyForProcessing. O tempo de espera esperada é um segundo.

Ver também

Referência

QueueSystem classe

QueueSystem membros

WebSvcQueueSystem namespace

ReadJobStatus

Outros recursos

How to: Use the QueueSystem Service