Seu primeiro formulário PDF usando o Scribus: Difference between revisions

From Scribus Wiki
Jump to navigation Jump to search
No edit summary
 
mNo edit summary
 
(11 intermediate revisions by one other user not shown)
Line 1: Line 1:
[[Category:PT]]
[[Category:Tutoriais]]
{{Tutorial}}
{{Tutorial}}


Versão em [[Your first PDF form with Scribus|inglês]].
Versão em [[Your first PDF form with Scribus|inglês]].
=Básico=
{| border="0" cellpadding="2" cellspacing="0" align="right" style="color:white;background:#065682;"
<!-- Header -->
|-style="color:white; background: #98712a;margin-bottom:5px;font-weight:bold"
|'''Requerimentos:'''
|&nbsp;&nbsp;


One of the biggest advantages of Scribus is the possibility to create PDF forms with embedded JavaScript scripts. Usually, PDF forms are meant to be filled out by users on their computers and then printed out. Information in a PDF form can also be submitted online to a remote location for further processing.
<!-- Linha 1 -->
|-
|'''Sistema Operacional:'''
|&nbsp;&nbsp;Qualquer &nbsp;
<!-- Linha 2 -->
|-
|'''Versão do Scribus:'''
|&nbsp;&nbsp;1.3.3.X
<!-- Linha 3 -->
|-
|'''Conhecimentos em DTP:'''
|&nbsp;&nbsp;Iniciante
<!-- Linha 4 -->
|-
|'''Navegador:'''
|&nbsp;&nbsp;Um que suporte o plugin do Adobe<br>&nbsp;&nbsp;Reader como o Firefox
|}


