Opções de processamento para um botão

Com o tipo de botão Executar, você pode executar uma solicitação de processo para um serviço da Web. Um serviço da Web processa as operações enviadas para definir informações de entrada e de saída em um formulário.

Adicione uma conexão ao serviço da Web e, em seguida, crie ou vincule campos às mensagens de solicitação e resposta. Os campos vinculados podem gerar dados de entrada para enviar para o serviço ou receber dados do serviço. Vários campos podem ser usados para criar a mensagem de solicitação e a mensagem de resposta pode preencher vários campos. Para processar a operação, é possível usar um botão Executar ou gravar um script. Por exemplo, use um serviço da Web para procurar uma taxa de juros, uma taxa de câmbio de moeda ou uma cotação de ações.

1. Adicione um botão ao design de formulário. Consulte Adicionar objetos a um design de formulário.

2. Na paleta Objeto, clique na guia Campo.

3. Na área Controle do tipo, selecione Executar. Uma operação de serviço de rede ou de consulta de banco de dados será executada de acordo com as configurações na guia Executar.

4. Clique na guia Executar e selecione Nova conexão de dados na lista Conexão.

5. Selecione Arquivo WSDL e clique em Próximo.

6. Na caixa Arquivo WSDL, digite o URL para o documento WSDL ou clique em Procurar para localizar e selecionar o documento no disco rígido do computador. Se o documento WSDL estiver armazenado em um servidor seguro, a caixa de diálogo Autenticação exigida ou a caixa de diálogo Selecionar uma ID digital será exibida.

7. Execute uma das ações a seguir:

   • Na caixa de diálogo Autenticação, digite o nome de usuário e senha corretos e clique em OK.

   • Na caixa de diálogo Selecionar uma ID digital, selecione a ID digital correta a ser usada como um certificado de cliente e clique em OK.

8. Selecione a operação a ser chamada e clique em Próximo.

   A janela à direita exibe detalhes para a operação selecionada. Se a operação selecionada não for codificada em SOAP ou não for doc-literal, essa janela exibirá um aviso e não será possível continuar.

9. (Opcional) Para configurar a autenticação de cliente, execute uma das ações a seguir:

   • Para definir a autenticação HTTP ou HTTPS, selecione Exige autenticação HTTP/HTTPS e selecione, opcionalmente, as credenciais a serem aceitas para verificação.

   • Para definir a autenticação de mensagem SOAP, selecione Exige autenticação de nível de mensagem e, opcionalmente, selecione Aceita nome de usuário e senha.

10. Clique em Concluir.

11. Na lista Executar em, especifique onde o processamento ocorrerá:

    • Para processar a solicitação no computador cliente, selecione Cliente.

    • Para processar a solicitação no servidor, selecione Servidor.

    • Para processar a solicitação no computador cliente e no servidor, selecione Cliente e Servidor.

12. Para atualizar a estrutura do formulário é atualizada e unir os dados retornados depois da conclusão do processamento, selecione Reunir os dados do formulário. É necessário usar a opção Reunir os dados do formulário se os dados de resposta forem preencher dados dinâmicos (como um subformulário repetitivo) vinculados a dados WSDL, o que pode ocorrer um número variável de vezes na resposta. Os dados dinâmicos exigem uma reunião completa para gerar o número correto de subformulários repetitivos. Se os dados da resposta WSDL forem vinculados a um número fixo de campos, os dados da resposta preencherão os campos existentes, para que não seja necessário reunir os dados do formulário.

Também é possível usar scripts para realizar uma manipulação de dados mais complexa em um sistema empresarial. Este exemplo mostra como adicionar certos scripts simples a campos de botão de forma a realizar operações básicas de banco de dados, incluindo mover-se até o primeiro registro, o anterior, o seguinte e o último, adicionar novos registros, atualizar registros existentes e excluir registros.

