Plugins de catalogação (construtores de valores)
Com os construtores de valores, pode melhorar a sua catalogação com funcionalidades adicionais, como validação, criação de ligações, geração automática de números, etc.
Um construtor de valores é um script Perl que, dentro de uma estrutura MARC, está ligado a um determinado subcampo em registos bibliográficos, registos de autoridade ou exemplares.
Nota
Os plugins de catalogação não devem ser confundidos com plugins do Koha
Configuração
Acesso: Administração > Modelos MARC
Para utilizar um construtor de valores no seu modelo MARC, navegue até Administração > Modelos MARC e, em seguida, escolha para ver a estrutura MARC do modelo desejado.
Pesquise ou navegue até um campo e selecione ‘Editar subcampos’ no menu ‘Ações’ do mesmo. Vá para o separador do subcampo e escolha a opção correspondente na lista suspensa em “plugin”.
Exemplo
Adicionar o navegador de cotas ao editor de exemplares:
No seu modelo MARC, vá para o campo 952 e edite o subcampo o.
Selecione cn_browser.pl na lista ‘Plugin’.
Guarde as suas alterações.

Construtores de valores padrão para MARC21
Estes construtores de valor já estão integrados no modelo MARC padrão no MARC21.
Para aceder a um construtor de valores a partir do editor básico, clique no ícone à direita do campo.
Etiqueta (registo bibliográfico)
O construtor de etiqueta está ligado ao campo MARC 000 em todas as estruturas bibliográficas MARC21 por omissão.

Os valores neste construtor baseiam-se nos valores de etiqueta do MARC21 (bibliográfico).
00-04 - Tamanho do registo: preenchido automaticamente pelo Koha.
05 - Estado do registo: em novos registos, este campo será definido como ‘n - Novo’ por omissão.
06 - Tipo de registo: nos novos registos, este campo será definido como ‘a - Material textual’ por omissão.
07 - Nível bibliográfico: nos novos registos, este campo será definido como ‘m - Monografia’ por omissão. Algumas características do Koha, como pacotes de itens, registos analíticos e CheckPrevCheckout, podem depender de um valor diferente neste campo.
08 - Tipo de controlo: em novos registos, este será definido como ‘# - Nenhum tipo específico’ por omissão.
09 - Esquema de codificação de caracteres: os registos no Koha estão sempre em Unicode.
10-16 - Indicador/subcampos/tamanho: preenchido automaticamente pelo Koha.
17 - Nível de codificação: nos novos registos, este campo será definido como ‘7 - Nível mínimo’ por omissão.
18 - Forma de catalogação descritiva: nos novos registos, este será definido como ‘a - AACR 2’ por omissão.
19 - Nível de registo de recursos de várias partes: em novos registos, este será definido como ‘# - Não especificado ou não aplicável’ por omissão.
20-24 – Mapa de entrada e extensões: preenchido automaticamente pelo Koha.
006 (registo bibliográfico)
O construtor de valores 006 está ligado ao campo MARC 006 em todas as estruturas bibliográficas MARC21 padrão.

Os valores neste construtor baseiam-se nos valores do campo 006 no MARC21.
Tipo de material: este valor irá alterar os campos e as opções abaixo, uma vez que os elementos do campo 006 são definidos pelo tipo de material. Em novos registos, o padrão definido será ‘BKS - Livros’.
00 - Forma do material: o valor padrão e as opções aqui dependerão do tipo de material indicado acima.
Os restantes valores são iguais aos do 008/18-34; ver descrição abaixo.
007 (registo bibliográfico)
O construtor de valores 007 está ligado ao campo MARC 007 em todas as estruturas bibliográficas MARC21 padrão.

Os valores neste construtor baseiam-se nos valores do campo 007 no MARC21.
Tipo de material: este valor irá alterar os campos e as opções abaixo, uma vez que os elementos do campo 007 são definidos pelo tipo de material. Em novos registos, esta opção será definida como ‘Texto’ por defeito.
008 (registo bibliográfico)
O construtor de valores 008 está ligado ao campo MARC 008 em todas as estruturas bibliográficas MARC21 padrão.

