Метод Project.ReadSchedulingContext

Статья
08/03/2015

Возвращает контекст планирования на основе набора проектов и ресурсов.

Пространство имен: WebSvcProject
Сборка: ProjectServerServices (в ProjectServerServices.dll)

Синтаксис

'Декларация
<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
'Применение
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
)

Параметры

projectUids
Тип: []

Массив идентификаторов GUID проекта.

resourceUids
Тип: []

Массив идентификаторов GUID ресурса.

Возвращаемое значение

Тип: WebSvcProject.ProjectContextDataSet
Содержит планирования контекст, который является производным от указанного проектов и ресурсов.

Замечания

Получает список проектов, которые связаны с указанным проектов и ресурсов. Связь существует при выполнении одного из следующих условий:

Проекты общий доступ к корпоративным ресурсам (либо с рабочей группы проекта или в списке ввода).
Проекты имеют межпроектные зависимости (перекрестных связей между проектами).
Проекты, общий доступ к ресурсам с или иметь перекрестных связей между проектами с проектами, связанные с проектами в списке ввода (косвенная связь).

Разрешения Project Server

Разрешение	Описание
OpenProject	Позволяет пользователю открывать указанных проектов. Разрешение категории.

Примеры

Необходимо учитывайте два проекта, совместно использующих один корпоративный ресурс, как показано в следующей таблице.

Имя проекта и GUID	Ресурсы и идентификаторов GUID
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

В следующем фрагменте кода для тестирования приложения WebSvcProject — случайное имя для ссылки на веб-службы Project, а project — инициализированный экземпляр класса 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)
{
    . . .
}

Значение элемента Relationship в файле SchedulingContextOut.txt показывает, что Project2 связана с Project1 с общего ресурса. При добавлении одного или обоих ресурсов идентификаторы GUID для массива resourceUids результат равен.

Примечание

Если вы добавляете оба проекта projectUids массив идентификаторов GUID, dsProjectContext будет пустым.

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