Tutorial - Developing an Android and iOS application

Practical example

Warning
This lesson is based on the WM Product Management example used in Lesson 1. To follow this lesson, you must have completed the steps from the previous lessons.

1. On the "Project" tab, in the "Project" group, expand "Import" and select "A web service".
2. The import wizard starts. Go to the next step.
3. Specify the address into which the web service WSDL description must be imported:
   
   https://examples.webdev.info/WSTUTORIALV2_WEB/awws/WSTutorialV2.awws?wsdl
   
   Reminder: this web service is used to query a supplier database to check the availability (stock) of a product using its reference.
   
4. Go to the next step. The web service is imported.
   
5. Validate the information window. The imported web service is in the "Imported web services" folder of the "Project explorer" pane.
6. In the "Project explorer" pane, expand the "Imported web services" folder.

Let's take a closer look at the information displayed in the "Project explorer" pane:

The structure includes:

• the web service name (WSTutorialV2 in this example),
• the name of each function (ProductInStock in this example).

To see the web service call syntax, double-click the name of the function in the "Project explorer" pane. The code editor displays the function description, with the prototype for calling the function:

Calling the web service

1. Open the "IW_Product" internal window in the editor (double-click on it in the "Project explorer" pane).
2. Reduce the width of the "Reorder" control.
3. Delete the "Quantity" control.
4. Add a Button control:
   • On the "Creation" tab, in the "Usual controls" group, click .
   • Click in the window next to the "Reorder" control.
   • The control is automatically created.
5. Modify the characteristics of the control (select "Description" in the context menu). Set "BTN_Stock" as name and "Stock" as caption.
   
6. Open the events associated with the control (select "Code" in the context menu).
7. Write the following WLanguage code in the "Click BTN_Stock" event:
   

   // Display SOAP web service response
   InfoBuild("Number of products ""%1"" in stock: %2", SAI_Référence, ...
   	ProductInStock(EDT_Reference))

   Let's analyze this code:
   • The ProductInStock function of the web service is called. This code uses the function prototype that was displayed previously in the code editor.
   • The response is formatted and displayed.
8. Close the code editor and save the window ( or Ctrl + S).
9. Close the "IW_Product" internal window.

Testing the web service

1. Open the WIN_Advanced_LIST_Products window (e.g., press CTRL + E).
2. Test the window (click in the quick access buttons).
3. Double-click on a product: the product form is displayed.
4. Click "Stock".
   
5. Validate the information window and close the simulator.

Calling the REST web service

1. Go back to the editor and open the code of the BTN_Stock control.
2. Comment out the existing code (select the lines of code and press Ctrl + //).
3. Write the following code:
   
   // Display REST web service response
   h is httpRequest
   h.Method = httpGet
   h.URL = "https://examples.webdev.info/product/" + EDT_Reference
   h.ContentType = "application/json"
   
   r is httpResponse = RESTSend(h)
   Content is ANSI string
   
   IF r.StatusCode = 200 THEN // Request successfully completed
   Content = r.Content
   Info(Content)
   ELSE
   Info("An error has occurred " +  ErrorInfo() + r.StatusCode + r.DescriptionStatusCode)
   END
   
   This code is used to:
   • Declare a variable of type httpRequest. This variable defines the parameters of the query sent to the REST web service. The properties of this variable are:
     • The method used: GET in our case.
     • Webservice call URL: this is the URL we've just seen. In our case, the product reference corresponds to the value in the EDT_Reference control.
     • The type of content of the HTTP message that will be sent to the server. In this case, the message is in JSON format.
   • Send the request to the server and get the response using RESTSend. The response is a variable of type restResponse.
   • Format the response.
4. Close the code editor and save the window ( or Ctrl + S).

Testing the REST web service call

1. If necessary, open the WIN_Advanced_LIST_Products window (e.g., press CTRL + E).
2. Test the window (click in the quick access buttons).
3. Double-click on a product: the product form is displayed.
4. Click "Stock".
5. Validate the information window and close the simulator.

Completed project
Do you want to check the end result of the steps described here? A completed project is available. This project contains the windows and reports created and used in this lesson. To open the corrected project, on the home page, click on "Tutorial", then in the "Tutorial - Complete application with data" area, click on the "Open corrected project" link.

• Push notification,
• Device panel,
• etc.