43
INSTALAÇÃO ACELERADOR WORKFLOW DE COMPRAS

Workflow Compras Manual de Implantação v.2.0

Embed Size (px)

DESCRIPTION

Workflow Compras Manual de Implantação v.2.0

Citation preview

Page 1: Workflow Compras Manual de Implantação v.2.0

INSTALAÇÃO

ACELERADOR WORKFLOW DE COMPRAS

Page 2: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

2

Sumário

Etapas simplificadas ...................................................................................................................... 4

1. Processo cotação ................................................................................................................... 4

1.1. Envio de e-mail aos fornecedores ................................................................................. 4

1.2. Reenvio .......................................................................................................................... 5

1.3. E-mail sem resposta ...................................................................................................... 5

1.4. Retorno de e-mail dos fornecedores ............................................................................ 6

1.5. Informação ao Comprador ............................................................................................ 6

2. Processo pedido de compra .................................................................................................. 7

2.1. Envio de e-mail para aprovação do pedido ................................................................... 7

2.2. Retorno de e-mail dos aprovadores (primeiros níveis) ................................................. 8

2.3. Retorno de e-mail dos aprovadores (último nível) ....................................................... 8

2.3.1. Resultado da Aprovação............................................................................................ 8

2.4. Pedido de compra ao fornecedor ................................................................................. 9

2.5. Exclusão do pedido de compra ................................................................................... 10

3. Processo Nota Fiscal de Entrada ......................................................................................... 10

3.1. Informação de Solicitação Atendida ........................................................................... 10

4. Premissas ............................................................................................................................. 11

5. Instalação ............................................................................................................................ 12

5.1. Configurações Iniciais .................................................................................................. 12

5.1.1. Aplicar o patch “WF_COMPRAS” ............................................................................ 12

5.1.2. Compatibilizador “U_UPDWF” ................................................................................ 14

5.1.3. Classe FSWLicenças ................................................................................................. 18

5.1.4. Pontos de Entrada ................................................................................................... 18

Page 3: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

3

5.1.5. Campos Gerados ..................................................................................................... 18

5.1.5.1. Campos no SC7 (Pedidos de Compras): .............................................................. 18

5.1.5.2. Campos no SC8 (Cotações): ................................................................................. 19

5.1.5.3. Campos no SCR (Documentos com Alçada) ........................................................ 19

5.1.6. Índices Gerados ....................................................................................................... 19

5.1.7. Parâmetros .............................................................................................................. 20

6. Pastas .................................................................................................................................. 23

7. Configuração de E-mail ....................................................................................................... 24

7.1. Parâmetros .................................................................................................................. 24

7.2. Contas de E-mail .......................................................................................................... 26

8. Configuração do WorkFlow no AppServer.ini ..................................................................... 30

9. Utilizando os pontos de entrada ......................................................................................... 31

9.1. Cotação ........................................................................................................................ 31

9.2. Pedido de compra ....................................................................................................... 32

9.3. Nota fiscal de entrada ................................................................................................. 33

10. Função adicional .............................................................................................................. 34

10.1. EnvPed() .................................................................................................................. 34

11. Problemas Adversos ........................................................................................................ 35

..................................................................................................................................................... 37

12. Pontos de Entrada Específicos ........................................................................................ 38

12.1. Exemplo de utilização .............................................................................................. 41

13. Pontos de Atenção .......................................................................................................... 42

Page 4: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

4

Etapas simplificadas

1. Processo cotação

1.1. Envio de e-mail aos fornecedores

Ao final da geração das cotações serão enviados e-mails para os fornecedores

selecionados efetuem a cotação das solicitações.

Ponto de Entrada: MT130WF

GRUPO PROCESSO P.E. RESPONSAVEL POR

DISPARAR

Cotação

Enviar Cotação aos fornecedores Cadastrar Job U_WFLOW04() ou PE MT130WF

Ponto de entrada quando se incluir um novo participante ou uma nova proposta na análise da cotação.

MT150END

Reenvio de cotação Cadastrar Job U_WFLOW04() ou PE MT130WF

E-mail sem resposta Cadastrar Job U_WFLOW04() ou PE MT130WF

Informa ao Comprador que todas as cotações foram realizadas Não precisa de JOB pois o retorno da aprovação já dispara este e-mail.

