Project.ReadSchedulingContext method

Artigo
05/13/2015

Obtém o contexto de programação com base em um conjunto de projetos e recursos.

Namespace: WebSvcProject
Assembly: ProjectServerServices (in ProjectServerServices.dll)

Syntax

'Declaração
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/Project/ReadSchedulingContext", RequestNamespace := "https://schemas.microsoft.com/office/project/server/webservices/Project/",  _
    ResponseNamespace := "https://schemas.microsoft.com/office/project/server/webservices/Project/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function ReadSchedulingContext ( _
    projectUids As Guid(), _
    resourceUids As Guid() _
) As ProjectContextDataSet
'Uso
Dim instance As Project
Dim projectUids As Guid()
Dim resourceUids As Guid()
Dim returnValue As ProjectContextDataSet

returnValue = instance.ReadSchedulingContext(projectUids, _
    resourceUids)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/Project/ReadSchedulingContext", RequestNamespace = "https://schemas.microsoft.com/office/project/server/webservices/Project/", 
    ResponseNamespace = "https://schemas.microsoft.com/office/project/server/webservices/Project/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public ProjectContextDataSet ReadSchedulingContext(
    Guid[] projectUids,
    Guid[] resourceUids
)

Parâmetros

projectUids
Type: []

Uma matriz de GUIDs de projeto.

resourceUids
Type: []

Uma matriz de GUIDs de recurso.

Valor retornado

Type: WebSvcProject.ProjectContextDataSet
Contém o contexto de programação que é derivado dos especificado de projetos e recursos.

Comentários

Obtém uma lista de projetos que estão relacionados a projetos especificados ou recursos. Se uma das seguintes condições for atendida, existe um relacionamento:

Projetos compartilham recursos da empresa (aqueles na equipe do projeto ou na lista de entrada).
Projetos têm dependências interproject (vínculos entre projetos).
Projetos compartilham recursos com ou tem links entre projetos com projetos que estão relacionados a projetos na lista de entrada (uma relação indireta).

Permissões do Project Server

Permissão	Descrição
OpenProject	Permite que o usuário abrir os projetos especificados. Permissão de categoria.

Examples

Considere a possibilidade de dois projetos que compartilham um recurso da empresa, como na tabela a seguir.

Nome do projeto e o GUID	Recursos e GUIDs
Project1 f0e98e26-2c9c-4F74-b40a-640f3f3f03f5	Resource1; d58fd816-d380-46e3-aff1-6cef617d32a2 Resource2; b3dab395-bc33-4DD7-a3a7-a45522857369
Project2 a9d03b87-37f1-473d-90f6-77ba3c521a40	Resource1; d58fd816-d380-46e3-aff1-6cef617d32a2

Project1

f0e98e26-2c9c-4F74-b40a-640f3f3f03f5

Resource1; d58fd816-d380-46e3-aff1-6cef617d32a2

Resource2; b3dab395-bc33-4DD7-a3a7-a45522857369

Project2

a9d03b87-37f1-473d-90f6-77ba3c521a40

Resource1; d58fd816-d380-46e3-aff1-6cef617d32a2

No seguinte fragmento de código para um aplicativo de teste, WebSvcProject é um nome arbitrário para obter uma referência ao serviço web de projeto e project é uma instância inicializada da classe WebSvcProject.Project .

try
{
    Guid[] projectUids = { new Guid("a9d03b87-37f1-473d-90f6-77ba3c521a40") };
    Guid[] resourceUids = null;
    
    WebSvcProject.ProjectContextDataSet dsProjectContext =
        project.ReadSchedulingContext(projectUids, resourceUids);
    dsProjectContext.WriteXml(@"C:\Tests\SchedulingContextOut.txt");
}
catch (SoapException ex)
{
    . . .
}

O valor do elemento no arquivo SchedulingContextOut.txt Relationship mostra que o Projeto2 está relacionado ao Projeto1 por um recurso compartilhado. Se você adicionar um ou ambos os GUIDs de recurso da matriz resourceUids , o resultado é o mesmo.

Dica

Se você adicionar que ambos os GUIDs de projeto da matriz projectUids , dsProjectContext está vazio.

<?xml version="1.0" standalone="yes"?>
<ProjectContextDataSet xmlns="https://schemas.microsoft.com/office/project/server/webservices/ProjectContextDataSet/">
  <Relationships>
    <PROJ_UID>a9d03b87-37f1-473d-90f6-77ba3c521a40</PROJ_UID>
    <RelatedTo_UID>f0e98e26-2c9c-4f74-b40a-640f3f3f03f5</RelatedTo_UID>
    <RelatedTo_NAME>Project1</RelatedTo_NAME>
    <Relationship>2</Relationship>
    <HasBuildTeamPermission>true</HasBuildTeamPermission>
  </Relationships>
</ProjectContextDataSet>