Boletim Tcnico

Workflow EIC

Produto

: Microsiga Protheus Easy Import Control M11 SIGAEIC TOTVS 11

Chamado

THTRLJ

Data da publicao

: 23/09/13

Pas(es)

Brasil

Banco(s) de Dados

: Todos

Esta melhoria depende de execuo do update de base UIWORKFLOW, conforme

Procedimentos para Implementao.

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 pela rotina de Schedule (CFGA010), presente no
mdulo Configurador (SIGACFG).

Procedimento para Implementao

Para viabilizar essa melhoria, necessrio aplicar o pacote de atualizaes (Patch) deste chamado.
Aplicar atualizao dos programas AVGERAL.PRW, AVOBJECT.PRW, AVUPDATE01.PRW, EIC.PRW,
EICPO400.PRW, EICSI400.PRW, EICDI500.PRW, EICDI154.PRW, EICAP100.PRW, EICNU400.PRW,
EASYWORKFLOW.PRW, EASYCADWORKFLOW.PRW, EASYWFPLI.APH, EASYWFSI.APH, EASYWFDES.APH,
EASYWFPU.APH, EASYWFPO.APH, EASYWFPRV.APH, EASYWFNF.APH, EASYWFEMB.APH, EASYWFCB.APH,
EASYWFNM.APH, EASYWFLQ.APH, EICPO401.PRW, EICPO402.PRW, EICPO403.PRW, EICSI401.PRW,
EICDI506.PRW, EICDI507.PRW, EICDI508.PRW, EICDI159.PRW, EICGI402.PRW, EICAP101.PRW,
EICAP102.PRW, EICNU401.PRW, UIWORKFLOW.PRW, WFSchEICCambio.PRW, WFSchEICPrev.PRW,
EASYWFLINK.APH e EASYWFANEXO.APH.
Para que as alteraes sejam efetuadas, necessrio executar a funo U_UIWORKFLOW.

Antes de executar o compatibilizador UIWORKFLOW 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.

SIGAEIC Workflow EIC

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 estaro selecionadas. 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 est(aro) 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!

SIGAEIC Workflow EIC

Boletim Tcnico

1.

Em Microsiga Protheus By You Smart Client, digite U_UIWORKFLOW no campo Programa Inicial.

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

Clique em OK para continuar.

3.

Depois da 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.

5.

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

6.

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.

7.

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

8.

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

Descrico

WF Ativo?

SIGAEIC Workflow EIC

Boletim Tcnico

Descrio

Filial

Cdigo Processo

Descrico

WF Ativo?

Nvel

Usado

No

Sim

Sim

Sim

Obrigatrio

No

Sim

Sim

No

Browse

No

Sim

Sim

No

Opes

1=Sim;2=No

Relao

Cdigo Processo

Descrio

WF Ativo?

Help

Filial do Sistema

Campo

EJ7_HTML

EJ7_HTMLI

EJ7_HTMAN

EJ7_VMDEST

Tipo

Tamanho

30

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

Copia

Copia Oculta

Assunto

TimeOutDias

Descrio

Copia

Copia Oculta

Assunto

TimeOutDias

Nvel

Usado

Sim

Sim

Sim

Sim

Obrigatrio

No

No

No

No

Browse

No

No

No

No

Help

Copia

Copia Oculta

Assunto

TimeOutDias

SIGAEIC Workflow EIC

Boletim Tcnico

Campo

EJ7_TIMEHR

EJ7_TIMEMI

EJ7_FUNCEN

EJ7_FUNCRE

Tipo

Tamanho

50

50

Decimal

Ttulo

TimeOutHrs

TimeOutMins

Func Envio

Func Retorno

Descrio

TimeOutHrs

TimeOutMins

Funcao Envio

Funcao Retorno

Nvel

Usado

Sim

Sim

Sim

Sim

Obrigatrio

No

No

No

No

Browse

No

No

No

No

Help

TimeOutHrs

TimeOutMins

Funcao Envio

Funcao Retorno

Campo

EJ7_TIPO

EJ7_FUNCVA

EJ7_TIPORE

EJ7_TIPSRV

Tipo

Tamanho

50

Decimal

Func Variav

Tipo Ret.WF

Tip Servidor

Tipo Ret. Work-Flow

Tipo Servidor

Ttulo

Tipo Env. WF

Descrio

Tipo Env. Work-Flow

Nvel
Opes
Inicializador Padro

Funcao Variaveis
0

1=Schedule;

1=Formulario;
2=Anexo; 3=Link

2=Funcao

1=Web Protheus;
2=Web

Usado

Sim

Sim

Sim

Sim

Obrigatrio

No

No

No

No

Browse

No

No

No

No

Tipo Ret. Work-Flow

Tipo Servidor

EJ7_TIPORE

EJ7_TIPSRV

Help
Campo

Tipo Env. Work-Flow

EJ7_TIPO

Funcao Variaveis
EJ7_FUNCVA

SIGAEIC Workflow EIC

Boletim Tcnico

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

