FVA-Workbench KnowledgeBase

Die Attribute, in denen Nutzereingaben und Berechnungsergebnisse gespeichert werden, haben folgende Datentypen:

Spezialfall Combo-Attribute

Im Eingabeeditor der FVA-Workbench gibt es an vielen Stellen Drop-Down Listen, bei denen der Anwender aus mehreren Einträgen auswählen kann. Diese Auswahl wird in sogenannten Combo-Attributen gespeichert. Der Datentyp solcher Combo-Attribute kann entweder String, Integer oder Double sein.

Combo-Attribut "Aufteilung Profilverschiebung" im Editor der FVA-Workbench.

Bei Combo-Attributen ist intern eine Werteliste hinterlegt, bei der jedem Wert genau eine Auswahlmöglichkeit zugeordnet ist.

In der Attributübersicht ist ersichtlich, welchem Wert welche Auswahlmöglichkeit entspricht.

setAttr("ratio_X1_X2", stageID, 6, EDAT);

Beispielscript: Combo-Attribut "Aufteilung Profilverschiebung" auf den Wert 6 für "Gleiche Wälzpressung" setzen.

Der Gültigkeitsbereich einer Variablen beschreibt, wo eine Variable innerhalb eines Scripts verfügbar ist und benutzt werden kann.

Variablen in JS sind entweder global oder lokal. Globale Variablen werden über das Schlüsselwort var deklariert. var myVariable = 3.14 Auf globale Variablen kann von jeder Stelle des Scripts aus zugegriffen werden. Dies kann aber schnell zu Fehlern führen, da Variablen doppelt vergeben oder überschrieben werden können.

Lokale Variablen werden über das Schlüsselwort let deklariert. let myVariable = 3.14 Auf lokale Variablen kann nur innerhalb des aktuellen Codeblocks zugegriffen werden.

Beispiel - Variable global deklarieren

 1for(var i=0; i<10; i++){
 2println(i);
    }

Beispiel - Variable lokal deklarieren

1for(let i=0; i<10; i++){
2println(i);
   }

JS bietet eine Reihe von mathematischen Funktionen, die im Scripting der FVA-Workbench angewendet werden können:

Vergleichsoperatoren werden in logischen Anweisungen verwendet, um Gleichheit oder Differenz zwischen Variablen oder Werten zu bestimmen. Logische Operatoren werden benutzt, um zwei oder mehr Bedingungen logisch miteinander zu verketten.

Beispiel - Vergleichs- und logische Operatoren in der Bedingung einer if Anweisung

let age = 17;
let country = "germany";

if(age >= 16 && country == "germany"){
   println("You are allowed to drink beer");
}

Der Schleifenkopf einer for-Schleife enthält eine Zählvariable, eine Fortführungsbedingung sowie eine Anweisung zur Änderung der Zählvariable.

Beispiel - Drehmoment für eine Belastungskomponente von 0 bis 100 in 10er Schritten erhöhen. Nach jeder Erhöhung wird eine Gesamtsystemberechnung durchgeführt.

let gearUnitID = 1;
let forceID = 20;
for (let i = 0; i <= 100; i+=10){
    setAttr("scaled torque", forceID, i, EDAT);
    runCalcMethod("001_SYSTEM_CALCULATION", gearUnitID);
}

Beispiel - Den Namen von jedem Wälzlager im Modell auf dem Scripting-Monitor ausgeben.

let bearings = getCompByType("bearing");
for (let i = 0; i < bearings.length; i++){
    println(getCompProperty(bearings[i], "NAME"));
}

while-Schleife

Die while-Schleife wiederholt Anweisungen, solange die Bedingung am Schleifenbeginn true liefert. Wenn die Bedingung bei der ersten Abfrage nicht true liefert, wird die while-Schleife gar nicht erst ausgeführt.

var i = 0;
while (i < 10) {
   println(i);
   i = i+1;
}

do-while-Schleife

Im Gegensatz zur while-Schleife wird die Schleifenbedingung erst am Ende der Schleife geprüft. Die Schleife wird also mindestens einmal durchlaufen.

