5.12.16. Automatisches Klassen Mapping: Editieren...

Mit V12 gibt es eine neue Funktion Automatisches Klassen Mapping: Editieren... [Automatic Class Mapping: Edit...].

Dialog: Automatisches Klassen Mapping bearbeiten [Edit Automatic Class Mapping]

Dialog: Automatisches Klassen Mapping bearbeiten [Edit Automatic Class Mapping]

Ein wichtiger Unterschied zur bestehenden Funktion Klassensysteme mappen [Map class systems] ist, dass hier ein virtuelles Mapping stattfindet, sodass zwar beim Export die gemappten Klassen und Merkmale in die Zielsysteme übertragen werden, aber die Klassifikationsdaten nicht physikalisch in die Projektdateien geschrieben werden.

[Hinweis]Hinweis
  • Voraussetzung: Unter $CADENAS_DATA/datasetup muss dass Verzeichnis class2class existieren.

  • Eine wichtige Einschränkung ist, dass Merkmale nicht in bereits vorhandene Klassen gemappt werden können (auch nicht, wenn das konkrete Merkmal nicht gesetzt ist). Wird das Mapping z.B. verwendet, um von eClass 11.1 auf eine noch völlig leere eClass 12.0 zu mappen, ist der Punkt irrelevant. Soll aber z.B. von der Revit Klassifikation auf die CNS Klassifikation gemappt werden, wird das Mapping voraussichtlich in vielen Fällen nicht ausgeführt werden.

  • Enthält ein Projekt Mappings aus der Registerseite Vorgeschlagene Elemente [Suggested items], erscheinen Klassen und Merkmale mit rötlicher Hintergrundfarbe , enthält es Mappings aus der Registerseite Gemappte Elemente [Mapped elements], werden Klassen und Merkmale in bläulicher Hintergrundfarbe angezeigt.

    Mapping aus "Vorgeschlagene Elemente [Suggested items]"

    Mapping aus "Vorgeschlagene Elemente [Suggested items]"

    Mapping aus "Gemappte Elemente [Mapped elements]"

    Mapping aus "Gemappte Elemente [Mapped elements]"

Beispiel

