Boletim Tcnico

Workflow EEC
Produto

Microsiga Protheus Easy Export Control Verso 11

Chamado/Requisito

TFVYJ2

Data da publicao

07/11/12

Pas(es)

Brasil

Banco(s) de Dados

Todos

Esta melhoria depende de execuo do update de base

Procedimentos para Implementao.

UEWORKFLOW,

conforme

Implementada melhoria que consiste na criao da rotina WorkFlow (EASYWORKFLOW) com o objetivo de informar ao usurio
via e-mail quando um processo includo ou manipulado.
possvel tambm configurar workflows automticos disparados atravs da rotina de Schedule (CFGA010) presente no mdulo
Configurador (SIGACFG).

PROCEDIMENTOS PARA IMPLEMENTAO

Para viabilizar essa melhoria, necessrio aplicar o pacote de atualizaes (Patch) deste chamado.

Aplicar atualizao do(s) programa(s) AVGERAL.PRW, AVOBJECT.PRW, AVUPDATE01.PRW, EECAE100.PRW, EECAF200.PRW,

EECNU400.PRW, EECTP101.PRW, EECAP100.PRW, EASYWORKFLOW.PRW, EASYCADWORKFLOW.PRW, EASYWFCR.APH,
EASYWFCA.APH, EASYWFLC.APH, EASYWFLD.APH, EASYWFAP.APH, EASYWFEC.APH, EASYWFNR.APH, EASYWFLB.APH,
EASYWFPE.APH, EECAP107.PRW, EECAP108.PRW, EECAE111.PRW, EECAE112.PRW, EECAE113.PRW, EECAF202.PRW,
EECAF203.PRW, EECNU401.PRW, EECTP201.PRW, UEWORKFLOW.PRW, WFSchEECCambio.PRW, EASYWFLINK.APH e
EASYWFANEXO.APH.

Para que as alteraes sejam efetuadas, necessrio executar a funo U_UEWORKFLOW.

Antes de executar o compatibilizador UEWORKFLOW imprescindvel:

a)
b)
c)

Realizar o backup da base de dados do produto que ser executado o compatibilizador (diretrio
\PROTHEUS11_DATA\ DATA) e dos dicionrios de dados SXs (diretrio \PROTHEUS11_DATA\ SYSTEM).
Os diretrios acima mencionados correspondem instalao padro do Protheus, portanto, devem ser alterados
conforme o produto instalado na empresa.
Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usurio deve estar utilizando o sistema.

SIGAEEC Workflow EEC

Boletim Tcnico

d)

e)

Se os dicionrios de dados possurem ndices personalizados (criados pelo usurio), antes de executar o
compatibilizador, certifique-se de que esto identificados pelo nickname. Caso o compatibilizador necessite criar
ndices, ir adicion-los a partir da ordem original instalada pelo Protheus, o que poder sobrescrever ndices
personalizados, caso no estejam identificados pelo nickname.
O compatibilizador deve ser executado com a Integridade Referencial desativada*.

O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de
Dados (DBA) ou equivalente!
A ativao indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no
banco de dados. Portanto, antes de utiliz-la, observe atentamente os procedimentos a seguir:
i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opo
Integridade/Verificao (APCFG60A).
ii. Se no h Integridade Referencial ativa, so relacionadas em uma nova janela todas as empresas e filiais
cadastradas para o sistema e nenhuma delas estar selecionada. Neste caso, E SOMENTE NESTE, no
necessrio qualquer outro procedimento de ativao ou desativao de integridade, basta finalizar a
verificao e aplicar normalmente o compatibilizador, conforme instrues.
iii. Se h Integridade Referencial ativa em todas as empresas e filiais, exibida uma mensagem na janela
Verificao de relacionamento entre tabelas. Confirme a mensagem para que a verificao seja concluda,
ou;
iv. Se h Integridade Referencial ativa em uma ou mais empresas, que no na sua totalidade, so relacionadas
em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em)
integridade estar(ro) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade
ativada e reserve esta anotao para posterior consulta na reativao (ou ainda, contate nosso Help Desk
Framework para informaes quanto a um arquivo que contm essa informao).
v. Nestes casos descritos nos itens iii ou iv, E SOMENTE NESTES CASOS, necessrio desativar tal integridade,
selecionando a opo Integridade/Desativar (APCFG60D).
vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instrues.
vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido
desativada, atravs da opo Integridade/Ativar (APCFG60). Para isso, tenha em mos as informaes da(s)
empresa(s) e/ou filial(is) que possua(m) ativao da integridade, selecione-a(s) novamente e confirme a
ativao.

