M461COR - Altera as cores dos status do “browse” dos pedidos para a Nota Fiscal de Saída

Características do Requisito

Linha de Produto:

Microsiga Protheus®

Segmento:

Serviços

Módulo:

Faturamento - SIGAFAT

Rotina:

Rotina

Nome Técnico

Preparação do Documento de Saída

MATA461

Ponto de Entrada:

M461COR

Tickets relacionados

2433223

Requisito/Story/Issue:

DSERFAT-6369

País(es):

Todos os países

Banco(s) de Dados:

Todos os homologados

Sistema(s) Operacional(is):

Todos os homologados

Ponto de Entrada

Descrição:

Este ponto de entrada pertence à rotina de Preparação do Documento de Saída (MATA461). Ele deve ser utilizado em conjunto com o ponto M461LEG para que as cores dos status do browse dos pedidos de venda para a geração do documento de saída sejam alteradas.

Localização:

Atualizações → Faturamento → Documentos de Saída

Eventos:

M461COR ( < PARAMIXB> ) → aCores

Parâmetros:O ponto de entrada se utiliza da variável padrão PARAMIXB, que receberá a configuração padrão das regras para as legendas da rotina, na forma de array, para que seja possível a customização das cores conforme a sua necessidade.

Programa Fonte:

Preparação de Documento de Saída - MATA461.PRX

Retorno:

Nome

Tipo

Descrição

Obrigatório

aCores

Array

Array com as cores padrões.

Sim


Exemplo:

#Include "protheus.ch"
User Function M461COR()
Local aCores := {} // Variável que conterá o retorno das novas regras para a aplicação nas legendas do browse da rotina
//****************************************************************************************************************************************************
//---- O ParamIXB recebeu a CONFIGURAÇÃO PADRÂO das legendas na forma de um array bidimensional
// ParamIXB := {{'Empty(SC9->C9_BLEST) .And. Empty(SC9->C9_BLCRED) .And. SC9->C9_BLWMS$"05,06,07, "','ENABLE'},; //Pedido de Venda Liberado (Configuração da regra padrão)
// {'SC9->C9_BLEST=="10" .And. SC9->C9_BLCRED=="10" .And. SC9->C9_BLWMS$"05,06,07, "','DISABLE'},; //Pedido de Venda Faturado (Configuração da regra padrão)
// {'!(Empty(SC9->C9_BLEST) .And. Empty(SC9->C9_BLCRED) .And. SC9->C9_BLWMS$"05,06,07, ")','BR_AZUL'}} //Pedido de Venda com bloqueio (Configuração da regra padrão)
//****************************************************************************************************************************************************
aCores := { {'Empty(SC9->C9_BLEST) .And. Empty(SC9->C9_BLCRED) .And. SC9->C9_BLWMS$"05,06,07, " .And. SC9->C9_MYFIELD == "1"','ENABLE'},;       //A regra padrão 1 para os 'Pedidos de Venda Liberados' foi customizada (acrescentando o teste do campo customizado C9_MYFIELD=="1"). A legenda será exibida na cor VERDE.
{'SC9->C9_BLEST=="10" .And. SC9->C9_BLCRED=="10" .And. SC9->C9_BLWMS$"05,06,07, " .And. SC9->C9_MYFIELD == "1"','DISABLE'},; //A regra padrão 2 para os 'Pedido de Venda Faturado' foi customizada (acrescentando o teste do campo customizado C9_MYFIELD=="1"). A legenda será exibida na cor VERMELHA.
{'!(Empty(SC9->C9_BLEST) .And. Empty(SC9->C9_BLCRED) .And. SC9->C9_BLWMS$"05,06,07, ") .And. SC9->C9_MYFIELD == "1"','BR_AZUL'},; //A regra padrão 3 para os 'Pedido de Venda com bloqueio' foi customizada (acrescentando o teste do campo customizado C9_MYFIELD=="1"). A legenda será exibida na cor AZUL.
{'Empty(SC9->C9_BLEST) .And. Empty(SC9->C9_BLCRED) .And. SC9->C9_BLWMS$"05,06,07, " .And. SC9->C9_MYFIELD == "2"',"BR_PINK"},; //Nova regra para o 'Pedido de Venda Liberado' acrescido do campo customizado C9_MYFIELD=="2". A legenda será exibida na cor ROSA.
{'SC9->C9_BLEST=="10" .And. SC9->C9_BLCRED=="10" .And. SC9->C9_BLWMS$"05,06,07, " .And. SC9->C9_MYFIELD == "2"',"BR_AMARELO"},; //Nova regra para o 'Pedido de Venda Faturado' acrescido do campo customizado C9_MYFIELD=="2". A legenda será exibida na cor AMARELA.
{'!(Empty(SC9->C9_BLEST) .And. Empty(SC9->C9_BLCRED) .And. SC9->C9_BLWMS$"05,06,07, ") .And. SC9->C9_MYFIELD == "2"','BR_MARROM'}} //Nova regra para o 'Pedido de Venda com bloqueio' acrescido do campo customizado C9_MYFIELD=="2". A legenda será exibida na cor MARROM.
Return aCores

Importante

  1. A eventual customização das legendas passará pela aplicação das regras e critérios pré-estabelecidos pelas funcionalidades do Framework;
  2. É obrigatório que, o array das regras customizadas devolvido à rotina padrão pelo ponto de entrada para a aplicação de cada legenda, contenha apenas uma das regras como válida. Isto porque, a cor da legenda de cada registro do browse obedecerá sempre à primeira regra válida encontrada. Por isso, verifique sempre se a construção das regras customizadas realmente satisfazem a este princípio, caso contrário, a exibição de suas legendas pode não surtir o efeito esperado;
  3. Ao criar as legendas customizadas, as funcionalidades padrões da rotina não serão modificadas.