Im folgenden Beispiel soll ein Klassenmerkmal der Klassifikation CNS auf ein Klassenmerkmal der Klassifikation eClass 9.1 gemappt werden. D.h. beginnend in der oberen Tabelle (Mapping zwischen Klassen [Mapping between classes]) werden die Daten der Klasse eingetragen und dann in der unteren Tabelle (Mapping zwischen Merkmalen [Mapping between characteristics]) die Merkmalsdaten.

  1. Klicken Sie in der oberen Tabelle auf System hinzufügen [Add System].

    -> Das gleichnamige Dialogfenster wird geöffnet.

  2. Tragen Sie im exakten Wortlaut in Kleinschreibung den Namen der gewünschten Klassifikation ein und bestätigen Sie mit OK.

    -> Es wird eine neue Zeile in der oberen Tabelle angelegt.

  3. Klicken Sie auf Element Hinzufügen [Add Item].

    -> Es wird eine Zeile mit Eingabefeldern erzeugt.

  4. Befüllen Sie nun die einzelnen Felder:

    [Hinweis]Hinweis

    Wenn Sie in ein Eingabefeld klicken, erscheint ein Listenfeld mit den möglichen Optionen. Ansonsten: Aktivieren Sie gegebenenfalls das Auswahlkästchen.

    • Ursprungs Klasse [Origin Class]:

    • Ziel System [Target System]: Geben Sie im exakten Wortlaut, in Kleinschreibung den Namen der gewünschten Klassifikation ein und bestätigen Sie mit Enter.

    • Ziel Klasse [Target Class]: Öffnen Sie das Listenfeld und wählen Sie die gewünschte Klasse.

    • Anzahl [Number]: Standardmäßig wird eine Instanz angelegt. Sie könnten auch mehrere Instanzen der Klasse anlegen.

    • Bidirektional [Bidirectional]: Standardmäßig wird nur in der angegebenen Richtung gemappt. Wenn Sie die Option aktivieren, wird in von Ursprungs Klasse [Origin Class] zu Ziel Klasse [Target Class] und umgekehrt gemappt.

    • Kopiere Instanz [Copy Instance]: Es wird der gesamte Inhalt der Klasse kopiert.

    • Kopiere Einschränkungen [Copy Restrictions]:

    • Kopiere Merkmale [Copy features]: Alle exakt gleichen Merkmale werden kopiert. Diese Option schließt Einträge in der unteren Tabelle aus.

      Oder

      Kopiere gemappte Merkmale [Copy mapped features] (Default): Es werden nur die Merkmale, die explizit in der unteren Tabelle angegeben werden, gemappt.

      Nur einer der beiden Punkte kann gewählt werden!

  5. Klicken Sie in der unteren Tabelle auf System hinzufügen [Add System].

  6. Tragen Sie im exakten Wortlaut in Kleinschreibung den Namen der gewünschten Klassifikation ein und bestätigen Sie mit OK.

  7. Klicken Sie auf Element Hinzufügen [Add Item].

    -> Es wird eine Zeile mit Eingabefeldern angelegt.

  8. Befüllen Sie nun die einzelnen Felder:

    • Ursprungs Klasse [Origin Class]: Öffnen Sie das Listenfeld und wählen Sie dieselbe Klasse wie in oberer Tabelle. Alternativ können Sie auch das Wildcard-Symbol (*) verwenden, was sich allerding negativ auf die Performance auswirkt.

    • Ursprungs Merkmal [Origin Characteristic]: Öffnen Sie das Listenfeld und wählen Sie das gewünschte Merkmal.

    • Ursprungs ID [Origin ID]: Wird automatisch befüllt.

    • Ziel System [Target System]: Geben Sie im exakten Wortlaut, in Kleinschreibung den Namen der gewünschten Klassifikation ein und bestätigen Sie mit Enter.

    • Ziel Klasse [Target Class]: Öffnen Sie das Listenfeld und wählen Sie die gewünschte Klasse.

    • Ziel Merkmal [Target Feature]: Öffnen Sie das Listenfeld und wählen Sie das gewünschte Merkmal.

    • Ziel ID [Target ID]: Wird automatisch befüllt.

    • Kopiere Merkmals Name [Copy Characteristic Name] ("Kopiere Variablen Name"): Wählen Sie diese Option, wenn eine bestimmte Variable gemappt werden soll.

      Oder

      Kopiere Merkmals Wert [Copy Characteristic Value]: Wählen Sie diese Option, wenn ein fixer Wert gemappt werden soll.

    • Werte Mapping [Value Mapping] (Optional): Klicken Sie auf den Button , wenn Sie den Ursprungswert anpassen möchten.

      -> Es öffnet sich das gleichnamige Dialogfenster.

      Werte Mapping [Value Mapping] "Dialogfenster"

      Werte Mapping [Value Mapping] "Dialogfenster"

      Mittels Eingaben unter Ursprungs Wert [Original Value] und Ziel Wert [Target Value] können Sie den Zielwert anpassen. Nach Bestätigung mit OK ändert sich das Aussehen des Button auf .

    • Kopiere Flags [Copy flags]:

    • Kopiere Einheit [Copy unit]: Default ist aktiviert.

    • Ziel Einheit [Objective Unit] (optional): Wird eine Einheit angegeben, erfolgt automatisch eine Umrechnung der Werte.

  9. Führen Sie das Mapping mittels Klick auf OK aus.

    [Hinweis]Hinweis

    Ein Mapping wird nur ausgeführt, wenn das Ziel leer ist.

    Änderungen an Mappings erfordern einen Neustart von PARTproject; bei Änderungen an Projekten reicht Aktualisierung (F5) der Projektauswahl [Project selection].

Test:

Im vorliegenden Beispiel wurde ein Mapping zwischen

Klassfikation "CNS" > Klasse "CNSERPBASE" > Merkmal "CNSORDERNO" 

und

Klassfikation "eclass 9.1" > Klasse "27-29-13-90" > Merkmal "AAO676002"

eingerichtet.

  1. Wählen Sie ein Bauteil mit entsprechender Ursprungs Klasse [Origin Class] und Ursprungs Merkmal [Origin Characteristic].

  2. Wählen Sie im Listenfeld unterhalb vom Reiter Klassifikation [Classification] die gewünschte Klassifikation, auf die das Mapping eingerichtet wurde.Jpara

    -> Die gemappten Klassen und Merkmale werden mit blauer Hintergrundfarbe angezeigt.

Benutzeroberfläche

Hauptmerkmale sind der obere Tabellenbereich (für das Klassen-Mapping) und der untere Tabellenbereich (für das Merkmal-Mapping)

Jeder Tabellenbereich hat 2 Reiter, einen für Gemappte Elemente [Mapped elements] und einen für Vorgeschlagene Elemente [Suggested items]. Diese sind separate Tabellen mit separaten Daten.

