In most cases, a Web service is defined as an application that can be accessed via standard Internet protocols. More specifically, Web services allow several computers connected via Internet to interact.

Web services allow you to run procedures and processes on a remote Web server (.NET, SOAP or J2EE) from a client computer.

With WINDEV, these Web services can be used as client, via the SOAP protocol on HTTP (the standard Internet protocol for transferring HTML pages), with the SOAPxx, DotNetxx and J2EExx functions.

Regardless of the platform of the Web server (.NET, J2EE, ...), a Web service is accessible via the SOAP protocol.


	Remark	With WINDEV, you don't even have to be an expert in this field. A wizard takes care of ("almost") everything!

Practical example

A Webservice specific to this tutorial allows you to check the different operations that can be performed on a Webservice.

When integrated to the "WD Full Application" project, this Webservice is used to interrogate a supplier database to check whether a product is available in stock using its reference.

In a first time, the Webservice will be imported into the "WD Full Application" project then it will be used in the application to check the product availability from a Product form.

Importing a Webservice

Close the current project if necessary. The WINDEV home page is displayed.

In the home page, click "Tutorial" and select "Full application (Exercise)". The project is loaded.


	Answers	If you did not create the windows in the previous lessons, you can follow this lesson by opening a corrected project: in WINDEV's home page (Ctrl + <), click "Tutorial" and select "Full application (With windows)". A full corrected application project is also available: in WINDEV's home page (Ctrl + <), click "Tutorial" and select "Full application (Answer)"

Position (if necessary) on the "32-bit Windows executable" configuration: in the "Project explorer" pane, in the "Configurations" folder, double-click "Windows 32-bit executable".

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

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

The structure includes:

the Webservice name (WSTutorialV2 in this example),
the name of each function (ProductInStock in this example).

To find out how to call the Webservice, simply 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:

Consuming a Webservice

In our "WD Full Application" example, the call to the Webservice will be included in the tab used to see the list of products. A button "In stock?" is used to check whether the product displayed via the Webservice is available.

To use the Webservice:
1. Open the "WIN_Menu" window in the editor (double-click its name in the "Project explorer" pane, for example).
2. Add a Button control in the "List of products" tab pane:
  - On the "Creation" pane, in the "Usual controls" group, click .
  - Click below the "Modify " Button control in the window.
  - The control is automatically created.
3. Modify the characteristics of the control ("Description" from the popup menu). This control is named "BTN_InStock" and its caption is "In stock?".
4. Display the events associated with the control ("Code" from the popup menu).
5. Write the following WLanguage code in the "Click BTN_InStock" event:
  // Displays the Webservice response
  InfoBuild(...
  "Number of ""%1"" products in stock: %2", ...
  COL_Reference, ProductInStock(COL_Reference))
  Let's study this code:
  - The ProductInStock function of Webservice is called. This code uses the function prototype that was displayed beforehand in the code editor.
  - The response is formatted and displayed.
6. Close the code editor and save the window ( or Ctrl + S).

We are going to check the operating mode of Webservice:
1. Run the project test ( among the quick access buttons).
2. Click the "List of products" tab if necessary.
3. Select any product in the Table control and click "In stock?".
4. Validate the information window and close the application.

DICAS 3008 - WINDEV TUTORIAL 31 - Adicionar e Modificar Janelas ANCORAS - PARTE D
DICAS 3009 - WINDEV TUTORIAL 32-Adicionar e Modificar Janelas - Exibicao registro - PARTE E

DICAS 3010 - WINDEV TUTORIAL 33-Adicionar e Modificar Janelas - Modifica Imagen - PARTE F

DICAS 3011 - WINDEV TUTORIAL 34 - Adicionar e Modificar Janelas - Validacao - PARTE G

DICAS 3012 - WINDEV TUTORIAL 35 - Adicionar e Modificar Janelas - CRIACAO - PARTE H

DICAS 3013 - WINDEV TUTORIAL 36 - Adicionar e Modificar Janelas - Teste - PARTE I

DICAS 3014 - WINDEV TUTORIAL 37 - Pesquisa Simples - Apresentacao - PARTE A

DICAS 3015 - WINDEV TUTORIAL 38 - Pesquisa Simples - Usando Controle Tab- PARTE B

DICAS_3016_WINDEV_TUTORIAL_39_Pesquisa_Simples_Configurando_Pesquisa_PARTE_C

DICAS 3017 - WINDEV TUTORIAL 40 - Pesquisa Simples - Pesquisa Identica- PARTE D