Os valores neste construtor baseiam-se nos valores do campo 008 no MARC21 (bibliográfico).
Tipo de material: este valor irá alterar os campos e as opções abaixo, uma vez que os elementos do campo 008 são definidos pelo tipo de material. O valor por defeito depende do valor em etiqueta/06 (bem como do valor em etiqueta/07, em alguns casos).
valor etiqueta/06
valor etiqueta/07
008 Tipo de material
a - Material textual
a - Parte componente de monografia
BKS - Livros
b - Parte componente de periódico
CR - Recursos contínuos
c - Coleção
BKS - Livros
d - Subunidade
BKS - Livros
i - Recurso integrado
CR - Recursos contínuos
m - Monografia
BKS - Livros
s - Periódico
CR - Recursos contínuos
c - Música anotada
MU - Música
d - Manuscrito de música anotada
MU - Música
e - Material cartográfico
MP - Mapas
f - Material cartográfico manuscrito
MP - Mapas
g - Meio de projeção
VM - Materiais visuais
i - Gravação de som não musical
MU - Música
j - Gravação de som musical
MU - Música
k - Gráficos bidimensionais não projetáveis
VM - Materiais visuais
m - Ficheiro de computador
CF - Ficheiros de computador
o - Kit
VM - Materiais visuais
p - Materiais mistos
MX - Materiais mistos
r - Artefacto tridimensional ou objeto de ocorrência natural
VM - Materiais visuais
t - Material linguístico de manuscrito
BKS - Livros
Outros construtores de valores padrão
Para além dos geradores de valores padrão para campos MARC específicos, existem outros plugins de catalogação que estão ligados a campos por omissão no Koha.
Código de barras
Este construtores de valores é o plugin ligado por omissão ao campo de código de barras em todos os modelos bibliográficos MARC padrão (952$p no MARC21 ou 995$f no UNIMARC).
É utilizado pela preferência de sistema autoBarcode. Se a preferência estiver definida para um formato de código de barras, o gerador de valores de código de barras criará um código automaticamente quando o utilizador clicar no campo de código de barras.
Em alternativa, pode utilizar o construtor manual de valores de código de barras opcional em vez deste padrão.
Data de aquisição
Este construtor de valores é o plugin ligado por omissão ao campo de exemplar que guarda a data de aquisição em todos os modelos bibliográficos MARC padrão (952$d no MARC21 ou 995$5 no UNIMARC).
O construtor simplesmente insere a data de hoje quando o utilizador clica no campo.
ISBN
Versão
Esta funcionalidade foi introduzida no Koha na versão 25.11.
O construtor de valores validate_isbn.pl está ligado por omissão ao campo ISBN em todos os modelos bibliográficos MARC padrão (020$a no MARC21 e 010$a no UNIMARC).
Verifica a validade do ISBN introduzido. Quando é introduzido um ISBN inválido, aparece uma mensagem de aviso no browser.
ISSN
Versão
Esta funcionalidade foi introduzida no Koha na versão 26.05.
O construtor de valores validate_issn.pl está ligado por omissão ao campo ISSN em todos os modelos bibliográficos MARC padrão (022$a no MARC21 e 011$a para UNIMARC).
Verifica a validade do ISSN introduzido. Quando é introduzido um ISSN inválido, aparece uma mensagem de aviso no browser.
Construtores de valores opcionais
Para além dos construtores de valores por omissão para campos MARC específicos ou outros campos, existem outros plugins de catalogação que podem ser opcionalmente adicionados aos modelos MARC para auxiliar em diversas tarefas durante a catalogação de registos.
Código de barras manual
Este construtor de valores é uma alternativa opcional ao construtor de valores de código de barras. Realiza a mesma função, mas o código de barras só é gerado quando o utilizador clica nas reticências (…) junto ao campo do código de barras.
Pode ser utilizado em bibliotecas que não pretendem necessariamente que seja gerado automaticamente um código de barras para todos os exemplares.
Para utilizar este construtor de valores em vez do construtor de valores de código de barras normal,
Clique em Ações > Estrutura MARC junto do modelo a editar
Clique em Ações > Editar subcampos junto ao campo de exemplar (952 no MARC21, 995 no UNIMARC)
Clique no separador código de barras (‘p’ no MARC21 ou ‘f’ no UNIMARC)
Em ‘Outras opções’, selecione ‘barcode_manual.pl’ como plugin
Clique em ‘Guardar alterações’
Cota (sequencial, 4 caracteres com prefixo)
Este construtor de valores pode ser utilizado, opcionalmente, para criar cotas alfanuméricas sequenciais internas.
Deve fornecer um prefixo de letras (de qualquer comprimento), seguido de um espaço e de um código alfanumérico. O código alfanumérico tem 4 caracteres e é constituído por uma sequência de letras ou números, à qual se acrescentam 1, 2, 3, etc.
Se a entrada não estiver exatamente neste formato, não será gerado nada.
Eis alguns exemplos de valores que irão desencadear a geração de uma cota:
AAA 0devolve o primeiro número não utilizado do formato AAA 0xxx, começando por AAA 0001BBB 12devolve o primeiro número não utilizado BBB 12xx, a partir de BBB 1201CCC QWdevolve o primeiro número não utilizado CCC QWxx, começando por CCC QW01
Para utilizar este construtor de valores,
Clique em Ações > Estrutura MARC junto do modelo a editar
Clique em Ações > Editar subcampos junto ao campo de exemplar (952 no MARC21, 995 no UNIMARC)
Clique no separador cota (‘o’ no MARC21 ou ‘k’ no UNIMARC)
Em ‘Outras opções’, selecione ‘callnumber-KU.pl’ como plugin
Clique em ‘Guardar alterações’
Para gerar uma cota, introduza o prefixo, um espaço e o início do número sequencial no campo da cota e, em seguida, clique nas reticências (…) junto ao campo. A quota será gerada de acordo com o padrão fornecido.
Cota (dígitos sequenciais com prefixo)
Este construtor de valores pode ser utilizado, opcionalmente, para criar cotas numéricas sequenciais internas, com ou sem prefixo de letra.
Deve fornecer um prefixo de letras (de qualquer comprimento). O plugin irá acrescentar um número incrementado ao prefixo.
Por exemplo, se a cota mais elevada com o prefixo “PREFIX” for “PREFIX 5236”, a próxima cota “PREFIX” a ser gerado será “PREFIX 5237”.
Se deixar o campo vazio, será gerado uma cota simples e incremental.
Para utilizar este construtor de valores,
Clique em Ações > Estrutura MARC junto do modelo a editar
Clique em Ações > Editar subcampos junto ao campo de exemplar (952 no MARC21, 995 no UNIMARC)
Clique no separador cota (‘o’ no MARC21 ou ‘k’ no UNIMARC)
Em ‘Outras opções’, escolha ‘callnumber.pl’ como plugin
Clique em ‘Guardar alterações’
Para gerar uma cota, introduza o prefixo e, em seguida , clique nas reticências (…) junto ao campo. A quota será gerada de acordo com o padrão fornecido.
Navegador de cotas
Este plugin pode ser utilizado opcionalmente para navegar pelas cotas diretamente a partir do editor de exemplares.
Ao clicar nas reticências (…) junto ao campo da cota, será aberta uma janela com um formulário de pesquisa.

