Datenbank-Attributwert als Dialogtext übernehmen

Wenn in der Datenmaske eines R+I-Symbols Dialogtexte vom Dialogtyp Kommentar oder von benutzerdefinierten Dialogtypen einen Verweis auf ein Datenbankattribut (eines zugeordneten oder zuzuordnenden Bauteils) beinhalten, werden die zugehörigen Attributinhalte in die Dialogtexte übernommen.

Angenommen der Inhalt des Datenbank-Attributes BENENNUNG soll in den ersten Kommentar-Dialog eines Behälter-Symbols übernommen werden. Dann muss dort folgender Dialogtext stehen:

%DBAT(BENENNUNG)

BENENNUNG ist hier der von HELiOS intern verwendete Name des Attributes (d.h. nicht der Aliasname aus den Dialogtyp- und Attributdefinitionen des HiCAD-Moduls R+I-Schemata).

 

Folgende Dialogtexte stehen zur Verfügung:

Beispiel 1:

%% Armatur: %DBAT(BENENNUNG) DN %PIDAT(…) ergibt nach Auswertung z.B. Armatur: Kugelhahn DN 100%% Armatur: %DBAT(BENENNUNG) DN %PIDAT(…).

Beispiel 2:

%DBAT(BENENNUNG) DN %PIDAT(431) ergibt nach Auswertung z.B. Kugelhahn DN 100%DBAT(BENENNUNG) DN %PIDAT(431).

Beispiel 1:

%PIDAT(4)-%COUNT(2:0) ergibt nach Auswertung z.B. B1-01%COUNT(2:1:%COUNTREFTEXT(B1-)).

Beispiel 2:

%PIDAT(4)-%COUNT(2:0:%PIDAT(3)-) ergibt nach Auswertung z.B. B1-01%PIDAT(4)-%COUNT(2:1:%PIDAT(3)-:%COUNTREFTEXT(Dortmund-B1-)).

Beispiel 3:

%PIDAT(4)-%COUNT(%PARENT(%PIDAT(4)):2:0) ergibt nach Auswertung z.B. E1-01%PIDAT(4)-%COUNT(%PARENT(%PIDAT(4)):2:1:%COUNTREFTEXT(B1)).

Bei jeder Art von Ausgabe des Dialogtextes, wird nur der Text vor dem ersten % berücksichtigt. Jede neue Auswertung überschreibt den Text vor dem ersten %.

Nach Auswertung der Generierungsvorschrift besteht der in der Datenmaske gespeicherte Attributtext aus dem durch die Generierungsvorschrift erzeugten Text, gefolgt von der Generierungsvorschrift selbst. Generierungsvorschriften dürfen nur für die Dialogtypen Kommentar und die benutzerdefinierten (Code 500 bis 599) verwendet werden.

Digits:

Anzahl der Stellen für den ausgegebenen Zählwert

Number:

0, wenn der Zählwert ermittelt werden soll, oder der ermittelte Zählwert

Präfix:

Zusätzliche Zeichenkette (kann Schlüsselwörter und festen Text enthalten) zur Bildung der Zeichenkette, auf die sich der Zähler beziehen soll; wird hierzu der Zeichenkette am Anfang hinzugefügt, die vor dem Schlüsselwert %COUNT steht.

Referenz:

Zeichenkette (kann Schlüsselwörter und festen Text enthalten), auf die sich der Zähler beziehen soll; die Vorschrift, die vor %COUNT steht, wird vom Zähler nicht verwendet.

Für die verschiedenen Symboltypen sind die folgenden Schlüsselwörter möglich:

 

%PCLDBAT(…)

%DBAT(…)

%PIDAT(…)

%FRAME(…)

%PARENT(…)

%DMO (...)

%COUNT

 

%COUNTREFTEXT

Rohrleitung

Ja

Ja

Ja

Ja

Nein

Ja

Ja

Nein

Rohrteil

Ja

Ja

Ja

Ja

Ja

Ja

Ja

Nein

Allgemeiner Typ

Nein

Ja

Ja

Ja

Ja

Ja

Ja

Nein

Schriftfeld

Nein

Nein

Ja

Nein

Nein

Ja

Ja

Nein

Abbruchzeichen

Nein

Nein

Ja

Ja

Nein

Ja

Ja

Nein

Datenmaskenobjekt

Nein

Nein

Ja

Nein

Nein

Nein

Ja

Nein

Matrix für Verschachtelung verschiedenen Schlüsselwörter:

%A\%B *

%PCLDBAT(…)

%DBAT(…)

%PIDAT(…)

%FRAME(…)

%PARENT(…)

%DMO (...)

%COUNT

 

