Olá pessoal,

Informo que estou fazendo umas aulas em vídeo de Team Developer 7 e disponibilizando no meu canal no Youtube

Convido a visitarem lá e aguardo os comentários e perguntas de vocês.

https://www.youtube.com/watch?v=svMIFQ0Ode0

Download do Livro de Team Developer 

 

Abraço!

Ferramenta SQLCmdWriter

 

Estou compartilhando uma ferramenta que fiz para ajudar na escrita de comandos SQL (Select, Insert, Update e Delete) principalmente quando a tabela possuir muitas colunas. Basta escolher a tabela e as colunas que deseja usar que o programa gera os comandos. A ideia é evitar que o desenvolvedor perca tempo escrevendo e procurando bug de digitação em comandos SQL imensos.

Numa visão resumida, use-o assim:

Login

Por enquanto o aplicativo só está funcionando com Oracle. Para usar com outro SGBD é preciso fazer algumas alterações na aplicação.

Se você deseja salvar as informações de login, marque o checkbox apropriado nesta janela. E se não quiser que a senha seja salva marque o outro checkbox. Aviso …. a senha não é criptografada. Portando…. pense bem se pode expor assim sua senha de banco.

Janela principal

É nesta janela onde as coisas acontecem, onde você pode configurar como seus comandos serão montados. Primeiramente escolha a tabela que deseja trabalhar. Algumas colunas serão meramente informativas. Mas duas delas são importantes e interferem na geração dos comandos. As colunas Select e Where são checks e quando selecionadas indicam que a coluna da linha correspondente será incluída na geração dos comandos. Quando a célula da coluna Select estiver marcada a coluna correspondente à linha será utilizada para manipulação dos dados, ou seja, será usada nos comandos Select, Insert e Update. Quando a célula da coluna Where estiver selecionada, a coluna correspondente à linha será utilizada nos filtros de dados dos comandos Select, Update e Delete.

As colunas “Utilizar no INTO” e “Utilizar no Where” são preenchidas automaticamente pelo SQLCmdWriter com sugestões de nomes das variáveis, datafields e colunas. São sugestões que serão usadas nos comandos montados. Eu me refiro a estas colunas como sendo o local onde se especifica os nomes dos objetos da aplicação.

Os nomes dos objetos da aplicação variam de acordo com a seleção que estiver feita na faixa de opções. Se você quiser usar variáveis como objetos da aplicação usados nos Where dos comandos, deixe selecionado o botão “usar como variáveis” no grupo Filtragem da faixa de opções. Se quiser que os objetos da aplicação sejam nomeados como data fields, deixe selecionado o botão “usar como Data Fields”. Da mesma forma caso queira usar as colunas da table window.

Siga o mesmo padrão para os objetos da aplicação usados na manipulação dos dados selecionando os botões da faixa de opções Manipulação dos dados.

Há um menu de contexto escondido nas colunas Select e Where para ajudar na seleção de múltiplas linhas. Para acioná-lo efetue um clique duplo nessas colunas e experimente.

Você pode eventualmente escrever o nome dos objetos da aplicação da forma como desejar.

Quando quiser gerar os comandos, clique no botão Gerar comandos. Os comandos serão mostrados em uma janela que permite que sejam editados e copiados para o seu aplicativo.

A idéia deste aplicativo é ajudar na montagem de comandos SQL para manipulação de uma unica tabela. Quanto mais colunas a tabela tiver, maior seja a ajuda.

 

Estou estudando a possibilidade de numa próxima versão fazer com que o SQLCmdWriter escreva no código fonte as colunas, variáveis e data fields caso não existam. Mas vai depender de tempo e se a comunidade vai achar essa ferramenta útil.

Divirtam-se.

Link para o download do SQLCmdWriter no OneDrive.

Lançamento do Team Developer 6.3

Foi lançado o Team Developer 6.3 e a Computer Machine fez um ótimo material para os interessados em conhecer os principais pontos de destaque dessa versão. Tomo a liberdade de reproduzir aqui neste post esta documentação feita pela Computer Machine.

GUPTA TECHNOLOGIES
Lançamento do Team Developer 6.3!

No ínicio de Abril a Gupta Technologies lançou a versão 6.3 do Team Developer, trazendo ainda mais recursos para os desenvolvedores.

