Project.ReadSchedulingContext-Methode

Artikel
08/03/2015

Ruft die Terminplanung Kontext basierend auf einer Reihe von Projekten und Ressourcen ab.

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

Syntax

'Declaration
<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
'Usage
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
)

Parameter

projectUids
Typ: []

Ein Array von Project GUIDs.

resourceUids
Typ: []

Ein Array von Ressourcen-GUIDs.

Rückgabewert

Typ: WebSvcProject.ProjectContextDataSet
Enthält den Terminplan Kontext, der die angegebenen Projekte und Ressourcen abgeleitet wird.

Hinweise

Ruft eine Liste der Projekte, die im Zusammenhang mit der angegebenen Projekte oder Ressourcen. Eine Beziehung vorhanden ist, wenn eine der folgenden Bedingungen erfüllt ist:

Projekte freigeben von Enterprise-Ressourcen (entweder die Informationen des Projektteams oder in der Liste Eingabe).
Projekte haben möchten Abhängigkeiten (projektübergreifenden Verknüpfungen).
Projekte Ressourcen mit freigeben oder projektübergreifenden Verknüpfungen mit Projekten, die im Zusammenhang mit Projekten in List (indirekte Beziehung) für die Eingabe haben.

Project Server-Berechtigungen

Berechtigung	Beschreibung
OpenProject	Ermöglicht einem Benutzer, die angegebenen Projekte zu öffnen. Kategorieberechtigung.

Beispiele

Berücksichtigen Sie zwei Projekte, die eine Enterprise-Ressource, wie in der folgenden Tabelle freigeben.

Projektname und GUID	Ressourcen und GUIDs
Project1 f0e98e26-2c9c-4f74-b40a-640f3f3f03f5	Ressource 1; d58fd816-d380-46e3-aff1-6cef617d32a2 Resource2; b3dab395-bc33-4DD7-a3a7-a45522857369
Project2 a9d03b87-37f1-473d-90f6-77ba3c521a40	Ressource 1; d58fd816-d380-46e3-aff1-6cef617d32a2

Project1

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

Ressource 1; d58fd816-d380-46e3-aff1-6cef617d32a2

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

Project2

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

Ressource 1; d58fd816-d380-46e3-aff1-6cef617d32a2

Im folgenden Codefragment für eine Testanwendung WebSvcProject ist ein beliebiger Name für einen Verweis auf den Project-Webdienst, und project keine initialisierte Instanz der Klasse WebSvcProject.Project ist.

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

Der Wert des Relationship -Elements in der Datei SchedulingContextOut.txt zeigt, dass Projekt2 Project1 gemeinsam genutzte Ressource verknüpft ist. Wenn Sie eine oder beide Ressourcen-GUIDs in das Array resourceUids hinzufügen, ist das Ergebnis identisch.

Hinweis

Wenn Sie, dass beide GUIDs in das Array projectUids Projekt hinzugefügt haben, ist die dsProjectContext leer.

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