Schrittedateien (.step/.xml): Aufbau, Elemente und Import in PACS
Technische Referenz zu STEP- und EMPLOYEE-Elementen, Attributen, Verschachtelung und Beispiel-XML für den Projektplan/XML-Import.
Schrittedateien (XML-basiert, Erweiterung .step oder .xml) enthalten Informationen über Schritthierarchie sowie ggf. zu den Mitarbeitern, die bei Schritten tätig sind:
- Informationen zu Schritten und deren Hierarchie werden mit Hilfe von <STEP>-Elementen angegeben und können in PACS entweder als tatsächliche Schritte oder als Schrittvorlagen übernommen (importiert) werden.
- Informationen zu den zugeordneten Mitarbeitern werden mit Hilfe von <EMPLOYEE>-Elementen angegeben und dienen dazu, bei der Planung entsprechende MA-Zeilen auf der Benutzeroberfläche des Planungsmoduls anzulegen (Eingabehilfe), d.h. es erfolgt kein MA-Eintrag in die DB.
- Root-Element <STEPS>
- 1 oder mehrere <STEP>-Elemente mit folgenden Attributen, die den gleichnamigen Spalten in der Tabelle [PACS_step] entsprechen (d.h. dort beim Import eingetragen werden):
- name - Schrittname
- text_01 - Notiz 1 (optional, Standardwert: leere Zeichenfolge)
- text_02 - Notiz 2 (optional, Standardwert: leere Zeichenfolge)
- text_03 - Notiz 3 (optional, Standardwert: leere Zeichenfolge)
- status - Schrittstatus (optional, Standardwert ist 0, d.h. Durchführung)
- <STEP>-Elemente können beliebig tief ineinander verschachtelt sein. Jedes <STEP>-Element kann beliebig viele <STEP>-Elemente enthalten (bzw. keine).
- Ein <STEP>-Element kann auch 1 oder mehrere <EMPLOYEE>-Elemente enthalten. Allerdings müssen alle Kindelemente eines <STEP>-Elements vom gleichen Typ sein, d.h. entweder <STEP>-Element(e) (die wiederum verschachtelt sein können) oder <EMPLOYEE>-Element(e), aber nicht beides gleichzeitig.
- Ein <EMPLOYEE>-Element entspricht einer MA-Zeile im Projektplan, kann keine Kindelemente enthalten und hat folgende Attribute:
- name - MA-Name
- firstname - MA-Vorname
- rate_name_01 - Name 1 des Leistungsatzes ([PACS_time_rate].[name_01])
- total_time_actual, total_time_plan, period_time_actual, period_time_plan (Format) - Summe Ist-/Plan-Zeiten gesamt bzw. im Zeitraum (Tabellenbereich im Projektplan)
Beispiel einer Schrittedatei
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<STEPS>
<STEP name="Importschritt 100">
<STEP name="Schritt 110" text_01="Notiz 1" text_02="Notiz 2" text_03="Notiz 3">
<EMPLOYEE name="Berbig" firstname="Sabine" rate_name_01="Support"/>
<EMPLOYEE name="Curtius" firstname="Friedrich" rate_name_01="Handbuch erstellen"/>
<EMPLOYEE name="Gogolin" firstname="Wilfried"/>
</STEP>
<STEP name="Schritt 120" text_03="Notiz 3">
<EMPLOYEE name="Berbig" firstname="Sabine" total_time_actual="12.99" total_time_plan="15" period_time_actual="10.5" period_time_plan="9.75"/>
<EMPLOYEE name="Curtius" firstname="Friedrich"/>
</STEP>
</STEP>
<STEP name="Importschritt 200">
<STEP name="Schritt 210">
<STEP name="Schritt 211">
<EMPLOYEE name="Berbig" firstname="Sabine"/>
<EMPLOYEE name="Berbig" firstname="Albert"/>
</STEP>
</STEP>
</STEP>
<STEP name="Importschritt 300">
<EMPLOYEE name="Götz" firstname="Wilfried"/>
<EMPLOYEE name="Pecher" firstname="Thomas"/>
</STEP>
<STEP name="Importschritt 400" status="-1"/>
</STEPS>
Dies ist relevant für den Projektplan: XML-Import und Register Projektplan.