Se introduzir uma cota e clicar nas reticências, o formulário de pesquisa será automaticamente preenchido com a cota.
Nos resultados, uma linha verde fina indica onde estaria a cota pesquisada na sequência.

Se a cota existir, os resultados aparecerão a vermelho.

Para utilizar este construtor de valores,
Clique em Ações > Estrutura MARC junto do modelo a editar
Clique em Ações > Editar subcampos junto ao campo de exemplar (952 no MARC21, 995 no UNIMARC)
Clique no separador cota (‘o’ no MARC21 ou ‘k’ no UNIMARC)
Em ‘Outras opções’, selecione ‘cn_browser.pl’ como plugin
Clique em ‘Guardar alterações’
Número de inventário (código da biblioteca)
Este plugin pode ser utilizado opcionalmente para gerar um número de inventário incremental, prefixado pelo código da biblioteca.
Por exemplo, se o código da biblioteca for CPL, os números de inventário serão gerados como CPL_1, CPL_2, CPL_3, etc.
Para utilizar este construtor de valores,
Clique em Ações > Estrutura MARC junto do modelo a editar
Clique em Ações > Editar subcampos junto ao campo de exemplar (952 no MARC21, 995 no UNIMARC)
Clique no separador do número de inventário (‘i’ no MARC21 ou ‘j’ no UNIMARC)
Em ‘Outras opções’, selecione ‘stocknumber.pl’ como plugin
Clique em ‘Guardar alterações’
Ao catalogar um exemplar, clique nas reticências (…) junto ao campo do número de inventário. Se ainda não existirem números de inventário, apenas será gerado o prefixo (por exemplo, CPL_). Se já existirem números de inventário, o sistema utilizará o maior deles e adicionará um incremento.
Número de inventário (10 dígitos com prefixo)
Este plugin pode ser utilizado opcionalmente para gerar um número de inventário de 10 dígitos com incremento e um prefixo personalizado.
Por exemplo, se o último número de inventário for ‘CAT 0000001456’, o próximo número de inventário ‘CAT’ será ‘CAT 0000001457’.
Para utilizar este construtor de valores,
Clique em Ações > Estrutura MARC junto do modelo a editar
Clique em Ações > Editar subcampos junto ao campo de exemplar (952 no MARC21, 995 no UNIMARC)
Clique no separador do número de inventário (‘i’ no MARC21 ou ‘j’ no UNIMARC)
Em ‘Outras opções’, selecione ‘stocknumberam123.pl’ como plugin
Clique em ‘Guardar alterações’
Ao catalogar um exemplar, introduza o prefixo e clique nas reticências (…) junto ao campo do número de inventário. O sistema irá procurar o maior número com o mesmo prefixo e incrementá-lo em uma unidade.
Número de inventário (10 dígitos com prefixo pré-determinado)
Este plugin pode ser utilizado opcionalmente para gerar um número de inventário de 10 dígitos com incremento, utilizando um prefixo personalizado de uma categoria de valores autorizada.
Por exemplo, se o último número de inventário for ‘CAT 0000001456’, o próximo número de inventário ‘CAT’ será ‘CAT 0000001457’.
Para utilizar este construtor de valores,
Clique em Ações > Estrutura MARC junto do modelo a editar
Clique em Ações > Editar subcampos junto ao campo de exemplar (952 no MARC21, 995 no UNIMARC)
Clique no separador do número de inventário (‘i’ no MARC21 ou ‘j’ no UNIMARC)
Em ‘Outras opções’, selecione ‘stocknumberAV.pl’ como plugin
Clique em ‘Guardar alterações’
Para utilizar este construtor de valores, é necessário criar uma categoria de valores autorizados chamada ‘INVENTORY’.
De seguida, adicione valores autorizados da seguinte forma:
Valor autorizado: introduza o prefixo pretendido para os números de inventário (maiúsculas ou minúsculas).
Descrição: introduza o primeiro valor para o seu número. Por exemplo, se o seu prefixo for ‘CAT’ e pretender que o seu primeiro número de inventário seja ‘CAT 0000001457’, introduza ‘1456’ ou ‘0000001456’ na descrição do valor autorizado.
Descrição (OPAC): deixar em branco.
Ao catalogar um exemplar, introduza o prefixo e clique nas reticências (…) junto ao campo do número de inventário. O sistema irá procurar o maior número com o mesmo prefixo e incrementá-lo em uma unidade. Se introduzir um prefixo inválido, não será gerado nenhum número.
Carregamento
Este plugin pode ser utilizado opcionalmente para carregar ficheiros (com a ferramenta de carregamento) directamente do editor de catalogação e ligar automaticamente o ficheiro ao campo. Isto é útil para associar ficheiros aos registos (utilização mais comum com o subcampo $u do campo de ‘localização e acesso electrónico’ - 856 no MARC21 ou UNIMARC).
Para utilizar este construtor de valores,
Clique em Ações > Estrutura MARC junto do modelo a editar
Clique em Ações > Editar subcampos junto ao campo de ligação (856 no MARC21 ou UNIMARC)
Clique no separador ‘u’
Em ‘Outras opções’, escolha ‘upload.pl’ como plugin
Clique em ‘Guardar alterações’
Para anexar ficheiros aos registos durante a catalogação,
Clique no botão ‘Carregar’ junto ao subcampo $u.

Clique no botão para escolher um ficheiro do seu computador.

Clique em ‘Carregar’.
Clique em ‘Escolher’.

O endereço para o ficheiro será automaticamente inserido no subcampo.