Contate o Help Desk Framework EM CASO DE DVIDAS!

1.

Em Microsiga Protheus Smart Client, digite U_UEWORKFLOW no campo Programa Inicial.

Para a devida atualizao do dicionrio de dados, certifique-se que a data do compatibilizador seja igual ou
superior a 27/09/12.
2.

Clique em Ok para continuar.

SIGAEEC Workflow EEC

Boletim Tcnico

3.

Aps a confirmao exibida uma tela para a seleo da empresa em que o dicionrio de dados ser modificado.
Selecione a empresa desejada e confirme.

4.

Ao confirmar exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo em modo
exclusivo.

Confirme para dar incio ao processamento. O primeiro passo da execuo a preparao dos arquivos, conforme
mensagem explicativa apresentada na tela.
5.

Em seguida, exibida a janela Atualizao concluda com o histrico (log) de todas as atualizaes processadas.
Nesse log de atualizao so apresentados somente os campos atualizados pelo programa. O compatibilizador
cria os campos que ainda no existem no dicionrio de dados.

6.

Clique em Gravar para salvar o histrico (log) apresentado.

7.

Clique em Ok para encerrar o processamento.

ATUALIZAES DO COMPATIBILIZADOR
1.

2.

Criao de Tabelas no arquivo SX2 Tabelas:

Chave

EJ7

EJ8

Nome

Workflow

Ctrl IDs WF

Modo

Exclusivo

Exclusivo

Criao de Campos no arquivo SX3 Campos:

Tabela EJ7 WorkFlow:

Campo

EJ7_FILIAL

EJ7_COD

EJ7_DESC

EJ7_ATIVO

Tipo

Tamanho

20

50

Decimal

@!

@!

Formato
Ttulo

Filial

Cdigo

Descrio

WF Ativo?

Descrio

Filial do Sistema

Cdigo

Descrio

WF Ativo?

Nvel

Usado

No

Sim

Sim

Sim

Obrigatrio

No

Sim

Sim

No

Browse

No

Sim

Sim

No

Opes

1=Sim;2=No

SIGAEEC Workflow EEC

Boletim Tcnico

Relao

Help

Filial do Sistema

Cdigo Processo

Descrio

WF Ativo?

Campo

EJ7_HTML

EJ7_HTMLI

EJ7_HTMAN

EJ7_VMDEST

Tipo

Tamanho

20

20

20

120

Decimal

Ttulo

HTML Form.

HTML Link

HTML Anexo

Destinatrios

Descrio

HTML Form.

HTML Link

HTML Anexo

Destinatrios

Nvel

Usado

Sim

Sim

Sim

Sim

Obrigatrio

No

No

No

No

Browse

No

No

No

No

Help

HTML Form.

HTML Link

HTML Anexo

Destinatrios

Campo

EJ7_COPIA

EJ7_COPOC

EJ7_ASSUNT

EJ7_TIMEOU

Tipo

Tamanho

120

120

50

Decimal

Ttulo

Cpia

Cpia Oculta

Assunto

TimeOutDias

Descrio

Cpia

Cpia Oculta

Assunto

TimeOutDias

Nvel

Usado

Sim

Sim

Sim

Sim

Obrigatrio

No

No

No

No

Browse

No

No

No

No

Help

Cpia