%COUNTREFTEXT

%PCLDBAT

/

Nein

Nein

Nein

Nein

Nein

Nein

Nein

%DBAT

Nein

/

Nein

Nein

Nein

Nein

Nein

Nein

%PIDAT

Nein

Nein

/

Nein

Nein

Nein

Nein

Nein

%FRAME

Nein

Nein

Ja

/

Nein

Nein

Nein

Nein

%PARENT

Ja

Ja

Ja

Nein

/

Nein

Nein

Nein

%DMO

Nein

Nein

Ja

Nein

Nein

/

Nein

Nein

%COUNT

Ja

Ja

Ja

Ja

Ja

Ja

/

Ja

%COUNTREFTEXT

Nein

Nein

Nein

Nein

Nein

Nein

Nein

/

*Schlüsselwort %A schachtelt %B bedeutet: %A(…%B(…)…) ist möglich

 

Beispiel:

%PARENT(%FRAME(%DMO(D1:%PARENT(%PIDAT(9))))) ist eine sinnvolle Generierungsvorschrift.


Symbol editieren

R+I-Schema > Symbol > Symbol editieren

  1. Aktivieren Sie erst die Funktion und dann das Symbol aus dem geladenen Projekt.
  1. Mit einem Rechtsklick im entsprechenden Eingabefeld erhalten Sie das Kontextmenü. Wählen Sie darin die Funktion Dialogtyp/Attribut.
  1. Aus der nun angezeigten Liste wählen Sie das gewünschte Attribut mit einem Doppelklick aus (oder mit Markieren und OK).

Die Liste zeigt die in den Dialogtyp- und Attributdefinitionen zugeordneten Aliasnamen der Datenbankattribute.

Dialogtyp

Wenn dem Symbol ein Bauteil zugeordnet ist, wird der zugehörige Attributwert aus den Artikelstamm dieses Bauteils automatisch als Dialogtext übernommen.

Hier im Beispiel besteht der Attributwert aus dem Text Beispielbehälter 2.

Wenn es zu dem Dialogtyp, zu dem der Datenbankverweis gehört, einen Textplatzhalter in der Symbolgrafik gibt (wie hier beim Dialogtyp Kommentar), erscheint der Attributwert automatisch am Symbol.

Beispiel

 

Beispiel für eine Generierungsvorschrift, die Schlüsselwörter (und statischen Text) enthält

  1. Aktivieren Sie erst die Funktion und dann das Symbol aus dem geladenen Projekt.
  2. Mit einem Rechtsklick im Eingabefeld (z.B. Comment (1)) erhalten Sie das Kontextmenü. Wählen Sie darin die Funktion Dialogtyp/Attribut.

Symbol editieren

Aus der nun angezeigten Liste können Sie einen Dialogtyp Icon, ein Helios-Attribut Icon oder ein Rohrklassenattribut Icon dem ausgewählten Symbol zuweisen.

Durch einen Doppelklick auf einen Dialogtyp Icon wird eine Generierungsvorschrift z.B. %PIDAT(4) in das Eingabefeld von Comment (1) eingetragen.

Durch einen Doppelklick auf ein Attribut Icon wird eine Generierungsvorschrift z.B. %DBAT(BENENNUNG) in das Eingabefeld von Comment (1) eingetragen.

Durch einen Doppelklick auf ein Rohrklassenattribut Icon wird eine Generierungsvorschrift z.B. %DBPCLAT(BENENNUNG) in das Eingabefeld von Comment (1) eingetragen.

Nach weiterer Bestätigung wird dieser Generierungsausdruck automatisch ausgewertet und ggf. als Grafik gezeichnet.

 

Schriftfeldsymbol Icon

Durch einen Doppelklick auf SchriftfeldsymbolIcon wird ein neues Dialogfenster geöffnet:

Hier können Sie nur den Dialogtyp Icon für das Schriftfeld auswählen z.B. %FRAME(%PIDAT(4)).

 

Übergeordnetes Symbol Icon

Durch einen Doppelklick auf Übergeordnetes SymbolIcon wird ein neues Dialogfenster geöffnet:

Hier können Sie einen Dialogtyp Icon, ein HELiOS-Attribut Icon oder ein Rohrklassenattribut Icon vom übergeordneten Symbol auswählen.

Durch einen Doppelklick auf einen Dialogtyp Icon wird eine Generierungsvorschrift z.B. %PARENT(%PIDAT(4)) in das Eingabefeld von Comment (1) eingetragen.

Durch einen Doppelklick auf ein Attribut Icon wird eine Generierungsvorschrift z.B. %PARENT(%DBAT(BENENNUNG)) in das Eingabefeld von Comment (1) eingetragen.