Jeder Tabellenbereich hat seine eigenen Buttons, die für den aktuell aktiven Reiter zuständig sind.

Buttons rechts oberhalb der Tabellen

  • System Hinzufügen [Add System]: Fügt ein Quellsystem hinzu (z.B. eclass8.0, eclass8.1, etc.). (Duplikate sind nicht möglich.)

  • Element Hinzufügen [Add Item]: Fügt unter einem obersten Knoten ein neues Element mit leeren Daten und Defaultwerten hinzu.

    Ein Element wird an der letzten Position unter dem aktuell selektierte Top-Knoten oder aktuell selektierten Element eingefügt.

  • Entfernen [Remove]: Löscht das aktuell selektierte Element bzw. Top-Knoten (alternativ auch entf-Taste)

    Wird ein oberster Knoten gelöscht, werden auch alle darunter liegenden Knoten gelöscht (nur nach einer Sicherheitsabfrage, ob wirklich gelöscht werden soll).

Suchleiste

Jeder Tabellenbereich hat seine eigene Suchleiste zum Durchsuchen aller Quell- und Zieldaten (System und Klassen (und Variablen und ID sofern Variablen durchsucht werden)).

Buttons unterhalb der Tabellenbereiche

  • eClass XML importieren [Import eClass XML]: Importiert eClass Daten aus einem Verzeichnis mit geeigneten .xml-Dateien (Legacy-Fall)

  • eClass CSV importieren [Import eClass CSV]: Importiert eClass Daten aus einem Verzeichnis mit geeigneten csv-Dateien (Upgrade auf nächste eClass Version)

  • CSV importieren [import CSV]: Importiert eClass Daten aus einem Verzeichnis mit geeigneten csv-Dateien (z.B. eclass8.0_classes_mapped.csv).

  • CSV exportieren [Export CSV]: Exportiert Tabellendaten in Form von mehreren csv-Dateien () in ein Verzeichnis (wie Import-Format oben)

    Die exportierten CSV-Dateien sind separiert nach Klassifikationssystem, Klassen-Daten / Variablen-Daten und gemappt / vorgeschlagen (z.B. eclass5.1_classes_mapped.csv oder eclass5.1_variables_suggested.csv).

  • OK: Speichert die Daten unter $CADENAS_DATA/datasetup -> Verzeichnis class2class -> Datei mapping.c2c und schließt den Dialog.

    Unter $CADENAS_DATA/datasetup muss dass Verzeichnis class2class existieren.

  • Abbrechen [Cancel]: Verwirft die Änderungen und schließt den Dialog (alternativ funktioniert der x-Button in der rechten oberen Ecke).

Beim Datenimport (via .csv-Dateien) werden Duplikate entfernt (evtl. zeitaufwändig).

Beim Datenexport (via .csv-Dateien) werden Duplikate entfernt (nur geänderte Elemente werden überprüft).

Beim Speichern von Daten (via OK Button) werden Duplikate entfernt (nur geänderte Elemente werden überprüft) und Variablen-Mapping-Daten werden auf fehlende korrespondierende Klassen-Mapping-Daten überprüft. Für den Fall, dass Elemente gefunden werden, gibt es einen Dialog, wo entweder fehlende Klassen-Mapping-Daten zugefügt oder falsche Variablen-Mapping-Daten gelöscht können.

Normalerweise sind Tabellenzellen editierbare Strings oder Auswahlkästchen.

Spezielle Fälle:

  • Manche Zellen geben eine Liste möglicher String-Werte, wenn sie geklickt werden (z.B. Quell-Klasse, sofern ein Quell-System existiert).

  • In der Tabelle Mapping zwischen Merkmalen [Mapping between characteristics], in der Spalte Werte Mapping [Value Mapping] findet sich in der Tabellenzelle ein Button (), der einen speziellen Dialog öffnet. Hier können Quell-Werte (bei Bedarf mehrere) auf Ziel-Werte gemappt werden (Warnung, falls es ein Duplikat ist). Es wird also in der gemappten Variable der Wert geändert, bzw. der fixe Wert geändert.

  • Ziel Einheit [Objective Unit]: Ist das Feld aktiviert, wird die Einheit konvertiert. Sind Werte vorhanden, werden diese automatisch in die neue Einheit umgerechnet.

Besondere Hinweise

Es gibt auch Klassen ohne Merkmale. In diesem Fall sind Einträge in der unteren Tabelle obsolet. Der umgekehrte Fall ist nicht möglich. Die obere Tabelle muss immer Einträge enthalten.