4.1.3. Konfigurationsdaten – BoltLengthCalculation.json

Die Schraubenberechnungs-Engine liest ihre Regeln aus der Datei „BoltLengthCalculation.json“, die sich im Ordner „Resources“ des Add-Ins. Diese Datei enthält sechs Abschnitte:

Für die komfortable Bearbeitung der Konfiguration steht der Befehl „Daten laden“ zur Verfügung (siehe Abschnitt 4.1). Dieser importiert eine Excel-Arbeitsmappe (.xlsx), in der jeder der oben genannten Abschnitte als eigene tab abgebildet ist. Auf diese Weise lassen sich alle Werte in einer vertrauten Tabellenkalkulationsumgebung pflegen, bevor sie in das interne JSON-Format überführt werden. Detaillierte JSON-Struktur der Einstellungen des Abschnitts „Formula“

Abschnitt „Formula“

Der Abschnitt „Formel“ definiert die Nachschlage-Regeln, die jeden Schraubensatz einer Berechnungsformel zuordnen. Jede Zeile stellt eine Regel dar und enthält die folgenden Spalten:

Standardmäßige End-Codes sind FL (Flansch), WF (Wafer) und LUG (Lug-Typ-Ventil mit Gewindesacklöchern). Darüber hinaus können beliebige projektspezifische End-Codes als zusätzliche Zeilen ergänzt werden, um individuelle Verbindungstypen abzubilden.

Hinweis zu den Multiplikator-Spalten: Die nachfolgenden Multiplikator-Spalten (VALVE, STUBEND, FLANGE, NUT, WASHER, ADDITIONAL) geben jeweils an, wie häufig der zugehörige Beitrag pro Verbindung. Ein Wert von 0 bedeutet, dass der Beitrag nicht berücksichtigt wird; ein Wert von 1 oder höher bedeutet n-fache Berücksichtigung. Bei einer Wafer-Verbindung (WF) liegt nur eine Verbindung vor; entsprechend wird die Bauteillänge bzw. Flanschdicke einmalig einbezogen.

Verhalten bei fehlenden Bauteilen: Ist ein in der Formel referenziertes Bauteil an einer konkreten Verbindung nicht vorhanden (z. B. ein Anschweißbund über die Spalte STUBEND), wird kein Fehler ausgelöst. Der entsprechende Beitrag entfällt einfach in der Summe. So bleibt dieselbe Formel-Zeile für unterschiedliche Verbindungsvarianten verwendbar.

Spalte	Beschreibung
DN	Nennweite des Schraubensatzes (numerisch, in mm). Wird verwendet, um die Nennweite des Schraubverbinders abzugleichen.
ENDTYPE	Anschlussart (z. B. `FL` für Flansch, `WF` für Wafer). Wird an die Hauptanschlussbedingungen des Schraubverbinders angepasst.
STANDARD	Konstruktionsstandardfilter (z. B. `API 600`). Wenn angegeben, gilt die Regel nur für Schraubensätze, die an Ventile mit einer passenden DesignStd-Eigenschaft angeschlossen sind. Wenn leer, gilt die Regel unabhängig vom Standard.
WAFERTYPE	Auf `TRUE` setzen für Wafer-Typ-Verbindungen (Durchgangsschrauben). Wafer-Schrauben überspannen sowohl die Flansche als auch den Ventilkörper und werden mit einer speziellen Aggregationsmethode berechnet.
THREAD_DEEP	Zusätzliche Einschraubtiefe (mm), die zur Schraubenlänge hinzugerechnet wird.
QUANTITY	Anzahl der Schrauben im Satz. Wenn dieser Wert größer als 0 ist, aktualisiert er die Eigenschaft `„NumberInSet“` der Schraube.
VALVE	Multiplikator für die Ventile. Wenn ein Wert größer als 0 eingestellt ist, wird `die Flanschdicke (bei FL)/die Ventillänge (bei WF)` des angeschlossenen Ventils in die Berechnung einbezogen und mit diesem Faktor multipliziert.
STUBEND	Multiplikator für den Anschweißbund. Ist dieser Wert größer als 0, wird `der Flanschversatz` des angeschlossenen Anschweißbunds mit diesem Faktor multipliziert.
FLANGE	Multiplikator für den Flansch. `Die Flanschdicke` des angeschlossenen Flansches wird mit diesem Faktor multipliziert und zur Schraubenlänge addiert.
NUT	Anzahl der Muttern. Die Mutternstärke (aus der Muttern-Tabelle) wird mit diesem Wert multipliziert.
WASHER	Anzahl der Unterlegscheiben. Die Dicke der Unterlegscheibe (aus der Tabelle „Washer“) wird mit diesem Wert multipliziert.
ADDITIONAL	Anzahl der zusätzlichen Längenelemente. Der Wert für die zusätzliche Länge (aus der Tabelle „AdditionalLength“) wird mit diesem Faktor multipliziert.
ROUND	Rundungsrichtung: `UP` rundet auf die nächstgrößere Standardlänge; `DOWN` rundet auf die vorherige kleinere Standardlänge.
SIZE_DESCRIPTION	Vorlage für die Eigenschaft `„PartSizeLongDesc`“. Verwenden Sie `&&&` als Platzhalter für die Schraubengröße und `@@@` als Platzhalter für die Schraubenlänge. Beispiel: `Sechskantschraube &&& x @@@`
FAMILY_DESCRIPTION	Vorlage für die Eigenschaft `„PartFamilyLongDesc`“. Gleiche Platzhalter wie bei SIZE_DESCRIPTION.