Durch einen Doppelklick auf ein Rohrklassenattribut Icon wird eine Generierungsvorschrift z.B. %PARENT(%DBPCLAT(BENENNUNG)) in das Eingabefeld von Comment (1) eingetragen.

 

Datenmaskenobjekt (DMO) Icon

Durch einen Doppelklick auf das Datenmaskenobjekt (DMO) Icon wird ein neues Dialogfenster geöffnet:

Datenbankattribute

Hier können Sie nur den Dialogtyp Icon für das DMO auswählen z.B. %FRAME(%PIDAT(4)).

Durch einen Doppelklick auf einen Dialogtyp Icon wird eine Generierungsvorschrift z.B. %DMO(D1:%PIDAT(4)) in das Eingabefeld von Comment (1) eingetragen.

Nach weiterer Bestätigung wird dieser Generierungsausdruck automatisch ausgewertet.

 

Hinweis:

Die Generierungsvorschriften sind auch bei der Funktion Mehrere Symbole editieren verwendbar, allerdings müssen Sie den Schlüssel manuell eintragen.

 

Konfigurierbare Zähler Icon

Durch einen Doppelklick auf Konfigurierbare ZählerIcon wird ein Dialogfenster geöffnet:

Konfigurierbare Zähler

Wählen Sie bei Zuordnung den Bezug des Zählers aus. Je nach Auswähl verändert sich das Dialogfenster.

Referenz-Text, Präfix-Text, Digits: Siehe oben die Syntax von %COUNT(…). In Kontext-Menü von Referenz-Text oder Präfix-Text ist der Eintrag Dialogtyp/Attribut zu finden:

Konfigurierbare Zähler

Hier können Sie einen Generierungsausdruck für Präfix- oder Referenz-Text vom Zähler einbauen. Nach der Bestätigung wird der Text ins Textfeld eingetragen. Digits ist von 1 bis 9 einstellbar. Klicken Sie auf Vorschau, so wird der Zähler im Readonly-Textfeld angezeigt. Mit einem Klick auf den Button Hilfe rufen Sie die Hicad-Online-Hilfe auf.

Konfigurierbare Zähler

Nach der Bestätigung mit OK wird der Generierungsausdruck mit Zähler z.B. %COUNT(6:0:%DMO(D2:%PIDAT(4))) im Eingabefeld des Dialogtextes angezeigt.

Nach einer weiteren Bestätigung wird dieser Generierungsausdruck mit Zähler automatisch ausgewertet und ggf. als Grafik gezeichnet.

Mit der Option Durch Vorschrift generieren kann die Anzahl der Stellen des Textschlüssel %XDIGITS bestimmt werden. Aktivieren Sie nach der Auswahl die Option Generieren. Im Kontextmenü des Eingabefeldes können Sie dann Dialogtyp/Attribut wählen und eine gewünschte Vorschrift einbauen.

Bestätigen Sie mit OK, dann wird die Vorschrift (z.B. %PIDAT(9)) angezeigt.

Weitere Textschlüssel rufen Sie im Kontextmenü Dialogtyp/Attribut mit der Option Andere Schlüsselwörter Icon auf.

z.B. %FIRST(%PIDAT(6):%PIDAT(3201):%PIDAT(3204))

z.B. %PREPOST(%PIDAT(6):%PIDAT(3201):%PIDAT(3207))

 

Den Generierungsausdruck mit Zähler (Konfigurierbare Zähler) können Sie auch einsetzen:


Maske bearbeiten

R+I-Symbol > Dialogtexte > Datenmaske

Sie können die Zuordnung eines Datenbank-Attributes zum einem Dialogtyp in der Symboldatenmaske eines Symbols bereits bei seiner Erstellung oder Bearbeitung im R+I-Symbol-Editor festlegen. Damit erreichen Sie, dass das Symbol, sobald es im R+I-Schema eingefügt worden ist und eine Bauteilzuordnung erhalten hat, automatisch den Attributwert übernimmt, der dem Verweis entspricht.

Geben Sie den Verweis, wie oben gezeigt, in die Spalte Default-Dialogtext des entsprechenden Dialogtyps ein. Sie können dem Verweis einen Text voranstellen (hier DB-Attribute) damit Sie in der Grafik des Symbols bereits am Textplatzhalter erkennen können, dass dort ein Attributwert übernommen werden soll. Bei der Auswertung des Verweises im R+I-Schema wird dieser vorangestellte Text gelöscht.

Symbol (R+I)Verwaltung von konfigurierbaren allgemeinen Datenmasken in Datenmaskenobjekten (R+I)