Workflow - Easy Import Control

Características do Requisito

Descrição

Implementação da rotina de Workflow (EASYWORKFLOW) que permite ao Sistema enviar e-mail informativo ou de tomada de decisão referente a processos diversos do módulo Easy Import Control (SIGAEIC) a um ou mais destinatários.

Esta melhoria permite o envio de Workflow para as rotinas: Solicitação de Importação, Purchase Order, Declaração de Importação, Nota Fiscal, Câmbio de Importação e Numerário.

É possível enviar 2 tipos de workflow diferentes: Informativo e Tomada de Decisão.

Workflow informativo é aquele que é enviado via e-mail para apenas informar a um usuario ou grupo de usuários, não sendo necessário nenhuma ação por parte dos mesmos.

Workflow de tomada de decisão é aquele que é enviado via e-mail para um usuario ou grupo de usuários, em que este aguarda a ação por parte dos mesmos para aprovação, liberação, desbloqueio, etc de um processo. Neste workflow é enviado um link em que o destinatario pode clicar e, com isso, iniciar a integração com o Protheus para executar a ação no processo descrito no próprio Workflow.

Para o Easy Import Control (SIGAEIC), são disponibilizados, por padrão, 12 workflows diferentes:

Importante

Antes de executar o compatibilizador informe o UIWORKFLOW é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS11_DATA\DATA e dos dicionários de dados SXs (diretório \PROTHEUS11_DATA\SYSTEM).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão 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 não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em ByYou Smart Client, digite o U_UIWORKFLOW no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 28/01/2016.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.

Atualizações do Compatibilizador

1.    Criação de tabela no arquivo SX2– Tabelas:

2.  Criação de Campos no arquivo SX3 – Campos:

• Tabela EJ7 - Cadastro Workflow:

• Tabela EJ8 - Ctrl IDs WF:

• Tabela SW0 - Capa da Solicitação de Importação:

• Tabela SW2 - Capa de Purchase Order:

• Tabela SW4 - Capa Preparação de Licença de Imp.:

• Tabela SW6 - Capa Declaração de Importação:

• Tabela SWN - Itens da NF de Importação:

• Tabela EIC - Numerario:

• Tabela SWB- Numerario:

Importante:

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

3.  Criação de Parâmetros no arquivo SX6 – Parâmetros:

4.  Criação de Índices no arquivo SIX - Indices:

• Tabela EJ7 - Cadastro Workflow:

• Tabela EJ8 - Ctrl IDs WF:

Procedimento para Configuração

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:

Importante:

No parametro MV_EASYSRV, deve ser informado um servidor válido para acesso ao Protheus + porta (a ser informada no Servidor Internet (HTTP)), a ser definido a critério do Administrador do Protheus da empresa. (Exemplo: http://10.197.24.171:9020)

Procedimento para Utilização

Pré-Requisitos:

• O sistema deve possuir um e-mail cadastrado na rotina de Workflow (WFC003) presente no módulo  SIGACFG (Ambiente/Workflow/Contas de E-mails);
• Criar uma pasta chamada web dentro do diretório RootPath do ambiente.

Sequencia 001: Configuração de Servidor Internet

1. No Wizard (SRVWIZARD) acesse Servidor Internet (HTTP/FTP) / HTTP e clique em Incluir.
2. O sistema abre o wizard de configuração.
3. Marque a caixa de Protocolo Habilitado.
4. No campo Patch de Arquivos, informe o diretorio RootPath + a pasta web. (Exemplo: C:\Ambientes\M11.8\Protheus_Data\web\)
5. No campo Porta de Conexão, informe uma porta para comunicação. (Exemplo: 8080)
6. No campo Ambiente, selecione o Environment configurado. (Exemplo: TOP)
7. No campo Instâncias do Protocolo (mínimo), informe o valor 1.
8. No campo Instâncias do Protocolo (máximo), informe o valor 10.
9. Clique em Finalizar.
10. Confirme a gravação das configurações.

Sequencia 002: Configuração de Módulo WEBEX

1. No Wizard (SRVWIZARD) acesse Módulos Web e clique em Incluir.
2. O sistema abre o wizard de configuração.
3. Marque a caixa de Habilitado processos na Inicialização do Servidor.
4. No campo Módulo Web, selecione a opção MAK - Modulo WEBEX Makira.
5. No campo Nome da Instancia, informe um nome desejado para o módulo. (Exemplo: Workflow_EASY)
6. O campo Diretório Raiz das imagens (Web Patch) é preenchido automaticamente.
7. No campo Environment, selecione o mesmo informado no Servidor Internet.
8. Clique em Avançar.
9. Na tela seguinte, note que na lista de Host é exibido o HTTP configurado anteriormente.
10. Na lista de Host, selecione o HTTP.
11. Na lista de Empresa/Filial, selecione Todas as Empresas e Filiais.
12. Clique em Relacionar.
13. O relacionamento é exibido na lista de Relacionamentos.
14. Clique em Avançar.
15. Na tela seguinte, selecione o campo Minimo Usuários e informe o valor 10.
16. Selecione o Maximo Usuarios e informe o valor 10.
17. Clique em Finalizar
18. Confirme a gravação das configurações.

Sequencia 003: Configuração de INI

Atenção: Para esta sequencia, os itens em azul devem ser mantidos e os itens em laranja devem ser alterados.

1. Na pasta Bin/AppServer do ambiente, localize e abra o arquivo appserver.ini.
2. Note que foi criado o grupo do Servidor Internet (HTTP) com as configurações informadas no Wizard anteriormente.
3. Note que foi criado o job referente ao Servidor WEBEX com as configurações informadas no Wizard anteriormente. O nome deste grupo é "JOB_"+Nome da instancia informada. (Exemplo: JOB_WORKFLOW_EASY).
4. Inclua no arquivo o bloco abaixo informado em azul.
   Atente-se em informar em Environment o mesmo informado no Servidor Internet, neste exemplo utilizamos TOP.
   
   

   [FWSCHDMANAG_TOP]
   Main=FWSCHDMANAG
   Environment=TOP

   [FWSCHDQUEUE_TOP]
   Main=FWSCHDQUEUE
   Environment=TOP

    

5. Inclua no arquivo o bloco abaixo informado em azul. Neste exemplo informamos o nome do job criado neste passo-a-passo, que é JOB_WORKFLOW_EASY.
   Atente-se em substituir pelo nome do job criado no Servidor WEBEX. 

   
   [ONSTART]
   JOBS=FWSCHDMANAG_TOP, FWSCHDQUEUE_TOP, JOB_WORKFLOW_EASY
   RefreshRate=120

   
   

6. Inclua no arquivo o bloco abaixo informado em azul.
   Para este bloco atente-se para substituir os itens conforme explicado abaixo:
   - O nome do bloco deve ser o mesmo do conteudo do parametro MV_EASYSRV, sem o "http://". (Exemplo: localhost:8080)
   - Em PATH, informe o diretorio RootPath + a pasta web + nome do job criado no Servidor WEBEX. (Exemplo: C:\Ambientes\M11.8\Protheus_Data\web\Workflow_EASY)
   - Em ENVIRONMENT, informe o  mesmo informado no Servidor Internet (Exemplo: TOP)
   - Em INSTANCENAME, informe o nome do job criado no Servidor WEBEX. (Exemplo: Workflow_EASY)
   
   

   [localhost:8080]
   ENABLE=1
   PATH=C:\Ambientes\M11.8\Protheus_Data\web\Workflow_EASY
   ENVIRONMENT=TOP
   INSTANCENAME=Workflow_EASY
   RESPONSEJOB=JOB_WORKFLOW_EASY

   
   

7. Salve as alterações, feche o arquivo e reinicie o Server do ambiente.

Sequencia 004: Configuração de Schedule

Atenção: Esta sequencia apenas é aplicavel para os Workflows que são processados via Schedule.

1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).
2. Acesse Schedule/Agent/Cadastro e clique em Incluir.
3. Informe um nome para o agente.
4. No campo IP (XX0_IP) informe o IP local: 127.0.0.1.
5. No campo Porta (XX0_PORTA) informe a mesma porta informada no INI do Server.
6. No campo Empresa (XX0_EMP) informe a empresa em que o Schedule será executado.
7. Marque a caixa Habilitado.
8. Clique em Confirmar.
9. Acesse Schedule/Agent/Monitor e selecione o agente incluido anteriormente.
10. Clique em Iniciar serviço.
11. Acesse Schedule/Agendamento/Cadastro e clique em Incluir.
12. No campo Rotina (XX1_ROTINA) informe a função WFRETURN("01","01"), onde os parametros da função são a Empresa e Filial de execução.
13. No campo Empresa/Filial (XX1_EMPFIL) informe a mesma Empresa e Filial de execução.
14. No campo Módulo (XX1_MODULO) informe o valor 17.
15. Marque a caixa Habilitado.
16. Clique em Recorrência.
17. Marque a opção Sempre ativo.
18. Marque a caixa Sem data de término.
19. Clique em Confirmar.
20. Clique em Ok para gravar o agendamento.
21. Acesse Schedule/Agendamento/Cadastro e clique em Incluir.
22. No campo Rotina (XX1_ROTINA) informe a função WFSchEICCambio().
23. No campo Empresa/Filial (XX1_EMPFIL) informe a mesma Empresa e Filial de execução.
24. No campo Módulo (XX1_MODULO) informe o valor 17.
25. Marque a caixa Habilitado.
26. Clique em Recorrência.
27. Informe a Recorrência.
28. Clique em Confirmar.
29. Clique em Ok para gravar o agendamento.
30. Acesse Schedule/Agendamento/Cadastro e clique em Incluir.
31. No campo Rotina (XX1_ROTINA) informe a função WFSchEICPrev().
32. No campo Empresa/Filial (XX1_EMPFIL) informe a mesma Empresa e Filial de execução.
33. No campo Módulo (XX1_MODULO) informe o valor 17.
34. Marque a caixa Habilitado.
35. Clique em Recorrência.
36. Informe a Recorrência.
37. Clique em Confirmar.
38. Clique em Ok para gravar o agendamento.
39. Ao termino destas configurações, os workflows referente a Previsão de Entrega e Cambios atrasados serão automaticamente enviados respeitando as recorrências informadas.

