Verwendung von Globalen Projekten

In diesem Leitfaden stellen wir das Konzept der globalen Projekte vor und geben Schritt-für-Schritt-Anleitungen, wie man globale Projekte innerhalb der Standardprojekte erstellt, verknüpft und verwaltet. Globale Projekte ermöglichen geteilte Ressourcen und Konfigurationen und sorgen so für Konsistenz über mehrere Standardprojekte hinweg. Für einen detaillierten Überblick über globale Projekte, siehe den Abschnitt Globale Projekte.

Globales Projekt erstellen

Siehe hier für einen detaillierten Überblick.

In diesem Tutorial konzentrieren wir uns darauf, ein globales Projekt aus unserer DATAMIMIC's Custom Components Demo zu erstellen.

1. Klicke im DATAMIMIC Demo Store auf Klonen für unsere Demo namens Custom Components.
2. Navigiere zu den Projekteinstellungen der geklonten Demo.
3. Klicke auf das "Globus"-Symbol, um dieses Projekt in ein globales Projekt zu verwandeln.

Dieses Projekt wird nun zu einem globalen Projekt, was bedeutet, dass jedes andere von dir erstellte Standardprojekt die Möglichkeit hat, zu diesem globalen Projekt zu verlinken.

Globales Projekt mit einem Standardprojekt verlinken

1. Erstelle ein neues leeres DATAMIMIC-Projekt.
2. Navigiere zu den neu erstellten leeren Projekteinstellungen.
3. Wähle den Tab Globale Projekte, klicke auf Hinzufügen und wähle das globale Projekt Custom Component aus, das wir gerade erstellt haben.
4. Navigiere zurück zum Editor.

Globales Projekt verlinken

Im Datei-Editor siehst du, dass unser Standardprojekt nun Dateien aus dem globalen Projekt Custom Components enthält. Diese Dateien sind jedoch nur mit Lesezugriff verfügbar. Diese Dateien haben ein spezielles Symbol und sind schreibgeschützt. Wenn du Änderungen an diesen Dateien vornehmen möchtest, siehe hier.

Note

Beachte, dass sowohl unser globales Projekt als auch das Standardprojekt beide eine datamimic.xml Datei haben. Wenn du sie jedoch verlinkst, wird der Inhalt der datamimic.xml Datei im neuen Projekt nicht automatisch aktualisiert, um dem globalen Projekt datamimic.xml zu entsprechen. Dies liegt daran, dass bei der Zusammenführung von Projektdateien die Dateien des Standardprojekts im Falle einer Namensduplikation Vorrang haben. Für weitere Details, siehe unsere Best Practices für die Verwaltung von globalen Projekten.

Projekt generieren

Unsere globalen Projekt Custom Components enthalten Dateien, die unsere Custom Converter, Generators enthalten. Wenn du mehr darüber erfahren möchtest, wie du diese selbst erstellen kannst, schau dir diesen Abschnitt an. Für jetzt werden wir diese in unserem aktuellen Projekt verwenden.

1. Bearbeite die datamimic.xml Datei mit:

<setup numProcess="4">

    <include uri="conf/base.properties"/>
    <memstore id="mem"/>

    <!-- Load scripts into the global context using <execute> -->
    <execute uri="script/generator.scr.py"/>
    <execute uri="script/converter.scr.py"/>

    <!-- Include the model using multiprocessing with custom generators, which use local imports -->
    <include uri="1_generator_multi.xml"/>

    <!-- Include the model using multiprocessing with custom converters -->
    <include uri="2_converter_multi.xml"/>

    <!-- Load scripts with global imports into the context. Note: executing this before
    <include uri="1_generator_multi.xml"/> will cause an error because multithreading and
    global imports are not supported together -->
    <execute uri="script/generator_glob.scr.py"/>

    <!-- Include the model using single processing with custom generators, which use global imports -->
    <include uri="3_generator_global_single.xml"/>

</setup>

1. Bearbeite die base Konfigurationsdatei mit:

global_count=10

1. Klicke auf Generieren.

2. Gehe zur Aufgaben Ansicht für das generierte Modell und überprüfe das Ergebnis nach Abschluss des Generierungsprozesses.

Unser DATAMIMIC-Modell ist nun so konzipiert, dass es vordefinierte benutzerdefinierte Generatoren und Konverter aus dem globalen Projekt enthält. Dieser Ansatz ermöglicht es dir, globale Projekte zu nutzen, um fortgeschrittene Anwendungsfälle zu verwalten, wie zum Beispiel das Teilen von Generatoren, Skripten oder Konvertern über mehrere Standardprojekte hinweg. Durch die Verwendung eines globalen Projekts kannst du eine konsistente Logik etablieren, die in jedem Standardprojekt repliziert werden kann, was deinen Workflow vereinfacht und Einheitlichkeit gewährleistet.

Zusammenfassung

In diesem Leitfaden haben wir das Konzept der globalen Projekte vorgestellt und gezeigt, wie man sie mit DATAMIMIC innerhalb der Standardprojekte erstellt, verlinkt und verwaltet. Hier ist eine Zusammenfassung der wichtigsten Schritte:

1. Erstelle ein globales Projekt:
   • Wir haben damit begonnen, ein Demoprojekt namens Custom Components aus dem DATAMIMIC Demo Store zu klonen.
   • Wir haben dieses Projekt in ein globales Projekt umgewandelt, indem wir zu den Projekteinstellungen navigiert und auf das "Globus"-Symbol geklickt haben.
2. Verlinke ein globales Projekt mit einem Standardprojekt:
   • Wir haben ein neues leeres DATAMIMIC-Projekt erstellt und seine Projekteinstellungen aufgerufen.
   • Unter dem Tab Globale Projekte haben wir das globale Projekt Custom Components hinzugefügt.
   • Wir sind zum Datei-Editor zurückgekehrt, wo wir beobachtet haben, dass Dateien aus dem globalen Projekt als schreibgeschützt mit einem speziellen Symbol erscheinen.
3. Generiere das Projekt:
   • Wir haben die datamimic.xml Datei bearbeitet, um benutzerdefinierte Generatoren und Konverter aus dem globalen Projekt einzuschließen.
   • Wir haben die Basis-Konfigurationsdatei aktualisiert und dann auf Generieren geklickt, um die benutzerdefinierten Konfigurationen anzuwenden.
   • Wir haben die Ergebnisse in der Aufgabenansicht überprüft, nachdem der Generierungsprozess abgeschlossen war.