Pedido de Compra

Análise da cotação para gerar o pedido de compra. Necessitando passar pelo controle de alçadas.

MT160WF ou MT120GOK

Informa se o Pedido de Compra foi aprovado ou reprovado. Não precisa de JOB pois o retorno da aprovação já dispara este e-mail.

Envio do Pedido de Compra ao Fornecedor Não precisa de JOB pois o retorno da aprovação já dispara este e-mail.

Envio de e-mail de vencedor ao fornecedor, quando pedido for liberado via rotina padrão(MATA097)

MT097END

Executado na exclusão manual do pedido de compra MTA120G1

NF entrada Informação de solicitação atendida (Documento de entrada foi inserido com o pedido de compra gerado através da cotação)

MT100AGR

Page 5: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

5

1.2. Reenvio Caso o campo C8_ZZDTENV (Data de Envio) não esteja preenchido ou a Data de envio

seja menor que (Data Base - ZZ_WFCOTRE (Dias antes da data atual para as cotações a serem

consideradas)) a cotação será reenviada.

Cadastrar JOB U_WFLOW04()

1.3. E-mail sem resposta Caso o campo C8_EMISSAO (Emissão) seja menor que a Data Base - ZZ_WFCOTSR

será enviado um e-mail ao comprador informando que o fornecedor não respondeu a

cotação.

Cadastrar Job U_WFLOW04()

Page 6: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

6

Atenção

O próprio Ponto de Entrada MT130WF utiliza a função U_WFLOW04, portanto quando forem geradas

as cotações da solicitação de compra, também será reenviado e-mails não respondidos no prazo, como também o tratamento de e-mails sem resposta, além de enviar o e-mail ao fornecedor desta nova solicitação.

1.4. Retorno de e-mail dos fornecedores

Neste ponto serão atualizados os dados das cotações conforme as informações respondidas pelos fornecedores.

Caso o parâmetro ZZ_EXCCOT esteja configurado como verdadeiro (.T.) e o ponto de

entrada MT150CHV esteja compilado, a opção de exclusão de cotações com o valor zerado durante o retorno será habilitada.

Não precisa de JOB pois o retorno da cotação já dispara este e-mail.

1.5. Informação ao Comprador

Após todos os fornecedores responderem, será enviado um e-mail ao comprador informando que as cotações estão disponíveis para análise.

Não precisa de JOB pois o retorno da cotação já dispara este e-mail, caso todos os fornecedores responderem.

Page 7: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

7

2. Processo pedido de compra

2.1. Envio de e-mail para aprovação do pedido

Após o comprador efetuar a análise das cotações e selecionar o(s) fornecedor(es) vencedor(es), o pedido será gerado bloqueado e será enviado e-mail para o grupo de aprovação do comprador para este efetuar a aprovação ou não do pedido de compra (Controle de alçadas).

Obs.: Caso não haja grupo de aprovação para o comprador o pedido estará liberado e não passará pelos processos do Workflow.

Se o parâmetro ZZ_WFAUTH estiver como .T. e o appserver.ini devidamente configurado para essa funcionalidade(vide página 29) será exibida a seguinte tela antes de abrir a página de aprovação do pedido de compra:

Nessa tela deverá ser informado o login e senha do aprovador (a mesma do protheus).

Page 8: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

8

2.2. Retorno de e-mail dos aprovadores (primeiros níveis)

Neste ponto serão atualizados os dados respondidos pelo aprovador.

� Próximo nível de aprovação - Caso haja algum aprovador acima do nível do(s) aprovador(es) que aprovou o pedido de compra o pedido continuará bloqueado e será enviado um novo e-mail para os aprovadores deste nível.

2.3. Retorno de e-mail dos aprovadores (último nível) Neste ponto, se todos os aprovadores do último nível efetuaram a aprovação

do pedido, este estará liberado.

2.3.1. Resultado da Aprovação

Será enviado um e-mail ao comprador e outro e-mail ao solicitante informando o resultado da aprovação do pedido de compra.

Page 9: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

9

Não precisa de JOB pois o retorno da cotação já dispara este e-mail.

Atenção O envio de e-mail aos aprovadores é automático, enviado após a resposta de cada aprovação.

