Projekte über die Befehlszeile importieren

Mithilfe der Windows-Befehlszeile können Sie Projekte im XER-Format importieren. Das kann auch mit einer Batch-Datei oder programmgesteuert erfolgen.

Gehen Sie dabei folgendermaßen vor:

1. Verwenden Sie einen XML-Editor oder ein anderes Programm, mit dem Dateien im XML-Format gespeichert werden können. Erstellen Sie die Datei actions.xml, die die UPS angibt, in die Sie das Projekt importieren möchten, sowie das zu verwendende Layout und die XER-Datei, aus der importiert werden soll.

   Sie können mehrere Importaktionen in einer Datei angeben, indem Sie mehrere <action>-Knoten einfügen.

   Im Folgenden finden Sie eine Beispieldatei für actions.xml, die zwei XER-Dateien aus demselben Skript importiert. Alle Tags müssen in der Datei enthalten sein. Sie können jedoch - wie unten angegeben - einige Tags leer lassen. Fett gedruckte Werte sind Literale, die Sie exakt wie gezeigt eingeben müssen. Kursiv dargestellte Werte sind Beispiele, die je nach Konfiguration variieren können.

   <actions>

   <action>

   <type>import</type>

   <importFormat>XER</importFormat>

   <importType>PROJECT</importType>

   <importAction>CREATE</importAction>

   <importTo>EPS1</importTo>

   <importConfiguration>MyConfig1</importConfiguration>

   <importFile>c:\somefile1.xer</importFile>

   </action>

   <action>

   <type>import</type>

   <importFormat>XER</importFormat>

   <importType>PROJECT</importType>

   <importAction>CREATE</importAction>

   <importTo>EPS2</importTo>

   <importConfiguration>MyConfig2</importConfiguration>

   <importFile>c:\somefile2.xer</importFile>

   </action>

   </actions>

   Tag	Beschreibung
   <type>	Erforderlich. Die Art der Aktion. Bei Projektimporten müssen Sie "import" eingeben. Beachten Sie, dass die Groß-/Kleinschreibung bei "import" berücksichtigt werden muss.
   <importFormat>	Erforderlich. Das zu importierende Format. Der Wert muss XER lauten.
   <importType>	Erforderlich. Der Typ der zu importierenden Daten. Der Wert muss PROJECT lauten.
   <importAction>	Erforderlich. Die Aktion beim Importieren. Der Wert muss CREATE lauten.
   <importTo>	Optional. Der Kurzname des UPS-Elements, in das Sie importieren. Dieser Name muss in der Zieldatenbank vorhanden sein. Wenn Sie keinen Namen angeben, wird die Standard-UPS verwendet.
   <importConfiguration>	Optional. Die Konfiguration für den Import. Dieser Name muss in der Zieldatenbank vorhanden sein. Wenn Sie keinen Namen angeben, wird die Standardimportkonfiguration verwendet.
   <importFile>	Erforderlich. Der vollständige Pfad für die XER-Datei, die importiert werden soll.

   Hinweis:

   Falls Sie sprachenabhängige Sonderzeichen in der Datei actions.xml verwenden, müssen Sie die Datei im Unicode-Format speichern und vor dem <actions>-Tag mit dem XML-Codierungsattribut die Sprache angeben. So legen Sie beispielsweise den Zeichensatz für Deutsch und Französisch fest:

   <?xml version="1.0" encoding="windows-1252"?>

   Wenn Sie eine Batch-Datei verwenden, legen Sie mit dem chcp-Befehl den entsprechenden Sprachenzeichensatz fest. Weitere Informationen zur Internationalisierung finden Sie unter Microsoft.com.

2. Schließen Sie P6 Professional, falls die Anwendung ausgeführt wird.
3. Geben Sie in der Windows-Befehlszeile, in einer Batch-Datei oder in einem Code einen Befehl im folgenden Format in dem Ordner aus, in dem sich PM.EXE befindet:

   PM.EXE /username=<name>

   [/password=<name>]

   [/alias=<name>] /actionScript=<path>

   [/logfile=<path>]

   Parameter	Beschreibung
   /username=<name>	Erforderlich. Der Benutzername für die Anmeldung in P6 Professional.
   /password=<name>	Das Kennwort für den Benutzernamen, falls eines vorhanden ist.
   /alias=<name>	Optional. Der Name eines vorhandenen Zieldatenbank-Aliasnamens. Falls Sie keinen Alias angeben, wird der zuletzt verwendete Aliasname verwendet.
   /actionScript=<path>	Der vollständige Pfad für die erstellte Datei actions.xml. Muss den Dateinamen enthalten.
   /logfile=<path>	Optional. Der vollständige Pfad zur Erstellung der Protokolldatei mit den Verarbeitungsergebnissen. Muss den Dateinamen enthalten. Falls keine Protokolldatei angegeben ist, wird das Standardziel für die Protokolldatei PrimaveraCmdLineLog.txt im Anwendungsordner von PM.EXE verwendet.

Beispiel:

PM.EXE /username=admin /password=admin /alias=PMDB /actionScript=c:\somefolder\importprojects.xml/logfile=c:\somefolder\myLog.txt

Falls ein Wert Leerzeichen enthält, setzen Sie ihn in doppelte Anführungszeichen ("). Beispiel:

PM.EXE /username=admin /password=admin /alias=PMDB /actionScript="c:\somefolder\importprojects.xml" /logfile="c:\somefolder\myLog.txt"

Bei erfolgreichem Import wird der Exit Code 0 zurückgegeben. Falls Fehler protokolliert wurden, wird ein Exit Code größer als 0 ausgegeben, der auf einen Fehler hinweist.

Die Verarbeitungsergebnisse werden in die Protokolldatei geschrieben oder können in der Befehlszeile ausgegeben werden. Folgende Ergebnisse sind möglich:

Falls der Befehl nicht alle erforderlichen Parameter enthält, wird P6 Professional geöffnet.

Hinweise

• Beim Import von Projekten mithilfe der Befehlszeile können Sie nur neue Projekte erstellen, jedoch keine vorhandenen aktualisieren.
• Wenn eine XER-Datei mehrere Projekte enthält, werden diese bei Verwendung der Befehlszeile unter derselben UPS erstellt.
• In einer XER-Datei können Sie keine bestimmten Projekte herausfiltern.
• Bei einer Verbindung mit einer P6 EPPM-Datenbank: Bei Verwendung des XER-Formats werden keine Risikodaten importiert.