Abaixo seguem algumas das evoluções e para visualizar ainda melhor as novidades, acesse nosso vídeo no YouTube e faça o Download da nova versão.

Agora conseguimos criar os Menus RibbonBar ainda mais poderosos, tendo total controle dos objetos internos

• Novo Componente RibbonBar Galery
• Incluir ou Excluir Itens (Tabs, Botões, CheckBox, Combos e etc)
• Exibir ou Não o Menu Completo
• Carregar um Item através de Query
• Definir Imagens, visibilidade ou itens habilitados

Algumas novidades e melhorias para os desenvolvedores:

• Construtor e Destrutor para as Classes
• Suporte a Imagens JPG e PNG
• SalMail agora possibilita Cópia Oculta
• Maior controle da ToolBar do objeto Rich Text
• Botão Close e Refresh para o objeto TabBar
• Melhorias na Criação de Tasks e novo Bookmarks
• Cores para Constantes e Includes

Mais evoluções para as Grids

• Sumarizadores para colunas Agrupadas
• Métodos para retornar Valor e a Coluna Sumarizada
• Justificar coluna sumarizada
• Novas propriedades para células do tipo Picture
• Importar dados de arquivos XML, CSV, Text e Excel

Nova ferramenta Report Designer para erar relatórios HTML ou PDF para o usuário final.

Possibilidade de colorir datas e recuperar quais são as datas selecionadas (permite selecionar multiplas datas)

 

Assista o vídeo para conhecer melhor o Team Developer 6.3

Conheça nossos Produtos, Serviços e Treinamentos

Para saber mais sobre os produtos da Gupta Technologies e serviços oferecidos pela da Computer Machine, acesse: http://www.computermachine.com.br

Tutorial Table Window – Parte 1 - CRUD

Este é o primeiro de uma série de artigos que serão publicados com o objetivo de mostrar diversas soluções envolvendo o uso do objeto Table Window, o que pode ser considerado por alguns como um dos objetos mais versáteis do Team Developer.

Este primeiro artigo mostrará como carregar os dados de uma tabela do banco de dados na table window, permitirá que os dados sejam modificados e oferecerá funções para salvar no banco de dados as informações que foram alteradas. Basicamente há duas formas de se executar estas atividades e este tutorial mostrará como fazer das duas formas.

Para facilitar o acompanhamento do tutorial será utilizada a tabela COMPANY do banco dedados ISLAND que é o banco padrão que acompanha o Team Developer.

A table window

A Table Window é um objeto visual do Team Developer onde é possível carregar uma matriz de dados em formato de colunas e linhas. Cada coluna é identificada por um título e equivale normalmente a uma coluna de alguma tabela do banco de dados. As linhas representam um registro do banco de dados e normalmente utilizam seu cabeçalho de linha para mostrar indicadores visuais que informam o estado da linha. A forma mais tradicional de trabalhar com a Table WIndow é carregar dados resultado da execução de um comando SELECT. Após o usuário fazer as edições desejadas as linhas editadas são identificadas e o comando SQL apropriado é executado no contexto de cada linha conforme a ação necessária.

Para este tutorial as técnicas serão mostradas baseadas numa janela de edição que foi montada desta forma:

Como é possível observar, a janela possui uma barra de ferramentas com alguns botões para executar as funções básicas a serem tratadas neste tutorial. Os botões executam as tarefas de Carregar dados, Adicionar linha, Salvar edições e um botão para Fechar a janela.

Tudo o que for apresentado aqui funciona para o objeto Child Table Window que é a mesma table window porém, utilizada como objeto child de algum formulário.

Cada coluna da table window deve ser inserida no código utilizando um objeto Table Window Column, conforme a imagem abaixo ilustra:

Cada coluna da table window deve ter seus atributos ajustados para estar em sincronismo com a definição no banco de dados, tipo de dado e tamanho devem ser configurados através do Attribute Inspector para refletir as características de cada coluna, conforme está definido no banco de dados.

Populando a Table Window

A carga dos dados baseia-se na execução de um comando SELECT e seu resultado, o result set, é carregado nas linhas e colunas da table window.

Para fins didáticos o comando SELECT a ser executado para a carga da table window será armazenado numa variável chamada sCmdSelect, conorme ilustrado abaixo:

Este mesmo comando SELECT será utilizado nos dois métodos de carga de dados na table window, por esse motivo foi separado e armazenado numa variável.

Populate automático

O Team Developer disponibiliza uma função para que o desenvolvedor faça a carga dos dados na table window de forma bastante simples, sendo necessário basicamente passar para a função o comando SELECT e informar a forma a ser utilizada para a carga dos dados, detalhes abaixo:

SalTblPopulate

Compila e executa um comando SELECT transferindo as linhas do result set para as linhas da table window.

Sintaxe:

• Call SalTblPopulate ( hWndTW , hSql , sComando , nMetodo )

Possui os seguintes parâmetros

• hWndTW – Window Handle – O ponteiro para a table window que será populada. Utilize o nome da table window ou o handle.
• hSql – Sql Handle – O ponteiro da conexão com o banco de dados que será vinculado à execução e aos resultados obtidos com a execução do comando SELECT. Na maioria dos casos este handle não deve ser utilizado para execução de outros comandos enquanto a table window estiver sendo utilizada.
• sComando – String -  O comando Select a ser utilizado para popular a table window.
• nMetodo – Number – Método que indica como a table window deverá ser populada. Possíveis métodos são indicados pelas constantes TBL_FillAll, TBL_FillAllBackground e TBL_FillNormal. Deve ser utilizado apenas uma dessas constantes para cada comando executado.

Caso a função seja executada com sucesso, retornará um booleano TRUE, caso contrário retornará FALSE.

Prosseguindo com a carga da table window deste tutorial, após o comando Select ter sido armazenado na variável sCmdSelect, basta executar a linha abaixo para que a table window seja populada:

Call SalTblPopulate( hWndForm, hSqlMAIN, sCmdSelect, TBL_FillAll )

Esta única linha é o suficiente para fazer a carga do resultado do comando Select. Isso caracteriza este como sendo o método simples de carga de dados numa table window, ou o método automático.

Alguns detalhes devem ser observados.

Quanto a associação das colunas no Select:

• Na montagem do comando Select, para cada coluna utilizada na cláusula Select uma coluna da table window deve ser usada na clausula Into.
• Deve-se utilizar o nome completo da coluna da table window, incluindo a referência completa do seu objeto parent.
• As colunas (ou variáveis ) utilizadas na clausula Into devem ser precedidas pelo caracter : (dois pontos) para indicar que são objetos externos ao banco de dados, oriundos da aplicação.

Obs: a função SalTblPopulate também pode ser usada para popular o objeto Grid Window, controle introduzido no Team Developer 5.2 e estendido nas versões posteriores.

A função SalTblPopulate torna muito prática a carga dos dados em table window pois esconde diversos controles necessários. Ao utilizar o método manual de carga dos dados na table window, sem utilizar SalTblPopulate, deve-se tormar uma série de cuidados.

O trecho de código abaixo ilustra uma possível solução de carga manual, certamente isso pode ser feito de outras formas:

Esta proposta de função para carregar os dados na table window executa diversos controles que SalTblPopulate já faz de forma automática, seguindo a sequencia em que o código foi escrito, pode-se dizer que a função faz o seguinte:

• A função SalTblReset apaga todos os dados existentes na table window deixando-a no estado inicial para receber dados.
• A função SqlPrepareAndExecute utiliza o comando sql presente no parâmetro sCmdSelect, compila, executa e retorna o ponteiro para manipulação no parâmetro hSqlMAIN.
• O comando Loop é utilizado neste ponto para agrupar as instruções de tratamento das repetições envolvendo:
• preparar a grid para uma nova linha ( inserindo linhas com a função SalTblInsertRow ),
• setar o contexto de trabalho ( a função SalTblSetContext faz isso ) para a linha recém inserida,
• recuperar os dados do result set com a função SqlFetchNext
• e encerrar o laço após todas as linhas terem sido recuperadas.
• Um detalhe aqui devido a forma como o laço foi montado, após término do fetch no result set a ultima linha da grid precisa ser excluída, a função SalTblDeleteRow faz isso.
• A função SalTblSetRow move o foco para a primeira linha da table window para que o usuário, após a carga da tabela ter sido concluída possa visualizar as primeiras linhas da table window.
• A função SalTblSetFlagAnyRows limpa o flag ROW_New que é inserido pelo Team Developer quando executada a função SalTblInsertRow.

 

Salvando alterações nos dados

Uma vez os dados disponíveis na table window o usuário pode modificá-los caso queira. No exemplo, da forma como ele está neste ponto, já é possível que o usuário modifique as informações das células. Nosso próximo passo é salvar no banco de dados estas edições.

Obs: Não faz parte do objetivo deste tutorial mostrar técnicas de como evitar que o usuário modifique a chave primária da tabela, isso será visto em outro momento. Portanto assumiremos que a coluna COMPANY_ID não será modificada e não faremos nenhum controle para garantir isso.

Para salvar edições feitas nesta tabela basicamente é necessário preparar um comando UPDATE, identificar as linhas que foram editadas pelo usuário e executar o comando Update para os dados da linha editada.

Para efeitos didáticos o comando Update será armazenado numa variável chamada sCmdUpdate, conforme definições abaixo:

Baseando-se neste comando é possível partir para a atualização em si. Novamente serão mostrado os métodos automático e manual.

Devido a simplicidade desta operação o código será mostrado com os dois métodos juntos. Como segue abaixo:

Primeiramente deve-se preparar o comando UPDATE que será executado para salvar as linhas editadas. Esta é uma etapa necessária para ambos os métodos e está sendo feita através da chamada da função SqlPrepare, é a primeira instrução deste trecho de código.

Para o método automático basta executar a função SalTblDoUpdates passando como parâmetro o handle da table window onde estão os dados alterados, o handle da conexão com o banco de dados que teve o comando Update preparado e um flag indicando se é para a função remover visualmente da table window o flag de que a linha foi editada.

O método manual é um pouco mais trabalhoso requerendo mais linhas de código, porém é inegável o poder e controle que o método manual oferece numa operação dessas.

O trecho de código executa as seguintes ações:

• A variável nLinha é usada como ponteiro das linhas a serem trabalhadas. Tem seu valor setado para –1 para que o laço que se segue inicie e percorra todas as linhas da table window.
• A condição do laço While é o retorno da função SalTblFindNextRow que sempre retornará TRUE caso encontre alguma linha que satisfaça a condição relativa aos flags que a linha possuir, neste caso está filtrando apenas as linhas com flag ROW_Edited = TRUE.  Isso garante que o laço While seja executado apenas para as linhas que efetivamente foram editadas.
• Após identificar a linha que foi editada é necessário setar o contexto de trabalho para ela, é isso que a função SalTblSetContext faz.
• Foco setado é preciso executar o comando Update para a linha, isso é feito com a função SqlExecute.
• O flag de linha editada é removido pela função SalTblSetRowFlags.
• Quando todas as linhas marcadas com o flag de edição forem atualizadas o laço é encerrado e a função SalTblSetRow move o foco para a primeira linha da table window para que o usuário, após a carga da tabela ter sido concluída possa visualizar as primeiras linhas da table window.

Excluindo linhas da table window

Para a exclusão de linhas os comandos necessários para procurar as linhas marcadas para exclusão e executar a exclusão são similares ao descrito anteriormente para update. As diferenças são:

• Deve ser compilado um comando DELETE ao invés de updade.
• O comando para processar automaticamente as exclusões é SalTblDoDeletes
• Para o método manual a função SalTblFindNextRow deve procurar por linhas marcadas com o flag ROW_MarkDeleted.
• O flag que deve ser removido com a função SalTblSetRowFlags deve ser ROW_MarkDeleted.

Na prática as alterações são simples e mostradas abaixo, desta vez num único bloco de comandos:

A única função nova neste trecho de código é SalTblDoDeletes que, de forma similar a como foi visto anteriormente, exclui da table window as linhas marcadas para exclusão. Aliás, este é o único ponto que falta para o programa suportar totalmente a exclusão de linhas.

Na table window do Team Developer há uma forma tradicional de marcar linhas para serem excluídas, basta clicar duplamente na área cinza que antecede a linha, área conhecida como row header. Há um evento para capturar o clique e o clique duplo nesta região. O evento chama-se SAM_RowHeaderDoubleClick e é acionado pelo Team Developer sempre que o usuário realiza um clique duplo no header da linhas.

Neste exemplo utilizaremos este evento para marcar a linha para ser excluída. O trecho de código abaixo ilustra isso:

Desta forma, sempre que o usuário clicar duas vezes no header da linha ela será marcada para excusão (ROW_MarkDeleted = TRUE ).

Para remover ROW_MarkDeleted será utilizado o clique simples na linha. Conforme mostrado abaixo:

Desta forma o usuário pode marcar para exclusão quantas linhas quiser, e depois comanda a exclusão em série de todas as linhas marcadas para serem excluídas.

Inserindo linhas na table window

A inclusão de novas linhas na table window pode (visualmente) ser feita de duas formas. Podemos inserir uma linha nova no início ou final da tabela e mover o foco para a linha para que o usuário possa inserir os dados da nova linha.

Outra forma é abrindo um espaço reservado para linhas novas chamado no Team Developer de Split Window. Nesta área reservada as linhas ficam fixas e não desaparecem caso o usuário role as linhas para cima/baixo com as setas de scroll da table window. Para efeitos didáticos faremos de todas estas formas.

Para inserir uma linha nova no topo da table window

Set nRow = SalTblInsertRow( hWndForm, 0 )
Call SalTblSetFocusCell( hWndForm, nRow, tblCOMPANY.colCOMPANY_ID, 0, 0 )

Para inserir uma linha nova no rodapé da table window

Set nRow = SalTblInsertRow( hWndForm, TBL_MaxRow )
Call SalTblSetFocusCell( hWndForm, nRow, tblCOMPANY.colCOMPANY_ID, 0, 0 )

Para criar uma split window e inserir a nova linha dentro da Split Window

Call SalTblDefineSplitWindow( hWndForm, 3, TBL_Split_Adjustable )
Set nRow = SalTblInsertRow( hWndForm, TBL_MinSplitRow )
Call SalTblSetFocusCell( hWndForm, nRow, tblCOMPANY.colCOMPANY_ID, 0, 0 )

Como é possível observar a codificação é muito parecida, portanto está destacado em sublinhado os trechos que diferem.

No exemplo que você poderá fazer download, o programa faz duas perguntas para identificar se deve criar a split window ou se deve inserir a linha nova no topo ou no rodapé da table window.

Vaja abaixo as perguntas e como as janelas se comportarão para cada tipo de resposta:

Caso seja escolhido inserir dados usando a Split Window, a interface se comporta como tal e a split window é criada.

 

Caso seja respondido “não” a aplicação perguntará se a nova linha deverá ser inserida acima ou abaixo, na table window.

Abaixo seguem uma ilustração mostrando a nova linha inserida no cabeçalho da table window.

No programa exemplo, o código ficou assim:

Após tratar esta questão de onde a linha nova será inserida para que o usuário possa digitar os dados da linha nova, a gravação das linhas novas segue o mesmo padrão adotado para update e delete.

Portanto o código da função que salva as linhas inseridas é esse:

Conclusão

Está pronta uma aplicação CRUD típica em Team Developer feita atrabés de table window mostrando dois métodos de codificação, um mais simples e rápido de codificar (tratado no artigo comom método automático), e outro método mais detalhado que alguns podem achar mais trabalhoso e menos produtivo (chamado no artigo de método manual).

O artigo não trata de questões de produtividade no desenvolvimento, mas sim de forma básica como fazer uma aplicação CRUD. Pretendo mostrar em outros artigos propostas de soluções para obtermos ganho de produtividade bem como explorar muitos outros recursos da table window.

Para fazer o download do código fonte clique aqui.

Como fazer para: formatar campos para tratar data e hora

Este estudo de caso procura mostrar algumas sugestões de formatação para campos de edição do tipo data field e table window column para receber e mostrar datas e horas. A formatação destes campos é feita em tempo de design, no ambiente de desenvolvimento do SQLWindows, utilizando-se o Attribute Inspector.

 

Neste estudo de caso vamos nos concentrar em formatação de campos de data e hora.

 

Entendendo a formatação

 

Objetos tipo data field e table window column permitem a edição do seu conteúdo. Após o usuário encerrar a edição e tirar o foco do objeto o SQLWindows aplica a configuração de formato que você definiu para o objeto mostrando a informação no formato especificado.

 

