Server-Ports
Für den Aufbau einer WebService-Verbindung zu RFEM und RSTAB muss auf bestimmte Server-Ports zugegriffen werden. Der Bereich der verfügbaren Server-Ports kann in den Programmeinstellungen unter Optionen → Programmoptionen modifiziert werden:
Standardmäßig ist der Serverport-Bereich von 8081 bis 8089 eingestellt. Der niedrigste Portwert in den Programmeinstellungen entspricht dem Port, der in der WSDL-URL für den Zugriff auf RfemApplication angegeben ist, in diesem Leitfaden also 8081.
Boomerang-Leitfaden
Boomerang ist ein benutzerfreundliches API-Testtool für das Debugging von APIs. In order to access it you first need to install the Boomerang Browser-Plugin .
1. Accessing RfemApplication Classes
Um auf die verfügbaren Klassen in RfemApplication zuzugreifen, gehen Sie wie folgt vor:
- Verwenden Sie die folgende WSDL-URL: http://localhost:8081/wsdl
- Load the URL and add it to service.
The port which you have to use in the WSDL URL may be different in your case. Try one of the other ports if 8081 doesn't work.
Nach der Fertigstellung ist der RfemApplication-Dienst über das Service-Register zugänglich und zeigt alle zugehörigen Klassen an. Diese Klassen umfassen alles, was mit der RFEM-Anwendung selbst zu tun hat.
2. Obtaining URL of Active Model
Um die URL Ihres Modells mit dem richtigen Server-Port abzurufen, führen Sie folgende Schritte aus:
- Run the "get_active_model" function by double-clicking it in the left menu.
- Click the send button.
Boomerang will automatically navigate to the response tab, where the URL of the model will be displayed. In this example the server port of the current model is 8083.
3. Accessing RfemModel Classes
To access all available classes in RfemModel, execute the following steps:
- Click on “Add Service” on the left.
- Verwenden Sie die folgende WSDL-URL: http://localhost:8083/wsdl
- Load the URL and add it to the services.
Upon completion, the RfemModel service will be accessible under the service tab, displaying all associated classes. These classes encompass all the model data, including basic objects, loads and more.
4. Verifying WebService Operations
You can now test all operations by double-clicking on them in the service menu on the left. Some operations require passing parameters in the request tab, while others can be executed simply by clicking “Send”. In diesem Tutorial wird das Testen bestimmter Operationen demonstriert.
get_all_selected_objects()
To test this operation no parameters need to be passed. You can directly send the request after selecting some objects in RFEM.
Die Operation gibt eine Liste von object_location-Objekten zurück, die aus Objekttyp und Objektnummer bestehen:
get_member()
In order to test the get_member function you need to provide the number of the desired member:
Die Antwort dieser Operation liefert alle Eigenschaften von Stab Nummer 1:
SoapUI-Leitfaden
SoapUI ist eine leistungsstarke Open-Source-Anwendung zum Testen von SOAP- und REST-Protokollen. The desktop application can be downloaded under .
1. Anlegen eines neuen SOAP-Projekts
Öffnen Sie zunächst SoapUI und erstellen Sie ein neues SOAP-Projekt:
Passen Sie den Projektnamen wie gewünscht an und verwenden Sie http://localhost:8081/wsdl als anfängliche WSDL. As described in the Boomerang guide, the port may be different in your case. Try one of the other ports if 8081 doesn't work. Nach dem Laden werden im Navigator links alle zu RfemApplication gehörenden Klassen angezeigt.
To acquire the initial WSDL for RfemModel, execute the get_active_model operation by double-clicking on “Request 1”. Stellen Sie vor dem Ausführen der Operation sicher, dass ein Modell in RFEM oder RSTAB geöffnet ist. Initiate the operation by clicking on the green triangle and shortly afterward the response containing the current server port will be displayed:
Now you can add a new WSDL to the project using the server port 8083 via Project → Add WSDL:
Subsequently all classes of RfemModel will appear in the navigator as well.
2. Verifying WebService Operations
All WebService operations can now be tested by double-clicking on “Request 1” under the respective class. Für bestimmte Operationen müssen auf der linken Seite Parameter angegeben werden. However, for other operations no parameters are required and you can simply click „Send“. In diesem Tutorial wird das Testen einiger Operationen gezeigt.
get_all_selected_objects()
Um diese Operation zu testen, müssen keine Parameter übergeben werden. Nach der Auswahl der Objekte in RFEM kann die Anfrage direkt gesendet und die Antwort eingesehen werden.
On the right side of SoapUI the function returns a list of type object_location that consists of object type and object number:
get_member()
In order to test the get_member function you need to input the number of the desired member:
Die Antwort dieser Operation liefert alle Eigenschaften von Stab Nummer 1:
Fazit
Both Boomerang and SoapUI are valuable tools for visualizing and testing the available operations within our Webservice library. Sie erleichtern effiziente API-Tests und Debugging.