Formulário de entrada

O formulário de entrada é utilizado no processo de submissão para descrever o(s) objeto(s) digital(is) a ser(em) depositado(s). Nesse caso, é apresentado no DSpace como páginas com campos para preenchimento ou com opções para seleção. Essa facilidade é ajustável, por meio de edição de um arquivo no padrão xml, adequando-se aos tipos de documentos contemplados na política de conteúdo. Assim, a sua configuração alinha-se a essa política, relacionando o tipo de documento com os campos necessários para sua descrição.

O formulário de entrada é composto por campos. cabe ao administrador decidir quais campos de metadados são necessários e que formatos eles terão. Dessa forma, o formulário de entrada pode ser extenso ou curto, dependendo do tipo de objeto digital a ser descrito. Por não ser configurável de forma interativa nas páginas do DSpace, necessita de apoio da equipe de informática para isso.

O endereço dp arquivo que permite a edição dos formulários é o [dspace-base]/input-forms.xml. Se desejar criar formulários diferentes para cada idioma do sistema, poderá ser adicionado no nome do arquivo o identificador do idioma, por exemplo:

• input-forms_pt_BR.xml para português brasileiro ou,

• input-forms_es.xml para espanhol.

Pode haver mais de um tipo de formulário de entrada. Neste caso a mudança entre os dois tipos de formulário não ocorre em relação ao idioma, mas dependerá da coleção em que se realizará a submissão, e assim não se pode querer utilizar mais que um tipo de formulário de entrada em uma mesma coleção. Entretanto, na maioria dos casos um formulário bem estruturado cobre a maioria dos tipos de documentos, pois alguns campos são comuns a todos eles, como título ou autor, por exemplo. Caso seja necessária a criação de mais de um formulário de entrada,

Os campos de um formulário de entrada possuem relação direta com o esquema de metadado escolhido. Por padrão, o esquema de metadados do DSpace é o Dublin Core. Na maioria dos casos o Dublin Core, com seus elementos e qualificadores, é suficiente para a descrição dos objetos digitais. Porém, se for necessária a utilização de outro esquema, deve-se primeiro criar todo o esquema dinamicamente na opção de “Gerenciar metadados” vista no capítulo anterior.

Nem todos os elementos e qualificadores estão contemplados no formulário de entrada padrão. Se preferir apenas ajustar o formulário padrão às necessidades de descrição dos documentos, é recomendável que se conheça o esquema de metadados Dublin core para melhor ajustar o formulário às necessidades de descrição. Nesse caso, basta ajustar o formulário de entrada, criando ou retirando campos.

Por outro lado, se necessitar criar um novo elemento ou qualificador para conter uma determinada informação utilizando a prerrogativa do Dublin core de ser um esquema de metadados mais flexível, primeiro crie o elemento ou qualificador na opção “Gerenciar metadados” visto no capítulo anterior, e depois ajuste o formulário. Esse procedimento evitará erros no momento de utilização do formulário de entrada.

Os campos podem ter vários formatos para adequar-se ao tipo de descrição. De campos de texto curto para título ou autor, a campos extensos para descrição ou resumo. Há também campos destinados a datas, com estrutura própria para esse tipo de dado. Há os campos com listas de dados para seleção ou campos que permitem vocabulário controlado. Deve-se, no entanto, escolher o melhor tipo de campo para a descrição necessária.

Os campos também podem ser únicos ou repetíveis. Por exemplo, o campo para o título deve ser único, pois é incomum um documento com mais de um título, podendo, no entanto, ter títulos alternativos utilizando outro campo. Entretanto, o campo autor precisa ser repetível, pois é comum um documento ter mais de um autor. Da mesma forma, um campo pode ser obrigatório ou opcional, dependendo das necessidades de descrição. Assim, ao definir o formato do campo, define-se também essas outras características.

Este manual não tem como objetivo explicitar a configuração do arquivo do formulário de entrada, mas orientar o administrador sobre as possibilidades oferecidas. Entretanto, essas informações podem ser úteis aos integrantes da equipe de informática, pois, apesar de não orientar quanto à forma de fazê-lo, apresenta as possibilidades, contemplando aqueles conhecimentos que devem ser compartilhados entre o administrador e a equipe de informática.

Exemplo de formulário

Formulário de entrada