2.4. Pedido de compra ao fornecedor

Após a aprovação do pedido, caso o parâmetro de envio de pedido automático (ZZ_WFHPCIF) este marcado como verdadeiro, um e-mail com os dados do pedido será enviado automaticamente ao fornecedor.

Page 10: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

10

2.5. Exclusão do pedido de compra

Quando um pedido é cancelado, um e-mail com a data de exclusão e o número do pedido será enviado automaticamente para o solicitante e comprador.

Ponto de Entrada: MTA120G1

3. Processo Nota Fiscal de Entrada

3.1. Informação de Solicitação Atendida

Page 11: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

11

Após a confirmação de uma nota fiscal de entrada que foi fruto de um pedido de compra, será enviado um e-mail ao solicitante informando a entrada do material.

Ponto de Entrada: MTA100AGR

Todos os processos possuem parâmetros para habilitar ou desabilitar o envio dos e-mails.

4. Premissas Existem diversos pontos de entrada para que o HTML seja personalizado com inclusão

de novos campos, porém essa personalização não está contemplada no preço inicial devendo ser negociada separadamente.

Page 12: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

12

5. Instalação

5.1. Configurações Iniciais

5.1.1. Aplicar o patch “WF_COMPRAS”

• Abrir o TDS;

• Clicar no ícone para aplicar o patch (Imagem abaixo);

• Selecionar o patch “WF_COMPRAS” disponibilizado (Imagens abaixo),

através do item em destaque.

Page 13: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

13

• Aguardar e clicar no botão .

Page 14: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

14

5.1.2. Compatibilizador “U_UPDWF”

Fazer backup da base de dados e dicionários.

Rodar compatibilizador “U_UPDWF” para criar os campos e parâmetros

personalizados.

• Abra o Smart Client.

• Defina o Programa inicial como “U_UPDWF” (Imagem abaixo).

• Defina o Ambiente no servidor.

• Click no botão .

Page 15: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

15

• Se já foi efetuado todo os Backup’s necessarios clicar no botão .

• Selecionar a Empresa (Imagem abaixo);

Page 16: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

16

• Clicar no botão .

• Clicar no botão .

Page 17: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

17

• Aguardar atualizações, conforme imagens:

Page 18: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

18

5.1.3. Classe FSWLicenças

Para o funcionamento do WorkFlow essa classe deve estar compilada no ambiente:

tttp110_FSWLicencas-2013-08-06.ptm

5.1.4. Pontos de Entrada

Os pontos de entrada presentes na pasta PE do kit de entrega devem ser compilados.

ATENÇÃO: Caso o cliente já utilize esses PE´s , adicione a chamada das funções do workflow.

Verifique nos fontes da pasta PE do kit de entrega a chamada das funções e adicione-as nos

PE´s do cliente.

5.1.5. Campos Gerados

Abaixo os campos gerados através do compatibilizador “U_UPDWF”

5.1.5.1. Campos no SC7 (Pedidos de Compras): Campo Descrição

C7_ZZDTENV Data do envio do e-mail

Page 19: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

19

5.1.5.2. Campos no SC8 (Cotações): Campo Descrição

C8_ZZDTENV Data do envio da cotação

C8_ZZDTRET Data do retorno da cotação

C8_ZZWFID Id do processo

C8_ZZUSRGC Usuário que ira mandar o e-mail

C8_ZZINCOT Incoterm

C8_ZZCOTOK Cot.final?

5.1.5.3. Campos no SCR (Documentos com Alçada)

Campo Descrição

CR_ZZDTENV Data de envio para o Primeiro Aprovador.

5.1.5.4. Campos no SA2 (Fornecedores)

Campo Descrição

A2_ZZOPER Operação de Compra.

IMPORTANTE

Preencher os campos C7_ZZDTENV e C8_ZZDTENV, com a data atual. Caso contrário na

primeira vez que for executado o WorkFlow Compras, será enviado um e-mail para

todos os fornecedores do histórico, inteiro, da base do cliente.

5.1.6. Índices Gerados

Tabela SCR:

CR_FILAIL+CR_TIPO+CR_NUM+CR_NIVEL+CR_USER

Tabela SY6:

Y6_FILIAL + Y6_SIGSE4