There are still some issues with PDF forms creating in Scribus, which have to be addressed to make Scribus a full featured PDF forms tool. E.g., there is an issue with radio buttons behaviour (see the [http://bugs.scribus.net/view.php?id=866 feature request 866]).
=Básico=


Nevertheless, Scribus already '''is''' an useful PDF forms tool for many people, and it's been becoming better in an incredible pace. Enjoy!
Uma das maiores vantagens do Scribus é a possibilidade de criar formulários PDF com um JavaScript incorporado ao documento. Normalmente, os formulários de PDF são feitos para serem preenchidos pelo usuário em seus computadores e então impressos. Informações contidas em formulários PDF podem também serem enviadas através da internet a algum lugar remoto para processamento futuro (um servidor, por exemplo).


=Requerimentos=
Ainda existem questões não resolvidas de formulários PDF no Scribus que devem ser solucionadas para o tornar completo no uso desta ferramenta. Por exemplo, há um problema relacionado ao comportamento dos botões de rádio (de marcação/seleção). Veja o [http://bugs.scribus.net/view.php?id=866 pedido de recurso] 866.


* Scribus -- the newer the better. Refer to the Scribus site [http://www.scribus.org.uk/modules.php?op=modload&name=Downloads&file=index download area] for the latest release.
Ainda sim, o Scribus já '''é''' uma ferramenta útil na criação de formulários PDF para muita gente, e está se tornando cada vez melhor a passos largos. Aproveite!
* [http://www.adobe.com/products/acrobat/readstep2.html Adobe Reader 7] or newer.
* Browser supporting Adobe Reader plug-in, preferrably [http://www.mozilla.org/products/firefox/ Firefox].


=Criando formulários PDF=
=Criando formulários PDF=


Its rather simple to create a new form with Scribus. We start with clicking on the &quot;New Document&quot; icon or choosing '''New''' from the '''File''' menu.
É simples criar um novo formulário com o Scribus. Nós começamos com um clique no ícone '''Novo Documento''' ou usando o menu '''Arquivo > Novo'''.  


[[Image:Pdf form howto new doc.png]]


<!--[[Image:New form.png|left|thumb|400px|New document dialog in Scribus 1.2.2]]-->
''Diálogo de novo documento no Scribus 1.3.3.X''
[[Image:New form.png|New document dialog in Scribus 1.2.2]]


Let us turn on the grid first (menu '''View>Show Grid'''), it will help us to correctly locate our form fields on the page. We need some text frames to make a nice title and field descriptions - a few clicks on the text frame icon (that one right to the arrow)  and all the text frames are there in no time.


Vamos nos voltar para a grade, primeiramente (menu '''Visualizar > Mostrar Grade'''). Ela irá nos ajudar a colocar os campos de formulário corretamente na página. São necessários alguns quadros de textos para criar uma boa descrição de título e campo - alguns cliques no botão de quadro de texto (aquele ao lado da seta) e todos os quadros de textos estarão lá, de forma instantânea.


[[Image:Grid menu.png]]
[[Image:Pdf form howto grid menu.png]]


''Use a grade para auxiliar no alinhamento''


Having filled our frames with text, we can change their properties with the '''Properties''' palette, which can be found in the '''Tools''' menu.


Tendo preenchido os quadros com o texto (como demostrado acima), nós podemos alterar as suas propriedades com a paleta '''Propriedades''' que pode ser encontrada no menu '''Janelas'''


[[Image:Properties.png]]
[[Image:Pdf_form_howto_properties.png]]


''A diálogo de propriedades''


Now we can start adding form elements: some text fields and one button for submitting our form to an URL. To add a field simply click on the arrow on the right side of the '''OK''' icon and select a type from the displayed options: button, text field, check box, combo box, and list box.


Agora adicione alguns campos de texto para o envio do formulário a uma URL. Para adicionar um campo, dê um clique simples na seta do lado direito do ícone '''OK''' e selecione o tipo de opção a ser exibida: Botão, campo de texto, caixa de combinação e caixa de lista.


[[Image:Form elements1.png]]
[[Image:Pdf form howto pdf form elements.png]]


''Janelas de seleção de campos formulário''


The current active element of the form has a red frame border; you can select an element in choosing the '''Select''' icon (the one with an arrow, left to the text frame icon) and clicking on the item to be chosen.


O elemento atualmente ativo do formulário tem a borda exibida na cor vermelha. Você pode selecionar um elemento utilizando a ferramenta de seleção (a seta ao lado do icone de quadro de texto).


[[Image:ulica.png]]
[[Image:ulica.png]]
''Posicionando o campo ao lado do quadro de texto ''




The right click on an element activates a new context menu. We choose  '''Pdf Options > Field Properties''' and define field names (we will need the field names in our PHP script, to which we'll send the form), types (e.g., number, time, date), and actions to be performed on different events (Mouse Enter, Mouse Exit, On Blur, and so on).
O clique com o botão direto do mouse em um elemento, ativa um novo menu de contexto.  
Escolha '''Opções de PDF > Propriedades de Campo''' e defina o nome dos campos (nós precisaremos dos nomes de campo do nosso script PHP cujo o forumlário será enviado), tipos (exemplo, números, data, hora) e ações a serem ocorridas em diferentes ações (Mouse Enter, Mouse Exit, On Blur e assim por diante).




[[Image:Field properties appearance1.png]]
[[Image:Field properties appearance1.png]]


''Propriedades de campo''


Here we are defining the '''No''' field as a number. Acrobat Reader won't accept anything else as a valid entry, then.


Aqui estamos nós definindo o campo '''NÃO''' como um número. O Acrobat Reader não aceitará qualquer coisa que não seja uma entrada válida.


[[Image:Field properties format1.png]]
[[Image:Field properties format1.png]]


''Propriedades de campo''


To change the existing '''tab order''' of your form fields, simply open the '''Properties''' palette, click on the '''X,Y,Z''' tab, and change the level of the selected field.


Para alterar a atual '''ordem das abas''' do seus campos de formulário, simplesmente abra a paleta de '''Propriedades''' e clique sobre a aba '''X,Y,Z'''. Altere o nível do campo selecionado.


[[Image:Field tab order.png]]
[[Image:Field tab order.png]]


''Eleve ou rebaixe o elemento''


Here, we are defining a custom validation script for the '''Name''' field - after changing the field contents there will be a beep sound and an alert will be showed (not very sophisticated, I know, but it still demonstrates the possibilities of PDF). Scribus has its own simple text editor, which enables us to save the script to a separate file. Custom scripts can be defined not only on the form field level, but document wide too ('''Edit > JavaScripts''').


Agora nós estamos definindo um script de validação personalizado para o campo '''Nome''' - depois de alterar o conteúdo dos campos, um som soará e um alerta será mostrado (não muito sofisticado, eu sei, mas ainda sim desmostra as capacidades do PDF). O Scribus possui o seu próprio editor de texto, o que nós habilita a salvar o script em um arquivo separado. Scripts personalizados podem não apenas serem definidos no nível do campo de formulário, mas como do documento como um todo ('''Editar > JavaScripts''').


[[Image:Js validate script.png]]
[[Image:Js validate script.png]]


''Script de validação''


After saving the script and closing the editor, the script contents is shown in the '''Field Properties'''.


Depois de salvar o script e fechar o editor, o conteúdo do script será mostrado na '''Propriedades de Campo'''.


[[Image:Field properties validate.png]]
[[Image:Field properties validate.png]]


''Propriedades de validação de campo''


We have still to define, to which URL the form contents will be sent (there is a simple PHP script at the destination address, which will format and display the received form data). We choose in the button properties as the action type '''Submit''' form and enter the address of our PHP script: '''scribus_test.php'''. We match the '''Submit Data as HTML''' option to end with (the other option would be the FDF data, but this is a very different story) and we are done now.


Temos ainda que definir para qual o URL o conteúdo do formulário será enviado (existe um simples script PHP no destinatário que irá formatar e exibir os dados recebidos dos formulários). Escolha o botão de ação do tipo '''Enviar''' (ou ''Submit'') formulário e entre com o endereço do nosso script PHP: '''scribus_test.php'''. Marque a opção '''Enviar dados como HTML''' para finalizar (a outra opção seria a de dados FDF, mas isso é uma história totalmente diferente).


[[Image:Field action.png]]
[[Image:Field action.png]]


''Definindo a URL''


The only thing else to do is to export the document to PDF: menu '''File > Export... > Export to PDF...'''.
We select Acrobat 5.0 as the file format and save the file.


A única coisa que resta a fazer é exportar o documento como PDF (use o menu '''Arquivo > Exportar > Exportar como PDF'''.
Salve como Acrobat 5.0.


[[Image:Pdf export.png]]
[[Image:Pdf export.png]]


''Diálogo de exportação de documento''


Now it is time to launch Acrobat Reader and and see what you have done. Acrobat Reader 7 finally delivers the capability to display Unicode characters inside form fields -- great news for all non English native speakers. Both '''Name''' and '''Street''' fields contain characters outside of the Latin-1 font set. The '''No''' field contains a '''default value''' of '''15''' that has been put into it eaerlier -- in Scribus, just right click onto the form field, choose '''Edit text...''' from the context menu and type your default value.


Agora é a hora de executar o Acrobat Reader e ver o que nós fizemos. O Acrobat Reader 7 finalmente oferece a capacidade de exibir caracteres Unicodes dentro de campos de formulários - ótima notícia para todos que não falam inglês.
Ambos os campos '''Nome''' e '''Rua''' possuem caracteres fora das fontes tipo Latin-1. O campo '''Não''' possui o '''valor padrão''' de '''15''' que fora posto anteriormente - no Scribus, apenas dê um clique com o botão direito no campo de formulário e selecione '''Editar Texto''' a partir do menu de contexto. Digite o seu valor padrão.


[[Image:Acroread unicode.png]]
[[Image:Acroread unicode.png]]


=Configurando o naveador para visualizar formulários de PDF=
''Definição do valor padrão''
 
If you are a happy owner of a relatively recent edition of [http://www.mozilla.org/products/firefox/ Firefox], Mozilla, or Netscape, you are best suited to view PDF forms with your browser. Since  neither Opera nor Konqueror has been capable of submitting PDF forms, let's focus on Mozilla family.  The only thing to do is to tell Firefox, where the Acrobat Reader plug-in is located. For Linux:
 
  1. Create a symbolic link to '''$your_installation_directory/Acrobat7.0/Browser/intellinux/nppdf.so'''
      to your Mozilla plugins directory, e.g. in Gentoo Linux '''/usr/lib/MozillaFirefox/plugins'''
  2. Ensure a copy of acroread is in your PATH.
 
For using Firefox plug-ins with other operating systems, refer to [http://plugindoc.mozdev.org/ Mozilla Plugindoc site].
 


=Testando e baixando arquivos de exemplos=  
=Testando e baixando arquivos de exemplos=  


* [http://linux.hanski.info/tests/scribus_form_en.pdf Sample PDF form (made with Scribus)] -- Open this form in your browser and click on the '''Submit''' button. If your browser is configured for working with Adobe Reader, you should get a responce from a PHP script.
* [http://linux.hanski.info/tests/scribus_form_en.pdf Modelo de PDF (feito com o Scribus)] - Abra este formulário e clique no botão '''Enviar''' (ou ''Submit'' neste caso). Se o seu navegador está configurado para trabalhar com o Adobe Reader, você deverá receber uma respota do script PHP.  


* [http://linux.hanski.info/tests/scribus_sample_form.tar.gz Download sample files] -- A gzipped tarball of sample files (SLA, PHP, PDF) used in this howto
* [http://linux.hanski.info/tests/scribus_sample_form.tar.gz Baixe os arquivos modelos] - Um gzipped tarball dos arquivos modelos (SLA, PHP, PDF) usados neste tutorial.


=Outras fontes de informação (''em inglês'')=  
=Outras fontes de informação (''em inglês'')=  


* [http://business.newsforge.com/article.pl?sid=05/04/06/1545203&tid=152&tid=39&tid=33&tid=111 Small-business forms using Scribus and PDF] - a NewsForge story about using Scribus to produce interactive forms
* [http://business.newsforge.com/article.pl?sid=05/04/06/1545203&tid=152&tid=39&tid=33&tid=111 Formulários para pequenas empresas utilizando o Scribus e PDF] - um artigo do NewsForge sobre o uso do Scribus na criação de formulários interativos.


* [http://www.planetpdf.com/developer/article.asp?ContentID=6575&mp JavaScript - Introduction to Development with Examples]
* [http://www.planetpdf.com/developer/article.asp?ContentID=6575&mp JavaScript - Introdução a criação com modelos]

Latest revision as of 16:33, 17 November 2006

Este artigo é parte da seção de Tutoriais.
Instalação Uso Questões sobre PDF DTP Outros
Voltar para a página principal

Versão em inglês.

Requerimentos:   
Sistema Operacional:   Qualquer  
Versão do Scribus:   1.3.3.X
Conhecimentos em DTP:   Iniciante
Navegador:   Um que suporte o plugin do Adobe
  Reader como o Firefox

Básico

Uma das maiores vantagens do Scribus é a possibilidade de criar formulários PDF com um JavaScript incorporado ao documento. Normalmente, os formulários de PDF são feitos para serem preenchidos pelo usuário em seus computadores e então impressos. Informações contidas em formulários PDF podem também serem enviadas através da internet a algum lugar remoto para processamento futuro (um servidor, por exemplo).

Ainda existem questões não resolvidas de formulários PDF no Scribus que devem ser solucionadas para o tornar completo no uso desta ferramenta. Por exemplo, há um problema relacionado ao comportamento dos botões de rádio (de marcação/seleção). Veja o pedido de recurso 866.

Ainda sim, o Scribus já é uma ferramenta útil na criação de formulários PDF para muita gente, e está se tornando cada vez melhor a passos largos. Aproveite!

Criando formulários PDF

É simples criar um novo formulário com o Scribus. Nós começamos com um clique no ícone Novo Documento ou usando o menu Arquivo > Novo.

Pdf form howto new doc.png

Diálogo de novo documento no Scribus 1.3.3.X


Vamos nos voltar para a grade, primeiramente (menu Visualizar > Mostrar Grade). Ela irá nos ajudar a colocar os campos de formulário corretamente na página. São necessários alguns quadros de textos para criar uma boa descrição de título e campo - alguns cliques no botão de quadro de texto (aquele ao lado da seta) e todos os quadros de textos estarão lá, de forma instantânea.

Pdf form howto grid menu.png

Use a grade para auxiliar no alinhamento


Tendo preenchido os quadros com o texto (como demostrado acima), nós podemos alterar as suas propriedades com a paleta Propriedades que pode ser encontrada no menu Janelas

Pdf form howto properties.png

A diálogo de propriedades


Agora adicione alguns campos de texto para o envio do formulário a uma URL. Para adicionar um campo, dê um clique simples na seta do lado direito do ícone OK e selecione o tipo de opção a ser exibida: Botão, campo de texto, caixa de combinação e caixa de lista.

Pdf form howto pdf form elements.png

Janelas de seleção de campos formulário


O elemento atualmente ativo do formulário tem a borda exibida na cor vermelha. Você pode selecionar um elemento utilizando a ferramenta de seleção (a seta ao lado do icone de quadro de texto).

Ulica.png

Posicionando o campo ao lado do quadro de texto


O clique com o botão direto do mouse em um elemento, ativa um novo menu de contexto. Escolha Opções de PDF > Propriedades de Campo e defina o nome dos campos (nós precisaremos dos nomes de campo do nosso script PHP cujo o forumlário será enviado), tipos (exemplo, números, data, hora) e ações a serem ocorridas em diferentes ações (Mouse Enter, Mouse Exit, On Blur e assim por diante).


Field properties appearance1.png

Propriedades de campo


Aqui estamos nós definindo o campo NÃO como um número. O Acrobat Reader não aceitará qualquer coisa que não seja uma entrada válida.

Field properties format1.png

Propriedades de campo


Para alterar a atual ordem das abas do seus campos de formulário, simplesmente abra a paleta de Propriedades e clique sobre a aba X,Y,Z. Altere o nível do campo selecionado.

Field tab order.png

Eleve ou rebaixe o elemento


Agora nós estamos definindo um script de validação personalizado para o campo Nome - depois de alterar o conteúdo dos campos, um som soará e um alerta será mostrado (não muito sofisticado, eu sei, mas ainda sim desmostra as capacidades do PDF). O Scribus possui o seu próprio editor de texto, o que nós habilita a salvar o script em um arquivo separado. Scripts personalizados podem não apenas serem definidos no nível do campo de formulário, mas como do documento como um todo (Editar > JavaScripts).

Js validate script.png

Script de validação


Depois de salvar o script e fechar o editor, o conteúdo do script será mostrado na Propriedades de Campo.

Field properties validate.png

Propriedades de validação de campo


Temos ainda que definir para qual o URL o conteúdo do formulário será enviado (existe um simples script PHP no destinatário que irá formatar e exibir os dados recebidos dos formulários). Escolha o botão de ação do tipo Enviar (ou Submit) formulário e entre com o endereço do nosso script PHP: scribus_test.php. Marque a opção Enviar dados como HTML para finalizar (a outra opção seria a de dados FDF, mas isso é uma história totalmente diferente).

Field action.png

Definindo a URL


A única coisa que resta a fazer é exportar o documento como PDF (use o menu Arquivo > Exportar > Exportar como PDF. Salve como Acrobat 5.0.

Pdf export.png

Diálogo de exportação de documento


Agora é a hora de executar o Acrobat Reader e ver o que nós fizemos. O Acrobat Reader 7 finalmente oferece a capacidade de exibir caracteres Unicodes dentro de campos de formulários - ótima notícia para todos que não falam inglês. Ambos os campos Nome e Rua possuem caracteres fora das fontes tipo Latin-1. O campo Não possui o valor padrão de 15 que fora posto anteriormente - no Scribus, apenas dê um clique com o botão direito no campo de formulário e selecione Editar Texto a partir do menu de contexto. Digite o seu valor padrão.

Acroread unicode.png

Definição do valor padrão

Testando e baixando arquivos de exemplos

  • Modelo de PDF (feito com o Scribus) - Abra este formulário e clique no botão Enviar (ou Submit neste caso). Se o seu navegador está configurado para trabalhar com o Adobe Reader, você deverá receber uma respota do script PHP.

Outras fontes de informação (em inglês)