XML-Import und -Export (Planungsparameter): Unterschied zwischen den Versionen

Aus Asprova Hilfe
Wechseln zu: Navigation, Suche
Zeile 1: Zeile 1:
{{DISPLAYTITLE:XML Import und Export}}
+
{{DISPLAYTITLE:XML-Import und -Export (Planungsparameter)}}
 
<div align="right">Hilfe Nummer: 757460</div>
 
<div align="right">Hilfe Nummer: 757460</div>
+
<div align="right">[[XML-Import und -Export]]</div>
 
<hr>
 
<hr>
Dieses Feature importiert und exportiert Planungsbefehle in Textdateien im XML-Format.
 
  
 +
Sie können Planungsparameter aus, im XML-Format formatierten, Textdateien importieren, oder in solche exportieren.
  
XML Importieren
+
== XML-Import ==
 +
Zum Importieren von Planungsparametern aus XML-Dateien,
 +
# klicken im Menü [Datei] auf [XML importieren ...],
 +
# suchen im Öffnen-Dialog die gewünschte Datei aus, und
 +
# klicken auf [Öffnen].
  
Importiert Planungsbefehle aus XML-Dateien. Während Import werden Daten nicht mit bestehenden Objekten zusammengeführt, sondern immer als neue Objekte hinzugefügt. Ebenso werden importierte Objekte als neue Einträge betrachtet, wenn bereits Objekte unter demselben Namen in Asprova existieren.
+
Die importierten Planungsparameter werden nicht mit bestehenden Planungsparameter zusammengeführt, sondern immer als neue Planungsparameter hinzugefügt. Werden Planungsparameter importiert, deren Namen in Asprova bereits für Planungsparameter genutzt werden, so wird an den Namen der importierten Planungsparameter ein Index angehängt, um diese zu unterscheiden (aus "Planungsparameter" würde zum Beispiel "Planungsparameter (1)" werden.).
  
Wenn Asprova eine XML-Datei mit Objekten darin importiert, die in Asprova nicht existieren, hängt das Ergebnis von den Einstellungen der Eigenschaft [[Übersicht Datenimport und -export|"Objekt automatisch erstellen"]] ab (in den Eigenschaftsdefinitionsklasse).<br />Hypothetischer Fall der "Zielressource" der Eigenschaft "Evaluationsformel" im Planungsparameter: Eine XML-Datei enthält eine Ressource namens "Mixer". Wenn die Ressourcentabelle Asprovas, in die diese XML-Datei importiert wird, keine Ressource mit dem Code "Mixer" enthält, dann wird das Ressourcenobjekt automatisch erstellt - falls die Eigenschaft "Objekte automatisch erstellen" auf "Ja" für "Zielressource" (ResEval_Resource) gesetzt ist. Die importierten Daten werden ignoriert, wenn die Eigenschaft auf "Nein" gesetzt ist.
+
Werden Planungsparameter importiert, die Objekte enthalten, die in Asprova nicht existieren, so hängt das Verhalten von von der Projektdefinitionseigenschaft <nowiki>[</nowiki>[[Übersicht Datenimport und -export|Objekte automatisch erstellen]]<nowiki>]</nowiki> des jeweiligen Objekts ab.
 +
; Beispiel
 +
<br />Hypothetischer Fall der "Zielressource" der Eigenschaft "Evaluationsformel" im Planungsparameter: Eine XML-Datei enthält eine Ressource namens "Mixer". Wenn die Ressourcentabelle Asprovas, in die diese XML-Datei importiert wird, keine Ressource mit dem Code "Mixer" enthält, dann wird das Ressourcenobjekt automatisch erstellt - falls die Eigenschaft "Objekte automatisch erstellen" auf "Ja" für "Zielressource" (ResEval_Resource) gesetzt ist. Die importierten Daten werden ignoriert, wenn die Eigenschaft auf "Nein" gesetzt ist.
  
Read-Only-Eigenschaften können nicht importiert werden. Beim Versuch, diese zu importieren, werden sie ignoriert.
+
Schreibgeschützte Eigenschaften können nicht importiert werden, beim importieren werden sie ignoriert.
 
 
 
 
XML Export
 
  
 +
== XML-Export ==
 
