Compatível Países: | Todos |
Sistemas Operacionais: | Todos |
Compatível às Bases de Dados: | Todos |
Nível de Acesso: | Nível 1 (Acesso Clientes) |
Idiomas: | Português, Inglês, Espanhol |
Versão | P10 R1.4 |
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
cID | Caracteres | Identificador do modelo | X | ||
bPre | Bloco de Código | Bloco de código de pré-validação do modelo. O bloco recebe como parametro o objeto de Model e deve retornar um valor lógico. Quando houver uma tentativa de atualização de valor de qualquer Submodelo o bloco de código será invocado. Caso o retorno seja verdadeiro, a alteração será permitida, se retornar falso não será possível concluir a alteração e um erro será atribuido ao model, sendo necessário indicar a natureza do erro através da função Help. | {|| .T.} | X | |
bPost | Bloco de Código | Bloco de código de pós-validação do modelo, equilave ao "TUDOOK". O bloco recebe como parametro o objeto de Model e deve retornar um valor lógico. O bloco será invocado antes da persistência dos dados para validar o model. Caso o retorno seja verdadeiro e não haja nenhum submodelo invalido, será feita a gravação dos dados. Se retornar falso não será possível realizar a gravação e um erro será atribuido ao model, sendo necessário indicar a natureza do erro através da função Help. | X | ||
bCommit | Bloco de Código | Bloco de código de persistência dos dados, ele é invocado pelo método CommitData. O bloco recebe como parametro o objeto do Model e deve realizar a gravação dos dados. | {|| FWFORMCOMMIT(SELF)} | X | |
bCancel | Bloco de Código | Bloco de código de cancelamento da edição, ele é invocado pelo método CancelData. O bloco recebe como parametro o objeto do Model. Quando esse bloco é passado o tratamento de numeração automatica não é mais realizado, a menos que o bloco chame a função FWFormCancel. | {|| FWFORMCANCEL(SELF)} | X |
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
lCopy | Lógico | Informa se o model deve carregar os dados do registro posicionado em operações de inclusão. Essa opção é usada quando é necessário fazer uma operação de cópia. | X |
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
cId | Caracteres | Identificador do modelo. O Id será solicitado em diversas operações com este submodelo. | X | ||
cOwner | Caracteres | Identificador superior do submodelo, o Owner é o submodelo que se relaciona diretamente com o formfield. | X | ||
oModelStruct | Objeto | Objeto com a estrutura de dados do tipo FWFormModelStruct. | X | ||
bPre | Bloco de Código | Bloco de Código de pré-validação do submodelo. Esse bloco é invocado quando há uma tentativa de atribuição de valores. O bloco recebe por parametro o objeto do FormField(FWFormFieldsModel), a identificação da ação e a identificação do campo que está sofrendo a atribuição. As identificações que podem ser passadas são as seguintes: - "CANSETVALUE" : valida se o submodelo pode ou não receber atribuição de valor. - "SETVALUE" : valida se o campo do submodelo pode receber aquele valor. Nesse caso o bloco recebe um quarto parametro que contem o valor que está sendo atribuido ao campo. Para todos os casos o bloco deve retornar um valor lógico, indicando se a ação pode ou não ser executada. Se o retorno for falso um erro será atribuido no Model, sendo necessário indicar a natureza do erro através da função Help. | {|| .T.} | X | |
bPost | Bloco de Código | Bloco de Código de pós-validação do submodelo, ele é equivalente ao "TUDOOK". O bloco de código recebe como parametro o objeto de model do FormField(FWFormFieldsModel) e deve retornar um valor lógico. Este bloco é invocado antes da persistência(gravação) dos dados, validando o submodelo . Se o retorno for verdadeiro a gravação será realizada se os demais submodelos também estiverem validos, do contrário um erro será atribuido no Model, sendo necessário indicar a natureza do erro através da função Help. | {|| .T.} | X | |
bLoad | Bloco de Código | Bloco de carga dos dados do submodelo. Este bloco será invocado durante a execução do método activate desta classe. O bloco recebe por parametro o objeto de model do FormField(FWFormFieldsModel) e um valor lógico indicando se é uma operação de cópia. Espera-se como retorno um array com os dados que serão carregados no objetp, o array deve ter a estrutura abaixo: [1] Array com os dados, a ordem dos dados deve seguir exatamente a mesma ordem dos campos da estrutura de dados [1][1] ExpX: "Nome" [1][2] ExpX: "Cidade" [2] ExpN: Id do registro (RecNo) | {|X,Y| FORMLOADFIELD(X,Y)} | X |
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
cId | Caracteres | Identificador do modelo. O Id será solicitado em diversas operações com este submodelo. | X | ||
cOwner | Caracteres | Identificador superior do submodelo. O Owner é o submodelo que se relaciona diretamente com o formgrid. | X | ||
oModelStruct | Objeto | Objeto com a estrutura de dados do tipo FWFormModelStruct. | X | ||
bLinePre | Bloco de Código | Bloco de Código de pre-edição da linha do grid. O bloco é invocado na deleção de linha, no undelete da linha e nas tentativas de atribuição de valor. Recebe como parametro o objeto de modelo do FormGrid(FWFormGridModel), o número da linha atual e a identificação da ação. A Identificação da ação pode ser um dos itens abaixo: - "UNDELETE" - "DELETE" - "SETVALUE" : nesse caso, serão passados mais três parametros. O 4º parametro é o identificador do campo que está sendo atualizado, o 5º parametro é o valor que está sendo atribuido e o 6º parametro é o valor que está atualmente no campo. - "CANSETVALUE" : nesse caso será passado mais um parametro. O 4º parametro é o identificador do campo que está tentando ser atualizado. O retorno do bloco deve ser um valor lógico que indique se a linha está valida para continuar com a ação. Se retornar verdadeiro, executa a ação do contrário atribui um erro ao Model, sendo necessário indicar a natureza do erro através da função Help. | {|| .T.} | X | |
bLinePost | Bloco de Código | Bloco de código de pós validação da linha do grid, equivale ao "LINHAOK" Recebe como parametro o objeto de modelo do FormGrid(FWFormGridModel) e o número da linha que está sendo validada. O bloco será invocado antes da gravação dos dados. Espera-se um retorno lógico do bloco indicando se a linha está ou não valida. Caso o retorno seja verdadeiro a gravação será realiza, do contrario um erro será atribuido no Model e a gravação não será realizada, sendo necessário indicar a natureza do erro através da função Help. | {|| .T.} | X | |
bPre | Bloco de Código | Bloco de Código de pré-validação do submodelo. O bloco é invocado na deleção de linha, no undelete da linha, na inserção de uma linha e nas tentativas de atribuição de valor. Recebe como parametro o objeto de modelo do FormGrid(FWFormGridModel), o número da linha atual e a identificação da ação. A Identificação da ação pode ser um dos itens abaixo: - "UNDELETE" - "DELETE" - "ADDLINE" : nesse caso não será passado nada para o parametro de numero de linha - "SETVALUE" : nesse caso, serão passados mais três parametros. O 4º parametro é o identificador do campo que está sendo atualizado, o 5º parametro é o valor que está sendo atribuido e o 6º parametro é o valor que está atualmente no campo. - "CANSETVALUE" : nesse caso será passado mais um parametro. O 4º parametro é o identificador do campo que está tentando ser atualizado. O retorno do bloco deve ser um valor lógico que indique se a linha está valida para continuar com a ação. Se retornar verdadeiro, a atualização é permitida, do contrário um erro será atribuido no Model, sendo necessário indicar a natureza do erro através da função Help. | {|| .T.} | X | |
bLinePost | Bloco de Código | Bloco de código de pós validação da linha do grid, equivale ao "LINHAOK" Recebe como parametro o objeto de modelo do FormGrid(FWFormGridModel) e o número da linha que está sendo validada. O bloco será invocado antes da gravação dos dados e na inclusão de uma linha. Espera-se um retorno lógico do bloco indicando se a linha está ou não valida. Caso o retorno seja falso um erro será atribuido no Model e a gravação não será realizada, sendo necessário indicar a natureza do erro através da função Help. | X | ||
bLoad | Bloco de Código | Bloco de carga dos dados do submodelo. Este bloco será invocado durante a execução do método activate desta classe. O bloco recebe por parametro o objeto de model do FormGrid(FWFormGridModel) e um valor lógico indicando se é uma operação de cópia. Espera-se como retorno um array com os dados que serão carregados no objeto, o array deve ter a estrutura abaixo: [n] [n][1] ExpN: Id do registro (RecNo) [n][2] Array com os dados, os dados devem seguir exatamente a mesma ordem da estrutura de dados | {|X,Y| FORMLOADGRID(X,Y)} | X |
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
cIdForm | Caracteres | Identificador do modelo | X |
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
bBloco | Bloco de Código | Code-Block a ser chamado | X |
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
bBloco | Bloco de Código | Code-Block a ser chamado | X | ||
lAcumula | Lógico | Se verdadeiro não substitui o bloco de post anterior, e sim adiciona a validação no final | .F. | ||
lFreeBlock | Lógico | Se verdadeiro, o bloco passado no primeiro parâmetro será executado | .F. |
Parâmetros
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
bBloco | Bloco de Código | Code-Block a ser chamado | X | ||
lAcumula | Lógico | Se verdadeiro não substitui o bloco anterior, e sim adiciona a validação no final | .F. | ||
lFreeBlock | Lógico | Se verdadeiro, o bloco passado no primeiro parâmetro será executado | .F. |
2 Comentários
Usuário desconhecido (everson.almeida)
Boa tarde,
No parametro bLoad do método ADDGRID() consta o seguinte:
n][1] ExpN: Id do registro (RecNo)
Qual seria a finalidade desse parametro na estrutura do array que é devolvido após a montagem do mesmo?
Usuário desconhecido (everson.almeida)
Bom dia,
Descobri que o parametro que mencionei acima realiza o link com o registro do banco e assim quando houver cópia, ele não fará uma cópia e sim atualizará o registro como se fosse uma alteração.
Por favor, documentar esse cenário para que fique claro a finalidade do atributo dentro do array daquele parametro.
Obrigado!