Lua Form e NodeDatabase

O Lua Form foi desenvolvido de forma a se conectar facilmente ao NodeDatabase para criar interfaces que salvam dados.

Para integrar um lua form ao Node Database é preciso duas coisas:

Preencher o atributo "field" das tags que suportam NodeDatabase
Definir um escopo de dados do Lua Form, isto é, informar em qual nodo de qual NodeDatabase o LuaForm salvará os dados.

Observação importante: O SDK3 faz isto automaticamente para você se for um modelo de ficha, se estiver usando a tag recordList ou se for uma janela acoplável.

Tags que suportam NodeDatabase

As tags/controles que se conectam ao NodeDatabase são:

Escopo de dados

Toda tag/controle que suporta NodeDatabase precisa de um escopo de dados, isto é, um objeto nodo de um nodedatabase onde os dados serão salvos.

As tags form, popup e dataScopeBox possuem o método "controle:setNodeObject" que permitem definir o escopo de dados e, após definido um objeto nodo como escopo, todas as tags que estão dentro passarão a salvar/carregar dados neste obeto nodo.

Exemplo:

Suponha a seguinte interface:

Se o seguinte trecho de código Lua executar:

minhaTagForm:setNodeObject(NODO_A)

o edit passará a ler e salvar dados em NODO_A.campoNome...

Agora, se o seguinte trecho de código Lua executar:

minhaTagForm:setNodeObject(OUTRO_NODO)

o edit agora passará a ler e salvar dados em OUTRO_NODO.campoNome...

E, por fim, se o seguinte trecho de código Lua executar:

minhaTagForm:setNodeObject(nil)

o edit agora ficará desabilitado, pois utilizamos o atributo "field" mas não há nodo escopo de dados associado.

Importante: O SDK3 define o escopo de dados automaticamente para os modelos de fichas, ao usar a tag recordList e para as janelas acopláveis:

Quando o usuário abre uma ficha no RRPG, o SDK3 carrega o NodeDatabase do personagem e define seu objeto nodo raiz como escopo de dados do form.
No caso da tag recordList, o SDK3 automaticamente define o escopo de dados de cada painel de item.
Quando o usuário ativa um janela acoplável, o SDK 3 carrega o NodeDatabase do form (se ele tiver a propriedade dataType preenchida) e define o objeto nodo raiz como escopo de dados do form.

Preenchendo o atributo "field"

Nas tags que suportam NodeDatabase, o atributo "field" contém o nome do campo de um objeto nodo a qual o controle deve se conectar.

Exemplo:

<?xml version="1.0" encoding="UTF-8"?>
<form name="frmFichaTeste">

No exemplo acima, quando a interface estiver rodando, o primeiro edit irá se ligará ao campo "nomeESobrenome" do objeto nodo, isto é:

Exibirá na interface o conteúdo do campo "nomeESobrenome" do objeto nodo escopo.
Quando alguém alterar o valor do campo "nomeESobrenome" do objeto nodo escopo, o edit captará a mudança e automaticamente mostrará o novo valor na interface.

Desde que estejam acessando o mesmo nodedatabase, este comportamento acontece mesmo se a pessoa que alterar o valor estiver em outro computador.

Se o usuário alterar o texto do edit, o novo valor será salvo no campo "nomeESobrenome" do objeto nodo escopo.

Idem para as demais tags que tem o atributo "field" definido.

Acessando/salvando dados que estão em um nodo filho.

É possível utilizar o caractere "." para informar que o campo na verdade está em um nodo filho do nodo escopo.

Exemplo:

<?xml version="1.0" encoding="UTF-8"?>
<form name="frmFichaTeste">

No exemplo acima, o primeiro edit se ligará ao campo "forca" do nodo de nome "modificadores" que está dentro do nodo de nome "atributos" que, por sua vez, está dentro do nodo escopo.

Se o usuário alterar o conteúdo do edit e o não existir um nodo de nome "atributos" no nodo escopo, o SDK3 automaticamente criará este nodo antes de salvar os dados. Idem para o nodo "modificadores" dentro do nodo "atributos".

Variável sheet

Os códigos que estão dentro de um Lua Form tem acesso à uma variável chamada "sheet" que representa o objeto nodo escopo do form.

Exemplo:

<?xml version="1.0" encoding="UTF-8"?>
<form name="frmFichaTeste">

</form>

No exemplo acima, ao clicar no botão, a propriedade "campoDeForca" será alterado para "8" e a mudança será refletida no edit já que está ligado ao mesmo campo que sofreu alteração.

Veja também:

Exemplos

Exemplo 1 - Pequeno cadastro que informa se a pessoa é maior de idade

<?xml version="1.0" encoding="UTF-8"?>
<form name="frmFichaTeste">

<dataLink field="idade">
<event name="onChange">
local idade = tonumber(sheet.idade);

if idade ~= nil then
if idade >= 18 then
self.labMaiorDeIdade.text = "Maior de idade";
else
self.labMaiorDeIdade.text = "Menor de idade";
end;
else
self.labMaiorDeIdade.text = "Preencha a idade";
end;
</event>
</dataLink>
</form>

Neste exemplo foram usados:

Veja também:

Orientações ao usar código LUA em um Lua Form

Created with the Personal Edition of HelpNDoc: Don't Let Unauthorized Users View Your PDFs: Learn How to Set Passwords