Estrutura do formulário

O arquivo de formulário é organizado por meio da seguinte estrutura:

Cabeçalho: contém informações sobre o padrão do arquivo (xml) e associação de formulários à coleções específicas (ver secção 5).

Formulários: É possível configurar mais de um tipo de formulário, e a diferenciação entre os diversos tipos é realizada pela tag <form name="traditional">, onde “traditional” deve ser substituído pelo nome desejado para o novo formulário.

Páginas: cada página representa uma nova etapa de descrição. Campos: são, de fato, a porta de entrada da informação, e se conectada a um, ou conjuntos de metadados;

Valores padrão de preenchimento: são os valores que aparecerão nas listas, radio buttons, caixas de seleção, etc.

Estrutura dos campos

Os campos são declarados como tags na estrutura do arquivo de formulários. Exemplo de entrada para :

       	<field>
       	<dc-schema>dc</dc-schema>
       	<dc-element>type</dc-element>
        	<dc-qualifier></dc-qualifier>
        	<repeatable>false</repeatable>
        	<label>Tipo de documento</label>
        	<input-type value-pairs-name="common_types">dropdown</input-type>
        	<hint>Selecione o tipo de documento.</hint>
        	<required>Este é um campo obrigatório</required> 
       	</field>

Tipos dos campos

Os tipos de campos devem ser definidos nas chaves <input-type>Tipo de campo</input-type>. Os tipos de campos são:

onebox – Um campo único para entrada de texto simples.

twobox – Um par de campos de texto simples.

textarea – Um campo de texto com várias linhas, para usar nas descrições que requerem várias linhas como, por exemplo: resumo.

name – Para identificação de pessoas, será salvo no formato ‘Sobrenome’, ‘Nome’

date – Data. Necessita ao menos que o ano seja preenchido.

series – para valores de fascículos/número. São salvos em valores separados por ponto e vírgula.

dropdown – Escolha do valhor em uma lista “drop-down”. Esta lista deve estar definida em form-value-pairs e o nome deve remeter a essa lista.

qualdrop_value – Usado para listar qualificadores para o campo. É necessário que estes valores estejam em uma lista definida em form-value-pairs.

list – Campo de escolha de valores por checkbox ou radio button list. Se for repetitivo, uma lista de checkboxes é exibida. Se não for, uma lista de radio buttons será exibida. É necessário que estes valores estejam em uma lista definida em form-value-pairs.

Campos controlados

A seleção de valores pré-estabelecidos para um determinado campo pode ser efetuada de diversas formas. A saber: definição de valores padrão de preenchimento (como listas e caixas de seleção), criação de um vocabulário controlado, ou mesmo utilização de um controle de autoridade. As duas primeiras opções serão objetos deste documento, enquanto que a terceira será abordada outro texto, pois sua configuração exige o uso de outros elementos, externos à edição de formulários.

Valores padrão de preenchimento

Ao definir o tipo do campo, caso se escolha os padrões dropdown, qualdrop_value ou list, é necessário se fazer referencia à lista de valores do qual se fará escolha na hora da submissão. Essa lista é declarada no final do arquivo imput_forms.xml, e será incluída dentro de <form-value-pairs> ... </form-value-pairs>. Um exemplo deste tipo de técnica é utilizada, por exemplo, no campo tipo de documento (dc.type):

       	<field>
     		<dc-schema>dc</dc-schema>
        		<dc-element>type</dc-element>
        		<dc-qualifier></dc-qualifier>
                 	<repeatable>false</repeatable>
        		<label>Tipo de documento</label>
        		<input-type value-pairs-name="common_types">dropdown</input-type>
        		<hint>Selecione o tipo de documento.</hint>
        		<required></required> 
       	</field>

....

  <value-pairs value-pairs-name="common_types" dc-term="type">
   	 <pair>
     		 <displayed-value>Artigo</displayed-value>
      		<stored-value>artigo</stored-value>
    	</pair>
   	 <pair>
      		<displayed-value>Tese</displayed-value>
      		<stored-value>tese</stored-value>
    	</pair>
             <pair>
     		<displayed-value>Dissertação</displayed-value>
     		 <stored-value>dissertação</stored-value>
    	</pair>
  </value-pairs>

