Exemplo Bridge - dax_bridge.AddRecord

Este exemplo mostra como usar o comando dax_bridge.addRecord para adicionar registros a uma seleção. Introduza os dados nos campos de entrada a seguir e logo clique no botão "Salvar registro" para adicionar o registro a seleção existente. O data grid exibido se atualizará ao pressionar o botão para mostrar a seleção atualizada.

Como utilizar dax_bridge.AddRecord

Este comando é utilizado para adicionar um registro a seleção passada. A função tratadora é necessária neste comando porque o 4DAF Bridge não analisa a resposta XML original devolvida pelo backend. A resposta é um simples êxito ou erro e um exemplo do tratador é incluído na seção "JavaScript Functions".

dax_bridge.addRecord(selectionName, fieldArray, valueArray, handler, variable)
         selectionName: O nome da seleção (table, view, dcs)
         fieldArray: Array de campos a adicionar (exemplo: ['firstName', 'lastName']
         valueArray: Array de valores a adicionar (exemplo: ['John', 'Doe']
         handler: Uma função JavaScript executada depois da resposta de 4D (addRecordHandler). opcional
         variable: Um objeto JavaScript, variable, array, etc. que é passado ao tratador. opcional

Configurar a página (HTML)

Formulário de entrada
A funcionalidade de entrada desta página é alcançada utilizado um formulário e campos de entrada. Cada campo de entrada tem uma etiqueta. É importante declarar um identificador para cada campo de entrada. Assim é como os campos são acessados pelo código javascript.

Data grid de dados
O data grid de dados é carregado em um registro exitoso ao 4DAF. É declarado por fora de qualquer função JavaScript específica com a seguinte linha de código:

var myGrid = new Object();

myGrid= new dax_dataGrid('InlineEditing', $('grid'), 0, 0);
myGrid.go();

É carregadp e inicializado pelas seguintes linhas de código:
A rede de dados se atualiza depois que o registro tenha sido adicionado a uma chamada JavaScript:

myGrid.populate();

Para maiores informações sobre o objeto data grid de dados consute a documentação na daxipedia.

Funções JavaScript

addRecordHandler
O tratador é a função JavaScript que é executada quando chega a resposta de 4D.

Begin JavaScript code:
function addRecordHandler(http_response, passedVariable) {
   if (http_response.readyState != 4);
      return;
   if (passedVariable == 'InlineEditing Table') {
      myGrid.populate();
      clearInputs();
   }
   else
      alert('Failed to add the record!');
}
End JavaScript code

dax_loginSuccess
Esta função corre em um registro exitoso ao 4DAF.

Begin JavaScript code:
function dax_loginSuccess(){
   $('inputArea').style.display='block';
   myGrid= new dax_dataGrid('InlineEditing', $('grid'), 0, 0);
   myGrid.go();
}
End JavaScript code

clearInputs
Esta função é chamada pelo tratador e exclui as entradas quando se adiciona um registro.

Begin JavaScript code:
function clearInputs(){
   $('firstName').value='';
   $('lastName').value='';
   $('acceptApt').checked=false;
   $('nextApt').value='';
   $('notes').value='';         
}
End JavaScript code

addMyRecord
Esta função é chamada pelo botão "Salvar registro" e utiliza dax_bridge.addRecord para adicionar o registro a seleção InlineEditing.

Begin JavaScript code:
function addMyRecord(){
   var bool = 'false';
   if ($('acceptApt').checked==true)
      bool = 'true';
   dax_bridge.addRecord('InlineEditing', ['Firstname', 'Lastname', 'Accept Appointment', 'Next Appointment', 'Notes'], [$('firstName').value, $('lastName').value, bool, $('nextApt').value, $('notes').value], addRecordHandler, 'InlineEditing Table');
}
End JavaScript code