Abschnitt „Nut“

Definiert die Mutternstärken nach Schraubengröße und Norm.

Spalte	Beschreibung
Size	Bezeichnung der Schraubengröße (z. B. `M16`, `M20`).
L	Dicke der Mutter in Millimetern.
Standard	Die Schrauben-Norm des Plant 3D Schraubsatz, auf die sich diese Mutternangaben beziehen (abgeglichen mit `BoltCompatibleStd/Schraube nach Norm`).

Abschnitt „Washer“

Definiert die Unterlegscheibendicken nach Schraubengröße und Norm.

Spalte	Beschreibung
Size	Bezeichnung der Schraubengröße.
L	Dicke der Unterlegscheibe in Millimetern.
Standard	Die Schrauben-Norm des Plant 3D Schraubensatz, auf die sich diese Unterlegscheibendaten beziehen.

Abschnitt „AdditionalLength“

Definiert einen zusätzlichen Längenbeitrag pro Schraube (z. B. Überstand der Schraube oder Einpressspiel für Dichtungen).

Spalte	Beschreibung
Size	Bezeichnung der Schraubengröße.
L	Zusätzliche Länge in Millimetern.
Standard	Der Schraubenstandard des Plant 3D Schraubensatz, für den diese zusätzliche Länge gilt.

Abschnitt „RoundLength“

Definiert die gültigen (im Handel erhältlicher) Schraubenlängen für die Rundung.

Spalte	Beschreibung
Size	Bezeichnung der Schraubengröße.
L	Eine gültige Schraubenlänge in Millimetern.

Es werden mehrere Einträge pro Größe erwartet (einer pro verfügbarer Länge). Das System sortiert diese aufsteigend und wählt den passenden Wert entsprechend der Rundungsrichtung aus.

Hinweis zur Erweiterbarkeit: The Nut, Washer, AdditionalLength and RoundLength lassen sich beliebig um zusätzliche Schraubengrößen, Normen und Längen ergänzen. So kann die Berechnung an unterschiedliche projektspezifische Anforderungen angepasst werden – etwa, wenn ein anderer Überstand als die voreingestellten 10 mm gewünscht ist oder wenn weitere Schraubengrößen unterstützt werden sollen.

Abschnitt „ExternalData“

Definiert externe Bauteildaten (insbesondere Flanschdicken und Bauteillängen) für Bauteile, an denen die entsprechenden Eigenschaften nicht direkt im 3D-Modell gepflegt sind. Dies ist beispielsweise bei benutzerdefinierten Bauteilen oder bei Katalogen ohne hinterlegte Flanschdicken-Eigenschaft notwendig.

Jede Zeile ordnet einer beliebigen Plant 3D-Eigenschaft (z. B. PartFamilyLongDesc, PartSizeLongDesc oder ItemCode) in Kombination mit einem konkreten Wert die zugehörige Flanschdicke und – sofern relevant – die Bauteillänge zu. Diese Werte werden bei der Berechnung verwendet, sobald in der Zeichnungsauswahl die Schraubendatenquelle „Aus externen Daten“ ausgewählt ist.

Spalte	Beschreibung
Property	Name der Plant 3D-Eigenschaft, über die die Zuordnung erfolgt (z. B. `PartFamilyLongDesc`).
Value	Konkreter Eigenschaftswert, anhand dessen das Bauteil identifiziert wird.
FlangeThickness	Flanschdicke in Millimetern, die für dieses Bauteil in die Berechnung einfließen soll.
Length	Bauteillänge in Millimetern. Wird vor allem für Wafer-Bauteile benötigt; für reine Flanschverbindungen kann der Wert auf `0` stehen bleiben.

Während der Berechnung sucht das Programm zunächst die externen Daten ab. Findet es einen Eintrag mit passender Property/Value-Kombination am Bauteil, werden die hinterlegten Werte verwendet. Andernfalls wird auf die Bauteileigenschaften aus dem Modell zurückgegriffen.