OpenBiblio – +1 Relatório

Vou anotar aqui as minhas observações sobre a criação de um relatório adicional para a nossa instalação do OpenBiblio (http://cedom.net/biblioteca/).

Sentimos a falta do histórico de um exemplar, para saber por onde ele andou, quem o retirou. Estas são as notas sobre o processo de criação de um tal relatório para a nossa biblioteca. O detalhamento destas notas é condicionado ao processo criativo.

Nada se cria, tudo se copia….

Meu modo básico de criar um novo relatório, eu copio um relatório existente (~/reports/defs/*.rpt) com um novo nome. Se possível, escolho um relatório parecido com o que quero criar….

Identificação

Cada relatório deve ter o seu nome, e cada nome somente deve ser usado para um relatório…. assim,

.title HistoricoCirculacao

alterei a primeira linha do meu novo relatório para ter uma palavra chave para o nome do meu relatório. Sim, esta deve ser somente uma palavra chave, que será o nome do relatório, se quiser que ele seja decodificada em sua lingua local, inclua uma linha de decodificação no arquivo ~/locale/pt/reports.php com o formato

$trans["HistoricoCirculacao"]  = "\$text = 'Histórico de Circulação';";

ainda no tema Identificação cabe definir a linha

.category Circulation

para indicar em que bloco de relatórios, este novo item deve entrar.

… encontrei um relatório muito parecido

Encontrei um relatório muito parecido com o que eu precisava em Reports, assim esta saga de escrever relatórios para a nossa biblioteca ficou para uma próxima oportunidade.

… Relatórios.

• Acompanhamento de Catalogação ganhou uma nova versão agora com a possibilidade de demarcar a data de inicio e data de fim do periodo de analise. Status : Instalado em testes.
• Titulos – uma lista de titulos, com a contagem de exemplares. Status: Instalado em testes.
• Leitores – especialmente preparado para crítica do cadastro de leitores com data de atualização, nome e sobrenome, endereço, telefones, grupo, e contagens. Status: A Desenvolver.

Perguntas

• Comentários – como eu incluo comentários em meu relatório? afinal quero deixar claro o que estou fazendo para quem for ler este programa.

Referências

• Reports – uma lista de relatórios prontos que podem ser úteis.
• WritingReports – a documentação sobre o módulo de relatórios do OpenBiblio na sua versão 0.6x.
• RPTSyntax – a Sintaxe dos arquivos de configuração de relatórios. Pode não ser realmente completo, mas dá uma boa idéia do que pode ser feito e como fazê-lo.
• OpenBiblio Customization – encontrei aqui bons recursos adicionais para a nossa instalação do OpenBiblio. Relatórios adicionais com contagem foi bem proveitoso.
• MySQL Outer Join Tips – algumas dicas de outer join do mysql que ajudam na construação de relatorios.
• Sintaxe Join – em último caso, sempre recorrer ao manual do MySQL.