Sequencia 005: Cadastro de Workflow

1. No Easy Import Control (SIGAEIC) acesse Tabelas/Cadastro WorkFlow (EASYCADWORKFLOW).
2. O sistema exibe os registros listados. Cada registro equivale a um workflow diferente.
3. Todos os workflows encontram-se, por padrão, desabilitados, sendo necessário habilitá-los conforme necessidade de cada empresa.
4. Selecione o registro desejado e clique em Alterar.
5. No campo WF Ativo? (EJ7_ATIVO), selecione a opção Sim.
6. No campo Destinatário (EJ7_VMDEST) insira o endereço de e-mail para envio do Workflow.
7. No campo Tipo Env. WF (EJ7_TIPO) informe a opção desejada.
   - Na opção Formulario, o sistema enviará o workflow no corpo do e-mail. Esta opção é sugerida para os workflows informativos.
   - Na opção Link,  o sistema enviará o workflow no corpo do e-mail. Esta opção é sugerida para os workflows de tomada de decisão.
   - Na opção Anexo, o sistema enviará o workflow como anexo do e-mail, em formato HTML.
8. Clique em Confirmar.

Sequencia 006: Workflow - Solicitação de Importação

1. No Easy Import Control (SIGAEIC) acesse Atualizações/Solic. Importacao/Manutenção (EICSI400).
2. Clique em Incluir.
3. Informe os dados do registro e clique em Confirmar.
4. O sistema efetua a gravação do registro.
5. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 007: Workflow - Itens Anuentes do Purchase Order

• Possuir uma SI cadastrada, com itens anuentes.

Sequencia 007: Workflow - Itens Anuentes do Purchase Order

1. No Easy Import Control (SIGAEIC) acesse Atualizações/Purchase Order/Manutenção (EICPO400).
2. Clique em Incluir.
3. Informe os dados do registro e clique em Confirmar.
4. Informe a SI de Referencia e clique em Confirmar.
5. Marque os itens e clique em Confirmar.
6. Clique em Confirmar para salvar o processo.
7. O sistema efetua a gravação do registro.
8. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 008: Workflow - Previsão de Embarque dos itens do Purchase Order

• Possuir uma SI cadastrada.

Sequencia 008: Workflow - Previsão de Embarque dos itens do Purchase Order

1. No Easy Import Control (SIGAEIC) acesse Atualizações/Purchase Order/Manutenção (EICPO400).
2. Clique em Incluir.
3. Informe os dados do registro e clique em Confirmar.
4. Informe a SI de Referencia e clique em Confirmar.
5. Marque os itens e clique em Confirmar.
6. Clique em Confirmar para salvar o processo.
7. O sistema efetua a gravação do registro.
8. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 009: Workflow - Embarque

• Possuir um PO cadastrado.

Sequencia 009: Workflow - Embarque

1. No Easy Import Control (SIGAEIC) acesse Atualizações/Embarque/Manutenção (EICDI501).
2. Clique em Incluir.
3. Informe os dados do registro e clique em Confirmar.
4. Informe o PO de Referencia e clique em Confirmar.
5. Marque os itens e clique em Confirmar.
6. Clique em Confirmar para salvar o processo.
7. O sistema efetua a gravação do registro.
8. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 010: Workflow - Licença de Importação

