Projekte über die Befehlszeile importieren

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

Achtung: Persönlich identifizierbare Informationen (PII) können ungewollt offengelegt werden. Abhängig von den jeweils geltenden lokalen Datenschutzgesetzen können Organisationen dazu verpflichtet sein, das Offenlegungsrisiko von Daten zu mindern.

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 EPS 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. Der Typ 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 EPS-Elements, in das Sie importieren. Dieser Name muss in der Zieldatenbank vorhanden sein. Wenn Sie keinen Namen angeben, wird die Standard-EPS 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 Batchdatei 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 Batchdatei 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 Logdatei mit den Verarbeitungsergebnissen. Muss den Dateinamen enthalten. Falls keine Logdatei angegeben ist, wird das Standardziel für die Logdatei 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 Logdatei 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 EPS 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. Risikokategorien sind Teil globaler Daten und werden bei Verwendung des XER-Formats importiert.