Fórum - Master Advpl :: Topic: CONTRIBUICAO: WORKFLOW HTTP/LINK NO ...

Page 1 of 4

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:

http://www.masteradvpl.com.br/index.php/forum/25-tecnologia-protheus/10978-contr... 02/07/2013
Fórum - Master Advpl :: Topic: CONTRIBUICAO: WORKFLOW HTTP/LINK NO ... Page 2 of 4

• 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

http://www.masteradvpl.com.br/index.php/forum/25-tecnologia-protheus/10978-contr... 02/07/2013
Fórum - Master Advpl :: Topic: CONTRIBUICAO: WORKFLOW HTTP/LINK NO ... Page 3 of 4

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

http://www.masteradvpl.com.br/index.php/forum/25-tecnologia-protheus/10978-contr... 02/07/2013
Fórum - Master Advpl :: Topic: CONTRIBUICAO: WORKFLOW HTTP/LINK NO ... Page 4 of 4

"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é.

http://www.masteradvpl.com.br/index.php/forum/25-tecnologia-protheus/10978-contr... 02/07/2013