1. Na paleta Biblioteca de objetos, clique na categoria Padrão e arraste oito objetos de botão até o design de formulário. Quando um objeto de botão é adicionado, o tipo de controle padrão é Regular. Aceite a configuração padrão.

2. Nomeie os botões desta maneira: Primeiro, Anterior, Seguinte, Último, Adicionar_novo, Atualizar, Excluir e Cancelar.

3. Selecione o primeiro botão, nesse caso, o botão denominado Primeiro.

4. No Editor de script, selecione click na lista Mostrar, selecione JavaScript na lista Idioma e selecione Cliente na lista Executar em.

5. No Editor de scripts, adicione o seguinte script JavaScript:

   xfa.sourceSet.DataConnection.first();

6. Repita a etapa 5 para cada um dos botões restantes, usando os seguintes scripts:

   • Anterior: xfa.sourceSet.DataConnection.previous();

   • Seguinte: xfa.sourceSet.DataConnection.next();

   • Último: xfa.sourceSet.DataConnection.last();

   • Adicionar_novo: xfa.sourceSet.DataConnection.addNew();

   • Atualizar: xfa.sourceSet.DataConnection.update();

   • Excluir: xfa.sourceSet.DataConnection.delete();

   • Cancelar: xfa.sourceSet.DataConnection.cancel();

7. Salve o design de formulário.

8. Teste o formulário na guia Visualizar PDF. Se o formulário estivesse sendo preenchido no Adobe Reader, você precisaria definir os direitos de uso para o formulário usando o Reader Extensions para que o Adobe Reader pudesse acessar o banco de dados.

9. Clique nos diferentes botões para exibir os dados associados a cada registro. O exemplo mostra que o botão último faz com que o ID, o número de peça, a descrição e o preço unitário do último registro apareçam nos campos aplicáveis.

   Visualizar gráfico inteiro

É possível usar um banco de dados para fornecer os dados para os campos em um formulário, incluindo campos de texto e campos numéricos.

Neste exemplo, o botão Recuperar registro e a caixa de listagem estão vinculados ao banco de dados (nomeado Conexãodados) especificado na paleta Exibição de dados, à esquerda. O botão também possui um script FormCalc anexado para recuperar as informações com base no número de peça selecionado no campo Caixa de listagem. Os registros recuperados são exibidos nos campos ID, Nº._PEÇA, PREÇOUNITÁRIO e DESCRIÇÃO.

Visualizar gráfico inteiro

1. Conecte-se ao banco de dados.

2. Na paleta Exibição de dados, arraste os elementos ID, Nº._PEÇA, PREÇOUNITÁRIO e DESCRIÇÃO em Conexãodados até o design de formulário. Cada nó arrastado até o design de formulário cria um campo vinculado.

3. Na paleta Objeto, clique na guia Padrão e arraste um objeto de botão até o design de formulário.

4. Digite um novo nome para o botão. O exemplo usa RECUPERAR REGISTRO.

5. Selecione o botão e no Editor de script, selecione click na lista Mostrar, selecione FormCalc na lista Idioma e selecione Cliente na lista Executar em.

6. Digite um script FormCalc semelhante ao exemplo a seguir. O script recupera os dados nos registros especificados e os imprime nos campos correspondentes quando o usuário clica o botão.

   //Change the commandType from TABLE to TEXT. TEXT 
   //is the equivalent of SQL Property 
   $sourceSet.DataConnection.#command.query.commandType = "text" 
    
   //Set the Select Node. Select in this case will be  
   //whatever SQL Property you want 
   $sourceSet.DataConnection.#command.query.select.nodes.item(0).value = Concat("Select*from OfficeSupplies Where ID = ", DataListBox1.rawValue,"") 
    
   //Reopen the Data connection 
   $sourceSet.DataConnection.open()

7. Salve o design de formulário como um arquivo PDF.

8. Teste o formulário usando a guia Visualizar PDF para verificar se o script funciona conforme esperado.