Cpia Oculta

Assunto

TimeOutDias

Campo

EJ7_TIMEHR

EJ7_TIMEMI

EJ7_FUNCEN

EJ7_FUNCRE

Tipo

Tamanho

50

50

Decimal

Ttulo

TimeOutHrs

TimeOutMins

Func Envio

Func Retorno

Descrio

TimeOutHrs

TimeOutMins

Funo Envio

Funo Retorno

Nvel

SIGAEEC Workflow EEC

Boletim Tcnico

Usado

Sim

Sim

Sim

Sim

Obrigatrio

No

No

No

No

Browse

No

No

No

No

Help

TimeOutHrs

TimeOutMins

Funo Envio

Funo Retorno

Campo

EJ7_TIPO

EJ7_FUNCVA

EJ7_TIPORE

EJ7_TIPSRV

Tipo

Tamanho

50

Decimal

Ttulo

Tipo Env. WF

Func Variav

Tipo Ret.WF

Tip Servidor

Descrio

Tipo Env. WorkFlow

Funo Variveis

Tipo Ret. WorkFlow

Tipo Servidor

Nvel

Opes

1=Formulrio;
2=Anexo; 3=Link

1=Schedule;
2=Funo

1=Web
Protheus;
2=Web

Inicializador Padro

Usado

Sim

Sim

Sim

Sim

Obrigatrio

No

No

No

No

Browse

No

No

No

No

Help

Tipo Env. WorkFlow

Funo Variveis

Tipo Ret. WorkFlow

Tipo Servidor

Campo

EJ7_SERVID

EJ7_ CHAVES

EJ7_FASE

EJ7_MODULO

Tipo

Tamanho

50

50

20

Decimal

Ttulo

Servidor

Chaves

Fase

Mdulo

Descrio

Servidor

Chaves

Fase

Mdulo

Nvel

Usado

Sim

Sim

Sim

Sim

Obrigatrio

No

No

No

No

Browse

No

No

No

No

Help

Servidor

Chaves

Fase

Mdulo

SIGAEEC Workflow EEC

Boletim Tcnico

Tabela EJ8 Ctrl IDs WF:

Campo

EJ8_FILIAL

EJ8_ID

EJ8_CHAVE

EJ8_IDENT

Tipo

Tamanho

10

200

20

Decimal

@!

@!

@!

ID Proc

Chave

Identific.

ID Processo

Chave

Nro de
Identificao

Formato
Ttulo

Filial

Descrio

Filial do Sistema

Nvel

Usado

No

Sim

Sim

Sim

Obrigatrio

Sim

Sim

Sim

Sim

Browse

No

Sim

Sim

Sim

Help

Filial do Sistema

ID Processo

Chave

Nro de
Identificao

Campo

EJ8_PROCES

Tipo

Tamanho

20

Decimal

Ttulo

Processo

Descrio

Processo

Nvel

Usado

Sim

Obrigatrio

Sim

Browse

Sim

Help

Processo

Tabela EE7 Processo de Exportao:

Campo

EE7_ID_CR

EE7_ID_AP

Tipo

Tamanho

10

10

Decimal

Ttulo

ID WF CR

ID WF AP

SIGAEEC Workflow EEC

Boletim Tcnico

Descrio

ID WorkFlow
Crd.

ID WorkFlow
Aprov.

Nvel

Usado

Sim

Sim

Obrigatrio

No

No

Browse

No

No

Help

ID WorkFlow
Crdito

ID WorkFlow
Aprovao

Campo

EEC_ID_LC

EEC_ID_EMB

EEC_ID_LB

Tipo

Tamanho

10

10

10

Decimal

Ttulo

ID WF LC

ID WF EMB

ID WF LB

Descrio

ID WorkFlow L/C

ID WorkFlow
Embarque

ID WorkFlow
Liberao

Nvel

Usado

Sim

Sim

Sim

Obrigatrio

No

No

No

Browse

No

No

No