DICAS 3018 - WINDEV TUTORIAL 41 - Pesquisa Simples - Pesquisa Generica - PARTE E

DICAS 3019 - WINDEV TUTORIAL 42 - Pesquisa Simples - Navegacao pelos Arquivos - PARTE F

DICAS 3020 - WINDEV TUTORIAL 43 - Pesquisa Multicriterio - Apresentacao - Parte A

DICAS 3021 - WINDEV TUTORIAL 44 - Pesquisa Multicriterio - Criacao Consulta - Parte B

DICAS 3022 - WINDEV TUTORIAL 45 - Pesquisa Multicriterio - Uso Parametro - Parte C

DICAS 3023 - WINDEV TUTORIAL 46 - Pesquisa Multicriterio - Criando Interface - Parte D

DICAS 3024 - WINDEV TUTORIAL 47 - Pesquisa Multicriterio - Primeiro Parametro - Parte E

DICAS 3025 - WINDEV TUTORIAL 48 - Pesquisa Multicriterio - Segundo Parametro - Parte F

DICAS 3026 - WINDEV TUTORIAL 49 - Pesquisa Multicriterio - Parametro Data - Parte G

DICAS 3027 - WINDEV TUTORIAL 50 - IMPRIMIR_TABELA

DICAS 3028 - WINDEV TUTORIAL 51 - IMPRIMIR PEDIDO-CRIACAO RELATORIO - PARTE A

DICAS 3029 - WINDEV TUTORIAL 52 - IMPRIMIR PEDIDO - CRIAR O RELATORIO BASE QUERY - PARTE B

DICAS 3030 - WINDEV TUTORIAL 53 - IMPRIMIR PEDIDO - ALTERACOES RELATORIO - PARTE C

DICAS 3031 - WINDEV TUTORIAL 54 - IMPRIMIR PEDIDO - MENU RELATORIO - PARTE D

DICAS 3032 - WINDEV TUTORIAL 55 - RELATORIO LISTA CLIENTE - PARTE A

DICAS 3033 - WINDEV TUTORIAL 56 - RELATORIO CLIENTE - Imprimir - PARTE B

DICAS 3034 - WINDEV TUTORIAL 57 - ESTATISTICAS GRAFICO PIVOT - QUERY ANO - PARTE A

DICAS 3035 - WINDEV TUTORIAL 58 - ESTATISTICAS GRAFICO PIVOT - GRAFICO-PARTE B

DICAS 3036 - WINDEV TUTORIAL 59 - ESTATISTICAS - PIVOT - PVT - PARTE C

DICAS 3037 - WINDEV TUTORIAL 60 - ENVIAR EMAIL - ADICIONANDO CAMPOS - PARTE A

DICAS 3038 - WINDEV TUTORIAL 61 - ENVIAR EMAIL - CODIGO - PARTE B

DICAS 3039 - WINDEV TUTORIAL 62 - ENVIAR EMAIL - MELHORIAS - PARTE C

DICAS 3040- WINDEV TUTORIAL 63 - GROUPWARE - CONFIGURACAO - PARTE A

DICAS 3041- WINDEV TUTORIAL 64 - GROUPWARE - TESTE - PARTE B

DICAS 3042- WINDEV TUTORIAL 65 - COMPONENTES EXTERNOS - CRIANDO - PARTE A

DICAS 3043 - WINDEV TUTORIAL 66 - COMPONENTES EXTERNOS - USANDO - PARTE B

DICAS 3044 - WINDEV TUTORIAL 67 - CONSUMINDO SERVICO WEBSERVICE

DICAS 3045 - WINDEV TUTORIAL 68 - MONITORAR EVOLUCAO SEUS APLICATIVOS - TESTES

sábado, 22 de agosto de 2020

DICAS 3043 - WINDEV TUTORIAL 66 - COMPONENTES EXTERNOS - USANDO - PARTE B

2IFCC0xrdRA

Bom Dia/Boa Tarde/Boa Noite

Esse Ao Vivo vai estrear as 11:00 do dia 01/09/2020

DICAS 3043 - WINDEV TUTORIAL 66 - COMPONENTES EXTERNOS - USANDO - PARTE B

Tutoriel WINDEV : Leçon 4.11.b. Réutilisez du code grâce aux composants externes - Utilisation

https://windevdesenvolvimento.blogspot.com/2020/08/dicas-3043-windev-tutorial-66.html

