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

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.

                    Um pensamento sobre “Semantic Forms no MediaWiki

                    Deixe um comentário

                    Preencha os seus dados abaixo ou clique em um ícone para log in:

                    Logotipo do WordPress.com

                    Você está comentando utilizando sua conta WordPress.com. Sair / Alterar )

                    Imagem do Twitter

                    Você está comentando utilizando sua conta Twitter. Sair / Alterar )

                    Foto do Facebook

                    Você está comentando utilizando sua conta Facebook. Sair / Alterar )

                    Foto do Google+

                    Você está comentando utilizando sua conta Google+. Sair / Alterar )

                    Conectando a %s