Page 20: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

20

5.1.7. Parâmetros

Prints e telas

Abaixo imagens que exibem a localização dos parâmetros, acessado pelo configurador.

• Abrir o Protheus no modulo SIGACFG

• Abri o Menu Ambiente>Cadastro>Parâmetros

• Clicar no botão .

Abaixo os parâmetros necessários para o correto funcionamento do WorkFlow

Compras e para o envio de e-mail.

Atenção ao parâmetros com destaque em amarelo

Parâmetro Descrição Exemplo

ZZ_WFLOGO Logo para o workflow (Tem que ser um .JPG da Web)

http://www.totvs.com/image/company_logo ?img_id=10209&t=1368996217181

ZZ_WFIPEXT IP para acesso externo Exemplo : 10.0.1.39:9191 (IP Local e Porta referente a seção HTTP) – Verificar Configuração do WorkFlow no AppServer.ini.

ZZ_WFRES Caminho dos HTMLs gerados pelo workflow

\messenger\

ZZ_WFCOTRE Dias antes da data atual para as cotações a serem consideradas

2

ZZ_WFCOTSR Dias até quando considerar as cotações

1

ZZ_WFCPAGT Condições de Pagamentos que entram no workflow

001;002;003

ZZ_WFHTML Caminho padrão do para os modelos HTMLs do Workflow

\Workflow\Compras

ZZ_WFPST Nome da caixa de correio cadastrada na tabela WF7 através do configurador

Exemplo: WORKFLOW TOTVSIP

ZZ_WFHCTEF Envia WF na cotação para fornecedor?

S=Sim; N=Não

ZZ_WFHCTNP Envia WF na inclusão de nova proposta?

S=Sim; N=Não

ZZ_WFHCTPP Envia WF na inclusão de novo participante?

S=Sim; N=Não

ZZ_WFHCTRE Reenvia WF na cotação para fornecedor?

S=Sim; N=Não

Page 21: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

21

ZZ_WFHCTSR

Envia WF de aviso sem

resposta para o usuário que

gerou a cotação?

S=Sim; N=Não

ZZ_WFHNFNO Envia WF para notificação do solicitante avisando a entrada do material?

S=Sim; N=Não

ZZ_WFHPCEN Envia WF para aprovador apos geração de pedido de compra?

S=Sim; N=Não

ZZ_WFHPCIS Envia WF para solicitante avisando aprovação ou reprovação do pedido?

S=Sim; N=Não

ZZ_WFHPCIC Envia WF para comprador avisando aprovação ou reprovação do pedido?

S=Sim; N=Não

ZZ_WFHPCIF Envia WF para fornecedor, vencedor, com os dados do pedido?

S=Sim; N=Não

ZZ_WFHPEXC Envia WF para comprador avisando sobre exclusão do pedido de compra?

S=Sim; N=Não

ZZ_WFHPEXS Envia WF para solicitante avisando sobre exclusão do pedido de compra?

S=Sim; N=Não

ZZ_WFALCAD Informa se o cliente tem controle de alçadas

S=Sim; N=Não

ZZ_WFTOD Dias para time out Numérico, Ex.: 5

ZZ_WFTOH Horas para time out Numérico, Ex.: 1

ZZ_WFTOM Minutos para time out Numérico, Ex.: 10

ZZ_WFESPNF Definir espécies da Nota Entrada

Ex.: NFE, NF, NFP, ETC (Caso haja mais que uma espécie separar por virgula)

ZZ_WFCPOMF Campo e-mail que será usado no cadastro fornecedor

Ex.: A2_EMAIL

ZZ_WFAUTH Autentica aprovador do pedido de compra via navegador web ?

.T. ou .F.

ZZ_WFATCOT

Proteção para não permitir atualizar uma cotação, que foi atualizado manualmente. True não permite atualizar e False permite atualizar.

.T. ou .F.

ZZ_WFHTV

Define o Nome do Arquivo Modelo html para o E-mail do Pedido de Compra ao Fornecedor Vencedor. Usado para Definir modelos específicos por Empresa.

Padrão = Vencedor.htm

Page 22: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

22

ZZ_WFHTVI

Define o Nome do Arquivo Modelo html para o E-mail do Pedido de Compra ao Fornecedor Vencedor em Inglês. Usado para Definir modelos específicos por Empresa.

