Freigeben über

Benutzerdefinierte Felddaten in XML

  • Artikel

Das Microsoft Office Project 2007 XML Data Interchange Schema (mspdi_pj12.xsd) ändert die Art und Weise, wie einige benutzerdefinierte Feldinformationen in XML dargestellt werden. In diesem Artikel wird beschrieben, wie Office Project 2007 benutzerdefinierte Felddefinitionen und benutzerdefinierte Feldwerte im XML-Format darstellt.

Benutzerdefinierte Felddaten

Project speichert Informationen zu benutzerdefinierten Feldern als einen von zwei Typen:

  • Benutzerdefinierte Felddefinition Eine benutzerdefinierte Felddefinition besteht aus Daten, die zum Definieren eines lokalen oder benutzerdefinierten Unternehmensfelds erforderlich sind. Project für das Web lokalen benutzerdefinierten Felder werden als benutzerdefinierte Enterprise-Felder dargestellt. Diese Daten umfassen Informationen wie den Namen des benutzerdefinierten Felds, die ID des benutzerdefinierten Felds und den Typ des benutzerdefinierten Felds.

    Die XML-Elemente, die zum Speichern von benutzerdefinierten Felddefinitionen verwendet werden, werden im Abschnitt XML-Schema für das ExtendedAttributes-Element des Project XML-Datenaustauschschemas definiert.

  • Benutzerdefinierter Feldwert Ein benutzerdefinierter Feldwert sind Daten, die erforderlich sind, um einen bestimmten Wert für ein benutzerdefiniertes Feld zu definieren und ihn einem Projekt, einem Vorgang, einer Ressource oder einer Zuordnung zuzuordnen. Sie können z. B. das benutzerdefinierte Feld Health Enterprise für eine bestimmte Aufgabe auf den Wert Late konfigurieren.

Dieser Artikel enthält die folgenden Abschnitte:

  • Benutzerdefinierte Felddefinitionen in XML

  • Benutzerdefinierte Feldwerte in XML

Benutzerdefinierte Felddefinitionen in XML

Project 2007 stellt alle Enterprise- und lokalen benutzerdefinierten Felddefinitionen in der erweiterten Attributauflistung dar, die im ExtendedAttributes-Element in der XML-Ausgabedatei enthalten ist. Jede benutzerdefinierte Felddefinition wird durch ein einzelnes ExtendedAttribute-Element und seine untergeordneten Elemente dargestellt.

Das folgende Beispiel zeigt die XML-Darstellung einer erweiterten Attributauflistung, die zwei benutzerdefinierte Felder definiert. Text1 ist ein lokales benutzerdefiniertes Feld, während Health ein benutzerdefiniertes Enterprise-Feld ist, das in Project 2007 vorkonfiguriert ist.

<ExtendedAttributes>
    <ExtendedAttribute>
        <FieldID>188743731</FieldID>
        <FieldName>Text1</FieldName>
        <Alias>MyLocalCustomField</Alias>
        <SecondaryPID>255869028</SecondaryPID>
    </ExtendedAttribute>
    <ExtendedAttribute>
        <FieldID>188776449</FieldID>
        <FieldName>Health</FieldName>
        <CFType>7</CFType>
        <Guid>0000E8D9-65F1-4769-9BD2-819D38036FCC</Guid>
        <ElemType>20</ElemType>
        <MaxMultiValues>1</MaxMultiValues>
        <UserDef>1</UserDef>
        <SecondaryPID>255885314</SecondaryPID>
        <DefaultGuid>000079D2-4A43-41FC-B264-98D23FADD84B</DefaultGuid>
    </ExtendedAttribute>
</ExtendedAttributes>

Wenn Sie ein Projekt als XML speichern, werden alle lokalen benutzerdefinierten Felddefinitionen in die erweiterte Attributauflistung geschrieben. Sie können jedoch auswählen, dass nur die aktuell geladenen benutzerdefinierten Enterprise-Felder in die XML-Ausgabe einbezogen werden sollen. Die Wahl, nur die derzeit geladenen globalen Enterprise-Elemente zu speichern, kann zu einer kleineren, besser verwaltbaren XML-Datei führen.

Weitere Informationen zum Speichern von Projekten als XML finden Sie unter Speichern und Öffnen von Projekten im XML-Format.

Benutzerdefinierte Feldwerte in XML

