Perguntas CONTRIBUICAO: WORKFLOW HTTP/LINK NO PROTHEUS 11

Vamos lá...

Se você chegou aqui através de alguma busca no google e está precisando configurar o processo de workflow no seu Totvs Protheus 11, a notícia é boa: é fácil, prático e rápido, só que a TOTVS faz questão de NÃO DOCUMENTAR APROPRIADAMENTE. Fora isso o que a gente encontra nos fóruns por aí na maioria das vezes são sugestões de COPIAR e COLAR appserver.ini, sem ninguém entender / explicar direito pra que servem esses parâmetros, afinal de contas a documentação PRATICAMENTE NÃO EXISTE.

O que voce precisa:

- Application Server versão 11 build >= 7.00.111010P
- Conhecimento Básico em Advpl
- IDE para compilar o ADVPL

O que você deve fazer:

1) Configuracoes iniciais

1.1) Configure um endereço de email válido para utilizacao com SMTP em SigaCFG-> Workflow -> Contas de Email.

1.2) Seguir SOMENTES ESTES passos da ativação do Workflow disponibilizados no Help Online.


Ativando o Workflow

Como o Workflow é uma ferramenta embutida dentro do Microsiga Protheus, bastam algumas configurações no "appserver.ini" para ativá-lo. Inicialmente, devemos colocar na seção ONSTART deste arquivo de configurações a função WFONSTART, para iniciar o agendamento das funções para o Workflow.

Esta função inicia um Job que fica verificando se existem agendamentos a serem executados.

Acrescente no "appserver.ini" as seguintes linhas:

[ONSTART]
jobs=SchedulerWF
[SchedulerWF]
Main=WFONSTART
Environment=Environment <- Coloque aqui o seu Environment (ambiente).


As linhas acima indicam que sempre que o servidor do Microsiga Protheus® for iniciado, ele irá executar as funções contidas em cada job. Você poderá iniciar várias funções ao mesmo tempo.

Crie no diretório "SIGAADV" um arquivo chamado scheduler.wf. Este arquivo deverá conter a seguinte estrutura:

• aa,bb,env,T,mod
onde:
aa = Indica o código da empresa onde será iniciado o job
bb = Indica o código da filial onde será iniciado o job
env = nome do environment (ambiente) onde será iniciado o job
T = Indica se inicia ou não os processos parados automaticamente.
Dica: Deixe como T e não como F.
mod = Sigla do módulo do qual o Scheduler irá pegar uma licença, caso exista. Por padrão, ele procura por uma licença do Faturamento.
Exemplo1:
01,01,EnvTop811,T,PCP
Caso seja necessário iniciar o agendamento para mais de uma empresa, basta repetir a seqüência acima separadas por pontos e vírgulas(.
Exemplo 2:
01,01,EnvTop811,T,PCP;03,01,EnvTop811,T,COM

Configurando os Parâmetros do Workflow

Após criadas as contas é necessário configurar alguns parâmetros do Workflow para que o mesmo passe a funcionar.

Procedimentos

Para configurar estes parâmetros é necessário estar na rotina "Parâmetros WF" do ambiente Configurador.

Nesta tela, são necessárias as seguintes informações:

1. Pasta "Correio"
a) Conta: Escolha a Conta de E-mail a ser utilizada.
b) Envia figuras do HTML como anexo da mensagem: Marque esta opção caso deseje enviar anexadas as imagens contidas no HTML.
c) Envia HTML no Corpo da Mensagem: Caso deseje que a página HTML vá anexada ao e-mail e não no corpo, deixe esta opção desmarcada.
d) Usa Java Script®: Marque esta opção caso deseje que o Workflow insira algumas validações em Java Script® na página HTML.
2. Pasta "Processos"
a) Execução de Retornos: Informe quantos retornos serão processados ao mesmo tempo pelo Workflow. Quanto maior este número, mais memória será exigida do Servidor.
b) Reativar Processos Automaticamente: Caso algum processo de retorno seja interrompido e esta opção estiver marcada, no próximo reinício do Workflow o processo será automaticamente reiniciado.
c) Usar Transação na Execução de Funções 'RETORNO' e 'TIMEOUTS': Caso queira usar controle de transação de banco de dados nas rotinas de retorno e timeout marque esta opção.
3. Pasta "Notificação"
a) Endereço: Informe a conta de e-mail que receberá notificações do Workflow
b) Enviar Notificação: Escolha qual tipo de notificação deverá ser enviada via e-mail.
4. Pasta "Messenger"
a) Browser Internet - Caminho: Informe o path do Internet Explorer® (iexplore.exe).
b) Servidor: Informe IP do Servidor do Microsiga Protheus®
c) Diretório HTTP - Caminho: Informe o diretório onde serão gravados os arquivos para o http.