Padrão = Vencedor_ing.htm

ZZ_WFOPECO

Operação padrão a ser utilizada na cotação via workflow caso o campo A2_ZZOPER não esteja preenchido

Exemplo: 001,002

ZZ_WFPEOPE Indica se preenche automaticamente a operaçã no workflow de compras

S=Sim; N=Não

ZZ_EXCCOT

Indica se exclui o item da cotação durante o retorno, caso o mesmo esteja com os valores zerados. Este parâmetro funciona em conjunto com o ponto de entrada MT150CHV.

.T. = Exclui

.F. = Não exclui

ATENÇÃO -> Revisar todos os parâmetros de acordo com a necessidade do cliente.

Obs.: Configurar Parâmetros de acordo com configuração de e-mail (ver sumário).

Page 23: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

23

6. Pastas

Criar dentro da pasta Protheus_Data a estrutura abaixo

1 – Criar pasta web 2 – Criar pasta workflow e dentro a pasta Compras Dentro da pasta (Compras) deve estar os arquivos e pastas abaixo:

Esses arquivos são disponibilizados no arquivo HTML.rar Obs.: Após executada a rotina de workflow, será criada a estrutura de pastas abaixo, com exceção das pastas PROCESSADOS e REJEITADOS que devem ser criadas manualmente:

Caso o servidor protheus seja LINUX, o caminho e os nomes dos arquivos HTML devem estar minúsculos, caso contrário ele não consegue localizar esses arquivos, assim não gerando o objeto oHTML, gerando erro (variable is not an object).

Page 24: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

24

7. Configuração de E-mail Abaixo segue os prints das telas para configuração da conta de e-mail no Protheus.

Configurar de acordo com o servidor de e-mail.

7.1. Parâmetros

Page 25: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

25

Page 26: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

26

7.2. Contas de E-mail

Page 27: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

27

Page 28: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

28

Page 29: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

29

Page 30: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

30

8. Configuração do WorkFlow no AppServer.ini

Adicionar ao .INI do servidor Protheus.

[HTTP] ENABLE=1 PORT=9191 path=D:\Protheus\Workflow\Sistema\Protheus_data\web [10.0.1.39:9191] (IP Local e Porta referente a sessão HTTP) ENABLE=1 path=D:\Protheus\Workflow\Sistema\Protheus_data\web ENVIRONMENT=WORKFLOW INSTANCENAME=WF RESPONSEJOB=JOB_WF ;Trecho referente a autenticacao do aprovador do pedido de compra via web [10.0.1.39:9191/AUT] ENABLE=1 PATH=C:\Protheus115\PROTHEUS_DATA\WEB ENVIRONMENT=TOP INSTANCENAME=wf RESPONSEJOB=JOB_AUT_WF [JOB_WF] TYPE=WEB ENVIRONMENT=WORKFLOW INSTANCES=1,10 SIGAWEB=WF ONSTART=STARTWEBEX ONCONNECT=CONNECTWEBEX ONEXIT=FINISHWEBEX WEBHOST=http://10.0.1.39:9191 (IP Local e Porta referente a sessão HTTP) PREPAREIN=99,01 ;Trecho referente a autenticacao do aprovador do pedido de compra via web [JOB_AUT_WF] TYPE=WEBEX ENVIRONMENT=TOP INSTANCES=1,10 INSTANCENAME=wf ONSTART=STARTWEBEX ONCONNECT=CONNECTWEBEX ONEXIT=FINISHWEBEX

Page 31: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

31

WEBHOST=http://10.0.1.39:9191 PREPAREIN=99,01

9. Utilizando os pontos de entrada

9.1. Cotação

PEWFCOT – Ponto de entrada para tratamento e manipulação dos arquivos HTML (Inclusão de e alteração de campos) durante o processo de cotação

Em que ponto Parâmetro

Envio de e-mail para fornecedor (Cabeçalho do HTML) HTML_COTEN_CAMPOS_CAB

Envio de e-mail para fornecedor (Itens do HTML)

HTML_COTEN_CAMPOS_ITEM

Envio de e-mail avisando que não houve resposta para a cotação

HTML_COTSR_CAMPOS_CAB

