XML-Import und -Export (Planungsparameter)

Aus Asprova Hilfe
Version vom 28. Januar 2019, 20:07 Uhr von GK (Diskussion | Beiträge) (Einbeziehung benutzerdefinierter Formeln)
Wechseln zu: Navigation, Suche
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

Die importierte XML-Datei enthält in [Zielressourcen] der [Ressourcenbewertung] die Ressource "Mischer", die bisher nicht im Projekt existiert. Ist [Objekte automatisch erstellen] von [Zielressourcen] auf "Ja" gesetzt, so wird das Ressourcenobjekt automatisch erstellt; die Eigenschaft auf "Nein" gesetzt, so wird die Ressource ignoriert und nicht importiert.

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

XML-Export

Alle Planungsparameter

Um alle Planungsparameter in XML-Dateien zu exportieren:

  1. klicken Sie im Menü [Datei] auf [XML-Export] > [Planungsparameter],
  2. suchen im Dialog "Speichern unter" das gewünschte Zielverzeichnis aus,
  3. geben den gewünschten Dateinamen ein, und
  4. klicken auf [Speichern].

Einzelne Planungsparameter

Um einzelne Planungsparameter, sowie deren Subparameter und Befehle, in XML-Dateien zu exportieren:

  1. markieren Sie in der Planungsparametertabelle die gewünschten Planungsparameter,
  2. klicken in deren Kontextmenü auf [XML-Export ...]
  3. suchen im Dialog "Speichern unter" das gewünschte Zielverzeichnis aus,
  4. geben den gewünschten Dateinamen ein, und
  5. klicken auf [Speichern].

Einbeziehung benutzerdefinierter Formeln

Enthält ein Planungsparameter Formeln, die als benutzerdefinierte Formeln gespeichert sind, (etwa als Einlastungsschlüssel), und wird in eine XML-Datei exportiert, so werden auch die Namen der benutzerdefinierten Formeln exportiert. Damit werden diese Namen mit importiert, so dass die benutzerdefinierten Formeln auch in anderen Projekte wiederhergestellt werden können.

Hinweis
Benutzerdefinierter Formeln werden erst ab Version 12.0.2 exportiert.

Falls der [Formelcode] oder die [Formel] bereits existieren, so wird eine entsprechende Nachricht angezeigt. Aus den Nachrichtendetails können Sie, durch einen Klick auf [Springen] hinter "Betroffene Objekte 1", direkt zu der Formeltabelle mit den betroffenen Formeln springen, so dass Sie dort bequem den [Formelcode] oder die [Formel] anpassen können.

Formelcode existiert bereits

Falls beim Import bereits eine Formel mit dem gleichen [Formelcode] existiert, so gibt es eine entsprechende eine Nachricht.

Beispiel

Der Formelcode <Einlastungsschlüsseltest-1> der importierten benutzerdefinierten Formel <ME.Work_Order.Order_DisplayOrder> wird bereits von einer anderen Formel genutzt. Daher wurde der Formelcode in <Einlastungsschlüsseltest-1 (2)> geändert.

Formel existiert bereits

Falls beim Import bereits eine Formel mit der gleichen [Formel] existiert, so gibt es eine entsprechende eine Nachricht.

Beispiel

Der Formelcode <Einlastungsschlüsseltest-2> der importierten benutzerdefinierten Formel <ME.Work_Order.Order_DisplayOrder> entspricht nicht dem vorhandenen Formelcode <Einlastungsschlüsseltest-1> für diese Formel. Daher wird ab jetzt der Formelcode <Einlastungsschlüsseltest-2> genutzt.

Formelcode und Formel existieren bereits

Falls beim Import bereits eine Formel mit dem gleichen [Formelcode] existiert, und eine andere Formel mit der gleichen [Formel], so gibt es eine entsprechende eine Nachricht.

Beispiel

Der Formelcode <Einlastungsschlüsseltest-2> der importierten benutzerdefinierten Formel <ME.Work_Order.Order_DisplayOrder> entspricht nicht dem vorhandenen Formelcode <Einlastungsschlüsseltest-1> für diese Formel. Da es aber bereits eine andere Formel mit Formelcode <Einlastungsschlüsseltest-2> gibt, wird jetzt <Einlastungsschlüsseltest-2 (2)> genutzt.

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