DEIXE A OPCAO DE UTILIZACAO DO MESSENGER DESMARCADA!!!
NAO EH NECESSARIO CONFIGURAR JOBS / PROCESSOS ESPECIAIS NO SCHEDULE QUANDO SE TRABALHA COM WORKFLOW VIA HTTP

2) Criar seu Workflow, que pode ser em um ponto de entrada, chamado pelo usuário ou ainda pelo Schedule, atraves da classe TWFProcess tdn.totvs.com/display/public/mp/TWFProcess . Existem vários exemplos na seção de Download deste FORUM, mas CUIDADO: atente apenas para os fontes PRW, muitos arquivos de configuracao sao confusos e/ou nao fazem mais sentido no Protheus 11. Utilize os exemplos e o help online para aprender como interagem os arquivos HTML com a classe TWFProcess.

Observacao 1: Com relacao aos metodos e propriedades da classe TWFProcess, quando houver conflito (e há) entre o que fala o HELP e o que fala o TDN, o correto esta no TDN.

Observacao 2: Quando for debugar, utilize a funcao CONOUT(cString) para imprimir cString no arquivo console.log (mesma pasta do appserver.ini).

Observacao 3: Se quiser cadastrar seus processos e status de Workflow, para rastrear seus processos pelo Smartclient, VOCE TEM QUE ACIONAR ESTES CADASTROS VIA FORMULA OU ADICIONA-LOS AO SEU MENU POIS A TOTVS OS RETIROU DO SUBMENU DO WORKFLOW. Sao as funcoes: WFA001 (Processos) e WFA002 (Status de Processos).

3) Habilite o servico HTTP apontando o caminho para a mesma pasta que voce definiu na configuracao do Workflow. Segue o exemplo:

[http]
enable=1
path=C:\TOTVS 11\Microsiga\Protheus_Data\web
port=80
Environment=SEUAMBIENTE

4) E pra finalizar, se o seu workflow estiver mandando o email, o destinatário estiver recebendo, o link estiver abrindo corretamente e na hora que voce vai clicar no enviar ele da uma mensagem de erro, informando que os parametros nao foram recebidos, ISSO NAO TEM NADA A VER COM SEU appserver.ini - se voce nao utiliza WEBSERVICES, tudo que voce vir de exemplo de appserver.ini contendo a expressao "WEBEX" NAO LHE INTERESSA. O problema será ou seu código fonte ou o PARAMETRO MV_WFWEBEX. Para funcionar corretamente deve estar como .F.

Entao é isso.

Um abraco, e quem quiser colaborar comigo nos meus tópicos, EU AGRADEÇO.


André.

Boa tarde Andre,

Rescentemente instalei e configurei o Protheus11 e uma das grandes mudanças em relacao ao Protheus10 refere-se ao schedule. No entanto, nao vi voce mencionar as novas funções conforme abaixo e necessarias ás execuções apartir da versao 11.

[OnStart]
jobs=FWSCHDMANAG_AGENDA,FWSCHDQUEUE_AGENDA
RefreshRate=120

[FWSCHDMANAG_AGENDA]
Main=FWSCHDMANAG
Environment=TESTE

[FWSCHDQUEUE_AGENDA]
Main=FWSCHDQUEUE
Environment=TESTE

Note que agora é necessario as funcoes FWSCHDMANAG e FWSCHDQUEUE.
Voce consegue disparar seus workflow´s sem estas funcoes na versao 11 ?

Att,
Rodrigo

Boa Tarde Rodrigo,

Pode ter certeza que as funções que você mencionou não tem impacto sobre o Workflow. Possivelmente elas tem alguma relação com o Scheduler em si, mas nao com as ações do Workflow.

Eu não utilizo funções de Workflow acionadas via Scheduler. Todos os meus workflows funcionam perfeitamente.

Um abraço.

Crie no diretório "SIGAADV" um arquivo chamado scheduler.wf.

Diretório? Aonde fica esse diretório? O Arquivo eu crio pelo notepad?

Boa tarde, Estou tentando implantar um APPSERVER exclusivo para o Workflow, configurei aparentemente correto, não consigo subir o Appserver. Da um erro como se ele tentasse executar uma função mas a função não existe no RPO, alguem já fez isso ?