ASSUNTOS

EXPLICANDO O QUE SERA FEITO

CRIANDO UM APLICATIVO SEM ANALISE

IMPORTANDO O COMPONENTE EXTERNO FEITO LICAO ANTERIOR

CRIANDO UMA JANELA CLIENTE POR CIDADE

CRIANDO O CODIGO PARA CHAMAR DataLocation

CRIAR UM EDT_CIDADE,TABELA RESULTADO,BOTAO PESQUISAR

ENTRAR NO BOTAO PESQUISA E FAZER COMANDO RETORNANDO AS CIDADES

NAVEGAR PELO RESULTADO DA PESQUISA DA CIDADE

ADICIONAR AS LINHAS

AVISAR SE NAO DEU CERTO

COMO FAZER INSTALADOR WDK PARA DISTRIBUIR

FAZENDO O INSTALADOR

https://doc.windev.com/en-US/?1410087525&name=lesson_411_reuse_code_via_the_external_components

Video original da Franca

https://youtu.be/7gX_xDkRbmg

Playlist Windev TUTORIAL

https://www.youtube.com/playlist?list=PLwJwZaqiZW-lxU1XF0M0htb5S5f8pavuE

https://youtu.be/3DshsXJ8I2M

=====================================

// end of initialization

DataLocation("C:\My Projects\My Examples\WD Full Application (Exercises)\Exe\Componente_Cidade")

=====================================

//btn pesquisar

sRESULTADO_LISTA is string

// Gets the list of customers and their orders for the specified city

// Obtém a lista de clientes e seus pedidos para a cidade especificada

sRESULTADO_LISTA=GiveOrdersByCity(EDT_CIDADE)

// Se a lista não estiver vazia

IF sRESULTADO_LISTA<>"" THEN

// Clears the Table control

// Limpa o controle da tabela

//TableDeleteAll(TABLE_RESULTADO)

TABLE_RESULTADO.DeleteAll()

// Browses the results

// Navega pelos resultados

// AMARILDO 1 + TAB + 100 + CR +

// AMARILDO 2 + TAB + 200

FOR EACH STRING sLINHA IN sRESULTADO_LISTA SEPARATED BY CR

// Adds this client to the Table control

// Adiciona este cliente ao controle Tabela

//TABLEADD(TABLE_RESULTADO,sLINHA)

TABLE_RESULTADO.Add(sLINHA)

END

ELSE

InfoBuild("NAO ACHADO CIDADE PARA %1 ",EDT_CIDADE)

END

=====================================

ErpMatos - TgsSistemas

skype:amarildo.matos.informatica

email: amarildo.matos@gmail.com

whats: 51984197742

Youtube: Amarildo Matos

http://www.amarildomatos.com.br

https://groups.google.com/forum/#!forum/amarildowindev

www.windev.com

https://www.pcsoft.fr/webinaires.htm?p=forumpcs

https://forum.pcsoft.fr/fr-FR/pcsoft.br.windev/page/1.awp

https://www.windev.com/windev/WD-Express.htm

https://www.windev.com/windevmobile/WM-Express.htm

http://windevdesenvolvimento.blogspot.com.br/2017/07/menu-blog.html

Step 2 : Using the external component

Once created, your component can be used in any other WINDEV project. Let's now see how this component can be re-used.

To do so, we are going to create a new project and import our component into this project.

Close the current project: on the "Home" pane, in the "General" group, expand "Close" and select "Close the project".
Validate the closing of project and save the modifications if necessary.
The WINDEV home page is displayed.
Create a new project: click "Create a project" in the home page.
- This project is a Windows application.
- This project is named "CompUse" and it has no analysis.
On the "Project" pane, in the "Project" group, expand "Import" and select "An External component ... From a file".

In the directory of "WD Full Application" project, select the "EXE\CompoOrdersByCity" sub-directory, then the "CompoOrdersByCity.wdi" file.


	Remark	If the component was created from: the "WD Full Application (Exercise)" example, select the "My Projects\My Examples\WD Full Application (Exercise)\EXE\CompoOrdersByCity" sub-directory, then the "CompoOrdersByCity.wdi" file. the "WD Full Application (with windows)" example, select the "My Projects\My Examples\WD Full Application (With windows) (Exercise)\EXE\CompoOrdersByCity" sub-directory, then the "CompoOrdersByCity.wdi" file.

Click "Open", the description of our component is displayed. This description contains:

On the "General" tab, the elements typed when creating the external component as well as its location.

