Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 3

changes.mady.by.user Gianluca Moreira

Gravado em

comparado com

Nova versão 4

changes.mady.by.user Gianluca Moreira

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Para maiores informações a respeito da grade de produtos, acesse Grades de Produtos (MATA550 - SIGAEST)

Por se tratar de ponto de entrada de uso geral, recomenda-se que as regras de negócio sejam tratadas por rotina, separando-as com a verificação da função FWIsInCallStack.

Por ser acionada por vários campos de dentro das rotinas, recomenda-se a verificação do campo que acionou utilizando a função READVAR().

04. Parâmetros

Os parâmetros a seguir são informados pela variável Private PARAMIXB, e devem apenas ser lidos e não alterados pela customização.

...

Os parâmetros a seguir são disponibilizados por variáveis Private e podem ser lidos e alterados, entretanto, deve-se alterá-los com cautela para não comprometer o funcionamento da rotina. A alteração da estrutura dos arrays abaixo (seja excluindo ou adicionando novas posições) poderá acarretar em comportamentos imprevisíveis.

NomeTipoDescrição
aHeadGradeArray

aHeadGrade - Array contendo os cabeçalhos das telas de grade, uma posição por linha do grid original (tamanho do aColsAux). Acessar sempre pelo índice nLinO. Produtos diferentes podem possuir tabelas de grade diferentes. Este array é de uso interno, e não é referente ao exibido na tela para o usuário.

Estrutura do array:

aHeadGradeContém um ou mais cabeçalhos de grade, a depender de quantos produtos com controle de grade foram informados na rotina principal.
aHeadGrade[nLinO]Contém 1+j posições, dependendo da quantidade de colunas de grade (tabela SBV)
aHeadGrade[nLinO,1]Indica se é uma Referência (R) ou não (N)
aHeadGrade[nLinO,j]A partir da segunda posição, contém as colunas da grade do produto, até o número diponível. Ex: Grade de 3 colunas, aHeadGrade[nLinO][2] a aHeadGrade[nLinO][4], j vai de 2 a 4. Contém arrays de 10 posições no mesmo padrão do aHeader do MsGetDados
aHeadGrade[nLinO,j,1]Título do campo, Ex: "[01] PEDRA"
aHeadGrade[nLinO,j,2]Nome do campo (controle interno). Ex: "_01"
aHeadGrade[nLinO,j,3]Máscara do campo. Ex: "@E 99,999,999,999.99                         "
aHeadGrade[nLinO,j,4]Tamanho do campo. Ex: 14
aHeadGrade[nLinO,j,5]Decimal do campo. Ex: 2
aHeadGrade[nLinO,j,6]Valid do campo. Ex: "MatVldGGrd() .And. aVldGr220()"
aHeadGrade[nLinO,j,7]Usado do campo. Ex: "û"
aHeadGrade[nLinO,j,8]Tipo do campo. Ex: "N"
aHeadGrade[nLinO,j,9]F3 do campo. Não utilizado
aHeadGrade[nLinO,j,10]Contexto do campo - Real (R) ou Virtual (V)

Recomenda-se que esta variável seja somente acessada para leitura.

oGrade:aCposCtrlGrdArray

Array com a lista de campos da rotina principal que acionam a interface de grade. Deverá ser usado apenas para consultar a posição no array aColsGrade. Veja a seguir e no exemplo. Não alterar este array.

aColsGradeArray

Array contendo os grids das tabelas de grade, uma posição por linha do grid original (tamanho do aColsAux). Acessar sempre pelo índice nLinO. Produtos diferentes podem possuir tabelas de grade diferentes. Este array é de uso interno, e não é referente ao exibido na tela para o usuário.

Estrutura do Array

Numérico

:

aColsGradeContém um ou mais grids da grade de produtos, a depender de quantos produtos com controle de grade foram informados na rotina principal.
aColsGrade[nLinO]Contém i posições, dependendo da quantidade de linhas de grade (tabela SBV)
aColsGrade[nLinO,i]Contém 1+j posições, dependendo da quantidade de colunas de grade (ver aHeadGrade)
aColsGrade[nLinO,i,1]Contém o título da linha. Ex: "[01] 10   "
aColsGrade[nLinO,i,j]A partir da segunda posição, contém as colunas da grade do produto, até o número diponível. Ex: Grade de 3 colunas, aColsGrade[nLinO][i][2] a aColsGrade[nLinO][i][4], j vai de 2 a 4. Contém array de k posições, a depender da quantidade de campos na rotina que permitem o controle de grade. Por exemplo, o Saldo inicial MATA220 possui 13 campos que permitem o preenchimento de grade, logo, este array terá 13 posições. Ver exemplo abaixo.
aColsGrade[nLinO,i,j,k]Contém o valor gravado na linha/coluna/campo da grade.

Caso necessário, este array poderá ser alterado.

oGrade:aSumCpos

Array

Contém os totalizadores da interface de grade. Não está disponível para todos os campos. Verificar se o array existe e procurar em qual posição está o campo que está sendo alterado.


05. RETORNO


NomeTipoDescrição
aLotesArrayRetornar novo array na mesma estrutura descrita no item 04. Parâmetros

...