Objetivo
O objetivo deste documento é auxiliar o usuário a criar um “script” para consumo de API Rest, que fornece dados de cotação de moeda, gravando-os em uma tabela personalizada, chamada “U_COTACAOMOEDAS”.
Criando a tabela personalizada “U_COTACAOMOEDAS”
Será necessário utilizar o Person para criar a tabela “U_COTACAOMOEDAS”. Caso exista alguma dúvida sobre o funcionamento do Person, a documentação a seguir deverá ser consultada. Person - Criando campos, tabelas e consultas personalizadas /wiki/spaces/TD/pages/1991213070
Estrutura da tabela
Abaixo é descrita a estrutura da tabela personalizada, a qual receberá os dados da cotação
...
Descrição: Tabela para cotação cotação de moedas
Coluna | MOEDABASE |
Descrição completa/reduzida | Moeda Base |
Dica para usuário | Moeda a ser convertida |
Tipo da coluna | Texto |
Tamanho máximo | 10 caracteres |
Coluna | MOEDADESEJADA |
Descrição completa/reduzida | Moeda desejada |
Dica para usuário | Moeda desejada para o cálculo da moeda base |
Tipo da coluna | Texto |
Tamanho máximo | 10 caracteres |
Coluna | NOMECONVERSAO |
Descrição completa/reduzida | Descrição |
Dica para usuário | Descrição da conversão |
Tipo da coluna | Texto |
Tamanho máximo | 50 caracteres |
Coluna | VALORMAXIMO |
Descrição completa/reduzida | Valor máximo |
Dica para usuário | Valor máximo da moeda na data |
Tipo da coluna | Número |
Quantidade casas inteiras / decimal | 4 / 4 |
|
|
Coluna | VALORMINIMO |
Descrição completa/reduzida | Valor mínimo |
Dica para usuário | Valor mínimo da moeda na data |
Tipo da coluna | Número |
Quantidade casas inteiras / decimal | 4 / 4 |
|
|
Coluna | PCTVARIACAO |
Descrição completa/reduzida | Porcentagem de Variação / Variação |
Dica para usuário | Porcentagem de Variação |
Tipo da coluna | Número |
Quantidade casas inteiras / decimal | 3 / 4 |
|
|
Coluna | PRECOCOMPRA |
Descrição completa/reduzida | Preço de compra |
Dica para usuário | Preço pago na compra da moeda |
Tipo da coluna | Número |
Quantidade casas inteiras / decimal | 4 / 4 |
|
|
Coluna | PRECOVENDA |
Descrição completa/reduzida | Preço de venda |
Dica para usuário | Preço de venda da moeda |
Tipo da coluna | Número |
Quantidade casas inteiras / decimal | 4 / 4 |
|
|
Coluna | VARIACAO |
Descrição completa/reduzida | Variação |
Dica para usuário | Valor da variação de preços |
Tipo da coluna | Número |
Quantidade casas inteiras / decimal | 4 / 4 |
|
|
Coluna | DATACOTACAO |
Descrição completa/reduzida | Data da cotação |
Dica para usuário | Data na qual a cotação foi feita |
Tipo da coluna | Data e hora |
Após criação da tabela, a mesma deverá ficar parecida com a figura abaixo:
...
Criando o “script” no aplicativo gerente Viasoft3C
Para iniciar o editor do VsScripter, no evento “Ao Iniciar Inclusão”, clicar no menu “Eventos via Script” e, em seguida, no submenu “Ao Iniciar Inclusão”, conforme imagem abaixo:
...
Inicialmente, a tela de edição do VsScripter será mostrada apenas com a “unit” uPrinc, conforme abaixo:
...
Entendendo o código do “script”
Código da “unit” uPrinc (copiar/digitar na unit uPrinc mostrada acima):
...
Ao final, a “unit” uPrinc deve ficar parecida ao mostrado na figura abaixo:
...
Criando o formulário “frmPesquisaCotacao”
Para criar um novo formulário, acessar o menu “File” e em seguida o submenu “New Form”, ou clicando no botão “New form”, que é representado por um formulário em branco com uma estrela amarela na parte superior esquerda.
O novo formulário precisará de três componentes, listados abaixo:
Componente | Novo nome | Caption / Text |
TButton | btnProcessar | &Pesquisar |
TLabel | lblEscolherCotacao | Escolher cotação |
TComboBox | cboEscolherCotacao | Escolher cotação |
Os componentes visuais ficam na barra a direita, chamada “Tool Palette”. Selecionar um componente por vez, clicando, segurando o botão do mouse e arrastando o componente para o formulário. Assim, repetir para todos os componentes.
...
Salvar novamente o projeto do “VsScripter” e fechar seu editor.
Testando o “script” de cotação de moedas
Para testar o “script”, é necessário clicar no ícone de inclusão de registro, representado pelo desenho de uma folha de papel com um sinal de mais verde. Logo em seguida, será mostrado o formulário “Pesquisa Cotação”, conforme figura abaixo:
...
Após finalizar a consulta, tendo os campos preenchidos, clicar no botão Salvar, ou executar o atalho “CTRL+S” para adicionar o registro da tabela personalizada.
Para facilitar ainda mais o entendimento, foi produzido um vídeo sobre este conteúdo. Para acessá-lo, utilize o link abaixo: