Esta função carrega a soma de string na memória e só retira de lá quando o processo morre, com isso temos  que tomar certos cuidados no uso desta função em fluxos grandes e complexos.

Para evitar estes tipos de problemas, podemos substituir a função “Concatenação” pela função “Append”

Função Append:

Junta vários itens de texto em apenas um item.

Parâmetros:
1. Valor que terá outros valores adicionados
2. Valor que será concatenado junto ao texto do primeiro parâmetro.
…
N. Valor n a ser adicionado.

Retorno:  Retorna o valor concatenado.

Em termo de usabilidade, ela difere da função “Concatenação”, veja abaixo:

Exemplo: Para acumular uma variável com a função concatenação, faríamos:

Já na função Append, não precisa ser atribuído a nenhuma variável, pois ela acumula  na variável que estiver no primeiro parâmetro, veja:

Atenção: É indispensável o uso desta função(Append) no desenvolvimento de sistema de nota fiscal eletrônica (NFe), pois faz muitas somas de strings para criação dos XMLs.

Há um grande problema em semáforos, o deadlock. Este ocorre quando um processo adquiri o semáforo, mas ocorre uma falha no meio da execução. Com isso o semáforo fica preso.

Para não ocorrer isto, temos que utilizar monitoramento de exceções (TRY-CATCH). Veja a  imagem abaixo:

Pronto, caso ocorra uma falha no subfluxo “Fluxo a ser processado”, a execução será pulada automaticamente para o processamento “Capturar exceção (CATCH)” e tudo que estiver após deste processamento será processado como FINALLY. Com isso o semáforo sempre será liberado.

Existem disponíveis na internet, algumas API’s do Twitter para várias linguagens, entre elas um pacote Java.
O pacote utilizado por mim chama-se jtwitter open source e criada pela winterwell. Se encontra na versão 1.3 neste momento em que escrevo.
Dentre as existentes (encontrei 4) escolhi o JTwitter por ser open source e muito simples de utilizar.

Foram criadas 3 funções:
Twitter – Abrir Conexão
Twitter – Atualizar Status
Twitter – Obter mensagens

Basicamente, com as 3 funções você pode enviar uma mensagem (ou tweet como é chamado) e verificar as últimas 20 mensagems nas últimas 24 horas da sua página do twitter.
As funções são bem simples de se utilizar. Só ler a pequena documentação que fiz em cada uma delas (Basicamente funciona como as funções de arquivo, onde se guarda a referencia do arquivo aberto para posteriormente utiliza-la para enviar ou receber mensagens).

Para utiliza-las, além de importar no Maker as funções, deve-se incluir o pacote jar da biblioteca do jtwitter no diretório: “…\Softwell Solutions\Maker 2.5\Webrun 2\tomcat\webapps\webrun\web-inf\libs”
Após inserir o pacote jar neste diretório, reinicie o servidor de aplicações 2x.

Pronto! Basta utilizar as funções agora em seu fluxo!
Segundo as “regras” da biblioteca gratuita, a única exigencia deles é expor o autor (feito acima). Se vocês observarem, a cada mensagem enviada, fica abaixo o “via JTwitter”. Caso queiram, basta editar o arquivo JTwitter.java que se encontra dentro do pacote e editar este trecho do código.

Downloads:
Pacote JAR (versão 1.3)
Funções Twitter

Simples e fácil, não?

Este exemplo contém os seguintes arquivos:

Abrir Consulta Paradox.frz –> Contém a função “Abrir conexão Paradox” e um exemplo
DadosParadox.rar –> Umas tabelas em paradox . Ponha em C:\DadosParadox
paradox.jar –> biblioteca que deverá ser adicionada ao webrun. Há duas alternativas para isso:
1) remove dbf_jdbc30.jar e adiciona paradox.jar em <webrun>\WEB-INF\lib (reinicia o webrun)
2) ou adiciona paradox.jar em <sistemas>\Maker.Commons\WEB-INF\lib\ e cria um arquivo zerado DBF_JDBC30.jar nesse mesmo diretório. (reinicia o webrun duas vezes)

Observações:

1) As bibliotecas de conexão a paradox (paradox.jar) e dbf (dbf_jdbc30.jar) não podem estar contidas ao mesmo tempo
no webrun. Para usar esta função, a biblioteca dbf_jdbc30.jar deve ser removida do webrun.
2) Deve ser usada a função “Abrir Consulta Navegável” no lugar da função “Abrir Consulta”

Imagem do fluxo:

Clique aqui para efetuar um download do exemplo.

Alguns necessitam redirecionar para uma página específica que depende do retorno do fluxo. Como fazer? No objeto fim, coloque o retorno:
<script language=”JavaScript”>window.location.href=”http://www.google.com”</script>
Neste caso, retornaria para a página do google. Observe que dentro da tag script, poderia ter sido utilizado qualquer comando javascript, como alert etc.

Também é possível retornar uma página html inteira, com um formulário, layout e tudo mais. Basta no objeto “FIM” incluir todo o código da página html:

<html>

<head></head>
<body>Página HTML!</body>
</html>

Só usar a criatividade!

Dúvidas?! Veja o nosso fórum!

Apesar de simples, muita gente ainda tem dificuldades de como realizar este tipo de operação. Em se tratando de banco de dados, uma das melhores (e mais rápida) maneira de resolver, seria no proprio select. Entretanto, o sistema iria começar a ficar “particular” para um banco de dados específico. Então geralmente partimos pro fluxograma.
E lá nos deparamos: Não há função para decrementar!

Como resolver?

Simples! Na função (Incrementar dia/mês/ano), passamos a data e um valor que será incrementado na data passada como primeiro parâmetro. O valor será somado na data. Para decrementar, basta passarmos um valor negativo!

Passando um valor negativo como parâmetro de entrada para a função.

A função irá fazer: data=data+valor.
Se valor for igual a -7 por exemplo, ficará: data=data+-7, o que acabará subtraindo o dia/mês ou ano.

Dúvidas!? Utilize o nosso forum!

Como funciona? Vamos criar um fluxo para executar a função “Traduzir”:

Passo 01: Selecione a função “Traduzir” no montador de expressão do componente processamento

Traduz um texto para um determinado idioma.

Parâmetros:

1. Texto a ser traduzido

2. Lista de parâmetros do texto

Retorno: Retorna o texto traduzido para o idioma definido no parâmetro

Observações:

1. Quando utilizada na camada servidor, a função irá buscar o texto passado na tabela de traduções. Se for utilizada na camada cliente, o texto já tem que estar determinado no fluxo para que ele possa buscar na tabela antes da chamada da função.

2. O segundo parâmetro é para definir nomes próprios que não possuem tradução.

Exemplo:

Se definirmos o texto:

P1. Meu nome é {0}

No Segundo parâmetro devemos criar uma lista com os valores correspondentes a posição no texto.

P2. Lista [Alex Santos]

Desta forma, a função irá retornar:  My name is Alex Santos

Atribua o retorno para uma variável do tipo letras e utilize o componente interação para exibir o conteúdo da variável na tela.

Antes de visualizar o resultado, é necessário colocar no Tradutor do Maker o texto a ser traduzido como  ilustrado na imagem abaixo:

Clique em “Novo” e insira o texto a ser traduzido na coluna “Texto Original” e a tradução do texto na coluna “Texto Traduzido” como mostra a imagem abaixo:

Clique no botão onde está circulado de vermelho na imagem acima para confirmar a inclusão.

Pronto, feito isto reinicie o sistema e a partir de agora quando o seu sistema for acessado com webrun internacionalizado paro o inglês o conteúdo da mensagem contido no fluxo do exemplo acima será internacionalizado também e caso o usuário acesse o webrun em português a mensagem continuará em português.

Para internacionalizar o webrun basta clicar nas devidas bandeirinhas no painel de entrada do sistema:

Soube que recentemente houve uma correção para função “Traduzir”, com isso clique aqui para baixa a função utilizada no exemplo acima

Como solucionar este problema?

Como solução, foi criada uma função que interage com um applet que tem a funcionalidade de executar um comando na máquina cliente.

Para executar a função é necessário seguir os seguintes passos:

1- Copiar os arquivos “HTMLExecuteCommandApplet.html” e “ExecCMD.jar” para a pasta ${webrun}\apps
2- Importar a função através do arquivo “ExecutarLinhaDeComandoNaMaquinaDoCliente.FRZ”
3- Será necessário que o cliente tenha instalado a máquina virtual java.
4- Será necessário que o applet seja assinado ou que o cliente dê permissão para que um applet possa executar comandos.

Observação: Caso a escolha seja permitir que um applet tenha permissão de acesso, pode-se incluir no arquivo “${JRE_HOME}\lib\security\java.policy” a seguinte linhas:

grant {
permission java.security.AllPermission;
};

Insira a linha acima na parte // default permissions granted to all domains do arquivo java.policy

Para testar se realmente está funcionando, crie um fluxo para executar a função “Executar linha de comando na máquina cliente”

Passe como parâmetro para a função o comando ”calc”, este comando abrirá a calculadora na máquina do cliente.

Clique aqui para fazer o download dos arquivos listados abaixo:

“HTMLExecuteCommandApplet.html” = Html responsável por invocar o applet
“ExecCMD.jar” = Contém os arquivos do applet
“ExecutarLinhaDeComandoNaMaquinaDoCliente.FRZ” = Função para ser exportada para o maker
“HTMLExecuteCommandApplet.java” = Código fonte do Applet

Esta solução foi desenvolvida por Alan Moraes

Importanto as Funções

Com esse excesso de atualizações de funções, evito ao máximo atualizar a API afim de evitar problemas nos meus sistemas, uma vez que o mesmo está desenvolvido baseado em como as funções foram concebidas. Para verificar qual a versão da sua API, basta um simples select na tabela FR_PROPRIEDADE. Nela existe uma propriedade de nome “CurrentAPIVersion”.

Comando SQL para verificar qual a versão da API utilizada no sistema

Observe que neste sistema específico, a versão que está sendo utilizada é a 1.1.8.

Um problema que pode-se ocorrer em sistemas manipulado por mais de 1 pessoa – uma fabrica de software por exemplo – é o de importação de funções de forma involuntária. Imagine a situação: Você está desenvolvendo um sistema a pelo menos 3 meses e decide adicionar uma pessoa nova a sua equipe de desenvolvimento. Como essa pessoa é novata e não conhece como a ferramenta funciona, durante o desenvolvimento dela na ferramenta, possívelmente ao acessar o sistema e perguntar se deseja atualizar a versão da API para uma mais nova ela clicará em SIM !

O problema não está no momento que ele/ela importar as funções e sim algumas semanas depois quando você verificar que uma tela que estava funcionando a 2 meses atrás e parou de funcionar “DO NADA”. Então, como evitar este tipo de problema?

1) Conversar com os funcionários e ter um bom treinamento antes de aplicar a mão na massa sempre é bem-vindo.
2) Restringir permissões a nível de banco de dados a alterações de alguma entidade.
3) “Desabilitar” o questionamento por novas funções.

Particularmente prefiro a terceira opção por ser simples e rápida. Basta fazer um update no campo pro_valor para um valor “9.9.9″ por exemplo. Desta forma, mesmo que exista uma versão 2.0 da API de funções (o que deve demorar a ocorrer acredito), não será perguntado a nenhum Maker (IDE), pois a versão do sistema está definida como 9.9.9
Desta forma, as funções estariam mais “seguras”.

Comando SQL para efetuar o update:

UPDATE fr_propriedade SET
pro_valor = ‘9.9.9′
WHERE (pro_nome = ‘CurrentAPIVersion’)

Atenção:
Se você obteve uma versão da API por download que não tenha sido o atualizador automático, observe que, o update na tabela FR_PROPRIEDADE ocorre de forma automática apenas se o arquivo frz estiver na pasta resource junto com as demais versões da API.

Pasta Resources do Maker

Fazendo a importação de forma manual não é efetuada a atualização na tabela FR_PROPRIEDADE fazendo com que o Maker “pense” que está utilizando uma versão inferior a utilizada por você.

Gostaria de continuar discutindo um pouco mais sobre este assunto ou tirar dúvidas? Acesse o tópico em nosso forum !