Help

ID WorkFlow L/C

ID WorkFlow
Embarque

ID WorkFlow
Liberao

Tabela EEC Embarque:

Tabela EEU Numerrio de Exportao:

Campo

EEU_ID

Tipo

Tamanho

10

Decimal

Ttulo

ID WF

Descrio

ID WorkFlow

Nvel

Usado

Sim

Obrigatrio

No

Browse

No
SIGAEEC Workflow EEC

Boletim Tcnico

Help

ID WorkFlow

Tabela EEQ Valor das Parcelas do Embarque:

Campo

EEQ_ID_CB

EEQ_ID_LB

Tipo

Tamanho

10

10

Decimal

Ttulo

ID WF CB

ID WF LB

Descrio

ID WorkFlow
Cambio

ID WorkFlow
Liquidao

Nvel

Usado

Sim

Sim

Obrigatrio

No

No

Browse

No

No

Help

ID WorkFlow
Cmbio

ID WorkFlow
Liquidao de
Cmbio

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

3.

ndice

EJ7

EJ7

EJ8

EJ8

Ordem

Chave

EJ7_FILIAL+EJ7_COD

EJ7_FILIAL+EJ7_FASE

EJ8_FILIAL+EJ8_ID

EJ8_FILIAL+EJ8_CHAVE

Descrio

Cod.Proc

Fase

ID.Proc

Chave

Proprietrio

4.

Criao de ndices no arquivo SIX ndices:

Criao de Parmetros no arquivo SX6 Parmetros:

Nome da Varivel

MV_HTMLWFA

Tipo

Caracter

Descrio

Define o diretrio do HTML anexo

Valor Padro

\SYSTEM\EASYWORKFLOW\

Nome da Varivel

MV_EASYWF

SIGAEEC Workflow EEC

Boletim Tcnico

Tipo

Lgico

Descrio

Habilita WorkFlow no Easy

Valor Padro

.F.

Nome da Varivel

MV_EASYSRV

Tipo

Caracter

Descrio

Endereo Servidor Web

Valor Padro

localhost

Nome da Varivel

MV_HTMLWF

Tipo

Caracter

Descrio

Define o diretrio do HTML do WF

Valor Padro

\HTMLWF\

PROCEDIMENTOS PARA CONFIGURAO

Menus
1.

No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013). Visualize a nova opo de menu do SIGAEEC,
conforme instrues a seguir:
Menu

Atualizaes

Submenu

Tabelas

Nome da Rotina

Cadastro WorkFlow

Programa

EASYCADWORKFLOW

Mdulo

SIGAEEC

Tipo

Tabelas

EJ7

PROCEDIMENTOS PARA UTILIZAO

Pr-Requisitos:

O parmetro MV_EASYWF deve possuir contedo .T..

SIGAEEC Workflow EEC

Boletim Tcnico

O parmetro MV_HTMLWFA deve possuir contedo \SYSTEM\EASYWORKFLOW\.

O parmetro MV_ EASYSRV deve possuir contedo localhost.

O parmetro MV_ HTMLWF deve possuir contedo \HTMLWF\.

Deve possuir um e-mail cadastrado como remetente na rotina de WorkFlow presente no mdulo SIGACFG
(Ambiente/Workflow/Contas de E-mails).

Possuir um Pedido de Exportao aguardando liberao de crdito.

Sequencia 001:
1.

No Wizard presente na pasta SmartClient acesse Servidor Internet (HTTP/FTP) / HTTP e clique em Incluir.

2.

Insira as informaes necessrias e clique em Finalizar.

3.

Acesse Mdulos Web e clique em Novo Mdulo.

4.

Insira as informaes necessrias e clique em Avanar.

5.

Selecione o HTTP que exibido na janela, clique em Relacionar e em seguida em Avanar.

6.

Preencha os campos de conexes mnimas e mximas de usurios e clique em Finalizar.

Sequencia 002:
1.

