Post on 27-Jan-2016
description
INSTALAÇÃO
ACELERADOR WORKFLOW DE COMPRAS
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
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
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
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()
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.
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).
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.
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.
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
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.
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.
ACELERADOR WORKFLOW DE COMPRAS
13
• Aguardar e clicar no botão .
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 .
ACELERADOR WORKFLOW DE COMPRAS
15
• Se já foi efetuado todo os Backup’s necessarios clicar no botão .
• Selecionar a Empresa (Imagem abaixo);
ACELERADOR WORKFLOW DE COMPRAS
16
• Clicar no botão .
• Clicar no botão .
ACELERADOR WORKFLOW DE COMPRAS
17
• Aguardar atualizações, conforme imagens:
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
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
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
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
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).
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).
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
ACELERADOR WORKFLOW DE COMPRAS
25
ACELERADOR WORKFLOW DE COMPRAS
26
7.2. Contas de E-mail
ACELERADOR WORKFLOW DE COMPRAS
27
ACELERADOR WORKFLOW DE COMPRAS
28
ACELERADOR WORKFLOW DE COMPRAS
29
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
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.
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.
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.
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.
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
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.
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.
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
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.
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)
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)
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:
ACELERADOR WORKFLOW DE COMPRAS
43
Obs.: Esta configuração pode ser específica de acordo com o servidor de e-mail
utilizado pela empresa.