5.12.17. Automatisches Klassen Mapping: Editieren...

Mit V12 gibt es eine neue Funktion Automatisches Klassen Mapping: Editieren....

Dialog: Automatisches Klassen Mapping bearbeiten

Dialog: Automatisches Klassen Mapping bearbeiten

Ein wichtiger Unterschied zur bestehenden Funktion Klassensysteme mappen 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, erscheinen Klassen und Merkmale mit rötlicher Färbung , enthält es Mappings aus der Registerseite Gemappte Elemente, werden Klassen und Merkmale in bläulicher Färbung angezeigt.

    Mapping aus "Vorgeschlagene Elemente"

    Mapping aus "Vorgeschlagene Elemente"

    Mapping aus "Gemappte Elemente"

    Mapping aus "Gemappte Elemente"

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) werden die Daten der Klasse eingetragen und dann in der unteren Tabelle (Mapping zwischen Merkmalen) die Merkmalsdaten.

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

    -> 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.

    -> 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:

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

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

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

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

    • Kopiere Instanz: Es wird der gesamte Inhalt der Klasse kopiert.

    • Kopiere Einschränkungen:

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

      Oder

      Kopiere gemappte Merkmale (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.

  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.

    -> Es wird eine Zeile mit Eingabefeldern angelegt.

  8. Befüllen Sie nun die einzelnen Felder:

    • Ursprungs Klasse: Ö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: Öffnen Sie das Listenfeld und wählen Sie das gewünschte Merkmal.

    • Ursprungs ID: Wird automatisch befüllt.

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

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

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

    • Ziel ID: Wird automatisch befüllt.

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

      Oder

      Kopiere Merkmals Wert: Wählen Sie diese Option, wenn ein fixer Wert gemappt werden soll.

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

      -> Es öffnet sich das gleichnamige Dialogfenster.

      Werte Mapping "Dialogfenster"

      Werte Mapping "Dialogfenster"

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

    • Kopiere Flags:

    • Kopiere Einheit: Default ist aktiviert.

    • Ziel Einheit (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.

Test:

  1. Wählen Sie ein Bauteil mit entsprechender Ursprungs Klasse und Ursprungs Merkmal.

    Das Bauteil ist standardmäßig in der CNS Klassifikation nach der Bestellnummer klassifiziert.

    Das Bauteil ist standardmäßig in der CNS Klassifikation nach der Bestellnummer klassifiziert.

  2. Passend zum Mapping sollte nun das gemappte Merkmal denselben Wert zeigen.

    Dasselbe Projekt zeigt in eClass 9.1 ein Mapping aus "Gemappte Elemente"

    Dasselbe Projekt zeigt in eClass 9.1 ein Mapping aus "Gemappte Elemente"

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 und einen für Vorgeschlagene Elemente. 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: Fügt ein Quellsystem hinzu (z.B. eclass8.0, eclass8.1, etc.). (Duplikate sind nicht möglich.)

  • Element Hinzufügen: 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: 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: Importiert eClass Daten aus einem Verzeichnis mit geeigneten .xml-Dateien (Legacy-Fall)

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

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

  • CSV exportieren: 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: 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, in der Spalte Werte 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: 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.