• Possuir um PO cadastrado, com itens anuentes.

Sequencia 010: Workflow - Licença de Importação

1. No Easy Import Control (SIGAEIC) acesse Atualizações/Licenca de Import/Manutenção (EICGI400).
2. Clique em Incluir.
3. Informe os dados do registro e clique em Confirmar.
4. Informe o PO de Referencia e clique em Confirmar.
5. Marque os itens e clique em Confirmar.
6. Clique em Confirmar para salvar o processo.
7. O sistema efetua a gravação do registro.
8. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 011: Workflow - Adiantamento de Numerario

• Possuir um Embarque cadastrado.

Sequencia 011: Workflow - Adiantamento de Numerario

1. No Easy Import Control (SIGAEIC) acesse Atualizações/Embarque/Solicit.numerario (EICNU400).
2. Selecione o processo e clique em Manutenção.
3. Em Ações Relacionadas clique em Incluir.
4. Informe os dados da despesa e clique em Confirmar.
5. Ao retornar a tela anterior, selecione a despesa e em Ações Relacionadas clique em Liberar Adiantamento.
6. Informe a data de vencimento e clique em Ok.
7. Clique em Confirmar para salvar o processo.
8. O sistema efetua a gravação do registro.
9. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 012: Workflow - Nota Fiscal

• Possuir um Embarque cadastrado, preparado para a geração de Nota Fiscal.

Sequencia 012: Workflow - Nota Fiscal

1. No Easy Import Control (SIGAEIC) acesse Atualizações/Desembaraço/Receb.Importacao (EICDI154).
2. Selecione o processo e clique em Primeira.
3. Clique em Itens.
4. Marque os itens, informe o número e série da Nota Fiscal e clique em Confirmar.
5. Ao retornar a tela anterior, clique em Gerar NFE.
6. O sistema efetua a geração da Nota Fiscal.
7. O sistema exibe o numero da Nota Fiscal em tela.
8. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 013: Workflow - Liquidação de Cambio

• Possuir um Embarque, com câmbio gerado.

Sequencia 013: Workflow - Liquidação de Cambio

1. No Easy Import Control (SIGAEIC) acesse Atualizações/Financeiro/Controle Cambio (EICAP100).
2. Selecione o processo e clique em Alterar.
3. Selecione a parcela e em Ações Relacionadas clique em Liquidar.
4. Informe os dados de liquidação e clique em Confirmar.
5. Clique em Confirmar para salvar o processo.
6. O sistema efetua a gravação do registro.
7. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 014: Workflow - Encerramento de Embarque

• Possuir um Embarque cadastrado.

Sequencia 014: Workflow - Encerramento de Embarque

1. No Easy Import Control (SIGAEIC) acesse Atualizações/Desembaraço/Manutenção (EICDI502).
2. Selecione o processo e clique em Alterar.
3. Na aba Cadastrais, preencha o campo Encerramento (W6_DT_ENCE).
4. Clique em Confirmar para salvar o processo.
5. O sistema efetua a gravação do registro.
6. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 015: Workflow - Aprovação de Numerario

• Possuir um Embarque cadastrado.

Sequencia 015: Workflow - Aprovação de Numerario

1. No Easy Import Control (SIGAEIC) acesse Atualizações/Embarque/Solicit.numerario (EICNU400).
2. Selecione o processo e clique em Manutenção.
3. Em Ações Relacionadas clique em Incluir.
4. Informe os dados da despesa e clique em Confirmar.
5. Clique em Confirmar para salvar o processo.
6. O sistema efetua a gravação do registro.
7. O workflow é enviado ao destinatario.
8. Por ser um workflow de tomada de decisão, além da mensagem informativa no corpo do e-mail, este workflow acompanha um link que ao ser selecionado, inicia a integração com o Protheus para executar a liberação dos adiantamentos automaticamente.
9. Ao receber o workflow, o destinatário poderá ou não aprovar a liberação dos adiantamentos.
   - Caso queria aprová-los, o destinatário deve clicar no link para iniciar a integração com o Protheus e executar a liberação dos adiantamentos automaticamente.
10. O sistema apenas liberará os adiantamentos após a aprovação do destinatário.
11. Após clicar no link, o Protheus efetua o processamento necessário.
12. No Easy Import Control (SIGAEIC) acesse Atualizações/Embarque/Solicit.numerario (EICNU400).
13. Selecione o processo e clique em Manutenção.
14. Note que as despesas foram liberadas.