Wenn Sie einen bestimmten Wert für ein benutzerdefiniertes Feld auf Projekt-, Vorgangs-, Ressourcen- oder Zuordnungsebene konfigurieren, schreibt Project 2007 Informationen zu diesem Wert in den Sammelvorgangs-, Vorgangs-, Ressourcen- oder Zuordnungsabschnitt der XML-Ausgabe.

Um einen benutzerdefinierten Feldwert in XML darzustellen, müssen Sie die folgenden drei Anforderungen erfüllen:

  • Ordnen Sie den Wert des benutzerdefinierten Felds der Project-Entität (Projekt, Vorgang, Ressource oder Zuordnung) zu, für die es konfiguriert ist.

  • Ordnen Sie den Wert des benutzerdefinierten Felds der benutzerdefinierten Felddefinition zu, zu der er gehört.

  • Geben Sie den Wert des benutzerdefinierten Felds an.

In den folgenden Abschnitten wird beschrieben, wie Project 2007 benutzerdefinierte Feldwerte in XML darstellt:

  • Werte für benutzerdefinierte Enterprise-Felder

  • Lokale benutzerdefinierte Feldwerte

Werte für benutzerdefinierte Enterprise-Felder

In Project 2007 können Sie eine unbegrenzte Anzahl von benutzerdefinierten Enterprise-Feldern konfigurieren. Diese Erweiterung ändert die Art und Weise, wie Project 2007 benutzerdefinierte Enterprise-Feldwerte in XML speichert.

Das folgende Beispiel zeigt die relevante XML-Ausgabe für einen Vorgang, für den das benutzerdefinierte Enterprise-Feld Health für den Wert der Nachschlagetabelle nach Zeitplan konfiguriert ist.

    <Task>
        ...
        <b408001>0000BB21-B2AE-410A-88B6-82C108903823</b408001>
        ...
    </Task>

Dieser XML-Code erfüllt die drei Anforderungen zum Speichern eines benutzerdefinierten Feldwerts in XML wie folgt:

  • Der Wert des benutzerdefinierten Felds wird in den Sammelvorgangs-, Vorgangs-, Ressourcen- oder Zuordnungsbereich der XML-Ausgabe geschrieben, für die der Wert konfiguriert ist. Dadurch wird der Wert des benutzerdefinierten Felds der richtigen Project-Entität zugeordnet, in diesem Fall einer bestimmten Aufgabe.

  • Die ID des benutzerdefinierten Felds wird verwendet, um den Wert des benutzerdefinierten Felds mit der Benutzerdefinierten Felddefinition zu verknüpfen. Die benutzerdefinierte Feld-ID wird im FieldID-Element in der benutzerdefinierten Felddefinition gespeichert. Für das benutzerdefinierte Feld Health Enterprise ist die ID des benutzerdefinierten Felds 188776449.

    Der Name des XML-Elements, in dem der benutzerdefinierte Feldwert gespeichert wird, in diesem Fall das b408001-Element, entspricht der hexadezimalen Darstellung der benutzerdefinierten Feld-ID. Für das benutzerdefinierte Feld Health enterprise ist der Hexadezimalwert 0xb408001 gleich dem Binärwert 188776449.

  • Der Wert des benutzerdefinierten Felds wird im b408001-Element gespeichert. Da das benutzerdefinierte Enterprise-Feld Health eine Nachschlagetabelle ist, ist der benutzerdefinierte Feldwert für On Schedule die GUID dieses Nachschlagetabellenwerts, 0000BB21-B2AE-410A-88B6-82C108903823.

Tabelle 1 zeigt die gültigen Bereiche von benutzerdefinierten Feld-IDs für jeden Typ des benutzerdefinierten Enterprise-Felds.

Tabelle 1. Benutzerdefinierte Enterprise-Feld-IDs

Benutzerdefinierte Enterprise-Feldwertkonfiguration

Benutzerdefinierter Feld-ID-Bereich (Dezimal)

Benutzerdefinierter Feld-ID-Bereich (hexadezimal)

Projektebene

190873600 – 190939135

b608000 – b617fff

Aufgabenebene

188776448 – 188841983

b408000 – b417fff

Ressourcenebene

205553664 – 205619199

c408000 – c417fff

Zuweisungsebene

255885312 – 255950847

f408000 – f417fff