var i = 0;
do {
   println(i);
   i = i+1
}while (i < 10);

Die forEach-Schleife führt eine Anweisung für jedes Element in einem Array aus.

Beispiel - Jeden Wert in einem Array mit 3 multiplizieren und auf dem Scripting-Monitor ausgeben.

let array = [2, 4, 5];
array.forEach(function(element){
    println(element * 3);
});

Beispiel - Eingabewert (EDAT) für Anwendungsfaktor ISO 6336 für alle Stirnradstufen auf 1.5 setzen.

let cylindricalStages = getCompByType("cylindrical_mesh"); 

cylindricalStages.forEach(function(element) { 
    setAttr("iso 6336 application factor", element, 1.5, EDAT);
});

Eine if-Anweisung wird ausgeführt, wenn eine Bedingung wahr (true) wird. Ist die Bedingung falsch (false), dann kann über else eine andere Anweisung ausgeführt werden.

Beispiel - Abfrage der Sicherheit gegen Dauerbruch auf einer Kerbstelle und Ausführung unterschiedlichen Anweisungen je nach Wert.

1let gearUnitID = 1;
2let notchID = 64;

3setAttr("gta_switch_iso_6336_2006", gearUnitID, true, EDAT);
4runCalcMethod("001_SYSTEM_CALCULATION", gearUnitID);
5let safety_SD = getAttr("safety_factor_S_D", notchID, RDAT);

6if (safety_SD >= 1.2){
    alert("Success SD = "+safety_SD);
7}else{
    alert("Failure SD = "+safety_SD);
    }

Die switch-Anweisung wird verwendet, um auf verschiedenen Bedingungen basierende Aktionen durchzuführen. Das break-Schlüsselwort beendet die switch-Anweisung und der entsprechende Wert wird zurückgegeben. Das default-Schlüsselwort definiert die Anweisung, die ausgeführt wird, wenn keiner der Werte übereinstimmt.

Beispiel - In Abhängigkeit vom Modul verschiedene Breitenkorrekturwerte setzen

1let gearID = 30;
2let modificationID = 51;
3let module = getAttr("normal module", gearID, EDAT);
4let amount = 0;
5switch (module) {
6    case 1:    amount = 3; break; 
        case 1.5:  amount = 3; break;
        case 2:    amount = 5; break;
        case 2.5:  amount = 8; break; 
        case 3:    amount = 10; break; 
        case 4:    amount = 12; break; 
        case 5:    amount = 15; break; 
        case 6:    amount = 15; break; 
        case 7:    amount = 15; break; 
        case 8:    amount = 20; break; 
        case 10:   amount = 25; break; 
7    default:   alert("No modification amount defined for this module"); break; 
  }
8println("Modification Amount: "+amount+" mym");
9setAttr("sekor_cb_bet", modificationID, amount, EDAT);

Tritt während der Ausführung eines Scriptes ein Fehler (Exception) auf, wird das Script abgebrochen und die Exception wird auf dem Scripting Monitor ausgegeben.

Exception auf dem Scripting Monitor der FVA-Workbench

Die try-catch-Anweisung kann verwendet werden, um Fehler, die während der Laufzeit eines Skripts auftreten, abzufangen, darauf zu reagieren und ggf. das Skript trotz des Fehlers weiter auszuführen.

Dazu wird die Anweisung, in der eine Exception auftreten könnte, von einer try-Anweisung eingerahmt. Wenn eine Ausnahme auftritt, wird die Anweisung in der catch-Anweisung ausgeführt.

Beispiel

In der try-Anweisung wird versucht, eine Berechnung durchzuführen. Die Funktion runCalcMethod() hat als Parameter die Berechnungsmethode und die ID der zu berechnenden Komponente. Nun können zur Laufzeit mehrere Fehler auftreten. Die Methoden-ID oder die Komponenten-ID existieren nicht oder die gewählte Kombination aus beiden kann nicht berechnet werden. Die Exception wird in der catch-Anweisung abgefangen und eine Meldung wird ausgegeben. Das Skript wird dann weiter ausgeführt.