Envio de e-mail avisando que uma cotação foi gerada HTML_COTAV_CAMPOS

Envio de e-mail avisando que a cotação foi respondida HTML_COTRESP_CAMPOS

Envio de e-mail avisando que uma cotação foi gerada

(Alteração nas informações do cabeçalho de e-mail) HTML_COTAV_CAB_CAMPOS

Como utilizar: Identificar pelas condições acima o momento onde o HTML deve ser alterado e adicionar no array o novo campo e o valor desejado, conforme exemplo abaixo:

Envio de Workflow para fornecedor (Cabeçalho do HTML)

If Alltrim(cPonto) == "HTML_COTEN_CAMPOS_CAB" aRet:= {{"TESTE","0001"}} --------------------� [ARRAY] Endif

Este ponto de entrada adicionará o valor “0001” ao campo “TESTE” do HTML.

Page 32: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

32

9.2. Pedido de compra

PEWFPC – Ponto de entrada para tratamento e manipulação dos arquivos HTML (Inclusão de e alteração de campos) durante o processo de PEDIDO DE COMPRA.

Em que ponto Parâmetro

Envio de e-mail com o pedido de compra para fornecedor vencedor.

HTML_PED_VENCEDOR

Envio de e-mail avisando sobre aprovação do pedido. HTML_AVISO_APROV_PC

Envio de e-mail avisando sobre o resultado da aprovação do pedido para comprador.

HTML_RESULT_APROV_PC_COMP

Envio do e-mail para aprovação do pedido de compra (Cabeçalho do HTML).

HTML_APROV_PC_CAB

Envio do e-mail para aprovação do pedido de compra (Itens do HTML).

HTML_APROV_PC_ITEM

Envio do e-mail para aprovação do pedido de compra (Itens da Cotação).

HTML_APROV_PC_ITEMCT

Envio do e-mail para aprovação do pedido de compra (Itens do Aprovador).

HTML_APROV_PC_ITEMAP

Envio de e-mail avisando sobre o resultado da aprovação do pedido para solicitante.

HTML_RESULT_APROV_PC_SOLIC

Envio de e-mail avisando sobre a exclusão do pedido para o comprador.

HTML_PED_EXCLUI_COMP

Envio de e-mail avisando sobre a exclusão do pedido para o solicitante.

HTML_PED_EXCLUI_SOLIC

Permite complementar informações no retorno da aprovação do pedido de compra.

RETORNO

Como utilizar: Identificar pelas condições acima o momento onde o HTML deve ser alterado e adicionar no array o novo campo e o valor desejado, conforme exemplo abaixo:

Envio de Workflow avisando sobre aprovação do pedido.

If Alltrim(cPonto) == "HTML_AVISO_APROV_PC" aRet:= {{"TESTE","0001"}} --------------------� [ARRAY] Endif

Este ponto de entrada adicionará o valor “0001” ao campo “TESTE” do HTML.

Page 33: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

33

9.3. Nota fiscal de entrada

PEWFNF – Ponto de entrada para tratamento e manipulação dos arquivos HTML (Inclusão de e alteração de campos) durante o processo de PEDIDO DE COMPRA, ao realizar a entrada da nota fiscal.

Em que ponto Parâmetro

Envio de Notificação sobre Atendimento da solicitação de compra

HTML_PC_INFATEND_SC

Como utilizar: Identificar pelas condições acima o momento onde o HTML deve ser alterado e adicionar no array o novo campo e o valor desejado, conforme exemplo abaixo:

Envio de Notificação sobre Atendimento da solicitacao de compra.

If Alltrim(cPonto) == "HTML_PC_INFATEND_SC" aRet:= {{"TESTE","0001"}} --------------------� [ARRAY] Endif

Este ponto de entrada adicionará o valor “0001” ao campo “TESTE” do HTML.

Page 34: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

34

10. Função adicional

10.1. EnvPed()

Apesar deste e-mail já ser disparado automático caso o pedido de compra seja

aprovado por todos os aprovadores, o botão Enviar e-mail é um processo manual,

não requisitando, necessariamente, a inclusão da função EnvPed no menu do

Protheus.

Essa função mostra as cotações analisadas e seu pedido de compra automático.

Tela apresentada:

