> For the complete documentation index, see [llms.txt](https://help.auxalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.auxalia.com/plant-tools/de/plantexpresstools/how-to-use/rule-based-block-insert/setup.md).
# Einrichtung
In diesem Kapitel wird erläutert, wie die regelbasierte Blockeinfügung eingerichtet wird, bevor Sie sie zum automatischen Einfügen von Blöcken verwenden können.
Diese Funktion ist mit PlantProjectCreate verknüpft. Auch wenn Sie es nicht verwenden, müssen Sie es einrichten. Details finden Sie unter: [Setup](/plant-tools/de/plantexpresstools/how-to-use/update-selection-lists/setup.md).
### Einführung
Das folgende Bild zeigt den Arbeitsablauf dieser Funktion. Die Konfiguration von Rule-Based Block Insert ist in PlantProjectSetup als Teil von PlantExpressTools integriert und somit ein Plugin in Plant 3D (1).
Um die regelbasierte Blockeinfügung einzurichten, benötigen Sie den Ordner, in dem sich Ihre Blöcke befinden (4), die Projektvorlage (2), die auch in PlantProjectCreate verwendet wird, und die Projektdatenvorlage (3). Die Einrichtung der Regeln wird dann in der Rules.xml (5) gespeichert.
Um Ihnen einen Kontext zu geben, zeigt Ihnen das nächste Bild, was wir später für die Zeichnung PID 001 (Blatt 01) sehen werden. Sie sehen die Blocknamen, die wir später verwenden werden.
Auf der zweiten Zeichnung PID 002 (Blatt 02) sehen wir nur diesen einen Block.
### Vorlagendatei
Die Template-Datei wird im Detail unter [Setup](https://github.com/auxalia-GmbH/ax-end-user-doc/blob/master/docs/Plant-Tools/de/plantexpresstools/how-to-use/rule-based-block-insert/pet_htu_ppc_setup.htm#pet_ppc_setup_templatefile) beschrieben. Für die regelbasierte Blockeinfügung wird es auch benötigt, um die Zeichnungsblattnummer aus der Datei zu erhalten, in die ein Block eingefügt werden soll.
### Projektdaten-Vorlagendatei
Die zweite Datei, die Sie benötigen, ist die Projektdatenvorlagendatei. Sie können XLSX, XLS, CSV oder TXT verwenden.
Die Projektdatenvorlagendatei benötigt nur zwei Spalten. Name und Wert. Name enthält alle „Variablen“, die Sie später in den Regeln verwenden möchten, und Werte enthalten die Werte, die das Ergebnis der Regeln steuern.
Zum Einrichten der Regeln müssen Sie alle Namen hinzufügen, die Sie später zum Einrichten der Regeln verwenden möchten. Die Werte können leer sein. Sie werden erst dann notwendig, wenn Sie die Blöcke später nach den von Ihnen definierten Regeln einfügen lassen. Sie können natürlich einige Werte eingeben, um sich daran zu erinnern, welche Art von Wert Sie für einen bestimmten Namen benötigen. Möglicherweise möchten Sie sogar eine dritte Spalte (vielleicht Kommentare) hinzufügen, in der Sie einige Informationen zum Namen hinzufügen.
### Blockordner
Zuletzt benötigen Sie einen Ordner, in dem Sie Ihre Blöcke/DWGs speichern. Dieser Ordner kann auch eine Unterordnerstruktur haben. Bei den DWGs handelt es sich typischerweise um P\&ID-Zeichnungen mit P\&D-Objekten (Symbole und Linien), die mit dem Befehl WBLOCK als Blöcke gespeichert wurden.
Hier sind die Beispiele aus dem Hauptordner.
Wie Sie sehen, sind Sie in der Ordnerstrukturtiefe und -benennung sowie den DWG-Dateinamen völlig frei.
### Regelbasierte Blockeinfügungseinrichtung
Stellen Sie sicher, dass Sie ein Projekt mit den Zeichnungseigenschaften geladen haben, die Sie für PlantProjectCreate verwendet haben, da wir später die Zeichnungseigenschaft auswählen müssen, die die Blattnummer enthält. Wenn Sie ein Projekt geöffnet haben, das diese Eigenschaft nicht hat, können Sie die Regeln nicht definieren.
Selbstverständlich kann die Immobilie auch einen anderen Namen haben. Es muss lediglich eine Eigenschaft sein, die die Blattnummer enthält.
Sie starten die Einrichtung des regelbasierten Blockeinschubs ab PlantProjectManager, indem Sie PlantProjectSetup öffnen.
Sie wählen den Knoten „Regelbasierte Blöcke“ aus.
Zuerst müssen Sie einen Pfad auswählen, unter dem die Datei Rules.xml erstellt wird. Diese Datei enthält die Regeln, die Sie definieren möchten. Normalerweise handelt es sich um ein Netzlaufwerk. Sie können einen Ordner per Drag & Drop in das Textfeld einfügen.
Die „Zeichnungseigenschaft“ wird standardmäßig auf „DWG-Nummer“ eingestellt, aber wir werden dies später ändern.
Als nächstes wählen Sie Ihren Ordner mit den Blöcken aus.
Sie sehen sofort die Ordnerstruktur und DWGs unter dem ausgewählten Ordner. Sie können wieder Drag & Drop verwenden.
Als nächstes wählen Sie Ihre Projektdatenvorlage aus, die die Namen der benötigten Variablen enthält.
Sie können Drag & Drop verwenden.
Wir müssen das Spaltenfeld und den Spaltenwert auswählen.
Wenn Sie die Dropdown-Liste verwenden, werden die beiden Spalten der Projektdatenvorlage angezeigt. „Spaltenfeld“ enthält die Variablen- oder Feldnamen, die wir für die Regeln verwenden möchten. „Spaltenwert“ sind die Spalten, die die Werte enthalten.
So sieht es aus, wenn beide ausgewählt wurden.
Nun wählen wir die Template-Datei aus, die auch von PlantProjectCreate ([Setup](https://github.com/auxalia-GmbH/ax-end-user-doc/blob/master/docs/Plant-Tools/de/plantexpresstools/how-to-use/rule-based-block-insert/pet_htu_ppc_setup.htm#pet_ppc_setup_templatefile)) verwendet wurde.
Hier eine Erinnerung zum Inhalt. Die Spalten „Blattnummer“ benötigen wir später für die Regeln.
Sie können wieder Drag & Drop verwenden.
Wir wählen die Spalte „Blatt-Nr.“ aus der Datei und „Blatt“ aus der Liste der Zeichnungseigenschaften aus.
Nun können wir mit der Definition der ersten Regel beginnen.
Dies funktioniert so, dass Sie eine oder mehrere Regeln für einen Block definieren können. Wenn Sie einen Block zweimal benötigen (entweder in einer Zeichnung oder in zwei verschiedenen Zeichnungen), definieren Sie einfach zwei Regeln.
Beginnen wir mit dem Hauptblock und klicken Sie auf „Hinzufügen“, um eine Regel hinzuzufügen.
Sobald Sie dies getan haben, wird ein Standardregelname erstellt (hier Regel 1), der jederzeit bearbeitet werden kann (grüner Pfeil).
Wir empfehlen, das Tutorial von DevExpress durchzulesen, um mehr über die Verwendung des \[Filtereditors] () zu erfahren.
Wir beginnen mit einem Klick auf das grüne Pluszeichen.
Dadurch wird automatisch eine erste Zeile erstellt.
Wenn Sie auf „Ventiltyp“ klicken, werden alle Namen angezeigt, die Sie in der Projektdatenvorlagendatei definiert haben.
Als nächstes können Sie die Bedingung auswählen. Für unser Beispiel verwenden wir „Contains“.
Als Wert geben wir „Ball“ ein.
Diese ganze Zeile bedeutet, dass dieser Block eingefügt wird, wenn „Ball“ in „Valve Type“ steht.
Unten haben wir die Option „Bearbeiten zulassen“. Dies bedeutet, dass Sie die Einstellungen später ändern können. Wenn Sie den Benutzer dazu zwingen möchten, keine Änderungen vorzunehmen, deaktivieren Sie dieses Kontrollkästchen.
Die Option „Explode“ löst den Block nach dem Einfügen auf. Dies ist normalerweise das, was Sie aktivieren möchten, damit Sie die Blöcke nicht selbst auflösen müssen, um die PID-Symbole und Zeilen innerhalb des vorherigen Blocks bearbeiten zu können.
Mit der Priorität können Sie die Reihenfolge der eingefügten Blöcke steuern. Dies ist wichtig, wenn ein zweiter Block über einen anderen eingefügt werden soll. Die folgenden drei Bilder zeigen:
1. Auf der linken Seite sehen Sie, wie der Block aussieht
2.In der Mitte sehen Sie, wie der Block aussieht, wenn er ohne die Option „Explodieren“ in einen anderen Block eingefügt wird.
3. Rechts sieht es aus, wenn der Block von links mit aktivierter „Explode“-Funktion eingefügt wird. Sie sehen, dass das zugrunde liegende Liniensegment unterbrochen wird. Und um dies zu erreichen, ist die Priorität wichtig, wenn ein zweiter Block „über“ einem anderen eingefügt werden soll.
  
Mit den beiden Offsetwerten kann der eingefügte Block mit einem Offset in X und Y eingefügt werden.
Die Blöcke in diesem Beispiel werden alle bei 0,0 eingefügt, da sie an der Stelle erstellt wurden, an der sie später platziert werden sollen.
Schließlich können Sie über die Auswahl der Seite festlegen, auf welcher Seite/Zeichnung der Block eingefügt werden soll.
Dies ist das Endergebnis der Einstellungen für die erste Regel.
Für komplexere Filterausdrücke können Sie auch in den Textmodus wechseln, in dem Sie den Ausdruck auf andere Weise sehen. Auch hier ist eine Bearbeitung möglich.
Die Ausdrücke und Einstellungen der zweiten Regel können hier eingesehen werden.
Die dritte Regel bekommt eigentlich keinen Ausdruck, da dieser Block auf jeden Fall eingefügt werden soll.
Die vierte Regel gilt ebenfalls, aber dieser Block soll auf Blatt 02 eingefügt werden. Also wählen wir dies unter Seite aus.
Die nächste Regel benötigt zwei Bedingungen. Das erste ist, dass wir es bereits wissen. Doch dann klicken wir erneut auf das grüne Pluszeichen.
Und so sieht die zweite Bedingung aus.
Im Textmodus sieht es so aus. Diesmal kopieren wir den Ausdruck aus dem Textmodusfenster.
Und nun erstellen Sie eine weitere Regel, wechseln Sie in den Textmodus ...
... und fügen Sie den Ausdruck in das Fenster ein.
Nun wechseln wir zurück in den visuellen Modus.
Und ändern Sie den Ausdruck, indem Sie Ball durch Globe ersetzen.
Die letzte Regel gilt für den Venturi-Block. Hier setzen wir die Priorität auf 2, da dieser nach den anderen Blöcken eingefügt werden soll.
### Aktualisieren
Die Schaltfläche „Aktualisieren“ dient zwei Zwecken. Es prüft, ob nicht gespeicherte Änderungen vorhanden sind. Wenn dies der Fall ist, werden Sie in einem Dialog gefragt, ob Sie die Änderungen speichern möchten.
Der zweite Zweck besteht darin, die Datei Rules.xml neu zu laden, falls Sie die Datei extern geändert haben (siehe [Rules.xml)](/plant-tools/de/plantexpresstools/how-to-use/rule-based-block-insert/rulesxml.md). In diesem Fall weichen die aktuell in der Baumstruktur angezeigten Regeln vom Inhalt in der Datei „Rules.xml“ ab und Sie werden außerdem gefragt, ob Sie die Änderungen (die derzeit in der Baumstruktur angezeigten) speichern möchten. In diesem Fall verwenden Sie wahrscheinlich Nein, da sonst Ihre manuell vorgenommenen Änderungen in der Rules.xml einfach mit dem überschrieben werden, was sich in Ihrem Baum befindet.
### Filtern
Mithilfe der Filterung kann der Baum gefunden und gefiltert werden. Dies funktioniert auf allen Knoten im Baum. Es reicht aus, einfach mit der Eingabe zu beginnen und die Filterung beginnt automatisch.
Es kann tatsächlich sinnvoll sein, einen festen Text im Namen der Regel zu haben. Lassen Sie beispielsweise alle Ihre Regeln mit „Regel“ und etwas zusätzlichem Text beginnen.
### Regeln kopieren
Regeln können auch mit der Schaltfläche „Kopieren“ kopiert werden. Wählen Sie die Regel aus, die Sie kopieren möchten, und klicken Sie dann auf die Schaltfläche.
Dadurch wird eine Kopie erstellt, die Sie dann umbenennen können.
### Regeln löschen
Mit der Schaltfläche „Löschen“ können Sie eine Regel auch löschen, indem Sie zunächst auf die Regel klicken, die Sie löschen möchten, und dann auf die Schaltfläche „Löschen“ klicken.
