Einbindung von Attributen

Für die Einbindung von Attributen muss die Attribut-ID (aid) des gewünschten Attributes bekannt sein.

Die Attribut-ID kann in den Objekteigenschaften, den Attributeigenschaften angezeigt oder auch in der Listenansicht aller Attribute eingeblendet werden.

Schlüsselkennung A

Einfacher Attributzugriff (skalare Attribute)

Syntax:

A  [<modif>] ["<Präfix>"]  (< aid > | <("<Data Service>")> | < fixaid>) ["<Postfix>"]

[s [[ a | d | f"<Dezimaltrennzeichen>" | "<sep>"] :<posEl>[:"<Standardwert>"] ]

 [  (  [ <numchar> [:<poschar>] ]  [ [<Präfix F>] "<Feld­format>" ]  )  ];

modif

Selektor für spezielle vordefinierte Attribute

F

AF ["<Präfix>"] aid ["<Postfix>"]  (<Wert>);

Test, ob an dem angegebenen Attribut Flags (manuell, automatisch, …) gesetzt sind.

Ergebnis:

1 oder Präfix, wenn das Flag gesetzt ist.

0 oder Postfix, wenn das Flag nicht gesetzt ist.

Wert

Kennnummer des Flags

4 =  Der Attributwert ist leer

256 = manuell eingetragener Wert

1024 = Attributwert aus Katalog

2048 = Translate-Text vorhanden

8192 = Attribut ist schreibgeschützt

f

Afaid;

Der Attributwert wird nicht nach den Kürzungsregeln gekürzt.

j

Ajaid;

Zugriff auf Attribute des Projektes; das Projektobjekt wird zum aktuellen Objekt.

J

AJaid;

Zugriff auf Attribute des Projektes; das aktuelle Objekt bleibt unverändert.

C.1

C.2

C.3

AC.1aid;, AC.2aid;, AC.3aid;

Zugehörige Kommentarattribute

Präfix /

Postfix

Zeichenfolge, die im Falle eines nicht-leeren Attributwertes vor bzw. nach dem Attributwert eingefügt wird.

aid

Attributreferenz (numerisch oder vordefinierte C).

fixaid

Attributreferenz vordefiniert.

r

Ar;

Klassischer Referenzbezeichner des Objektes (mit Teil von..).

R

AR;

Referenzbezeichner des Objektes mit Pfadausdruck (mit Ordner).

o oder 1

Ao; oder A1;

Objekt-ID des Objektes.

c oder 2

Ac; oder A2;

Cover-ID des Objektes.

t

At; oder A4;

Typ-ID des Objektes.

Data Service

Attributreferenz mit Datenservice-Eintrag

Statt der aid wird der Datenservice-Eintrag am Attribut verwendet. Dadurch können Attribute unabhängig von ihrer Attribut-ID in unterschiedlichen Datenbanken verwendet werden.

s

Funktion zum Trennen von Text

a

Auftrennen des Texts nach Textblöcken. Ein Textblock kann alle Zeichen, außer Ziffern enthalten.

d

Auftrennen von Texten nach Ganzzahlen-Blöcken.

f

Auftrennen von Text nach Dezimalzahlen.

Das Dezimaltrennzeichen muss in "" angegeben werden. Jede Dezimalzahl entspricht einem Block.

sep

Auftrennen des Texts anhand eines Zeichens, das in "" angegeben werden muss. Dies ermöglicht z. B. das Auftrennen von Text, der durch Semikolon getrennt ist.

posEl

Gibt an, welcher Block ausgegeben werden soll.

  • 0  alle gefundenen Blöcke werden hintereinander ausgegeben.
    Dieser Wert ist bei Fließkommazahlen nicht gültig.
  •  >0  Startpunkt von links ausgehend
    :1  der erste Block wird ausgegeben
  • <0  Startpunkt von rechts ausgehend
    :-1  der letzte Block wird ausgegeben

Standardwert

Zeichenfolge in "", die ausgegeben werden soll, wenn das Ergebnis leer wäre.

numchar

Anzahl der Zeichen, die aus dem ermittelten Wert des Formelattributs angezeigt werden sollen (>0 vom Anfang; <0 vom Ende beginnend).

poschar

Zeichenposition, nach der zu beginnen ist (>0 vom Anfang; <0 vom Ende beginnend).

Bei negativem numchar und positivem oder leeren poschar werden die letzten Zeichen (Anzahl=numchar) angezeigt.

Feldformat

Spezifiziert die exakte Zeichenfolgenlänge, inklusive einzufügender Ersatzzeichen.

Für Präfix F = „-“, „e“ und „f“ ergibt sich eine andere Bedeutung (siehe unten).

Dimensionsattribute:

Eine besondere Bedeutung hat das <Feldformat> für Dimensionsattribute.
Hiermit kann bestimmt werden, welche Elemente (Wert, Einheit) und wie sie dargestellt wer­den.
Als vordefinierte Elementverweise gibt es:

$Ux

Einheit (Unit)

$UOx: Erzwingt die Darstellung angehängter Nullen.

$Uox: Unterdrückt die Darstellung angehängter Nullen, sofern diese am Ziel konfiguriert sind.

Zeigt bei Dimensionsattributen die Einheit an.

Für die Konvertierung von Einheiten steht @...@ zur Verfügung.
Folgende Ausprägungen sind möglich:

  • $Ux@Einheit@ - die gewünschte Einheit wird direkt eingetragen.
  • $Ux@aid@ - die Einheit wird aus dem Eintrag des Projekt-Attributs mit der ID=aid ermittelt.
  • $Ux@!aid@ - für die Ermittlung der Einheit wird das Objekt verwendet, auf dem die Formel ausgewertet wird.
    Die Einheit wird also aus dem Eintrag des Objekt-Attributs mit der ID=aid ermittelt.
  • $Ux@datenservice@ - die Einheit wird aus dem Eintrag des Attributs ermittelt, das im Attribut Datenservice den Wert „datenservice“ enthält.

wobei x:

0

Wertekonvertierung in eine angegebene Einheit

Die gewünschte Einheit wird wie folgt festgelegt:

  • $U0@mm@ - direkte Eingabe der Einheit, hier „mm“.
  • $U0@aid@ - die Einheit wird aus dem Eintrag im Projekt-Attribut aid ermittelt.
  • @$U0datenservice@ - die Einheit wird aus dem Eintrag des Projekt-Attributs mit dem Datenservice-Eintrag „datenservice“ ermittelt.

Eine besondere Bedeutung hat die Verwendung von „@..@“ bei den Einheiten­selektoren ungleich 0.
Ergäbe die Konvertierung des Zahlenwertes in der durch die Ziffer ausgewählten Einheit einen Text, der nur aus Nullen besteht, so wird stattdessen in die Einheit des „@..@“ konvertiert.

1

num. Basis

2

num. Basis - nicht dargestellt

3

Darstellungseinheit in der Grafik

4

Darstellungseinheit in der Grafik - nicht dargestellt

5

Eingabedefault

6

Eingabedefault - nicht dargestellt

7

Toggle zwischen Gage und Non-Gage Wertedarstellung.

Gilt nur bei Attributen mit den Einheiten bar und bar(G).

8

Toggle zwischen Gage und Non-Gage Wertedarstellung – nicht dargestellte Einheit.

Gilt nur bei Attributen mit den Einheiten bar und bar(G).

9

Anzeige im Eingabeformat (‚raw‘)

$V 

Wert (Value)

Zeigt bei Dimensionsattributen den Zahlenwert an.

%

Wert (analog der Definition im Kapitel Formatierung der Ausgabe; bei Vorhandensein von $V wird ein % ignoriert).

Präfix F

Präfix für Feldformat.

-'0

Führende Nullen werden gestrichen.

-

Die Zeichen in „Feldformat“ werden aus dem Wert des Formelattributes gestrichen.

e

„Feldformat“ wird nur genutzt, wenn der Wert des Formelattributes nicht leer ist.

f

„Feldformat“ wird als c-konformer Formatstring interpretiert und kann formatiert werden.

 

Beispiele für Formeln mit Attributen

Formel

Wert des Formelattributes (Zeichenfolge)

A"Präfix"aid"Postfix";

Präfix/Postfix = Zeichenfolge, die im Falle eines nicht-leeren Attributwertes vor bzw. nach dem Attributwert eingefügt wird.

Aaid(Anzahl);

Anzeige einer bestimmten Anzahl von Zeichen (>0 vom Anfang; <0 vom Ende beginnend).

Aaid(n:x);

Anzeige von n Zeichen nach Position x.

Aaid("0000000000")

Anzeige des Attributwerts, Auffüllen mit „0“ auf 10 Zeichen.

Aaid(-n-‘0"--------");

Wert des Attributs, die letzten n Zeichen verwenden, führende Nullen streichen und mit „-“ auf 8 Zeichen auffüllen.

Aaid(n-"Wert");

Wert des Attributs, die ersten n Zeichen verwenden und die Zeichen streichen, die „Wert“ entsprechen.

Aaid(f"%8.2f");

Ausgabe des Attributwerts nach C-Syntax formatiert. Hier Fließkommazahl mit 8 Vorkomma- und 2 Nachkommastellen.

Af5; 

Name des Objekts ohne Kürzung nach den Kürzungsregeln (z. B. gegen das Blatt).

Das Attribut mit der ID= 5 enthält den Objektnamen, er sei hier 00123456.

A5("0000000000"); 

Wert des Attributs mit der ID = 5, Auffüllen mit „0“ auf 10 Zeichen.

„0000123456“

A10212;"-";A10386;"-";A10175;

Werte der aufgeführten Attribute mit „-“ getrennt anzeigen.

Planart-Blattformat-Gezeichnet von

A5(4-'0);

Wert des Attributs mit der ID=5, die ersten 4 Zeichen verwenden und führende Nullen streichen.

„12“.

A5(4-‘0"--------");

Wert des Attributs mit der ID=5, die ersten 4 Zeichen verwenden, führende Nullen streichen und mit „-“ auf 8 Zeichen auffüllen.

„------12“

A5(-4-‘0"--------");

Wert des Attributs mit der ID=5, die letzten 4 Zeichen verwenden, führende Nullen streichen und mit „-“ auf 8 Zeichen auffüllen.

„----3456“

A5(6-"0012");

Wert des Attributs mit der ID=5, die ersten 6 Zeichen verwenden und die Zeichenfolge „0012“ streichen.

„34“

A5(3:5);

Wert des Attributs mit der ID=5, nach Position 5 werden 3 Zeichen angezeigt.

„456“

A5(-1000:-2);

Wert des Attributs mit der ID=5, die letzten beiden Zeichen werden abgeschnitten, alle davor liegenden Zeichen werden angezeigt.

„01234“

A5(-4);

Wert des Attributs mit der ID=5, die letzten 4 Zeichen werden angezeigt.

„3456“

A5(4);

Wert des Attributs mit der ID=5, die ersten 4 Zeichen werden angezeigt.

„0012“

AF"manuell"5(256);

„manuell“, wenn das Attribut mit der ID = 5 manuell eingetragen wurde.

A"("102875")"(f"%.2f");

Attribut 102875 sei eine Fließkommazahl mit dem Wert -47,1256

„(-47,13)“

Der Wert wird auf 2 Nachkommastellen gerundet.

A102875(f"%0 10.3f");

„-00047,126“

Der Wert wird als 10-stellige Fließkommazahl dargestellt, es werden führende Nullen eingefügt.

A102675(f"%.6d");

Attribut 102675 sei eine Ganzzahl (Integer) mit dem Wert 4711.

„004711“

Das Ergebnis soll 6-stellig sein, es werden daher führende Nullen eingefügt.

Das Attribut mit der ID=25 enthält folgende Zeichenfolge:  WW123.45xx

A25s".":3:"Start";

Der Text im Attribut soll durch das Trennzeichen „.“  in Blöcke aufgetrennt werden.

Es soll der 3. Block angezeigt werden. Gibt es keinen 3. Block, soll der Standardwert „Start“ angezeigt werden.

„Start“

A25sd:0;

Gibt alle Ziffern im Attributs-Text aus.

„12345“

A25sd:1;

Gibt den ersten Block von Ziffern im Attributs-Text aus.

„123“

A25sf".":1;

Gibt die erste Dezimalzahl mit dem Dezimaltrennzeichen „.“ aus.

„123.45“

Das Attribut mit der ID=77 enthält folgende Zeichenfolge:  ww123.45xx22.2zz33.3

A77sf".":3;  oder

A77sf".":-1; 

Gibt die dritte Dezimalzahl mit dem Dezimaltrenner „.“ aus.

Gibt die erste Dezimalzahl von rechts, mit dem Dezimaltrenner „.“ aus.

„33.3“

Dimensionsattribute mit Format

Das Attribut mit der ID=245 enthält folgende Zeichenfolge: 123,45 mm

A245(f"$U  $V");

Darstellung der Dimensionselemente in der Reihenfolge Einheit und Wert, z. B. „mm 123,45“.

A245(f"$U");" z ";A245(f"$V");

oder

A245(f"$U z $V");

Darstellung der einzelnen Dimensionselemente – getrennt durch „ z“  also  „mm z 123,45“

A245(f"$U  %.6f");

Darstellung der Dimensionselemente in der Reihenfolge Einheit und Wert, wobei der Wert in einer speziellen Formatierung ausgegeben werden soll, z. B.  „mm  123,450000“.

A245(f"$V $U0@4711@");

Das Projekt-Attribut A4711 enthält die Einheit „dm“, in die der Attributwert von A245 konvertiert werden soll.

Ergebnis: 1,23

A245(f"$V $U0@4711@");Aj4711;

Das Projekt-Attribut A4711 enthält die Einheit „dm“, in die der Attributwert von A245 konvertiert werden soll. Die Einheit soll zusätzlich angezeigt werden.

Ergebnis: 1,23 dm