Enchoice Bar

O botão Enviar e-mail (figura acima), envia um e-mail ao fornecedor, referente às cotações selecionadas, informando da geração do pedido de compra.

Page 35: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

35

11. Problemas Adversos

Atenção aos problemas adversos que podem ser encontrados no momento do fluxo de trabalho ou na própria instalação:

Ponto de Entrada MT100AGR

Este Ponto de Entrada é executado quando inserimos um documento de entrada. Em algum momento pode ser que o mesmo não seja executado:

Atenção no momento do cadastro:

O ponto de entrada filtra o seu funcionamento através dos campos destacados, conforme imagem acima, obrigando que o Tipo da Nota seja “Normal”, e Espec.Docum. esteja informado no parâmetro ZZ_WFESPNF, conforme mencionado na seção parâmetros deste documento.

Caso algum campo seja cadastrado diferentemente do padrão, o envio de e-

mail ao solicitantes / compradores estará comprometido e ocasionará uma quebra no

WorkFlow Compras.

Caso ocorra o erro abaixo, é necessário aplicar o patch anexo no arquivo TQJBEJ.rar

(Patch de correção, contido no chamado TQJBEJ).

THREAD ERROR […]

argument error in function Len() on

TWFPROCESS:SAVEVALFILE(WFPROCESS.PRW) 28/05/2014

19:41:26 line : 666

Page 36: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

36

Correção do erro:

on TWFMAIL:SENDMAIL(WFMAIL.PRW) 02/06/2014 17:26:59 line : 585

OBS: O erro irá ocorrer sem o parâmetro MV_WFREPRO criado em base após as atualizações: RPO (14-08-08-bra-chi-eua-par-uru-tttp110.rpo) LIB (14-07-25-Lib_Label_20140526_P11-tttp110) UPD (14-08-08-update-bra-chi-eua-par-uru-tttp110.zip)

Ele é criado automaticamente ao marcar a opção “Reprocessar arquivos da pasta error” na rotina “Parâmetros do WF” via SIGACFG conforme print de tela abaixo.

Após marcar a opção citada acima e confirmar, verifique se foi criado o parâmetro

MV_WFREPRO.

Page 37: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

37

Inicialmente o parâmetro é criado como .T.

Ao desmarcar a opção citada acima, o parâmetro automaticamente é definido como .F.

Page 38: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

38

12. Pontos de Entrada Específicos Ponto de Entrada Descrição Tabela Posicionada Retorno Parametro

COTAÇÃO

PEWFCTQTD Ponto de entrada que altera o valor da quantidade (TB.QUANT) dos 2 html's

SC1, SC8 e SB1 Caracter (Formatado com a

Picture) -

PEWFCTGR Ponto de entrada executado durante a gravação da tabela SC8.