try {
   runCalcMethod(methodID, compID);
}
catch (e) {
    println("Error in the calculation of the component "+compID+" with calculation method "+methodID);
}
println("Script is continued");

Arrays sind Datenstrukturen, bei denen mehrere Werte in einer Variablen gespeichert werden können. Der Zugriff erfolgt über den Index des Elements in eckigen Klammern. Der Index startet bei 0.

let array = [element0, element1, element2];

array[2] liefert das dritte Element der Liste zurück.

Die Länge, also die Anzahl der Elemente, kann über die Methode .length abgefragt werden.

array.length liefert 3 zurück.

Über die Methode array .push(newElement); können dem Array weitere Elemente am Ende hinzugefügt werden.

In der FVA-Workbench können Array Zahlen, Strings sowie Komponenten enthalten .

Beispiel - Zugriff auf Arrays

let array = [2, 4, 5];
let result = array[0] + array[2];
println(result);

Die Addition von 2 Elementen eines Arrays ergibt in diesem Beispiel 7.

Beispiel - Abfragen der Arraylänge

let numbers = [1, 2, 3, 4, 5];

for (var i = 0; i < numbers.length; i++) {
   numbers[i] = numbers[i]*2;
}
println(numbers);

Die for-Schleife wird so oft durchlaufen, wie das Array numbers Elemente besitzt. In jedem Durchlauf wird das aktuelle Element mit dem Wert des Elements * 2 überschrieben. Nach Abschluss der Schleife enthält numbers folgende Elemente: [2, 4, 6, 8, 10]

Beispiel - Einem Array Elemente hinzufügen

let carmakers = ["BMW", "Mercedes", "Audi", "Edsel"];
carmakers.push("VW");
println(carmakers);

Dem Array carmakers wird per .push ein weiteres Element "VW" angefügt. ["BMW", "Mercedes", "Audi", "Edsel", "VW"]

Beispiel - FVA-Workbench-Komponenten in Arrays speichern

let bearings = getCompByType("bearing");

for (i=0; i < bearings.length; i++){
    let catalog_name = getAttr("name", bearings[i], EDAT);
    println(catalog_name);
}

Die Funktion getCompByType() liefert ein Array mit allen Komponenten eines Typs (hier Wälzlager) zurück. In der for-Schleife wird für jedes Element (Lager) des Arrays das Attribut "Katalogname" abgefragt und auf dem Scripting-Monitor ausgegeben.

Für einfache Textformatierungen stehen die inline-Anweisungen Tabulator \t und Zeilenumbruch \n zur Verfügung. Für weitergehende Textformatierungen kann die format() -Funktion verwendet werden. Mehrere Texte (Strings) können einfach über den + Operator zusammengefügt werden.

Abbildung 31. Zeilenumbruch Über \n kann ein Zeilenumbruch erzeugt werden.

Abbildung 32. Tabulator \t rückt den Text um einen Tab ein.

Abbildung 33. Verkettung mehrerer Strings

Mehrere Strings und auch Zahlenwerte können zu einem langen String verkettet werden.

Über das JS-Objekt Date kann das aktuelle Jahr, Monat, Tag, Stunde, Minute, Sekunde und Millisekunden ausgegeben werden. Um das Datum abzufragen, wird eine Variable mit new Date(); initialisiert. Die Abfrage erfolgt dann mittels Punktnotation auf dieser Variable.

Beispiel - Ausgabe des kompletten Datums und des aktuellen Monats auf dem Scripting-Monitor

var today = new Date();
println(JSON.stringify(today));
println(today.getMonth());

Kommentare in JS können verwendet werden, um Code zu erklären und lesbarer zu machen. Es kann auch verwendet werden, um Codeabschnitte temporär auszukommentieren, um bspw. alternativen Code auszuprobieren.

1//Comments can be used to explain the code
    /*
2  Code between /* and */ is not executed
    */