Porty serveru
Pro navázání připojení webové služby k programům RFEM a RSTAB je třeba přistupovat k příslušným portům serveru. Rozsah dostupných portů serveru lze změnit v nastavení programu v Nastavení → Možnosti programu:
Standardně je rozsah portů serveru nastaven od 8081 do 8089. Nejnižší hodnota portu v nastavení programu odpovídá portu zadanému v URL WSDL pro přístup k programu RfemApplication, což je v tomto návodu 8081.
Návod pro Boomerang
Boomerang je uživatelsky přívětivý API testovací nástroj pro ladění API. In order to access it you first need to install the Boomerang Browser Plugin.
1. Accessing RfemApplication Classes
Pro přístup k dostupným třídám v RfemApplication postupujte následovně:
- Použijte následující 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.
Po dokončení bude služba RfemApplication přístupná v záložce Servis a zobrazí se všechny příslušné třídy. Tyto třídy zahrnují vše, co se týká samotné aplikace RFEM.
2. Obtaining URL of Active Model
Pro načtení URL vašeho modelu se správným portem serveru proveďte následující kroky:
- 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.
- Použijte následující 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”. V tomto tutoriálu předvedeme testování určitých operací.
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.
Operace vrátí seznam objektů object_location, který se skládá z typu objektu a čísla objektu:
get_member()
In order to test the get_member function you need to provide the number of the desired member:
Odezva této operace poskytuje všechny vlastnosti prutu číslo 1:
Průvodce SoapUI
SoapUI je výkonná open-source aplikace určená pro testování protokolů SOAP a REST. The desktop application can be downloaded under .
1. Vytvoření nového projektu SOAP
Pro začátek otevřete SoapUI a vytvořte nový SOAP projekt:
Upravte název projektu podle potřeby a použijte http://localhost:8081/wsdl jako počáteční 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. Po načtení se v navigátoru vlevo zobrazí všechny třídy přiřazené k RfemApplication.
To acquire the initial WSDL for RfemModel, execute the get_active_model operation by double-clicking on “Request 1”. Před spuštěním operace se ujistěte, že je model v programu RFEM nebo RSTAB otevřený. 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. Pro určité operace je třeba na levé straně zadat parametry. However, for other operations no parameters are required and you can simply click „Send“. V tomto tutoriálu si ukážeme testování některých operací.
get_all_selected_objects()
Pro otestování této operace není třeba předat žádné parametry. Po výběru objektů v programu RFEM můžete přímo odeslat dotaz a prohlédnout si odezvu.
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:
Odezva této operace poskytuje všechny vlastnosti prutu číslo 1:
Závěr a výhled
Both Boomerang and SoapUI are valuable tools for visualizing and testing the available operations within our Webservice library. Umožňují efektivní testování a ladění API.