SC8 Sem Retorno (Utilizado para alteração da tabela SC8.

É passado o objeto oProcess(processo do workflow)

PEWFCTPR

Ponto de entrada para manipulação da descrição do produto nos arquivos HTML (Inclusão e alteração de campos) durante o processo de cotação

SC7 e SC8 Caracter

É passado um array de parâmetros onde o primeiro possuí o código do produto e o segundo se é no idioma ingles (.T. ou

.F.)

PEWFCT Ponto de entrada que retorna os endereços de e-mail para envio da cotação.

- Caracter EMAIL_COTACAO

Page 39: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

39

Ponto de Entrada Descrição Tabela Posicionada Retorno Parametro

PEWFLOW04 Ponto de entrada que permite preencher o array com os produtos da cotação em questão.

-

Array de String contendo os arquivos

a serem anexados com seu devido

caminho (absoluto ou relativo)

É passado um array com 5 posições: Primeira: Em que momento ocorre ("PRODUTOS

DA COTACAO" ou "ANEXA ARQUIVOS") PRODUTOS DA COTACAO: Ocorre item a item da cotação e retorna um array de arquivos a serem

anexados. ANEXA ARQUIVOS: Ocorre uma unica vez antes de

anexar os arquivos.

Segunda: O numero da cotação Terceira: Se é em ingles (.T. ou .F.)

Quarta: Array de arquivos já preparados anteriormente

Quinta: Array contendo os dados do cabeçalho

PEDIDO DE COMPRA

PEWFEPPR Ponto de Entrada que permite carregar uma descrição do produto, diferente da padrão.

SC7 Caracter -

PEWFITPC Ponto de Entrada que permite alterar o valor total do Pedido.

SB1 e SC7 Numérico

É passado um array de parâmetros onde o primeiro identifica o ponto de ocorrência (PC ou

COTACAO) e o segundo o objeto oHTML onde DEVEM ser informados os campos de itens que

não serão preenchidos automaticamente no HTML.

Page 40: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

40

Ponto de Entrada Descrição Tabela Posicionada Retorno Parametro

DSTEMLPC Ponto de Entrada que permite informar um destinatário de e-mail diferente do padrão do fornecedor.

SA2 e SC7 Caracter, formato e-mail (validação se existe @)

-

NOTA-FISCAL

PEWFNFPR Ponto de Entrada que permite carregar uma descrição do produto, diferente da padrão.

SB1, SC7 e SD1 Caracter -

PEWFNFPR

Ponto de Entrada que permite carregar uma descrição do produto, diferente da padrão.

SC7, SA2 e SE4 Caracter Código do produto (D1_CODIGO)

Page 41: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

41

12.1. Exemplo de utilização

PEWFCTPR

User Function PEWFCTPR()

Local cProd := PARAMIXB Local cDescri := "" cDescri := posicione("SB5",1,xFilial("SB5")+cProd,"B5_CEME")

Return(cDescri)

PEWFITPC

User Function PEWFITPC()

aAdd( (oHtml:ValByName( "tc.item" )),AllTrim(VSC8->C8_ITEM) )

aAdd( (oHtml:ValByName( "tc.codigo" )),AllTrim(VSC8->C8_PRODUTO) )

aAdd( (oHtml:ValByName( "tc.descricao" )),SB1->B1_DESC )

aAdd( (oHtml:ValByName( "tc.preco" )),Transform( VSC8->C8_PRECO,PesqPict( "SC8", "C8_PRECO" )) )

aAdd( (oHtml:ValByName( "tc.total" )),Transform( VSC8->C8_TOTAL,PesqPict( "SC8", "C8_TOTAL" )) )

Return VSC8->C8_TOTAL

DSTEMLPC

User Function DstEmlPC()

Local cDestEmail := Alltrim(SuperGetMv("ZZ_WFRETCF",, 'F'))

Local cEmailDest := ""

If cDestEmail == "C" // Manda email para o Comprador

cEmailDest := Lower(Alltrim(UsrRetMail(SC7->C7_USER)))

EndIf

Return(cEmailDest)

Page 42: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

42

PEWFEPPR

User Function PEWFEPPR() Local cMoeda := "" Local cDescri := "" Local lIngles := Upper(Posicione("SA2", 1, xFilial("SA2") + SC7->C7_FORNECE, "A2_EST")) == "EX" If lIngles If SC7->C7_MOEDA == 1 cMoeda := "R$" ElseIf SC7->C7_MOEDA == 2 cMoeda := "US$" ElseIf SC7->C7_MOEDA == 4 cMoeda := "EUR" ElseIf SC7->C7_MOEDA == 5 cMoeda := "JPY" EndIf EndIf If lIngles .And. cMoeda == "US$" cDescri := AllTrim(MSMM(SB1->B1_DESC_I)) ElseIf !lIngles .Or. (lIngles .And. cMoeda != "US$") cDescri := SB1->B1_DESC EndIf

Return(cDescri)

13. Pontos de Atenção

Há casos em que o ponto de entrada MT160WF não funciona, sendo necessário o

uso do MT120GOK.

Caso o envio de e-mail seja intermitente, ou seja, enviando e-mails para alguns

casos e outros não, verificar o log. Se a mensagem de erro for a abaixo, remover porta

das configurações do servidor nas “Contas de E-mails” no sigacfg.

[ERROR][SERVER] [SOCKCLIENT] Error [12] There was no response from the server.

Remover conteúdo dos campos marcados abaixo:

Page 43: Workflow Compras Manual de Implantação v.2.0

ACELERADOR WORKFLOW DE COMPRAS

43

Obs.: Esta configuração pode ser específica de acordo com o servidor de e-mail

utilizado pela empresa.