Exportiert Planungsparameterbefehle in Textdateien im XML-Format. [Datei] - [XML Export] aus dem Hauptmenü speichert die gesamten Planungsparameter im XML-Format. Wenn Sie [XML Export] aus dem Kontextmenü [[Übersicht Fenster des Tabellenzeitdiagramms |"Linker Teil"]] der Planungsparametertabelle auswählen, werden ausgewählte Befehle, und darunter gelistete Befehle, im XML-Format gespeichert.
 
Exportiert Planungsparameterbefehle in Textdateien im XML-Format. [Datei] - [XML Export] aus dem Hauptmenü speichert die gesamten Planungsparameter im XML-Format. Wenn Sie [XML Export] aus dem Kontextmenü [[Übersicht Fenster des Tabellenzeitdiagramms |"Linker Teil"]] der Planungsparametertabelle auswählen, werden ausgewählte Befehle, und darunter gelistete Befehle, im XML-Format gespeichert.
  
 
+
== XML-Dateiformat==
XML-Dateiformat
 
 
 
 
Das Dateiformat einer exportierten XML-Datei sieht wie folgt aus:
 
Das Dateiformat einer exportierten XML-Datei sieht wie folgt aus:
  
 
[[Image:xml001.jpg]]
 
[[Image:xml001.jpg]]
  
 
+
=== Tags/Attribute ===
Tags/Attribute
 
  
 
<Asprova>
 
<Asprova>
Zeile 40: Zeile 41:
  
 
:: Eine Version vom XML-Format Asprovas; Wenn dies weggelassen wird, wird die XML-Version als die neueste betrachtet.
 
:: Eine Version vom XML-Format Asprovas; Wenn dies weggelassen wird, wird die XML-Version als die neueste betrachtet.
 
  
 
: Beispiel: <Asprova AppVersion="3.0.0.0" XMLVersion="1.0">
 
: Beispiel: <Asprova AppVersion="3.0.0.0" XMLVersion="1.0">
 
  
 
<WBSAlias>
 
<WBSAlias>
  
 
Beschreibt die Klasse, auf die Daten Bezug nehmen. Dieser Eintrag kann nicht weggelassen werden. Da derzeit nur Planungsbefehle importiert und exportiert werden können, beschreiben Sie diesen Eintrag bitte wie folgt:
 
Beschreibt die Klasse, auf die Daten Bezug nehmen. Dieser Eintrag kann nicht weggelassen werden. Da derzeit nur Planungsbefehle importiert und exportiert werden können, beschreiben Sie diesen Eintrag bitte wie folgt:
 
  
 
: Beispiel: <WBSAlias Code="SchedulingCommand">
 
: Beispiel: <WBSAlias Code="SchedulingCommand">
  
 
+
== Hinweise ==
Andere
+
=== Eigenschaftsnamen ===
 
 
 
Sie können einen Eigenschaftennamen anhand von einem 'Tag' (Attribut) beschreiben.
 
Sie können einen Eigenschaftennamen anhand von einem 'Tag' (Attribut) beschreiben.
  
Zeile 65: Zeile 62:
 
:: <Child Code="Assign first processes">
 
:: <Child Code="Assign first processes">
  
 +
Kurznamen der Eigenschaften können nicht verwendet werden.
  
 +
=== Reservierte Zeichen ===
 
Reservierte Zeichen "<", ">" und "&" in XML werden in Textdateien in Escape-Sequenzen umgewandelt, also: "&lt;", "&gt;" und "&amp;"
 
Reservierte Zeichen "<", ">" und "&" in XML werden in Textdateien in Escape-Sequenzen umgewandelt, also: "&lt;", "&gt;" und "&amp;"
  
Zeile 72: Zeile 71:
 
:: Im Web-Browser werden die oben genannten, reservierten Zeichen wie in Asprova angezeigt.
 
:: Im Web-Browser werden die oben genannten, reservierten Zeichen wie in Asprova angezeigt.
  
Kurznamen der Eigenschaften können nicht verwendet werden.
+
=== Ereignisbedingungsobjekte ===
 
 
 
 
 