Acesse o arquivo appserver.ini presente na pasta System do Sistema.

2.

Na tag [ONSTART] ser exibido o job criado anteriormente, adicione as funes WFONSTART, FWSCHDMANAG e
FWSCHDQUEUE e logo abaixo insira a expresso RefreshRate=60 conforme exemplo abaixo. Neste exemplo a tag
JOB_TESTE_WF foi configurada atravs do Wizard.
[ONSTART]
JOBS=JOB_TESTE_WF, WFONSTART, FWSCHDMANAG, FWSCHDQUEUE
RefreshRate=60

3.

Adicione as tags FWSCHDMANAG e FWSCHDQUEUE com suas devidas configuraes conforme exemplo abaixo. Neste
exemplo o Environment do Sistema TOP.
[FWSCHDMANAG]
Main=FWSCHDMANAG
Environment=TOP
[FWSCHDQUEUE]
Main=FWSCHDQUEUE
Environment=TOP

4.

Salve o arquivo e feche.

Sequencia 003:
1.

10

No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).

SIGAEEC Workflow EEC

Boletim Tcnico

2.

Em Agent/Cadastro, adicione um novo registro, insira as informaes necessrias e clique em Confirmar.

3.

Em Agendamentos/Cadastro, adicione um novo registro clicando em Incluir.

4.

Insira as informaes de empresa e mdulo. No campo Rotina (XX1_ROTINA) informe a funo WFSchEECCambio e
clique em Recorrncia. Este agendamento permite ao Sistema enviar automaticamente o workflow das parcelas de
cmbio que encontram-se em atraso.

5.

Informe a recorrncia e clique em Confirmar.

6.

Clique em Ok para gravar o agendamento.

7.

Adicione um novo registro clicando em Incluir.

8.

Insira as informaes de empresa e mdulo. No campo Rotina (XX1_ROTINA) informe a funo WFRETURN(99,01) e
clique em Ok. Este agendamento permite ao Sistema receber automaticamente os workflows de categoria de tomada
de deciso. Lembrando que os parmetros passados na funo WFRETURN so respectivamente a empresa e a filial do
Sistema

9.

Em Agent selecione o agente cadastrado e clique em Iniciar todos os servios.

10. O status do agente passa a ser Iniciado.

Sequencia 004:
1.

No Easy Export Control (SIGAEEC) acesse Tabelas/Cadastro WorkFlow (EASYCADWORKFLOW).

2.

Selecione o registro desejado e clique em Alterar.

3.

No campo WF Ativo? (EJ7_ATIVO) escolha a opo Sim e no campo Destinatrio (EJ7_VMDEST) insira o endereo de
e-mail para envio do Workflow e clique em Confirmar.

Sequencia 005:
1.

No Easy Export Control (SIGAEEC) acesse Atualizaes/Pedido Export./Manuteno (EECAP100).

2.

Selecione o registro desejado e em Aes relacionadas clique em Apr.credito.

3.

Insira a data de aprovao de crdito e clique em Confirmar.

O registro exibido em tela.
O e-mail referente aprovao deste registro enviado com sucesso ao destinatrio cadastrado.
Ao retornar ao mdulo Easy Export Control (SIGAEEC), note que o campo ID WF CR (EE7_ID_CR) foi preenchido
automaticamente com a numerao de controle do WorkFlow.

SIGAEEC Workflow EEC

11

Boletim Tcnico

INFORMAES TCNICAS
EJ7 WorKFlow
EJ8 Ctrl IDs WF
Tabelas Utilizadas

EE7 Processo de Exportao

EEC Embarque
EEU Numerrio de Exportao
EEQ Valor das Parcelas do Embarque
CFGA010 Schedule

Funes Envolvidas

EASYCADWORKFLOW Cadastro Workflow

EECAP100 Manuteno de Pedido de Exportao
EECAP107 WorkFlow Liberao de Crdito

Sistemas Operacionais

12

SIGAEEC Workflow EEC

Windows/Linux