Tabela EJ8 Ctrl IDs WF:

Campo

EJ8_FILIAL

EJ8_ID

EJ8_CHAVE

EJ8_IDENT

Tipo

Tamanho

10

200

20

Decimal

@!

@!

@!

Formato
Ttulo

Filial

ID Proc

Chave

Identific.

Descrio

Filial

ID Processo

Chave

Nro de Identificacao

Nvel

Usado

No

Sim

Sim

Sim

Obrigatrio

Sim

Sim

Sim

Sim

Browse

No

Sim

Sim

Sim

ID Processo

Chave

Nro de Identificacao

EJ8_ID

EJ8_CHAVE

EJ8_IDENT

Help
Campo

SIGAEIC Workflow EIC

Filial do
Sistema
EJ8_FILIAL

Boletim Tcnico

Campo

EJ8_PROCES

Tipo

Tamanho

20

Decimal

Ttulo

Processo

Descrio

Processo

Nvel

Usado

Sim

Obrigatrio

Sim

Browse

Sim

Help

Processo

Tabela SW0 Capa da Solicitao de Importao:

Campo

W2_ID_ANU

W2_ID_PRV

Tipo

Tamanho

10

10

Decimal

Ttulo

ID WF ANU

ID WF PRV

Descrio

ID WorkFlow Anuente

ID WorkFlow Previsao

Nvel

Usado

Sim

Sim

Obrigatrio

No

No

Browse

No

No

Help

ID WorkFlow Item Anuente

ID WorkFlow Previso de Entrega

Tabela SW4 Capa Preparao de Licena de Imp.:

Campo

W4_ID

Tipo

Tamanho

10

Decimal

Ttulo

ID WF

Descrio

ID WorkFlow

SIGAEIC Workflow EIC

Boletim Tcnico

Nvel

Usado

Sim

Obrigatrio

No

Browse

No

Help

ID WorkFlow

Tabela SW6 Capa Declarao de Importao:

Campo

W6_ID_EMB

W6_ID_ENCE

W6_ID_PRV

Tipo

Tamanho

10

10

10

Decimal

Ttulo

ID WF EMB

ID WF ENC

ID WF PRV

ID WorkFlow
Embarque

ID WorkFlow
Encerramento

ID WorkFlow
Previsao

Descrio
Nvel

Usado

Sim

Sim

Sim

Obrigatrio

No

No

No

Browse

No

No

No

Help

ID WorkFlow
Embarque

ID WorkFlow
Encerramento

Tabela SWN Itens da NF de Importao:

Campo

WN_ID

Tipo

Tamanho

10

Decimal

Ttulo

ID WF

Descrio

ID WorkFlow

Nvel

Usado

Sim

Obrigatrio

No

Browse

No

Help

ID WorkFlow

SIGAEIC Workflow EIC

ID WorkFlow
Previsao

Boletim Tcnico

Tabela EIC Numerario:

Campo

EIC_ID

Tipo

Tamanho

10

Decimal

Ttulo

ID WF

Descrio

ID WorkFlow

Nvel

Usado

Sim

Obrigatrio

No

Browse

No

Help

ID WorkFlow

Tabela SWB Itens do Cmbio:

Campo

WB_ID_CB

WB_ID_LQ

Tipo

Tamanho

10

10

Decimal

Ttulo

ID WF CB

ID WF LQ

Descrio

ID WorkFlow Cambio

ID WorkFlow Liquidacao

Nvel

Usado

Sim

Sim

Obrigatrio

No

No

Browse

No

No

Help

ID WorkFlow Cambio

ID WorkFlow Liquidacao de cambio

Os tamanhos dos campos que possuem grupos podem variar conforme ambiente em uso.

SIGAEIC Workflow EIC

Boletim Tcnico

3.

Criao de ndices no arquivo SIX ndices:

ndice

EJ7

EJ7

EJ8

EJ8

Ordem

Chave

4.

EJ7_FILIAL+EJ7_COD

EJ7_FILIAL+EJ7_FASE

EJ8_FILIAL+EJ8_ID

EJ8_FILIAL+EJ8_CHAVE

Descrio

Cod.Proc

Fase

ID.Proc

Chave

Proprietrio

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

Tipo

Lgico

Descrio

Habilita WorkFlow no Easy

Valor Padro

.F.

Nome da Varivel

MV_EASYSRV

Tipo

Caracter

Descrio

Endereco Servidor Web

Valor Padro

localhost

Nome da Varivel

MV_HTMLWF

Tipo

Caracter

Descrio

Define o diretrio do HTML do WF

Valor Padro

\HTMLWF\

SIGAEIC Workflow EIC

10

Boletim Tcnico

Procedimentos para Configurao

Menus
1.

No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parmetros (CFGX017). Visualize a nova

opo de menu do SIGAEIC, conforme instrues a seguir:
Menu

Atualizaes

Submenu

Tabelas

Nome da Rotina

Cadastro WorkFlow

Programa

EASYCADWORKFLOW

Mdulo

SIGAEIC

Tipo