Das Ereignisbedingungsobjekt eines Planungsparameters gehört nicht zum Parameter, sondern existiert unter einem separaten Klassenursprung für Ereignisbedingungen. Für die Zwecke des XML-Exports werden Ereignisbedingungsobjekte jedoch im XML-Format erfasst, als ob sie untergeordnete Objekte des Parameters seien. Werden diese importiert, so werden Ereignisbedingungsobjekte für Planungsparameter erstellt, selbst wenn ein Ereignisbedingungsobjekt mit demselben Namen existiert.
 
Das Ereignisbedingungsobjekt eines Planungsparameters gehört nicht zum Parameter, sondern existiert unter einem separaten Klassenursprung für Ereignisbedingungen. Für die Zwecke des XML-Exports werden Ereignisbedingungsobjekte jedoch im XML-Format erfasst, als ob sie untergeordnete Objekte des Parameters seien. Werden diese importiert, so werden Ereignisbedingungsobjekte für Planungsparameter erstellt, selbst wenn ein Ereignisbedingungsobjekt mit demselben Namen existiert.
  
 +
=== Referenzbefehl ===
 +
Enthält ein zu exportierender Parameter den Befehl "Referenzbefehl", so wird der darin referenzierte Parameter rekursiv ebenfalls exportiert.
 +
{|class="wikitable"
 +
|-
 +
!Befehle und Exportbedingungen!!Export referenzierter Parameter
 +
|-
 +
|Kontextmenü der Planungsparametertabelle||style="background:#E2EFDA" align="center|&#x2714;
 +
|-
 +
|Kontextmenü der Tabelle benutzerdefiniertes Menü||style="background:#E2EFDA" align="center|&#x2714;
 +
|-
 +
|Menü [Datei] > [XML-Export] > [Benutzerdefiniertes Menü]||style="background:#E2EFDA" align="center|&#x2714;
 +
|-
 +
|Menü [Datei] > [XML-Export] > [Planungsparameter]||style="background:#FFBFBF" align="center|&#x274c;
 +
|-
 +
|Benutzerdefiniertes Menü (lokal)<br>(beim Schließen des Projekts in MES etc.)||style="background:#FFBFBF" align="center|&#x274c;
 +
|-
 +
|Benutzerdefiniertes Menü (DS)<br>(beim Schließen des Projekts in MES etc.)||style="background:#FFBFBF" align="center|&#x274c;
 +
|-
 +
|COM-Schnittstelle IASBProject::ExportXMLSchedulingParameter||style="background:#FFBFBF" align="center|&#x274c;
 +
|-
 +
|}
  
 
<hr>
 
<hr>
 
<div align="right">Hilfe Nummer: 757460</div>
 
<div align="right">Hilfe Nummer: 757460</div>

Version vom 28. Januar 2019, 17:46 Uhr

Hilfe Nummer: 757460
XML-Import und -Export

Sie können Planungsparameter aus, im XML-Format formatierten, Textdateien importieren, oder in solche exportieren.

XML-Import

Zum Importieren von Planungsparametern aus XML-Dateien,

  1. klicken im Menü [Datei] auf [XML importieren ...],
  2. suchen im Öffnen-Dialog die gewünschte Datei aus, und
  3. klicken auf [Öffnen].

Die importierten Planungsparameter werden nicht mit bestehenden Planungsparameter zusammengeführt, sondern immer als neue Planungsparameter hinzugefügt. Werden Planungsparameter importiert, deren Namen in Asprova bereits für Planungsparameter genutzt werden, so wird an den Namen der importierten Planungsparameter ein Index angehängt, um diese zu unterscheiden (aus "Planungsparameter" würde zum Beispiel "Planungsparameter (1)" werden.).

Werden Planungsparameter importiert, die Objekte enthalten, die in Asprova nicht existieren, so hängt das Verhalten von von der Projektdefinitionseigenschaft [Objekte automatisch erstellen] des jeweiligen Objekts ab.

Beispiel


Hypothetischer Fall der "Zielressource" der Eigenschaft "Evaluationsformel" im Planungsparameter: Eine XML-Datei enthält eine Ressource namens "Mixer". Wenn die Ressourcentabelle Asprovas, in die diese XML-Datei importiert wird, keine Ressource mit dem Code "Mixer" enthält, dann wird das Ressourcenobjekt automatisch erstellt - falls die Eigenschaft "Objekte automatisch erstellen" auf "Ja" für "Zielressource" (ResEval_Resource) gesetzt ist. Die importierten Daten werden ignoriert, wenn die Eigenschaft auf "Nein" gesetzt ist.

