Ports du serveur
Pour établir une connexion du service Web à RFEM et RSTAB, des ports de serveur spécifiques doivent être accessibles. La liste des ports serveur disponibles peut être modifiée dans les paramètres du programme en navigant dans Options → Options du programme :
La gamme de ports du serveur est définie par défaut de 8081 à 8089. La valeur de port la plus basse dans les paramètres du logiciel correspond au port spécifié dans l'URL WSDL pour accéder à RfemApplication, qui sera 8081 dans ce guide.
Guide de Boomerang
Boomerang est un outil de test d’API convivial, conçu pour le déblocage d’API. In order to access it you first need to install the Boomerang Browser Plugin.
1. Accessing RfemApplication Classes
Pour accéder aux classes disponibles dans RfemApplication, procédez comme suit :
- Utilisez l'URL WSDL suivante : 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.
Une fois l’opération complétée, le service RfemApplication sera accessible dans l’onglet « service », affichant toutes les classes associées. Ces classes couvrent tout ce qui est lié à l’application RFEM elle-même.
2. Obtaining URL of Active Model
Pour récupérer l’URL de votre modèle via le port serveur adéquat, procédez comme suit :
- 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.
- Utilisez l'URL WSDL suivante : 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”. Ce tutoriel présente le test de certaines opérations.
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.
L’opération renvoie une liste d’objets object_location qui se composent de type d’objet et de numéro d’objet :
get_member()
In order to test the get_member function you need to provide the number of the desired member:
La réponse de cette opération fournit toutes les propriétés de la barre n°1 :
Guide de SoapUI
SoapUI est une application open source puissante conçue pour tester les protocoles SOAP et REST. The desktop application can be downloaded under .
1. Création d’un nouveau projet SOAP
Pour commencer, ouvrez SoapUI et créez un nouveau projet SOAP :
Personnalisez le nom du projet selon vos besoins et utilisez http://localhost:8081/wsdl comme WSDL initial. 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. Une fois chargé, le navigateur à gauche affichera toutes les classes associées à RfemApplication.
To acquire the initial WSDL for RfemModel, execute the get_active_model operation by double-clicking on “Request 1”. Avant de lancer l’opération, assurez-vous qu’un modèle est ouvert dans RFEM ou RSTAB. 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. Les paramètres doivent être renseignés sur le côté gauche de la fenêtre pour certaines opérations. However, for other operations no parameters are required and you can simply click „Send“. Ce tutoriel présente le test de certaines opérations.
get_all_selected_objects()
Pour tester cette opération, aucun paramètre ne doit être transmis. Après avoir sélectionné les objets dans RFEM, vous pouvez envoyer directement la demande et afficher la réponse.
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:
La réponse de cette opération fournit toutes les propriétés de la barre n°1 :
Conclusion
Both Boomerang and SoapUI are valuable tools for visualizing and testing the available operations within our Webservice library. Ils facilitent le test et le débogage des API.