Tabelas

EJ7

Procedimentos para Utilizao

Pr-Requisitos:

O parmetro MV_EASYWF deve possuir contedo .T..

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 PO cadastrado com pelo menos um item anuente.

Sequencia 001:
1. No Wizard presente na pasta SmartClient, acessar Servidor Internet (HTTP/FTP) / HTTP e clicar em
Incluir.
2. Inserir as informaes necessrias e clicar em Finalizar.
3. Acessar Mdulos Web e clicar em Novo Mdulo.
4. Inserir as informaes necessrias e clicar em Avanar.
5. Selecionar o HTTP que exibido na janela, clicar em Relacionar e, em seguida, em Avanar.
11

SIGAEIC Workflow EIC

Boletim Tcnico

6. Preencher os campos de conexes mnimas e mximas de usurios e clicar em Finalizar.

Sequencia 002:
1. Acessar o arquivo appserver.ini presente na pasta System do sistema.
2. Na tag [ONSTART], ser exibido o job criado anteriormente, adicionar as funes WFONSTART,
FWSCHDMANAG e FWSCHDQUEUE e logo abaixo inserir a expresso RefreshRate=60 conforme
exemplo abaixo. Neste exemplo a tag JOB_TESTE_WF foi configurada pelo Wizard.
[ONSTART]
JOBS=JOB_TESTE_WF, WFONSTART, FWSCHDMANAG, FWSCHDQUEUE
RefreshRate=60
3. Adicionar 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. Salvar o arquivo e fechar.
Sequencia 003:
1. No Configurador (SIGACFG), acessar Ambiente/Schedule/Schedule (CFGA010).
2. Em Agent/Cadastro, adicionar um novo registro, inserir as informaes necessrias e clicar em
Confirmar.
3. Em Agendamentos/Cadastro, adicionar um novo registro clicando em Incluir.
4. Inserir as informaes de empresa e mdulo. No campo Rotina (XX1_ROTINA), informar a funo
WFSchEICCambio e clicar em Recorrencia. Este agendamento permite ao sistema enviar
automaticamente o workflow das parcelas de cmbio que se encontra em atraso.
5. Informar a recorrncia e clicar em Confirmar.
6. Clicar em Ok para gravar o agendamento.
7. Adicionar um novo registro clicando em Incluir.
8. Inserir as informaes de empresa e mdulo. No campo Rotina (XX1_ROTINA), informar a funo
WFSchEICPrev e clicar em Recorrncia. Este agendamento permite ao sistema enviar

SIGAEIC Workflow EIC

12

Boletim Tcnico

automaticamente o workflow de Previses de Entrega referente aos Processos de Importao que se

encontra em atraso.
9. Informar a recorrncia e clicar em Confirmar.
10. Clicar em Ok para gravar o agendamento.
11. Em Agent, selecionar o agente cadastrado e clicar em Iniciar todos os servios.
12. O status do agente passa a ser Iniciado.
Sequencia 004:
1. No Easy Import Control (SIGAEIC), acessar Tabelas/Cadastro WorkFlow (EASYCADWORKFLOW).
2. Selecionar o registro desejado e clicar em Alterar.
3. No campo WF Ativo? (EJ7_ATIVO), escolher a opo Sim e no campo Destinatrio (EJ7_VMDEST)
inserir o endereo de e-mail para envio do Workflow e clicar em Confirmar.
Sequencia 005:
1. No Easy Import Control (SIGAEIC), acessar Atualizaes/Licenca Import/Manutencao P.l.i.
(EICGI400).
2. Clicar em Incluir.
3. Inserir as informaes da capa e em Aes Relacionadas clicar em PO de Referencia.
4. Inserir o PO de referencia e clicar em Confirmar.
5. Na aba Dados Da Li, inserir as informaes necessrias e clicar em Confirmar.
6. Marcar o item e clicar em Monta LI.
7. Na tela seguinte, conferir as informaes e clicar em Grava PLI.
8. O registro exibido em tela.
9. O e-mail referente incluso deste registro enviado com sucesso ao destinatrio cadastrado.
10. Ao retornar ao Easy Import Control (SIGAEIC), clicar em Alterar.
11. Note que o campo WF ID (W4_ID) foi preenchido automaticamente com a numerao de controle do
WorkFlow.

13

SIGAEIC Workflow EIC

Boletim Tcnico

Informaes Tcnicas

EJ7 WorKFlow
EJ8 Ctrl IDs WF
SW0 Capa de Solicitao de Importao
SW2 Capa do Purchase Order
Tabelas Utilizadas

SW4 Capa Preparao de Licena de Imp.

SW6 Capa Declarao de Importao
SWN Itens da NF de Importao
EIC Numerrio
SWB Itens do Cmbio
CFGA010 Schedule

Funes Envolvidas

EASYCADWORKFLOW Cadastro Workflow

EICGI400 Manuteno de Licena de Importao
EICGI402 WorkFlow PLI

Sistemas Operacionais

SIGAEIC Workflow EIC

Windows/Linux

14