Semantic Forms no MediaWiki

Introdução

Semantic Forms é uma extensão do MediaWiki que permite a criação de formulários em sistemas wiki, facilitando a criação e padronização de páginas.

Muitas vezes nos deparamos com situações que poderiam ser resolvidas com um sistema wiki, mas infelizmente nos esbarramos de frente com a experiência do usuário, que encontra dificuldades imensas em formatar e manter organizado as páginas dentro de um sistema de edição colaborativa, foi este o motivo que me levou a procurar por extensões que pudesse me ajudar a manter o usuário distante do campo de edição da wiki, e eis que me apareceu o Semantic Forms.

 

 

Pré Requisitos

• Servidor LAMP
• MediaWiki
• Semantic Media Wiki

Se você não tem o MediaWiki instalado, eu sugiro que você siga os passos demonstrado pelo meu grande amigo Raul, não deixe de instalar o Semantic MediaWiki.

 

 

Instalação do Semantic Forms

É importante inicializar os dados do Semantic Media Wiki, antes de proseguir com a instalação do Semantic Forms, para fazer isso, acesse as “Páginas especiais” da sua wiki (http://seu_servidor/wiki/Especial:Páginas_especiais), em seguida clique em “Funções administrativas do Semantic MediaWiki” e clique no botão “Inicializar ou atualizar tabelas”. Após a inicialização dos dados do Semantic Media Wiki, descompacte a pasta da extensão Semantic Forms na pasta de extensões do seu MediaWiki, no meu caso:

  tar xvzf semantic_forms_2.0.9.tar.gz -C /srv/www/vhosts/w/extensions/

Agora precisamos editar o arquivo arquivo de configuração para que a wiki faça uso da extensão, edite o arquivo LocalSettings.php e inclua a seguinte linha:

  include_once("$IP/extensions/SemanticForms/SemanticForms.php");

Para ter certeza de que a extensão foi instalada acesse a página da versão através do endereço:

http://seu_servidor/wiki/Especial:Versão

Na seção Extensões instaladas deverá aparecer o Semantic forms.

 

 

Planejando o formulário

Antes de iniciar o nosso trabalho com os formulários, devemos pensar nos campos que queremos que o formulário tenha, aqui nós faremos um formulário para fazer o cadastro de máquinas com o objetivo de manter um histórico de manutenção, sendo assim utilizaremos os seguintes campos:

• Número de patrimônio
• Marca
• Departamento
• Histórico

 

 

Criando as propriedades

Vá até as Páginas especiais através do link no menu de ferramentas na parte esquerda (http://seu_servidor/wiki/Especial:Páginas_especiais), na seção “Formulários Semânticos” e clique em “Criar uma propriedade”.

As propriedades serão os campos do nosso formulário, é uma boa idéia evitar acentuação nas propriedades, você poderá colocar um nome amigável quando estivermos criando o formulário.

 

 

Máquinas

A nossa primeira propriedade será a propriedade que dará o nome às páginas que serão geradas pelo formulário, coloque no campo “Nome da propriedade” o valor “maquinas” e tipo será “Page”. Aperte no botão “Salvar página”.

 

 

Número de patrimônio

A próxima propriedade será o número de patrimônio, no campo “Nome da propriedade” coloque o valor “patrimonio” e o tipo deste campo será “number”.

 

 

Marca

Na próxima propriedade coloque o nome de “marca” e o tipo como “string”, para limitar as opções de marca, e de certa forma mantermos uma padronização, coloque no campo que está logo acima do botão salvar, os seguintes valores separados por vírgula:

  Marca1, Marca2, Marca3

 

 

Departamento

Nesta propriedade poderemos fazer o mesmo que foi feito com o campo “marca” coloque o nome da propriedade como sendo “departamento”, tipo “string” e limite os valores a:

  Departamento pessoal, Recursos Humanos, Contabilidade, Informática, Gerência

 

 

Histórico

Na propriedade histórico colocaremos o nome “historico” e o tipo será “Text”, aperte em “Salvar e terminamos por aqui a criação das propriedades.

 

 

Criando uma predefinição

Após criar as propriedades será necessário criar uma predefinição, as predefinições funcionarão como uma forma de agrupar as propriedades criadas. Você poderá acessar a função de criar predefinições nas páginas especiais, o nome da nossa predefinição será “predfMaquinas” e no campo “Categoria definida por predefinição” colocaremos o valor “Inventário” para facilitar a pesquisa futuramente.

Na seção “Campos da predefinição” inclua os seguintes valores:

 

 

Número de patrimônio

Nome do campo: patrimonio

Exibir rótulo: Número de patrimônio

Propriedade semântica: Patrimonio

Aperte em adicionar campo

 

 

Marca

Nome do campo: marca

Exibir rótulo: Marca

Propriedade semântica: Marca

Aperte em adicionar campo

 

 

Departamento

Nome do campo: departamentos

Exibir rótulo: Departamento

Propriedade semântica: Departamentos

Aperte em adicionar campo

 

 

Histórico

Nome do campo: historico

Exibir rótulo: Histórico

Propriedade semântica: Historico

Aperte em Salvar página

 

 

Criando o formulário

Acesse nas páginas especiais a função “Criar um formulário”, no campo “Nome do formulário” insira o seguinte valor: “cadEquipamento” e adicione a predefinição “predfMaquinas”.

Automáticamente será definido um tipo de entrada correspondente ao tipo de dados que escolhemos durante a criação das propriedades, fique a vontade para alterar o tipo do campo, mas no nosso exemplo, será necessário apenas indicar quais serão os campos obrigatórios e para isso basta marcar a opção “Obrigatório” nos itens que achar necessário, marquemos então os campos “patrimonio” e “marca” como sendo obrigatórios e após isso clique em “Salvar página”.

Pronto ! O nosso formulário está pronto para ser utilizado, automaticamente você foi redirecionado à página de nosso formulário e o endereço é semelhante a este:

  http://seu_servidor/wiki/Form:CadEquipamento

Utilizando o formulário

Para utilizar o formulário é simples, basta inserir o nome do equipamento e o formulário auxiliará a criar uma página com o nome escolhido, faça um teste. Na página do formulário coloque o nome “Máquina01” no campo em branco e clique em “Criar ou editar”, você será direcionado ao formulário que além das propriedades escolhidas, ainda apresenta uma caixa para a inserção de texto livre, insira alguns valores para teste e clique em “Salvar página”.

Você poderá incluir formulário em qualquer página, basta copiar o código da página do formulário e colar em outra página, ou simplesmente mover a página do formulário para outra página a fim de ter um nome mais amigável.

 

 

Fazendo uso das propriedades

Faça alguns cadastros utilizando o formulário que criamos e crie duas máquinas que possuam o Departamento em comum, após isso abra a página de uma delas e clique no link “Navegar pelas propriedades”, que fica na seção de ferramentas (parte esquerda da wiki), aparecerá uma página com as propriedades dos equipamentos, e aí será possível fazer pequenas pesquisas que facilitam muito o trabalho. Clique na lupa que aparece ao lado do Departamento e veja o resultado …. lol

Aparecerá uma lista dos equipamentos que possuam aquele departamento em comum.

 

 

Conclusão

Neste artigo eu descrevi a maneira mais simples de criar um formulário usando o MediaWiki, com um pouco mais de pesquisa e estudo você conseguirá criar formulários melhor elaborado e com mais recursos, é possível desenvolver pequenos sistemas utilizando a wiki, seja criativo e siga em frente, a página do Semantic Forms é um excelente lugar para começar.