Schreibgeschützte Eigenschaften können nicht importiert werden, beim importieren werden sie ignoriert.

XML-Export

Exportiert Planungsparameterbefehle in Textdateien im XML-Format. [Datei] - [XML Export] aus dem Hauptmenü speichert die gesamten Planungsparameter im XML-Format. Wenn Sie [XML Export] aus dem Kontextmenü "Linker Teil" der Planungsparametertabelle auswählen, werden ausgewählte Befehle, und darunter gelistete Befehle, im XML-Format gespeichert.

XML-Dateiformat

Das Dateiformat einer exportierten XML-Datei sieht wie folgt aus:

Xml001.jpg

Tags/Attribute

<Asprova>

Zeigt den Beginn von Asprova-Daten an.

<AppVersion>
Eine Version von Asprova; dieser Eintrag kann weggelassen werden, wenn eine XML-Datei in einem externen System erstellt wird.
<XMLVersion>
Eine Version vom XML-Format Asprovas; Wenn dies weggelassen wird, wird die XML-Version als die neueste betrachtet.
Beispiel: <Asprova AppVersion="3.0.0.0" XMLVersion="1.0">

<WBSAlias>

Beschreibt die Klasse, auf die Daten Bezug nehmen. Dieser Eintrag kann nicht weggelassen werden. Da derzeit nur Planungsbefehle importiert und exportiert werden können, beschreiben Sie diesen Eintrag bitte wie folgt:

Beispiel: <WBSAlias Code="SchedulingCommand">

Hinweise

Eigenschaftsnamen

Sie können einen Eigenschaftennamen anhand von einem 'Tag' (Attribut) beschreiben.

Beispiel 1: Die Klasse ist die zur Zuweisung von Fertigungsaufträgen.
<Object_ClassDef>ASPCommand_AssignManufacturingOrders</Object_ClassDef>
Beispiel 2: Verfügt über ein untergeordnetes Objekt namens "Assign first processes".
<Child Code="Assign first processes">

Kurznamen der Eigenschaften können nicht verwendet werden.

Reservierte Zeichen

Reservierte Zeichen "<", ">" und "&" in XML werden in Textdateien in Escape-Sequenzen umgewandelt, also: "<", ">" und "&"

Beispiel: "Order_Priority>90&&Order_Priority<100" in Asprova
-> "Order_Priority>900&&Order_Priority<100" in einer XML-Datei
Im Web-Browser werden die oben genannten, reservierten Zeichen wie in Asprova angezeigt.

Ereignisbedingungsobjekte

Das Ereignisbedingungsobjekt eines Planungsparameters gehört nicht zum Parameter, sondern existiert unter einem separaten Klassenursprung für Ereignisbedingungen. Für die Zwecke des XML-Exports werden Ereignisbedingungsobjekte jedoch im XML-Format erfasst, als ob sie untergeordnete Objekte des Parameters seien. Werden diese importiert, so werden Ereignisbedingungsobjekte für Planungsparameter erstellt, selbst wenn ein Ereignisbedingungsobjekt mit demselben Namen existiert.

Referenzbefehl

Enthält ein zu exportierender Parameter den Befehl "Referenzbefehl", so wird der darin referenzierte Parameter rekursiv ebenfalls exportiert.

Befehle und Exportbedingungen Export referenzierter Parameter
Kontextmenü der Planungsparametertabelle
Kontextmenü der Tabelle benutzerdefiniertes Menü
Menü [Datei] > [XML-Export] > [Benutzerdefiniertes Menü]
Menü [Datei] > [XML-Export] > [Planungsparameter]
Benutzerdefiniertes Menü (lokal)
(beim Schließen des Projekts in MES etc.)
Benutzerdefiniertes Menü (DS)
(beim Schließen des Projekts in MES etc.)
COM-Schnittstelle IASBProject::ExportXMLSchedulingParameter

Hilfe Nummer: 757460