Da es 262.140 mögliche benutzerdefinierte Enterprise-Feld-IDs gibt, gibt es 262.140 mögliche XML-Elementnamen für benutzerdefinierte Feldwerte. Aus Leistungsgründen sind die XML-Elemente, die Project 2007 zum Speichern von enterprise-Benutzerdefinierten Feldwerten verwendet, nicht im Project XML Data Interchange Schema (mspdi_pj12.xsd) definiert. Stattdessen werden diese Elemente in den zusätzlichen Schemadateien definiert, die im Project 2007 SDK-Download enthalten sind. Einen Link zum Project 2007 SDK-Download finden Sie unter Willkommen beim Microsoft Office Project 2007 SDK.

Das Kernschema enthält Anmerkungen mit der durchsuchbaren Zeichenfolge "##", um den Speicherort anzugeben, an den Project 2007 die benutzerdefinierten Enterprise-Feldwertelemente schreibt, die nicht in mspdi_pj12.xsd definiert sind.

Lokale benutzerdefinierte Feldwerte

Project 2007 stellt lokale benutzerdefinierte Feldwerte in XML auf eine von zwei Arten dar. Lokale benutzerdefinierte Feldwerte für die Zuordnung werden in demselben Format in XML geschrieben, das auch für benutzerdefinierte Enterprise-Feldwerte verwendet wird, während lokale benutzerdefinierte Feldwerte für Projekte, Vorgänge und Ressourcen im gleichen Format in XML geschrieben werden, das auch von Microsoft Office Project 2003 verwendet wird.

Die folgenden Abschnitte enthalten ausführlichere Informationen zur Darstellung lokaler benutzerdefinierter Feldwerte in XML durch Project 2007:

  • Zuweisung lokaler benutzerdefinierter Feldwerte in XML

  • Project, Task, and Resource Local Custom Field Values in XML

Zuweisung lokaler benutzerdefinierter Feldwerte in XML

Project 2007 schreibt lokale benutzerdefinierte Feldwerte für Zuweisungen im gleichen Format wie benutzerdefinierte Enterprise-Feldwerte und erfüllt die drei Anforderungen zum Speichern eines benutzerdefinierten Feldwerts in XML auf die gleiche Weise.

Tabelle 2 zeigt den gültigen Bereich der benutzerdefinierten Feld-IDs für die Zuweisung lokaler benutzerdefinierter Felder. Das mspdi_pj12.xsd-Kernschema definiert die 200 möglichen XML-Elemente für die Zuweisung lokaler benutzerdefinierter Feldwerte.

Tabelle 2. Zuweisung lokaler benutzerdefinierter Feld-IDs

Lokale Benutzerdefinierte Feldwertkonfiguration

Benutzerdefinierter Feld-ID-Bereich (Dezimal)

Benutzerdefinierter Feld-ID-Bereich (hexadezimal)

Zuweisungsebene

255868928 – 255869128

f404000 – f4040c8

Project, Task, and Resource Local Custom Field Values in XML

Project 2007 schreibt lokale benutzerdefinierte Feldwerte für Projekte, Vorgänge und Ressourcen in dem im folgenden Beispiel gezeigten Format. Dies ist das gleiche Format, das von Project 2003 für alle benutzerdefinierten Feldwerte verwendet wird.

    <Task>
        ...
        <ExtendedAttribute>
          <FieldID>188743731</FieldID>
          <Value>This is the value of Text1</Value>
        </ExtendedAttribute>
        ...
    </Task>

Dieser XML-Code erfüllt die drei Anforderungen zum Speichern eines benutzerdefinierten Feldwerts in XML wie folgt:

  • Der Wert des benutzerdefinierten Felds wird in den Sammelvorgangs-, Vorgangs-, Ressourcen- oder Zuordnungsbereich der XML-Ausgabe geschrieben, für die der Wert konfiguriert ist. Dadurch wird der Wert des benutzerdefinierten Felds der richtigen Project-Entität zugeordnet, in diesem Fall einer bestimmten Aufgabe.

  • Die ID des benutzerdefinierten Felds wird verwendet, um den Wert des benutzerdefinierten Felds mit der Benutzerdefinierten Felddefinition zu verknüpfen. Die ID des benutzerdefinierten Felds wird im FieldID-Element im XML gespeichert, das sowohl die Benutzerdefinierte Felddefinition als auch den benutzerdefinierten Feldwert darstellt.

  • Der Wert des benutzerdefinierten Felds wird im Value-Element gespeichert.

Siehe auch

Konzepte

Einführung in XML-Project-Daten

Project-Datenaustauschelemente