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
包含衍生自指定的專案及資源的排程內容。

備註

取得與指定之的專案或資源的專案清單。如果符合下列條件時，有關聯性：

專案共用企業資源 (可以是這些專案小組或輸入清單中)。
專案具有 interproject 相依性 (跨專案連結)。
專案共用資源，或具有跨專案連結之輸入的清單 (間接關聯) 中的專案相關的專案。

Project Server 權限

權限	描述
OpenProject	可讓使用者開啟指定的專案。類別權限。

範例

請考慮共用一個企業資源，如下列表格所示的兩個專案。

專案名稱和 GUID	資源和 Guid
Project1 f0e98e26-2c9c-4f74-b40a-640f3f3f03f5	Resource1 ；d58fd816-d380-46e3-aff1-6cef617d32a2 資源 2 ；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

資源 2 ；b3dab395-bc33-4dd7-a3a7-a45522857369

Project2

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

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

下列程式碼片段測試應用程式， WebSvcProject為 Project web 服務參考的任意名稱， 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)
{
    . . .
}

SchedulingContextOut.txt 檔案中Relationship元素的值會顯示 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>