On the "Details" tab, the component description as well as the help that was automatically generated. This allows you to identify the re-usable component elements.


	Remark	The component description can be accessed at any time. Simply select the component in the "Project explorer" pane and select the "Description" option from the popup menu. In this case, you also have the ability to define the load mode of component.

Validate ("Close" button). The component is included in your project.

We are now going to create a blank window to use the component.

Create a blank window.
- The window title is "Customers by city".
- The window name is "WIN_Customers_by_city".
- Save.
Display the WLanguage events associated with the window ( "Code" from the popup menu).

We are going to call the DataLocation function of component in the "End of initialization" event. This function expects in parameter the path used to access the data files handled by the component. Type the access path to the data found in the "WD Full Application" example. For example:

DataLocation(...// Specify the path of YOUR data
"C:\WINDEV\Tutorial\WD\Exercises\" + ...
"WD Full Application\Exe")


	Remark	If your project uses another procedure named "DataLocation", the name of component procedure must be prefixed by the name of the set of procedures used. The code becomes: SET_Component.DataLocation(...

Close the code editor.
Add the following controls into the window:
- A text Edit control whose caption is "City" and whose name is "EDT_City".
- A Table control named "TABLE_Result", filled by programming and that includes 2 columns:
  - a "Name" column of Text type.
  - a "Total sales" column of Currency type.
- A Button control whose caption is "Search" and whose name is "BTN_Search".

You can now edit the WLanguage events associated with "BTN_Search". When this control is clicked on, we will run the search procedure found in the component. This procedure:
- expects the city name in parameter
- returns a string in the following format:
  Name of customer 1 + TAB + Total sales 1 + CR +
  Name of customer 2 + TAB + Total sales 2 + ...
So, the code of the "Click" event from "BTN_Search" should:
- call the GiveOrdersByCity procedure of component while passing the content of EDT_City control in parameter.
- process the returned string to add it into the Table control.
Write the following WLanguage code:
sResultList is string
// Gets the list of customers and their orders
// for the specified city
sResultList = GiveOrdersByCity(EDT_City)
// If the list is not empty
IF sResultList <> "" THEN
// Clears the Table control
TableDeleteAll(TABLE_Result)
// Browses the results
FOR EACH STRING sACustomer OF sResultList SEPARATED BY CR
// Adds this client to the Table control
TableAdd(TABLE_Result, sACustomer)
END
ELSE // If the list is empty
InfoBuild("No customer found for %1", ...
EDT_City)
END

Close the code editor and save your window.

Run the window test: click among the quick access buttons. In the edit control, type "Paris" (while respecting the case) and click the "Search" button. The list of customers is displayed.

That's it! Child's play isn't it?

You know how to create a component and how to re-use it in your applications. You also have the ability to manage the setup procedures of your components, in order to distribute them separately from your applications for example.

Distributing an external component

Two methods can be used to distribute a component:

Provide the necessary files "manually", this is a "standard" distribution.
Create a more "professional" distribution, via the setup editor of WINDEV (WDInst).

Standard distribution

In this case, you must supply all the files required for your component to operate. These files are created when generating the component (WDI, WDK and WDO files, images, other documents, ...). These files will be manually copied from their source directory to the destination directory. The WINDEV projects that use this component will find the dependent files in this destination directory.

List of files that must be supplied for a standard distribution:

the files automatically generated by WINDEV (WDK, WDI, ...).
the dependency files.
the WDO file must be supplied if the component uses dependency files. This file contains the references to the external files used in the component.

Professional distribution

The distribution of components via a setup procedure consists in providing a setup program to the users of WINDEV component. This program installs all the files required for using the component in the directory specified by the user.

This setup mode is used to automatically manage:

the WDO file and the setup of additional files used by the component.
the automatic setup of necessary tools (MDAC, ODBC driver for HFSQL, ...).
the automatic update of data files used by the component (if necessary).
the uninstall program of component.

Close the "CompoUse" project: on the "Home" pane, in the "General" group, expand "Close" and select "Close the project".

Open the "WD Full Application" project that was used beforehand (for example, display the home page and select the "WD Full Application" project found in the recent projects). If necessary, select the project configuration corresponding to the component in the "Project explorer" pane.

To create the setup, on the "Project" pane, in the "Generation" group, click "Setup procedure"..

The component setup creation wizard starts.

We won't go into details about the different setup modes of a component. Follow the steps of the wizard.
See Distributing an external component for more details.