Linha Microsiga Protheus

Árvore de páginas

Ponto de entrada MTALCPER

Linha de Produto:

Protheus

Segmento:

Manufatura

Módulo:

SIGACOM - Compras

Rotina:

Rotina

Nome Técnico

Liberação de Documentos

MATA094

Liberação de DocumentosMATA097
Controle de AlçadasMATXALC

Ponto de Entrada:

MTALCPER

País(es):

Brasil

Banco(s) de Dados:

Todos

Sistema(s) operacional(is):

Windows® / Linux®

Versões/Release:

12.1.14

Ponto de Entrada

Descrição:

O ponto de entrada MTALCPER permite utilizar o controle de alçadas de forma customizada em documentos que não controlam alçada por padrão. 

Localização:

No momento da liberação de documentos bloqueados por controle de alçada.

Programa Fonte:

MATA194; MATA197; MATXALC;

Função:

FonteFunçãoEm qual momento
MATA094A094CommitNa atualização dos dados da liberação (tabela SCR e tabela do documento com alçada customizada).
MATA097A097Libera

Antes da montagem da tela de liberação para carga dos dados do documento e depois da confirmação de liberação para atualização dos dados,

(tabela SCR e tabela do documento com alçada customizada).

MATA097A097Superi

Antes da montagem da tela de liberação para carga dos dados do documento e depois da confirmação de liberação para atualização dos dados,

(tabela SCR e tabela do documento com alçada customizada).

MATA097A097Estorn

Antes da montagem da tela de estorno para carga dos dados do documento e depois da confirmação de estorno para atualização dos dados,

(tabela SCR e tabela do documento com alçada customizada).

MATA097A097Transf

Antes da montagem da tela de transferência para carga dos dados do documento e depois da confirmação de transferência para atualização dos dados,(tabela SCR).

MATA097A097ProcLibNo processamento da liberação para atualização do campo de flag do controle de alçadas.
MATA097A097ProcSupNo processamento da liberação pelo superior para atualização do campo de flag do controle de alçadas.
MATA097A097VisualAo acionar a visualização do documento
MATA097A097LockAo bloquear o registro para atualização do status de aprovação
Parâmetrosnão há

Retorno:

Deverá retornar um Array com as informações de todos os documentos com alçada implementada de forma customizada. Estas informações serão utilizadas pelo programa de Liberação de Documentos para processar os eventos de aprovação, rejeição, transferência, aprovação pelo superior e estorno. O array deverá ser entregue no seguinte formato:

Posição

Descrição

Tipo

Tamanho

 aRet[nx,1]

Código do tipo de documento utilizado para o documento com alçada customizada (conforme parâmetro enviado na MaAlcDoc, para criação da alçada e campo CR_TIPO).

Caractere

Mesmo do campo CR_TIPO

aRet[nx,2]

Alias do documento com alçada customizada.Caractere3
aRet[nx,3]

Índice do Alias do documento com alçada customizada para pesquisa do referido documento. Deve ser um índice onde o início da chave corresponda a(os) ao valor(es) gravado no campo CR_NUM (chave de identificação do documento).

NuméricoNão fixado

aRet[nx,4]

Chave de campos (sem a filial) do alias do documento com alçada customizada que compõe o valor do campo CR_NUM (chave de identificação do documento).CaractereNão fixado

aRet[nX,5]

Bloco de código com o comando para abertura da interface de visualização do documento com alçada customizada.Bloco de código sem retorno esperado.Não fixado
aRet[nX,6]Bloco de código com o comando para validar a permissão de estorno das aprovações e rejeições do documento com alçada customizada .Bloco de código com retorno lógico, sendo verdadeiro (.T.)para permitir o estorno e falso (.F.) para bloquear o estorno.Não fixado

aRet[nX,7]

Vetor com os dados do campo de controle no alias do documento com alçada customizada utilizado para controle da liberação.Vetor4
aRet[nX,7,1]Nome do campo de controle no alias do documento com alçada customizada.CaractereConforme campo
aRet[nX,7,2]Conteúdo do campo de controle que indicará que o documento encontra-se bloqueado (pendente de aprovação ou rejeição)CaractereConforme campo

aRet[nX,7,3]

Conteúdo do campo de controle que indicará que o documento encontra-se aprovado.CaractereConforme campo
aRet[nX,7,4] Conteúdo do campo de controle que indicará que o documento encontra-se rejeitado.CaractereConforme campo

 Exemplo:

#INCLUDE 'PROTHEUS.CH'

User function MTALCPER()

Local aAlc := {}

// Validações do usuário

If SCR->CR_TIPO == 'ED'

    aAdd(aAlc,{ SCR->CR_TIPO, 'CO1', 1, 'CO1->CO1_CODEDT','','',{'CO1->CO1_XBLQST',"A","","2"}}}

EndIf

Return(aAlc)


Observações: 

  1. A geração e exclusão das alçadas de aprovação (processadas pela função MAAlcDoc) nos eventos de inclusão, alteração e exclusão dos documentos, não serão realizadas a partir da utilização deste ponto de entrada. Para isto, deverão ser utilizados pontos de entrada (se documento padrão do sistema) ou alterado o fonte (se documento customizado), para que na gravação dos documentos sejam realizadas as chamadas da função MAAlcDoc.
  2. Caso esteja utilizando a aprovação por tipo de documento (parâmetro MV_ALTPDOC), recomenda-se a criação dos campos “AL_DOC” + tipo de documento, para possibilitar determinar os grupos de aprovação por tipo de documento para os documentos com alçadas customizadas.