Os valores que aparecem na tag <displayed-value> são aqueles que serão exibidos como opções de seleção na tela, enquanto que os <stored-value> serão os efetivamente armazenados no metadado dc.type

Vocabulários controlados

Os vocabulários controlados no DSpace são conjuntos de termos organizados em uma estrutura relacional (Kobayashi, 2008) que fornecem, de forma padronizada, os termos para utilização na submissão e indiretamente auxiliam nas buscas. Assim, servem para facilitar o preenchimento de determinados campos e na recuperação de documentos.

A utilização de vocabulários controlados foi disponibilizado no DSpace a partir da versão 1.4.x. Entretanto, até a versão 1.6.0 os vocabulários controlados estão disponíveis, de forma padrão, apenas para a interface JSPUI, que mantém a compatibilidade com as versões mais antigas pois possui a mesma tecnologia de construção.

Para o DSpace, o vocabulário controlado pode ser utilizado em vários campos, ou seja, pode-se ter mais que um campo com vocabulário controlado. Sua utilização dá-se por meio de janelas pop up (páginas que abrem ao clicar uma opção hipertextual). As janelas do vocabulário controlado apresentam os termos organizados hierarquicamente em formato de árvores cujos termos, ao serem clicados, são transferidos para os campos relacionados.

A implementação dos vocabulários controlados geralmente é feita em duas etapas: a criação do arquivo do vocabulário controlado e sua adição ao formulário de entrada. Essas etapas não são sequenciais, mas devem ser efetuadas para a plena utilização dessa facilidade.

O arquivo do vocabulário controlado possui um formato XML, que possui uma estrutura própria para organização hierárquica. Deve-se criar um arquivo para cada campo de metadado a usar o vocabulário controlado. Assegure-se da boa formação da estrutura XML para evitar erros.

O nome do arquivo de vocabulário controlado deve ser indicado na definição do campo onde ele será utilizado, no formulário de entrada. Deve-se notar que, mesmo que coloque o nome do arquivo no formulário de entrada, na interface XMUI não haverá a chamada para esse vocabulário, somente na interface JSPUI.

Configurando vocabulários controlados

Um bom exemplo são as Áreas de Conhecimento do CNPq. Há a necessidade de classificação entre áreas e subáreas, e isso gera a necessidade de uma ordem taxonômica. Para ativar o controle via um vocabulário em um campo, é necessário que se explicite o nome do vocabulário que o controlará na tag <vocabulary>:

        <field>
        <dc-schema>dc</dc-schema>
             ….  
        <vocabulary>cnpq</vocabulary>
        </field>

Ela fará busca pelo arquivo de vocabulário cnpq.xml, que deverá estar dentro da pasta [dspace-base]/config/controlled-vocabularies/. Este arquivo será organizado de forma a criar uma taxonomia entre os termos que lá se encontram. Segue exemplo:

        <node id="cnpq" label="CNPq">
                 <isComposedBy>
                          <node id="1" label="Ciências Exatas e da Terra">
                                   <isComposedBy>
                                   <node id="101" label="Matemática">
                                   </node>
                                   <node id="102" label="Probabilidade e Estatística">
                                   </node>
                                   …
                          </node>
                 </isComposedBy>
        </node>		
        <node id="2" label="Ciências Biológicas">
        <isComposedBy>
        …
        </isComposedBy>
        </node>
        ….
        </isComposedBy>
        </node>
        

Ativando vocabulários controlados

Com a conclusão e codificação do seu vocabulário controlado (cnpq.xml foi usado como exemplo) e te-lo transferido para a pasta informada acima, seu vocabulário não estará liberado ainda. Faz-se necessário a configuração do arquivo dspace.cfg presente na pasta [dspace-base]/config. Ao abrir o arquivo, localize o código abaixo:

        #### Controlled Vocabulary Settings #####
        
        # Enable or disable the controlled vocabulary add-on
        # Warning: this feature is not compatible with WAI (it requires javascript to function)
        #
        #webui.controlledvocabulary.enable = true

É necessário somente, deletar a # (chave) presente na última linha:

        webui.controlledvocabulary.enable = true

Com isso seu vocabulário estará liberado para utilização.

Exemplo de vocabulário (áreas do conhecimento do CNPq)

NOTA: Documento técnico pra realização da configuração de formulários dinâmicos para instalações 3.x, ou superiores.