A formatação de campos no SQLWindows está concentrada em dois locais que você precisa conhecer bem, a seção Formats e o Attribute Inspector.

 

A seção formats está localizada no interior da seção Global Declarations, como você pode ver abaixo:

 

figura 1.

 

Na seção Formats estão definidos todos os formatos utilizados pela sua aplicação. Você deve manter nesta seção apenas os formatos utilizados, evite deixar aqui formatos que não estão sendo utilizados. Esta observação torna-se uma regra quando estiver utilizando Dynalibs.

Você pode determinar como um campo será formatado de forma bem simples, basta selecionar o campo e procurar no Attribute Inspector pela propriedade “Format”, selecionando a formatação que desejar.

 

figura 2.

 

Você pode formatar um campo de duas formas:

• escolhendo um dos formatos já existentes e mostrados no combo Box de tipos de formatos.
• personalizar a formatação informando uma nova máscara que se adapte melhor às  necessidades da sua aplicação.

 

Para formatar um campo de forma personalizada você precisará conhecer os caracteres que compõem a máscara de formato e suas funções:

 

Caracter	Função
d	Mostra o número do dia , sem o zero à esquerda ( 1-31 )
dd	Mostra o número do dia , com o zero à esquerda ( 01-31 )
ddd	Mostra o nome do dia abreviado ( Seg-Dom )
dddd	Mostra o nome completo do dia ( Segunda-feira – Domingo )
M	Mostra o número do mês, sem o zero à esquerda ( 1-12 )
MM	Mostra o número do mês, com o zero à esquerda ( 01-12 )
MMM	Mostra o nome do mês abreviado ( Jan-Dez )
MMMM	Mostra o nome completo do mês ( Janeiro-Dezembro )
yy	Mostra o ano com dois dígitos
yyyy	Mostra o ano com quatro dígitos
hh	Mostra a hora ( 0-12 )
hhhh	Mostra a hora ( 0-24 )
mm	Mostra os minutos ( 0-59 )
ss	Mostra os segundos ( 0-59 )
mmmmmm	Mostra os milésimos de segundos ( 000000-999999 )
AMPM	Mostra hora no formato internacional

 

Basicamente um formato precisa ser definido nos mesmos padrões dos formatos do MS Excel.

 

Fique atento !   Uma outra maneira de formatar campos é utilizando a formatação pré-configurada pelo SQLWindows, conhecida como profile-driven, escolhendo um país na lista chamada “Country”. Porém este recurso foi descontinuado e está presente apenas para efeito de manter a compatibilidade, recomendamos que você não utilize este recurso. Se estiver utilizando recomendamos que troque para os formatos pré-definidos na lista de formatos do Attribute Inspector.

 

Mãos a obra !

 

Agora que você já conhece os caracteres utilizados na definição dos formatos, suas funções e sabe onde é feita a definição dos formatos podemos exercitar um pouco.

 

 

Este exemplo chama-se “Estudo de caso - 1.apt” e está disponível para download aqui:

 

Novo produto da familia Team Developer

A Gupta está preparando uma ferramenta totalmente nova para criação de aplicações mobile e eu testei uma aplicação exemplo e gostaria de compartilhar aqui.

A aplicação exemplo é uma interface para o banco de dados de exemplo que acompanha o Team Developer há alguns anos, o banco ISLAND.

A aplicação é bem simples e funcionou rápida e sem problemas num acesso através de wi-fi.

Abaixo segue algumas imagens da navegação através do site:



Página de login na aplicação

 

A sequencia abaixo mostra as páginas de uso da aplicação após a navegação ter sido iniciada escolhendo uma empresa cliente.

Relação de clientes

Detalhes do cliente

Cada cliente possui invoices associadas a ele e cada invoice possui algumas informações de cadastro. Estas duas páginas são mostradas abaixo:

Relação de invoices

Detalhes de uma invoice

A página abaixo mostra os itens que compoem uma invoice

A página abaixo mostra o nível maior de detalhe, onde é possível ver a imagem da estampa da camiseta.

A aplicação foi testada com sucesso num smartphone rodando Windows Phone 8.

links

página do TD Mobile: http://guptatechnologies.com/Products/App_Dev/TDMobile/default.aspx

página da aplicação: 
https://tdmobile.guptatechnologies.com/Island/Login