Linha Microsiga Protheus

Page tree

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

Ponto de entrada FT600ULGRID

Características do Requisito

Linha de Produto:

Microsiga Protheus®

Segmento:

Serviços

Módulo:

CRM - SIGACRM

Faturamento - SIGAFAT

Rotina:

Rotina

Nome Técnico

Proposta comercialFATA600

Proposta comercial

FATN600

Tickets relacionados

790786

Requisito/Story/Issue (informe o requisito relacionado):

DSERFAT-2025

País(es):

Todos os países.

Banco(s) de Dados:

Todos os bancos de dados homologados.

Sistema(s) Operacional(is):

Todos os sistemas operacionais homologados.

Versão:A partir da 12.1.17

Descrição

Permite interferir no processo de carga dos dados na grid da Proposta Comercial.

Procedimento para Implantação

Este ponto de entrada estará disponível somente se os programas fonte FATA600.PRW e FATN600.PRW possuírem data posterior à 06 de novembro de 2017 (versão 12.1.17) em seu repositório (arquivo ".RPO" do seu ambiente). Portanto, caso deseje utilizar este ponto de entrada, certifique-se desta premissa.

Ponto de Entrada

Descrição:

A finalidade do ponto de entrada FT600ULGRID é permitir que, durante o processo de carga dos dados na grid da Proposta Comercial, seja possível realizar interferências em sua execução, respeitando as suas quatro ações básicas.

Localização:

Quando for realizada a carga dos dados de Serviços (PMS) na Proposta Comercial:

  • SIGACRM → Atualizações → Vendas → Vendas → Oportunidades → Ações Relacionadas → Proposta Comercial → Ações Relacionadas → Serviços (PMS)
  • SIGAFAT → Atualizações → CRM-Administração de vendas → Oportunidades → Ações Relacionadas → Proposta Comercial → Ações Relacionadas → Serviços (PMS)

Para quando o produto possuir acessórios associados a ele:

  • SIGACRM → Atualizações → Vendas → Vendas → Oportunidades → Ações Relacionadas → Proposta Comercial → Ao selecionar o produto na Grid de Produtos da Proposta Comercial
  • SIGAFAT → Atualizações → CRM-Administração de vendas → Oportunidades → Ações Relacionadas → Proposta Comercial → Ao selecionar o produto na Grid de Produtos da Proposta Comercial

Quando for realizada a carga com base nas categorias dos produtos (Para quando o parâmetro MV_FATMNTP for diferente de 4):

  • SIGACRM → Atualizações → Vendas → Vendas → Oportunidades → Ações Relacionadas → Proposta Comercial → Ações Relacionadas → Categoria
  • SIGAFAT → Atualizações → CRM-Administração de vendas → Oportunidades → Ações Relacionadas → Proposta Comercial → Ações Relacionadas → Categoria

Quando for realizada a carga com base nos agrupadores dos produtos (Para quando o parâmetro MV_FATMNTP for igual a 4):

  • SIGACRM → Atualizações → Vendas → Vendas → Oportunidades → Ações Relacionadas → Proposta Comercial → Ações Relacionadas → Agrupadores
  • SIGAFAT → Atualizações → CRM-Administração de vendas → Oportunidades → Ações Relacionadas → Proposta Comercial → Ações Relacionadas → Agrupadores

Programa Fonte:

FATN600.PRW

Parâmetros:

{ <cAction>, <oMdlGrid>, <aGridDetail>, <__cMdlDetail>}

Onde:

NomeTipoDescriçãoObrigatório
<cAction>
Caractere

Código da ação que está em execução no processo de carga dos dados das grids da Proposta Comercial.
As ações disponíveis são:

  • GRID_BEFORE
  • LINE_BEFORE
  • GRID_AFTER
  • LINE_AFTER
Sim
<oMdlGrid>
ObjetoModelo ativo da grid.Sim
<aGridDetail>
ArrayDados/Detalhes da grid ou da linha da grid, conforme a ação que estiver sendo executada.Sim
<__cMdlDetail>
CaractereNome do modelo (detalhe)Sim

Retorno:

Para a ação "GRID_BEFORE"
RetornoTipoDescrição
aRetArray

Array com o conteúdo da grid completa que será considerado na fase anterior ao seu carregamento.
Observações:

  1. A estrutura do array de retorno deve obedecer à mesma estrutura que fora recebida através do parâmetro <aGridDetail> quando da execução do ponto de entrada.
  2. Se tipo do retorno não for um array,
Para a ação "LINE_BEFORE"
RetornoTipoDescrição
aRetArray

Array referente à linha (item) da grid com o conteúdo que será considerado na fase anterior ao seu carregamento.
Observação: A estrutura do array de retorno deve obedecer à mesma estrutura que fora recebida através do parâmetro <aGridDetail> quando da execução do ponto de entrada.

Para a ação "LINE_AFTER"
RetornoTipoDescrição
lRetLógico

Onde:

ConteúdoExecução
.T.O processamento do ponto de entrada foi executado com sucesso. Portanto, a execução da carga das próximas linhas da grid continuará, sem interrupção, até que todas as linhas previstas sejam incluídas na grid.
.F.Ocorreu algum problema durante o processamento do ponto de entrada. Assim, a execução da carga das próximas linhas da grid será interrompida.
Para a ação "GRID_AFTER"
RetornoTipoDescrição
xRetNIL

É o último ponto de entrada a ser executado dentro do processo de carga dos dados da grid.

Exemplo:

#Include 'Protheus.ch'
#Include "FwMVCDef.ch"

*==========================
User Function FT600ULGRID()
*==========================

Local cAction := ParamIXB[1]
Local oMdlGrid := ParamIXB[2]
Local aGridDetail := aClone(ParamIXB[3])
Local cMdlDetail := ParamIXB[4]
Local xRet := NIL

Do Case
       Case cAction == "GRID_BEFORE" // Execução antes de iniciar inclusão de linhas

                     /* Construa a sua customização para que seja executada antes iniciar a inclusão das linhas na GRID.
                     Sua customização deve atualizar os dados do array aGridDetail, e este novo conteúdo deve
                     ser retornado à função padrão. */
                     xRet := aGridDetail

       Case cAction == "LINE_BEFORE" // Execução antes de iniciar inclusão de uma linha

                     /* Construa a sua customização para que seja executada antes da inclusão de uma linha na GRID.
                     Sua customização deve atualizar os dados do array aGridDetail, e este novo conteúdo deve
                     ser retornado à função padrão. */
                     xRet := aGridDetail

       Case cAction == "LINE_AFTER" // Execução após a inclusão de uma linha

                     /* Construa a sua customização para que seja executada após a inclusão de cada linha na GRID */
                     xRet := .T.

       Case cAction == "GRID_AFTER" // Execução após a inclusão de todas as linhas

                     /* Construa a sua customização para que seja executada após a inclusão de todas as linhas na GRID */
                     xRet := NIL

EndCase

Return xRet


Imagem da aplicação do ponto de entrada

Não disponível.

  • No labels