del método Project.ReadSchedulingContext

Artículo
08/03/2015

Obtiene el contexto de programación basándose en un conjunto de proyectos y recursos.

Espacio de nombres: WebSvcProject
Ensamblado: ProjectServerServices (en ProjectServerServices.dll)

Sintaxis

'Declaración
<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
Tipo: []

Una matriz de GUID de proyecto.

resourceUids
Tipo: []

Una matriz de los GUID del recurso.

Valor devuelto

Tipo: WebSvcProject.ProjectContextDataSet
Contiene el contexto de programación que se deriva de los proyectos especificados y los recursos.

Comentarios

Obtiene una lista de proyectos que estén relacionados con proyectos especificados o los recursos. Existe una relación si se cumple una de las siguientes condiciones:

Proyectos comparten recursos de empresa (las que están en el equipo del proyecto o en la lista de entrada).
Los proyectos tienen acto seguido, cree dependencias (vínculos entre proyectos).
Proyectos de compartan recursos con o tienen vínculos entre proyectos con los proyectos que están relacionados con los proyectos en la lista de entrada (una relación indirecta).

Permisos de Project Server

Permiso	Descripción
OpenProject	Permite que un usuario abrir los proyectos especificados. Permiso de categoría.

Ejemplos

Tenga en cuenta dos proyectos que comparten un recurso de empresa, como se muestra en la siguiente tabla.

Nombre del proyecto y el GUID	Recursos y GUID
Project1 f0e98e26-2c9c-4F74-b40a-640f3f3f03f5	Resource1; d58fd816-d380-46e3-aff1-6cef617d32a2 Recurso2; 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

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

Project2

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

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

En el siguiente fragmento de código para una aplicación de prueba, WebSvcProject es un nombre arbitrario de una referencia al servicio web de Project y project es una instancia de la clase WebSvcProject.Project inicializada.

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)
{
    . . .
}

El valor del elemento Relationship en el archivo SchedulingContextOut.txt muestra que está relacionada con Proyecto2 Project1 mediante un recurso compartido. Si agrega uno o ambos los GUID del recurso a la matriz de resourceUids , el resultado es el mismo.

Nota

Si agrega que ambos GUID del proyecto a la matriz de projectUids , dsProjectContext está vacío.

<?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>