Administração

Parâmetros de base

Acesso: Mais > Administração

Importante

Configure estes “parâmetros” por ordem de visualização.

Bibliotecas

Quando estiver a configurar o seu sistema, adicione a informação para cada biblioteca que vai partilhar o sistema. Os dados serão usados em várias áreas do Koha.

  • Acesso: Mais > Administração > Parâmetros de base > Bibliotecas

Nota

Apenas os utilizadores com a permissão manage_libraries (ou superbibliotecários) terão acesso a esta secção.

Quando estiver a visualizar esta página, verá a lista das bibliotecas já adicionadas ao sistema.

Tabela de bibliotecas existentes

Nota

Pode personalizar as colunas desta tabela na secção Configurações da tabela do módulo de Administração (identificador da tabela: libraries).

Clicar no nome da biblioteca apresenta uma visualização detalhada das informações da biblioteca.

Página de detalhes da biblioteca

Adicionar uma biblioteca

Para adicionar uma nova biblioteca:

  • Clicar em “Nova biblioteca”

  • Preencher o formulário

    Formulário de nova biblioteca

    • Código de biblioteca (obrigatório): o código não deve conter espaços ou hífens e deve ter 10 ou menos caracteres. Este código será usado como identificador único na base de dados.

    • Nome (obrigatório): o nome será mostrado no OPAC e na interface dos técnicos sempre que a biblioteca é mostrada, e deve ser um nome que faça sentido para os leitores e para os técnicos.

    • Endereço, cidade, estado, código postal, país, telefone, fax: os campos de endereço e contato podem ser usados para personalizar os avisos e talões para cada biblioteca; podem também serão exibidos na página “Bibliotecas” do OPAC, caso a biblioteca esteja configurada como “Pública”

    • Email: O endereço de email não é necessário, mas deve ser preenchido para cada biblioteca no seu sistema

      Nota

      Tenha a certeza que inseriu um email para a biblioteca para que os avisos sejam enviados do endereço correcto

      Nota

      Se nenhum endereço de email for inserido aqui, o endereço definido na preferência de sistema KohaAdminEmailAddress será utilizado para o envio de avisos desta biblioteca

    • Email da equipa de empréstimo interbibliotecas: se esta biblioteca utilizar um endereço de email específico para a gestão de empréstimos interbibliotecas, insira-o aqui

      Nota

      Se não for aqui introduzido nenhum endereço de correio eletrónico, o endereço definido na preferência de sistema ILLDefaultStaffEmail será utilizado para receber pedidos de empréstimo interbibliotecas para esta biblioteca

    • Email de resposta: pode introduzir um endereço de email diferente para resposta (“Reply-To”). Este é o endereço de email para o qual serão enviadas todas as respostas.

      Nota

      Se não for aqui introduzido nenhum endereço de correio electrónico, será utilizado o endereço definido na preferência de sistema ReplytoDefault para receber as respostas referentes a esta biblioteca

    • Email de retorno: pode introduzir um endereço de email diferente para o “Return-Path”. Este é o endereço de email para o qual serão enviadas todas as mensagens devolvidas.

      Nota

      Se não for aqui introduzido nenhum endereço de correio electrónico, o endereço definido na preferência de sistema ReturnpathDefault será utilizado para receber as mensagens devolvidas desta biblioteca.

    • Servidor SMTP: se esta biblioteca utilizar um servidor SMTP diferente do predefinido, especifique-o aqui.

    • URL: se este campo estiver preenchido, o nome da biblioteca aparecerá como um endereço na tabela de exemplares no OPAC

      O nome da biblioteca na tabela de exemplares é um endereço

    • Informação OPAC: isto leva à ferramenta de personalização HTML, permitindo adicionar informação adicional sobre a biblioteca. Esta informação aparecerá na página “Bibliotecas” do OPAC, bem como na tabela de exemplares no OPAC.

      Existe um pequeno ícone de "i" ao lado do nome da biblioteca na tabela de exemplares

      Clicar no nome da biblioteca que tem um pequeno ícone de “i” ao lado, abrirá um janela com a informação.

      Pop-up com o conteúdo da personalização HTML OpacLibraryInfo para Centerville

    • IP: este campo não necessita de ser preenchido, a menos que pretenda limitar o acesso à interface da equipa a um endereço IP ou a um intervalo de endereços IP específicos.

      Nota

      Os endereços e intervalos de IP das bibliotecas são utilizados pelas preferências de sistema StaffLoginLibraryBasedOnIP e StaffLoginRestrictLibraryByIP.

    • Código de organização MARC: se esta biblioteca tiver um código de organização MARC [https://www.loc.gov/marc/organizations/orgshome.html] específico, pode introduzi-lo aqui.

      Nota

      Se for deixado em branco, o código introduzido na preferência de sistema MARCOrgCode será utilizado para esta biblioteca.

    • Notas: se tiver alguma observação, pode inseri-la aqui. Não serão exibidas no OPAC.

    • Local de levantamento: escolha se esta biblioteca aparecerá como um local de recolha disponível para reservas e empréstimos entre bibliotecas.

    • Público: escolha se esta biblioteca irá aparecer na página “Bibliotecas” no OPAC, bem como uma opção de filtro na pesquisa avançada do OPAC.

    • Horário de funcionamento: se realiza empréstimos à hora, preencha o horário de funcionamento da biblioteca para cada dia da semana. Em seguida, pode definir a preferência de sistema ConsiderLibraryHoursInCirculation de acordo com as suas políticas.

      Versão

      Esta opção foi adicionada ao Koha na versão 24.05.

    • UserJS: utilize este campo para adicionar JavaScript personalizado ao OPAC desta biblioteca (quando os utilizadores estão ligados ou se existe uma entrada SetEnv OPAC_BRANCH_DEFAULT no ficheiro de configuração do Apache)

      Nota

      As modificações gerais aplicáveis a todas as bibliotecas podem ser inseridas na preferência de sistema OPACUserJS.

    • UserCSS: utilize este campo para adicionar CSS personalizado ao OPAC desta biblioteca (quando os utilizadores estão ligados ou se existe uma entrada SetEnv OPAC_BRANCH_DEFAULT no ficheiro de configuração do Apache)

      Nota

      As modificações gerais aplicáveis a todas as bibliotecas podem ser inseridas na preferência de sistema OPACUserCSS.

    • Se existirem campos adicionais para bibliotecas, estes serão apresentados na parte inferior do formulário.

  • Clique em “Submeter” para guardar a nova biblioteca.

Editar/eliminar uma biblioteca

Na tabela de bibliotecas, clique em “Editar” ou “Apagar” para editar ou apagar uma biblioteca.

Tabela de bibliotecas existentes

Aviso

Não poderá editar o “Código da Biblioteca”.

Aviso

Não poderá remover qualquer biblioteca que tenha leitores ou exemplares associados.

Mensagem de aviso a informar "Esta biblioteca não pode ser eliminada. Os leitores ou exemplares ainda a estão a utilizar (4 leitores e 1243 exemplares )."

Grupos de bibliotecas

Os grupos de biblioteca podem servir diversos propósitos: limitar o acesso aos dados dos utilizadores, restringir a modificação de itens, limitar as pesquisas no OPAC ou na interface dos técnicos, ou definir o comportamento das reservas.

  • Acesso: Mais > Administração > Parâmetros de base > Grupos de bibliotecas

Nota

Apenas os utilizadores com a permissão manage_libraries (ou superbibliotecários) terão acesso a esta secção.

Ao visitar esta página, vê uma lista dos grupos que já foram adicionados ao sistema.

Página de grupos de bibliotecas, com grupos que contêm bibliotecas

Adicionar um grupo

Para criar um novo grupo de biblioteca,

  • Clique no botão “Adicionar grupo” na parte superior do ecrã.

    Formulário para novo grupo de bibliotecas

    • Título (obrigatório): dê um título ao grupo. Este título será apresentado na interface de limites da pesquisa avançada.

    • Descrição: opcionalmente, introduza uma descrição para este grupo. A descrição é utilizada apenas nesta página para dar uma ideia da finalidade do grupo.

    • Recursos: marque a utilização deste grupo

    • Limite a edição de exemplares por grupo: isto impedirá os membros da equipa de editarem exemplares das bibliotecas de outros grupos.

      Nota

      Esta pode ser substituída pela permissão edit_any_item (ou sendo superbibliotecário).

    • Utilize para grupos de pesquisa OPAC: isto tornará o grupo visível no menu suspenso de bibliotecas no topo do OPAC (quando a preferência de sistema OpacAddMastheadLibraryPulldown estiver definida como “Adicionar”) e na página de pesquisa avançada.

      Menu suspenso des bibliotecas e grupo de bibliotecas na barra de pesquisa simples do OPAC

    • Para grupos de pesquisa da equipa: isto tornará o grupo visível no menu suspenso das bibliotecas, na pesquisa avançada da interface dos técnicos.

      Secção de limites de localização e disponibilidade do formulário de pesquisa avançada na interface dos técnicos

    • É um grupo de reserva local: isto fará deste grupo um grupo de reserva local, que pode ser utilizado para adicionar políticas de reserva nas regras de circulação e, assim, limitar os utilizadores a solicitar reservas apenas de exemplares pertencentes a esse grupo.

    • É um grupo de reservas local: isto define este grupo como um grupo de reservas local, que pode ser utilizado numa política de devolução ou numa política de reserva nas regras de circulação para determinar se um exemplar flutua (permanece na biblioteca onde foi devolvido) ou se é transferido de volta para a sua biblioteca de origem.

  • Clique em “Guardar” para criar o grupo.

Adicionar uma biblioteca a um grupo

Clique no botão “Adicionar biblioteca” junto ao grupo para adicionar uma biblioteca a esse grupo. Será apresentada uma lista das bibliotecas que ainda não fazem parte do grupo.

O botão Adicionar biblioteca está premido e é apresentada uma lista de bibliotecas

Adicionar um subgrupo

Se o seu sistema for muito grande, pode criar subgrupos. Clique no botão “Ações” junto ao grupo e selecione a opção “Adicionar um subgrupo”.

Ao clicar no botão Ações junto a um grupo de bibliotecas, as opções apresentadas são Adicionar subgrupo, Editar e Apagar.

Preencha o título e a descrição (opcional) do subgrupo. Os recursos serão herdados do grupo pai.

Formulário de novo subgrupo

Eliminar um grupo

Para eliminar um grupo, clique no botão “Ações” junto ao grupo e selecione a opção “Eliminar”.

Ao clicar no botão Ações junto a um grupo de bibliotecas, as opções apresentadas são Adicionar subgrupo, Editar e Apagar.

O sistema solicitará a confirmação da eliminação.

Pop-up de confirmação ao eliminar um grupo de bibliotecas.

Clique em “Eliminar” para confirmar e apagar o grupo.

Balcões de atendimento

O Koha permite definir vários balcões de atendimento dentro da mesma biblioteca. Por exemplo, se tiver um balcão de atendimento para adultos e outro para o público infantil, ou se existir um balcão diferente para cada piso ou departamento.

Certifique-se de que ativa a preferência de sistema UseCirculationDesks para utilizar esta funcionalidade.

  • Acesso: Mais > Administração > Leitores e circulação > Balcões de atendimento

Adicionar balcões de atendimento

Para adicionar um novo balcão, clique no botão “Novo balcão” no topo da página.

image1477

  • No campo “Balcão”, introduza um nome para o seu balcão.

  • Escolha a biblioteca onde este balcão se encontra.

  • Clique em “Submeter”.

Editar um balcão de atendimento

Para editar um balcão de atendimento existente, clique no botão “Editar” à direita do balcão que pretende modificar.

image1478

A partir daí, pode alterar o nome e/ou a biblioteca do balcão.

Eliminar um balcão de atendimento

Para eliminar um balcão de atendimento existente, clique no botão “Eliminar” à direita do balcão que pretende remover.

Tipos de documento

  • Acesso: Mais > Administração > Parâmetros de base > Tipos de documento

Nota

Apenas os colaboradores com a permissão manage_itemtypes (ou superbibliotecários) terão acesso a esta secção.

O Koha permite organizar a sua coleção por tipos de documento e códigos de coleção. Tal como as bibliotecas e as categorias de leitor, os tipos de documento são utilizados para controlar as regras de circulação.

Os tipos de documento referem-se geralmente ao tipo de material (livro, CD, DVD, etc.), mas podem ser utilizados da forma que melhor se adequa à sua biblioteca.

Tabela de tipos de documento

Nota

Pode personalizar as colunas desta tabela na secção Configurações da tabela do módulo de Administração (identificador da tabela: table_item_type).

Adicionando tipos de documento

Para adicionar um novo tipo de documento,

  • Clique no botão “Novo tipo de documento” na parte superior da página de tipos de documento.

  • Preencha o formulário:

Formulário para adicionar novo tipo de documento

  • Tipo de documento: introduza um código curto para o seu tipo de artigo (máximo de 10 caracteres)

  • Tipo de documento pai: pode escolher um tipo de documento que servirá de categoria pai para este tipo de documento . Em seguida, pode definir regras de circulação com base neste tipo de documento pai.

    • Por exemplo, poderia ter tipos de documento DVD e Blu-ray, e o DVD seria o pai do tipo de documento Blu-ray.

      Tipos de documento DVD e Blu-ray, em que DVD é o pai de Blu-ray

      Pode então criar uma regra de circulação apenas para Blu-ray ou para DVD e Blu-ray (DVD (Todos))

      Ao criar uma regra de circulação para um tipo de item pai, o menu suspenso de tipos de documento está aberto e apresenta opções para os vários tipos; DVD (Todos) e Blu-Ray aparecem com recuo sob DVD

  • Descrição: introduza a definição em texto simples do tipo de documento

    • Em sistemas com vários idiomas instalados, pode traduzir a descrição do tipo de documento para todos esses idiomas utilizando a ligação «Traduzir para outros idiomas».

  • Categoria de pesquisa: os tipos de documento podem ser agrupados para pesquisa simultânea na pesquisa avançada do OPAC. Por exemplo, pode reunir DVDs e Blu-rays num grupo chamado “Filmes”, permitindo aos utilizadores pesquisá-los em conjunto. Estes grupos são definidos na categoria de valores autorizados ITEMTYPECAT.

    Nota

    As categorias de pesquisa são apenas utilizadas no OPAC. A equipa pode pesquisar tipos de documentos específicos na pesquisa avançada da interface administrativa.

  • Escolha um ícone: pode optar por associar uma imagem ao seu tipo de documento. Estas imagens aparecerão na interface da equipa e no OPAC, na pesquisa avançada e na tabela de exemplares, ou no registo bibliográfico, caso a preferência do sistema item-level_itypes esteja definida como nível de registo. Pode escolher um ícone a partir de diversas coleções de imagens ou ligar uma imagem remota.

    Aviso

    Se esta opção não estiver ativada, pode alterar a configuração de noItemTypeImages ou OPACNoItemTypeImages.

    Nota

    Para que as imagens dos tipos de item apareçam no OPAC, é necessário definir OPACnoItemTypeImages como “Mostrar”.

  • Ocultar no OPAC: para os exemplares que está a ocultar do OPAC, é possível impedir que o tipo de documento seja pesquisado no OPAC.

    Importante

    Isto não impedirá que estes exemplares apareçam nos resultados de pesquisa; simplesmente removerá o tipo de documento do formulário de pesquisa avançada.

    Se pretende ocultar completamente exemplares de um determinado tipo de documento, digamos, por exemplo, que tem um acervo profissional com livros reservados à equipa e não pretende que estes apareçam no OPAC, utilize a preferência de sistema OpacHiddenItems.

  • Não disponível para empréstimo: selecione esta opção para os tipos de documento que não devem circular. Os exemplares marcados como “Não disponível para empréstimo” aparecerão no catálogo, mas não poderão ser emprestados aos utilizadores.

  • Devolução automática: pode selecionar esta opção para exemplares que não são físicos, mas para os quais ainda existem regras de circulação, como passes de museu ou ebooks.

    Nota

    Esta opção requer a rotina misc/cronjobs/automatic_checkin.pl. Solicite ao administrador do sistema que a agende.

  • Reservável: assinale esta opção para permitir marcações para todos os exemplares deste tipo.

    Versão

    Esta opção foi adicionada ao Koha na versão 24.11.

  • Taxa de aluguer: se cobra uma taxa fixa de aluguer para o levantamento de exemplares deste tipo, insira aqui o valor. Esta taxa será cobrada ao leitor no momento da recolha e da renovação.

    Importante

    Não introduza símbolos neste campo, apenas números e pontos decimais (por exemplo, 5,00 dólares devem ser introduzidos como 5 ou 5,00).

  • Taxa de aluguer diária: no caso de a taxa de aluguer ser cobrada com base no número de dias de empréstimo do exemplar, insira aqui o valor da diária. Esta taxa será cobrada ao leitor no momento da devolução, multiplicada pelo número de dias em que o exemplar esteve emprestado. Por exemplo, para um exemplar emprestado por 7 dias com uma taxa diária de 1 dólar, será cobrado ao utilizador o valor de 7 dólares no momento da devolução. Esta taxa diária de aluguer também será aplicada em casos de renovação.

    Importante

    Não introduza símbolos neste campo, apenas números e pontos decimais (por exemplo, 5,00 dólares devem ser introduzidos como 5 ou 5,00).

  • Empréstimos diários com base no calendário: assinale esta opção para excluir os feriados do cálculo da tarifa de locação diária.

    Nota

    Certifique-se de que introduz os dias de fecho no calendário para os excluir da cobrança diária do aluguer.

  • Taxa de aluguer por hora: se os exemplares forem emprestados por hora, introduza aqui o custo por hora. Mais uma vez, o valor total (custo por hora × número de horas de empréstimo) será cobrado ao leitor no momento da devolução ou da renovação.

    Importante

    Não introduza símbolos neste campo, apenas números e pontos decimais (por exemplo, 5,00 dólares devem ser introduzidos como 5 ou 5,00).

  • Empréstimos por hora utilizam o calendário: assinale esta opção para excluir os feriados do cálculo da tarifa de aluguer por hora.

    Nota

    Certifique-se de que introduz os dias de fecho no calendário para os excluir da cobrança diária do aluguer.

  • Custo de substituição padrão: é o valor que será cobrado ao leitor quando um exemplar deste tipo for perdido e o exemplar não tiver um custo de substituição. Se o exemplar tiver um custo de substituição, este será o valor cobrado ao leitor.

    Importante

    Não introduza símbolos neste campo, apenas números e pontos decimais (por exemplo, 5,00 dólares devem ser introduzidos como 5 ou 5,00).

  • Taxa de processamento (em caso de perda): esta taxa de processamento será acrescida ao custo de substituição caso o leitor perca um exemplar deste tipo.

    Importante

    Não introduza símbolos neste campo, apenas números e pontos decimais (por exemplo, 5,00 dólares devem ser introduzidos como 5 ou 5,00).

  • Mensagem de devolução: se pretender que uma mensagem ou um alerta seja apresentado quando exemplares deste tipo dão entrada, introduza aqui a mensagem.

  • Tipo de mensagem de devolução: a mensagem de devolução pode ser uma «mensagem» ou um «alerta». A única diferença entre as duas é o estilo. Uma mensagem é azul

    Mensagem 'Por favor, devolva à estante de empréstimo entre bibliotecas' numa caixa azul-claro na página de devolução

    e um alerta é amarelo.

    Mensagem 'Por favor, devolva à estante de empréstimo entre bibliotecas' numa caixa amarela na página de devolução

  • Tipo de suporte SIP: alguns dispositivos SIP requerem a utilização de um tipo de suporte específico para o SIP, em vez do tipo de documento do Koha (geralmente, os armários e os classificadores automáticos requerem este tipo de suporte). Se utilizar um dispositivo deste tipo, selecione o tipo de suporte SIP correspondente a esse tipo de documento.

  • Limitação da biblioteca: se este tipo de documento só deve ser utilizado em bibliotecas específicas, pode seleccioná-las aqui. Selecione «Todas as bibliotecas» se este tipo de documento for utilizado em todo o sistema de bibliotecas.

    Nota

    Se for deixado em branco, assume-se “Todas as bibliotecas”.

    Dica

    Para selecionar mais do que uma biblioteca, mantenha a tecla “Ctrl” premida enquanto seleciona as bibliotecas.

  • Resumo: este resumo é apenas utilizado em visualizações que não utilizam XSLT.

  • Verificar empréstimos anteriores: esta configuração só aparece se a preferência de sistema CheckPrevCheckout estiver definida como “A menos que substituído pela categoria de leitor ou pelo tipo de documento, fazer” ou “A menos que substituído pela categoria de leitor ou pelo tipo de documento, não fazer”. Isto permite que as bibliotecas personalizem se o Koha deve alertar a equipa quando um leitor já requisitou o mesmo título, com base no tipo de documento.

    • Herdar das preferências de sistema: utiliza a configuração da preferência de sistema CheckPrevCheckout.

    • Sim, e sobrepor as preferências de sistema: verifica sempre o histórico de circulação do leitor para este tipo de documento, independentemente da configuração da preferência do sistema CheckPrevCheckout.

    • Não, e sobrepor preferências de sistema: nunca verificar o histórico de circulação do leitor para este tipo de documento, independentemente da configuração da preferência de sistema CheckPrevCheckout.

    Versão

    Esta opção foi adicionada ao Koha na versão 25.11.

  • Quando terminar, clique em “Guardar alterações”.

Nota

Todos os campos, com exceção de “Tipo de documento”, serão editáveis a partir da lista de tipos de documento.

O seu novo tipo de documento aparecerá agora na lista.

Editar tipos de documento

Para editar um tipo de documento, clique no botão “Editar” junto ao mesmo ou clique no código do tipo de documento.

Consulte a secção Adicionar tipos de documento para obter uma descrição de cada campo.

Importante

Não poderá editar o código atribuído como “Tipo de documento”, mas poderá editar a descrição do tipo.

Eliminar tipos de documento

Para eliminar um tipo de documento, clique no botão “Apagar” ao lado.

Importante

Não poderá eliminar tipos de documento que estejam a ser utilizados por exemplares ou registos bibliográficos no seu sistema. Caso isto ocorra, uma mensagem irá alertá-lo de que o tipo de documento está em uso.

Alerta com a mensagem 'Não é possível eliminar este tipo de artigo. Este registo está em utilização. A eliminação não é possível.'

Valores Autorizados

Os valores autorizados podem ser utilizados em diversas áreas do Koha. Trata-se de listas de termos, frases ou códigos controlados.

Por exemplo, um motivo para adicionar uma categoria de valores autorizados seria controlar os valores que podem ser introduzidos nos campos MARC pelos catalogadores.

  • Acesso: Mais > Administração > Parâmetros de base > Valores autorizados

Lista de categorias de valores autorizados existentes

Nota

Apenas os colaboradores com a permissão manage_auth_values (ou superbibliotecários) terão acesso a esta secção.

Categorias de valores autorizados existentes

O Koha é instalado com categorias de valores autorizados predefinidas que a sua biblioteca provavelmente utilizará ou que são utilizadas pelo sistema.

AR_CANCELLATION

Esta categoria contém as razões pelas quais um pedido de artigo pode ter sido cancelado.

Se optar por instalar os valores por omissão para esta categoria, terá

  • O exemplar não foi localizado nas prateleiras (NOT_FOUND)

  • O exemplar estava demasiado danificado para atender à solicitação (DAMAGED)

  • Cancelado a partir da página do leitor no OPAC (OPAC)

Pode alterá-los para atender às necessidades da sua organização.

Asort1

Estes valores são utilizados para fins estatísticos de aquisições. Pode utilizá-los como categorias estatísticas ao criar um fundo no módulo de aquisições.

Asort2

Estes valores são utilizados para fins estatísticos de aquisições. Pode utilizá-los como categorias estatísticas ao criar um fundo no módulo de aquisições.

BOOKING_CANCELLATION

Versão

Esta categoria de valores autorizados foi introduzida pela primeira vez na versão 24.11 do Koha.

Estes valores são utilizados ao cancelar marcações como os motivos do cancelamento da marcação.

BOR_NOTES

Estes valores são utilizados para mensagens ao leitor e mensagens de circulação predefinidas, que aparecem no ecrã de circulação e na conta do leitor no OPAC.

Escreva a mensagem que pretende que apareça no campo “Descrição”.

Captura de ecrã de um valor autorizado para a categoria BOR\_NOTES; o valor autorizado é ADDR e a descrição é 'Por favor, traga um comprovativo de morada na sua próxima visita à biblioteca'. No topo da página, existem dois botões: 'Nova categoria' e 'Novo valor autorizado para BOR\_NOTES'

Nota

Este campo está limitado a 200 caracteres. No entanto, o campo de mensagem no registo do leitor pode conter mais do que isso. Escreva os primeiros 200 caracteres na descrição e escreva os restantes ao adicionar a mensagem.

Bsort1

Estes valores podem ser introduzidos para preencher o campo de classificação 1 do leitor.

Bsort2

Estes valores podem ser introduzidos para preencher o campo de classificação 2 do leitor

CAND

Uma lista utilizada no UNIMARC.

CCODE

Estes valores são códigos de coleção. Aparecem ao catalogar e ao trabalhar com os exemplares.

Isto é normalmente mapeado para o items.ccode na base de dados do Koha.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Ficção (FIC)

  • Não ficção (NFIC)

  • Referência (REF)

Pode alterá-los para atender às necessidades da sua organização.

Aviso

Para obter melhores resultados ao pesquisar, evite utilizar hífens nos códigos de coleção.

CONTROL_NUM_SEQUENCE

Esta categoria é utilizada para gerar números de controlo no editor avançado de catalogação.

Introduza uma sequência de caracteres terminada num número como o valor autorizado e utilize a descrição para especificar o tipo de número. Por exemplo: “sprLib0001” e “Springfield Library”. No editor avançado, isto irá ativar um novo componente que lhe permitirá selecionar o tipo de número e gerar o próximo número da sequência.

COUNTRY

Uma lista de nomes de países utilizados no campo 102, subcampo $a, do UNIMARC.

DAMAGED

Esta categoria contém descrições para os exemplares marcados como danificados. Aparecem ao catalogar e ao trabalhar com os exemplares.

Isto é normalmente mapeado para items.damaged na base de dados.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Danificado (1)

Pode alterá-los para atender às necessidades da sua organização.

Aviso

Os valores autorizados para DAMAGED devem ser numéricos.

DEPARTMENT

Esta categoria contém departamentos que são requeridos e utilizados no módulo de reservas de curso.

ERM_AGREEMENT_CLOSURE_REASON

Estes valores são usados para descrever o motivo do encerramento de um registo de acordo após ele ter sido marcado como “Encerrado” no módulo de gestão de recursos eletrónicos.

Também podem ser utilizados nos relatórios.

Os valores por omissão são

  • Expirado (expired)

  • Cancelado (cancelled)

ERM_AGREEMENT_LICENSE_LOCATION

Estes valores são utilizados para descrever a localização física de um registo de licença nos casos em que ainda possua uma cópia impressa da licença (em vez de uma versão eletrónica).

Os valores por omissão são

  • Armário de arquivo (filing cabinet)

  • Armário (cupboard)

ERM_AGREEMENT_LICENSE_STATUS

Estes valores são utilizados para descrever o estado de uma licença ligada a um registo de acordo no módulo de gestão de recursos eletrónicos. Isto ajuda a equipa a identificar as licenças no seu ciclo de vida.

Também podem ser utilizados nos relatórios.

Os valores por omissão são

  • Em controlo (controlling)

  • Futuro (future)

  • Histórico (historic)

ERM_AGREEMENT_RENEWAL_PRIORITY

Estes valores são utilizados para descrever a prioridade de renovação de um registo de acordo no módulo de gestão de recursos eletrónicos, de forma a indicar o grau de importância da renovação desse acordo.

Também podem ser utilizados nos relatórios.

Os valores por omissão são

  • Para revisão (for_review)

  • Renovar (renew)

  • Cancelar (cancel)

ERM_AGREEMENT_STATUS

Estes valores são utilizados para descrever o estado de um registo de acordo no módulo de gestão de recursos eletrónicos.

Também podem ser utilizados nos relatórios.

Os valores por omissão são

  • Ativo (active)

  • Em negociação (in_negotiation)

  • Fechado (closed)

    Aviso

    Não altere o valor autorizado para “Fechado” (a descrição pode ser alterada); é utilizado para ativar o menu suspenso “Razão do fecho”.

ERM_LICENSE_STATUS

Estes valores são utilizados para descrever o estado de um registo de licença no módulo de gestão de recursos eletrónicos. Ajudam a equipa a identificar as licenças no seu ciclo de vida.

Também podem ser utilizados nos relatórios.

Os valores por omissão são

  • Em negociação (in_negotiation)

  • Ainda não ativa (not_yet_active)

  • Ativo (active)

  • Rejeitada (rejected)

  • Expirado (expired)

ERM_LICENSE_TYPE

Estes valores são utilizados para descrever o tipo de licença no módulo de gestão de recursos eletrónicos.

Também podem ser utilizados em relatórios.

Os valores por omissão são

  • Local (local)

  • Consorcial (consortial)

  • Nacional (national)

  • Aliança (alliance)

ERM_PACKAGE_CONTENT_TYPE

Estes valores são utilizados para descrever os tipos de material encontrados num pacote local no módulo de gestão de recursos eletrónicos.

Isto é apenas para pacotes locais.

Os valores por omissão são

  • Texto completo agregado (AggregatedFullText)

  • Resumo e índice (AbstractAndIndex)

  • E-book (EBook)

  • Jornal eletrónico (EJournal)

  • Conteúdo misto (MixedContent)

  • Referência online (OnlineReference)

  • Impressão (Print)

  • Streaming de media (StreamingMedia)

  • Desconhecido (Unknown)

ERM_PACKAGE_TYPE

Estes valores são utilizados para descrever os tipos de pacote no módulo de gestão de recursos eletrónicos.

Isto é apenas para pacotes locais.

Os valores por omissão são

  • Local (local)

  • Completo(complete)

ERM_TITLE_PUBLICATION_TYPE

Estes valores são utilizados para descrever o tipo de material de um título no módulo de gestão de recursos eletrónicos.

Isto aplica-se apenas a títulos locais

Os valores por omissão são

  • Audiolivro (audiobook)

  • Livro (book)

  • Série de livros (bookseries)

  • Base de dados (database)

  • E-book (ebook)

  • Revista (journal)

  • Boletim informativo (newsletter)

  • Jornal (newspaper)

  • Actas (proceedings)

  • Relatório (report)

  • Streaming de áudio (streamingaudio)

  • Streaming de vídeo (streamingvideo)

  • Tese/Dissertação (thesisdissertation)

  • Não especificado (unspecified)

  • Website (website)

ERM_USER_ROLES

Estes valores são utilizados para descrever a função de um utilizador da equipa ligado a um registo de acordo ou de licença no módulo de gestão de recursos eletrónicos.

Os valores por omissão são

  • Bibliotecário de ERM (librarian)

  • Especialista na área (subject_specialist)

ETAT

Estes valores são utilizados nas implementações francesas do UNIMARC, no campo 995 $o, para identificar o estado do item. São semelhantes ao NOT_LOAN.

HINGS_AS

Estes valores são utilizados como designador geral do estado de aquisição do acervo. Este elemento de dados especifica o estado de aquisição da unidade no momento do relatório de recolha.

HINGS_C

Estes valores são utilizados como indicador geral de completude do acervo.

HINGS_PF

Estes valores são utilizados como designadores de forma física.

HINGS_RD

Estes valores são utilizados como designadores gerais de retenção de acervo. Este elemento de dados especifica a política de retenção para a unidade no momento do relatório de recolha.

HINGS_UT

Estes valores são utilizados como um designador de unidade do tipo posses gerais.

HOLD_CANCELLATION

Estes valores são utilizados ao cancelar reservas como os motivos pelos quais a reserva foi cancelada.

Se optar por instalar os valores por omissão para esta categoria, terá

  • O exemplar não foi localizado nas prateleiras (NOT_FOUND)

  • Artigo estava demasiado danificado para preencher a reserva (DAMAGED)

Pode alterá-los para atender às necessidades da sua organização.

HSBND_FREQ

Estes valores são frequências de entrega utilizadas pelo módulo de atendimento a utilizadores impossibilitados de se deslocar. São apresentados no separador housebound, na conta do utilizador, dentro da interface dos técnicos.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Todas as semanas (EW)

Pode alterá-los para atender às necessidades da sua organização.

ILL_STATUS_ALIAS

Estes valores são estados de pedidos de empréstimo interbibliotecas (ILL) utilizados no módulo ILL.

ITEMTYPECAT

Estes valores são categorias de pesquisa para tipos de documentos. Permitem pesquisar vários tipos de documento simultaneamente.

Para agrupar os tipos de documento em categorias, escolha a categoria nas configurações dos tipos de documento.

Por exemplo, um valor de ITEMTYPECAT pode ser “NOVO”. Esta categoria de pesquisa poderia ser definida para os tipos de artigo “LIVROS NOVOS” e “DVDs NOVOS”. Isto irá substituir os tipos de item “LIVROS NOVOS” e “DVDs NOVOS” no formulário de pesquisa avançada pela opção “NOVO”. Quando um utilizador selecionar a categoria “NOVO”, irá pesquisar em múltiplos tipos de item com uma única pesquisa.

Nota

As categorias de pesquisa são apenas utilizadas no OPAC.

LANG

Esta categoria é uma lista de códigos de idioma da norma ISO 639-2.

LOC

Estes valores correspondem a localizações de prateleira. Normalmente aparecem ao adicionar ou editar um exemplar.

Isto é normalmente mapeado para items.location na base de dados do Koha.

Se optar por instalar os valores por omissão para esta categoria, terá

Pode alterá-los para atender às necessidades da sua organização.

Aviso

Para obter melhores resultados ao pesquisar, evite utilizar hífens nos códigos de localização.

LOST

Estes valores são descrições para os exemplares marcados como perdidos. Aparecem ao adicionar ou editar um exemplar.

Isto é normalmente mapeado para items.itemlost na base de dados do Koha.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Perdido (1)

  • Empréstimo em atraso (perdido) (2)

  • Perdido e pago (3)

  • Em falta (4)

  • Em falta no conjunto (5)

Pode alterá-los para atender às necessidades da sua organização.

Aviso

Os valores autorizados para LOST devem ser numéricos.

NOT_LOAN

Estes valores indicam os motivos pelos quais um exemplar não está disponível para empréstimo. Aparecem ao adicionar ou editar um exemplar.

Isto é normalmente mapeado para items.notforloan na base de dados do Koha.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Encomendado (-1)

  • Não emprestável (1)

  • Coleção da equipa (2)

  • Adicionado ao conjunto (3)

Pode alterá-los para atender às necessidades da sua organização.

Aviso

Os valores autorizados para NOT_LOAN devem ser numéricos.

  • Valores numéricos negativos permitirão reservas (para utilização com o estado de “encomendado”, por exemplo).

  • Os números positivos não permitirão reservas ou empréstimos.

  • Um valor de 0 significa “para empréstimo”.

OPAC_SUG

Esta categoria contém uma lista de motivos apresentados no formulário de sugestão no OPAC.

Se optar por instalar os valores por omissão para esta categoria, terá

  • O exemplar que se encontra na prateleira está danificado (damaged)

  • Próximo título de autor popular (bestseller)

Pode alterá-los para atender às necessidades da sua organização.

ORDER_CANCELLATION_REASON

Estes valores indicam os motivos pelos quais uma encomenda pode ter sido cancelada. São utilizados nas aquisições.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Nenhum motivo apresentado (0)

  • Esgotado (1)

  • Reposição de stock (2)

Pode alterá-los para atender às necessidades da sua organização.

PA_CLASS

Estes valores são utilizados para agrupar atributos de leitor no formulário de adição e edição de leitores.

PAYMENT_TYPE

Esta categoria preenche uma lista suspensa de tipos de pagamento personalizados ao pagar multas.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Dinheiro via SIP2 (SIP00)

  • Visa via SIP2 (SIP01)

  • Cartão de crédito via SIP2 (SIP02)

Pode alterá-los para atender às necessidades da sua organização.

qualif

Estes valores são códigos de função (autor, editor, colaborador, etc.) utilizados no campo 7XX $4 do formato UNIMARC (francês).

RELTERMS

Esta categoria é uma lista de códigos e termos de relação.

Esta lista baseia-se na lista de códigos MARC21 para funções de relação [https://www.loc.gov/marc/relators/] da Biblioteca do Congresso

Importante

Esta lista não é mantida atualizada nas instalações existentes. Certifique-se de que adiciona novos valores à sua instalação à medida que são publicados pela Biblioteca do Congresso.

Pode ser ligado a um subcampo numa estrutura bibliográfica MARC para criar um menu suspenso que permita aos catalogadores fazerem uma seleção, em vez de digitarem o código de relação. No MARC21, os códigos de relação constam normalmente no subcampo $4.

REPORT_GROUP

Estes valores podem ser utilizados para classificar e filtrar os seus relatórios. Aparecerão como separadores na página de relatórios guardados.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Conta (ACC)

  • Aquisições (ACQ)

  • Catálogo (CAT)

  • Circulação (CIRC)

  • Leitores (PAT)

  • Periódicos (SER)

Pode alterá-los para atender às necessidades da sua organização.

REPORT_SUBGROUP

Estes valores podem ser utilizados para classificar e filtrar ainda mais os seus relatórios.

Os valores aqui devem incluir o código de valor autorizado de REPORT_GROUP no campo Descrição (OPAC) para ligar o subgrupo ao grupo apropriado.

Valores autorizados para as categorias de REPORT\_SUBGROUP: esta captura de ecrã mostra que o código do grupo de relatórios é guardado no campo Descrição (OPAC) do valor autorizado do subgrupo. Na parte superior da página existem dois botões: 'Nova categoria' e 'Novo valor autorizado para REPORT\_SUBGROUP'

RESTRICTED

Estes valores são utilizados como o estado de restrição de um exemplar. Aparecem ao adicionar ou editar um exemplar.

Isto é normalmente mapeado para items.restricted na base de dados do Koha.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Acesso restrito (1)

Pode alterá-los para atender às necessidades da sua organização.

Aviso

Os valores autorizados para esta categoria devem ser numéricos.

RETURN_CLAIM_RESOLUTION

Estes valores são motivos pelos quais um pedido de devolução foi resolvido.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Devolvido pelo leitor (RET_BY_PATRON)

  • Encontrado na biblioteca (FOUND_IN_LIB)

Pode alterá-los para atender às necessidades da sua organização.

ROADTYPE

Estes valores são tipos de logradouro a utilizar nos endereços dos utilizadores, no campo “tipo de logradouro” do formulário de leitor.

SIP_MEDIA_TYPE

Estes valores são utilizados ao criar ou editar um tipo de exemplar para atribuir um tipo de media específico do SIP a dispositivos como armários (lockers) e classificadores (sorters).

Se optar por instalar os valores por omissão para esta categoria, terá

  • Outro (000)

  • Livro (001)

  • Revista (002)

  • Revista encadernada (003)

  • Fita áudio (004)

  • Fita de vídeo (005)

  • CD/CDROM (006)

  • Disquete (007)

  • Livro com disquete (008)

  • Livro com CD (009)

  • Livro com fita áudio (010)

Aviso

Os tipos de suporte SIP estão limitados a 3 caracteres. Certifique-se de que os valores autorizados para SIP_MEDIA_TYPE não têm mais de 3 caracteres.

STACK

Estes valores são números de controlo de estante. Aparecem ao adicionar ou editar um exemplar.

Isto é normalmente mapeado para items.stack na base de dados do Koha.

Aviso

Os valores autorizados para esta categoria devem ser numéricos.

SUGGEST

Estes valores são motivos para a aceitação ou rejeição de sugestões de compra em aquisições. Aparecem ao gerir sugestões.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Disponível via empréstimo interbibliotecas (AVILL)

  • Mais vendido (BSELL)

  • Documento que não está em conformidade com a nossa política de aquisição (Poldoc)

  • Documento muito caro (Expensive)

  • Orçamento insuficiente (Budget)

  • Exemplar da biblioteca em falta (LCL)

  • Exemplar de prateleira danificado (SCD)

Pode alterá-los para atender às necessidades da sua organização.

SUGGEST_FORMAT

Esta é uma lista de tipos de documento a apresentar num menu suspenso no formulário de sugestões do OPAC.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Audiolivro (AUDIOBOOK)

  • Livro (BOOK)

  • EBook (EBOOK)

  • DVD (DVD)

  • Impressão larga (LP)

Pode alterá-los para atender às necessidades da sua organização.

Aviso

Os tipos de formato de sugestão estão limitados a 30 caracteres. Certifique-se de que os valores autorizados para esta categoria não excedem os 30 caracteres.

SUGGEST_STATUS

Esta é uma lista de valores de estado personalizados adicionais para sugestões que podem ser utilizados para além dos valores padrão.

Aviso

O estado da sugestão está limitado a 10 caracteres. Certifique-se de que o seu valor autorizado não tem mais de 10 caracteres.

Aviso

O estado da sugestão não deve conter espaços.

TERM

Estes valores são termos a utilizar no módulo de reservas de curso. Por exemplo: Primavera, Verão, Inverno, Outono.

Estes termos aparecerão no menu suspenso ao adicionar um novo curso.

TICKET_RESOLUTION

Versão

Esta categoria foi adicionada ao Koha na versão 24.05.

Estes valores são tipos de resolução a utilizar quando se marca questões do catálogo como “Resolvidas”.

TICKET_STATUS

Versão

Esta categoria foi adicionada ao Koha na versão 24.05.

Estes valores são estados a utilizar ao atualizar preocupações do catálogo.

UPLOAD

Estes valores são categorias a atribuir a carregamentos de ficheiros. Sem uma categoria, um carregamento é considerado temporário e pode ser removido durante a limpeza automatizada.

VENDOR_INTERFACE_TYPE

Estes valores são utilizados como tipos de interface de fornecedor no módulo de aquisições.

VENDOR_ISSUE_TYPE

Estes valores são utilizados como um tipo de problema com fornecedor ao adicionar um problema no módulo de aquisições.

VENDOR_TYPE

Estes valores são utilizados para categorizar fornecedores no módulo de aquisições.

WITHDRAWN

Estes valores são descrições para exemplares retirados. Aparecem ao adicionar ou editar um exemplar.

Isto é normalmente mapeado para items.withdrawn na base de dados do Koha.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Retirado (1)

Pode alterá-los para atender às necessidades da sua organização.

Aviso

Os valores autorizados para esta categoria devem ser numéricos.

YES_NO

Este é um campo de valor autorizado genérico que pode ser utilizado onde quer que necessite de um menu suspenso simples de sim/não.

Se optar por instalar os valores por omissão para esta categoria, terá

  • Sim (1)

  • Não (0)

Aviso

Em geral, os campos binários requerem um valor 1 ou 0. Se alterar estes valores, certifique-se de que o campo ao qual pretende associá-los aceita valores diferentes de 0 ou 1.

Adicionar novas categorias de valores autorizados

Para além das categorias existentes que vêm por omissão no Koha, os bibliotecários podem adicionar as suas próprias categorias de valores autorizados para controlar os dados introduzidos no sistema.

Para adicionar uma nova categoria:

  • Clique em “Nova categoria”

    Formulário de nova categoria de valor autorizado

  • Preencher o formulário

    • Categoria: introduza o código da nova categoria. Limite o código a 32 caracteres (algo curto que deixe claro o propósito da categoria).

      Aviso

      Um código de categoria não pode conter espaços ou caracteres especiais, exceto sublinhados e hífens.

    • Restringir o valor apenas a números: assinale a caixa se os valores desta categoria deverem ser exclusivamente numéricos. Isto impedirá que a equipa crie valores autorizados que não estejam em conformidade com esta regra.

      Versão

      Esta opção foi adicionada ao Koha na versão 24.05.

  • Clicar em “Guardar”

Categoria de valores autorizados sem valores. No topo da página, dois botões: 'Nova categoria' e 'Novo valor autorizado para CONTENT\_TYPE'; na parte inferior, dois botões: 'Adicionar um novo valor autorizado' e 'Apagar categoria CONTENT\_TYPE'

Prossiga para adicionar um novo valor autorizado à categoria.

Adicionando novos valores autorizados

Os novos valores autorizados podem ser adicionados a qualquer categoria existente ou nova.

Para adicionar um valor:

  • Na lista de categorias, clique no botão “Adicionar” à direita da categoria

    Lista de categorias de valores autorizados existentes

    • Em alternativa, clique no nome da categoria e, em seguida, clique em “Novo valor autorizado para…”

      Captura de ecrã de um valor autorizado para a categoria BOR\_NOTES; o valor autorizado é ADDR e a descrição é 'Por favor, traga um comprovativo de morada na sua próxima visita à biblioteca'. No topo da página, existem dois botões: 'Nova categoria' e 'Novo valor autorizado para BOR\_NOTES'

    • Se a categoria ainda não tiver valores, clique no botão “Adicionar um novo valor autorizado” na parte inferior da página

      Categoria de valores autorizados sem valores. No topo da página, dois botões: 'Nova categoria' e 'Novo valor autorizado para CONTENT\_TYPE'; na parte inferior, dois botões: 'Adicionar um novo valor autorizado' e 'Apagar categoria CONTENT\_TYPE'

  • Preencher o formulário

    Formulário de novo valor autorizado

    • Valor autorizado: introduza um código para o seu valor autorizado

      Nota

      O valor autorizado está limitado a 80 caracteres e não pode conter espaços ou caracteres especiais, exceto sublinhados e hífens.

      Algumas categorias, como SUGGEST_STATUS, podem ter limites mais rigorosos. Consulte a secção categorias de valores autorizados existentes acima para verificar os limites especificados.

    • Descrição: utilize este campo para o valor real que será apresentado.

    • Descrição (OPAC): se pretender visualizar uma descrição diferente no OPAC, introduza-a aqui. Se este campo estiver vazio, a “Descrição” será utilizada tanto na interface dos técnicos como no OPAC.

    • Limitações por biblioteca: se pretender restringir este valor autorizado a bibliotecas específicas, pode seleccioná-las neste menu. Para o disponibilizar a todas as bibliotecas, basta escolher “Todas as bibliotecas” no topo da lista.

    • Escolha um ícone: pode selecionar uma imagem que aparecerá ao lado do valor na interface da equipa e no OPAC.

      Nota

      Esta funcionalidade não funciona em todos os lugares. Aplica-se principalmente a localizações de artigos (LOC) e códigos de recolha (CCODE) na pesquisa avançada.

  • Clicar em “Guardar”

  • O novo valor irá aparecer na lista junto com os já existentes

    Captura de ecrã de um valor autorizado para a categoria BOR\_NOTES; o valor autorizado é ADDR e a descrição é 'Por favor, traga um comprovativo de morada na sua próxima visita à biblioteca'. No topo da página, existem dois botões: 'Nova categoria' e 'Novo valor autorizado para BOR\_NOTES'

Eliminar valores autorizados

Para eliminar um valor autorizado, clique no botão “Apagar” à direita do valor autorizado.

Captura de ecrã de um valor autorizado para a categoria BOR\_NOTES; o valor autorizado é ADDR e a descrição é 'Por favor, traga um comprovativo de morada na sua próxima visita à biblioteca'. No topo da página, existem dois botões: 'Nova categoria' e 'Novo valor autorizado para BOR\_NOTES'

Assim que não restarem valores autorizados numa categoria de valores autorizados, pode eliminar a categoria.

Categoria de valores autorizados sem valores. No topo da página, dois botões: 'Nova categoria' e 'Novo valor autorizado para CONTENT\_TYPE'; na parte inferior, dois botões: 'Adicionar um novo valor autorizado' e 'Apagar categoria CONTENT\_TYPE'

Leitores e empréstimo

Configurações para controlar a circulação e a informação dos leitores.

Categorias de Leitores

As categorias de leitor permitem organizar os seus leitores em diferentes funções, faixas etárias e tipos de leitor.

  • Acesso: Mais > Administração > Leitores e circulação > Categorias de leitor

Tabela de categorias de leitor

Nota

Pode personalizar as colunas desta tabela na secção Configurações da tabela do módulo de Administração (identificador da tabela: patron_categories).

Nota

Apenas os colaboradores com a permissão manage_patron_categories (ou superbibliotecários) terão acesso a esta secção.

Adicionar categoria de leitor

Para adicionar uma nova categoria de leitor, clique em “Nova categoria” no topo da página

Formulário de nova categoria de leitor

  • Código da categoria: um identificador para a sua nova categoria.

    • O código da categoria está limitado a 10 caracteres (números e letras) e deve ser único.

    • Este campo é obrigatório para guardar a categoria de utilizador. Se for deixado em branco, será apresentada uma mensagem de erro.

  • Descrição: uma versão em texto simples da categoria.

    • A descrição estará visível em todo o Koha.

    • Este campo é obrigatório para guardar a categoria de utilizador. Se for deixado em branco, será apresentada uma mensagem de erro.

  • Período de inscrição:

    • Em meses: deve ser preenchido se houver um período de inscrição limitado para os leitores. Por exemplo, os cartões de estudante expiram ao fim de 9 meses

    • Até à data: pode escolher uma data em que os cartões expirarão

    • Este campo é obrigatório para guardar a categoria de utilizador. Se for deixado em branco, será apresentada uma mensagem de erro.

    Aviso

    Não pode introduzir um limite mensal e uma data limite para a mesma categoria. Escolha inserir um ou outro.

  • Expiração da palavra-passe: introduza o número de dias após os quais o leitor deve alterar a sua palavra-passe.

  • Idade exigida: requisito de idade mínima (em anos) associado à categoria. Por exemplo, uma categoria de leitor “Adulto” poderia exigir uma idade mínima de 18 anos; isto significa que os leitores devem ter pelo menos 18 anos para pertencer a esta categoria.

    • Ao criar ou atualizar um leitor, será apresentado um aviso se o leitor for demasiado jovem para esta categoria.

      Aviso 'Os seguintes campos estão incorretos. Por favor, corrija-os. A idade do leitor é incompatível com a sua categoria. As idades permitidas são dos 5 aos 17 anos.'

    • Este valor é utilizado pela tarefa cron update_patrons_category.pl para alterar a categoria dos leitores que são demasiado jovens.

  • Limite superior de idade: idade máxima (em anos) associada à categoria. Por exemplo, uma categoria de leitor “Crianças” poderia ter um limite superior de idade de 18 anos, o que significa que os leitores podem manter cartões infantis até completarem 18 anos.

    • Ao criar ou atualizar um leitor, será apresentado um aviso se o leitor tiver uma idade superior à permitida para esta categoria.

      Aviso 'Os seguintes campos estão incorretos. Por favor, corrija-os. A idade do leitor é incompatível com a sua categoria. As idades permitidas são dos 5 aos 17 anos.'

    • Este valor é utilizado pela tarefa cron update_patrons_category.pl para alterar a categoria de leitores que ultrapassaram o limite de idade.

  • Taxa de inscrição: insira o valor caso cobre uma taxa de adesão aos seus membros (como por exemplo, os que residem noutra região).

Aviso

Introduza apenas números e decimais neste campo.

Nota

Dependendo do valor definido para a preferência do sistema FeeOnChangePatronCategory, esta taxa será cobrada tanto na renovação do registo do utilizador como no momento da sua inscrição inicial.

  • Aviso de atraso necessário: selecione “Sim” se pretender que os leitores desta categoria recebam avisos de atraso. Isto permitir-lhe-á configurar os aviso de atraso no módulo Ferramentas.

  • Exemplares perdidos na interface dos técnicos: defina, com base na categoria de leitor, se os exemplares perdidos serão apresentados na interface dos técnicos.

    • Exibido: os exemplares perdidos são apresentados na interface dos técnicos.

    • Ocultos por omissão: os exemplar perdidos ficam ocultos, mas os membros da equipa podem clicar em “Mostrar todos os exemplares” para os visualizar.

Nota

Isto aplica-se apenas à interface dos técnicos e, portanto, alterar este valor para categorias de leitores que não têm acesso à interface dos técnicos não fará qualquer diferença.

  • Taxa de reserva: insira o valor da taxa caso cobre aos leitores desta categoria uma taxa para efetuar reservas de exemplares.

    • Introduza apenas números e decimais neste campo.

    Atenção

    A partir da versão 26.05 do Koha, esta funcionalidade foi transferida para as regras de circulação e multas.

  • Tipo de categoria: escolha uma das seis categorias principais (categorias-pai)

    • Adulto: tipo de leitor mais comum, geralmente utilizado para uma categoria geral de “Leitor”.

    • Criança: outro tipo comum de leitor.

    • Staff: equipa da biblioteca

    • Organizacional: as organizações podem atuar como garantes para os leitores profissionais.

    • Profissional: os leitores profissionais podem estar ligados a leitores organizacionais.

    • Estatístico: este tipo de leitor é utilizado estritamente para fins estatísticos, como por exemplo a utilização de exemplares nas instalações da biblioteca.

    • Este campo é obrigatório para guardar a categoria de utilizador. Se for deixado em branco, será apresentada uma mensagem de erro.

  • Pode ter fiador: se os leitores desta categoria puderem ter fiadores, selecione sim. Isto fará com que as secções “Fiador (leitor)” e “Fiador (não leitor)” apareçam no formulário do leitor.

  • Limitações da biblioteca: se necessário, restrinja esta categoria a apenas algumas bibliotecas do seu sistema. Selecione “Todas as bibliotecas” se alguma biblioteca puder utilizar esta categoria.

    Dica

    Para selecionar mais do que uma biblioteca, mantenha a tecla “Ctrl” premida ao fazer a seleção.

  • Redefinição de palavra-passe no OPAC: determine se os leitores desta categoria têm permissão para redefinir as suas palavras-passe através da função “Esqueci-me da palavra-passe” do OPAC. Por omissão, será aplicada a regra definida na preferência de sistema OpacResetPassword.

    • Seguir a preferência de sistema OpacResetPassword.

    • Permitido: os leitores desta categoria poderão redefinir a sua palavra-passe através do OPAC, independentemente da configuração em OpacResetPassword.

    • Não permitido: os leitores desta categoria não poderão redefinir a sua palavra-passe através do OPAC, independentemente da configuração em OpacResetPassword.

  • Alteração de palavra-passe no OPAC: determine se os leitores desta categoria têm permissão para alterar as suas palavras-passe através do OPAC. Por omissão, será aplicada a regra definida na preferência de sistema OpacPasswordChange.

    • Seguir a preferência do sistema OpacPasswordChange.

    • Permitido: os leitores desta categoria poderão alterar a sua palavra-passe através do OPAC, independentemente da configuração em OpacPasswordChange.

    • Não permitido: os leitores desta categoria não poderão alterar a sua palavra-passe através do OPAC, independentemente da configuração em OpacPasswordChange.

  • Comprimento mínimo da palavra-passe: Introduza o comprimento mínimo da palavra-passe para os leitores desta categoria. Deixe em branco para utilizar o comprimento por omissão definido na preferência de sistema minPasswordLength.

  • Exigir palavra-passe forte: decida se pretende aplicar uma política de palavra-passe forte (pelo menos uma letra maiúscula, uma letra minúscula e um dígito) para os leitores desta categoria. Por omissão, será seguida a regra definida na preferência de sistema RequireStrongPassword.

    • Seguir a preferência do sistema RequireStrongPassword.

    • Sim: os leitores desta categoria terão de ter uma palavra-passe forte, independentemente da configuração em RequireStrongPassword.

    • Não: os leitores desta categoria não serão obrigados a ter uma palavra-passe forte, independentemente da configuração em RequireStrongPassword.

  • Forçar redefinição da palavra-passe do utilizador: escolha se os leitores desta categoria criados pela equipa serão obrigados a alterar a palavra-passe após o primeiro acesso ao OPAC.

    • Seguir a preferência do sistema ForcePasswordResetWhenSetByStaff

    • Forçar: os leitores desta categoria serão obrigados a alterar a sua palavra-passe quando iniciarem sessão no OPAC pela primeira vez, independentemente da configuração em ForcePasswordResetWhenSetByStaff

    • Não forçar: os leitores desta categoria não serão obrigados a alterar a sua palavra-passe quando iniciarem sessão no OPAC pela primeira vez, independentemente da configuração em ForcePasswordResetWhenSetByStaff

    Nota

    Isto aplica-se apenas aos leitores cuja conta foi criada manualmente por membros da equipa (ao contrário dos leitores que realizaram o seu próprio registo).

    Versão

    Esta configuração foi adicionada ao Koha na versão 24.11.

  • Bloquear ações de leitores expirados no OPAC: determine se os leitores desta categoria estão impedidos de realizar ações no OPAC caso as suas contas estejam expiradas. Por omissão, será aplicada a regra definida na preferência de sistema BlockExpiredPatronOpacActions.

    Nota

    Esta configuração substitui o que está definido na preferência de sistema BlockExpiredPatronOpacActions.

    Aviso

    Antes da versão 24.11 do Koha, esta definição é uma simples opção de ativar/desativar, sendo que todas as ações são bloqueadas se estiver ativada.

  • Verificar empréstimos anteriores: se a preferência de sistema CheckPrevCheckout estiver definida como uma das opções “A menos que seja substituído pela categoria de utilizador”, pode definir o valor para essa categoria de leitor específica aqui.

    • Sim, e tente sobrepor as preferências de sistema: o Koha irá verificar se o leitor já requisitou este exemplar, a menos que as definições pessoais do leitor o impeçam.

    • Não tente sobre as preferências de sistema: o Koha não vai verificar se o leitor já requisitou o exemplar, a menos que as definições pessoais do utilizador o permitam.

    • Herdar das preferências de sistema: será seguida a configuração da preferência de sistema CheckPrevCheckout.

  • Permitir empréstimo interbibliotecas (ILL) no OPAC: se a preferência de sistema ILLModule estiver ativada, esta configuração determina se os leitores desta categoria podem fazer pedidos de empréstimo interbibliotecas a partir do OPAC.

  • Privacidade predefinida: escolha as definições de privacidade predefinidas para os leitores desta categoria.

    • Omissão: o histórico de empréstimos será mantido indefinidamente, até que o script batch_anonymize.pl seja executado ou que seja realizada uma anonimização em lote manual.

    • Nunca: o histórico de empréstimos é anonimizado após a devolução. As estatísticas são mantidas, mas o vínculo entre o empréstimo, o exemplar e o leitor é removido.

    • Para sempre: o histórico de empréstimos nunca é anonimizado para os leitores desta categoria, independentemente das rotinas ou da anonimização manual.

    • Esta configuração pode ser editada pelo leitor via OPAC, caso o permita através da preferência de sistema OPACPrivacy.

  • Excluir da prioridade de reservas locais: escolha se as reservas para os leitores desta categoria recebem prioridade.

    • Sim: as reservas dos leitores desta categoria não recebem prioridade especial, independentemente da configuração em LocalHoldsPriority.

    • Não: os pedidos de reserva para leitores desta categoria estão sujeitos à configuração em LocalHoldsPriority.

  • Limite de multa para empréstimos: impede os leitores desta categoria de realizar empréstimos de artigos caso tenham débitos superiores ao valor especificado.

    • Se este campo for deixado em branco ou estiver definido para 0, o valor da preferência de sistema noissuescharge será utilizado para os leitores desta categoria.

    • Se este campo contiver um valor, irá sobrescrever o valor definido na preferência de sistema noissuescharge para os leitores desta categoria.

    Versão

    Esta configuração foi adicionada ao Koha na versão 24.11.

  • Guarantees checkout charge limit: prevent patrons from this category from checking out items if their guarantees collectively owe more than the specified amount.

    • Se este campo for deixado em branco ou estiver definido para 0, será utilizado o valor da preferência de sistema NoIssuesChargeGuarantees para os leitores desta categoria.

    • Se este campo contiver um valor, irá sobrescrever o valor definido na preferência do sistema NoIssuesChargeGuarantees para os leitores desta categoria.

    Versão

    Esta configuração foi adicionada ao Koha na versão 24.11.

  • Guarantors with guarantees checkout charge limit: prevent patrons from this category from checking out items if the patron has guarantors and those guarantors” guarantees collectively owe more than the specified amount.

    Versão

    Esta configuração foi adicionada ao Koha na versão 24.11.

  • Preferências de mensagens por omissão para esta categoria: atribuir preferências avançadas de mensagens por omissão para a categoria de leitor

    • Estas preferências padrão podem ser alteradas individualmente para cada leitor. Esta configuração serve apenas como omissão para facilitar a definição das mensagens ao registar novos leitores.

    Nota

    Isto requer que a preferência do sistema EnhancedMessagingPreferences esteja definida como “Permitir”.

    Aviso

    Estas definições padrão serão aplicadas apenas aos novos leitores adicionados ao sistema. Não alterarão as preferências dos leitores já existentes.

    Se necessitar de aplicar as preferências padrão aos leitores existentes, pode forçar estas alterações executando o script borrowers-force-messaging-defaults, localizado na pasta misc/maintenance. Solicite assistência ao administrador do sistema para o utilizar.

Regras de empréstimo e multas

Estas regras definem como os seus exemplares circulam, como e quando as multas são calculadas e como as reservas são geridas.

  • Acesso: Mais > Administração > Leitores e circulação > Regras de circulação e multas

Nota

Apenas os colaboradores com a permissão manage_circ_rules (ou superbibliotecários) terão acesso a esta secção.

As regras são aplicadas do mais específico para o menos específico, utilizando-se o primeiro encontrado na seguinte ordem:

  • mesma biblioteca, mesma categoria de leitor, mesmo tipo de documento

  • mesma biblioteca, mesma categoria de leitor, todos os tipos de documento

  • mesma biblioteca, todas as categorias de leitor, mesmo tipo de documento

  • mesma biblioteca, todas as categorias de leitor, todos os tipos de documento

  • omissão (todas as bibliotecas), mesma categoria de leitor, mesmo tipo de documento

  • omissão (todas as bibliotecas), mesma categoria de leitor, todos os tipos de documento

  • omissão (todas as bibliotecas), todas as categorias de leitor, mesmo tipo de documento

  • omissão (todas as bibliotecas), todas as categorias de leitor, todos os tipos de documento

O CircControl e o HomeOrHoldingBranch também entram em jogo ao determinar qual a regra de circulação que deve ser seguida.

  • Se CircControl estiver definido como «a biblioteca em que está ligado», as regras de circulação serão seleccionadas com base na biblioteca em que está ligado

  • Se CircControl estiver definido como «a biblioteca do leitor», as regras de circulação serão selecionadas com base na biblioteca do leitor

  • Se CircControl estiver definido como «a biblioteca de origem do exemplar», as regras de circulação serão selecionadas com base na biblioteca do exemplar, sendo que HomeOrHoldingBranch determina se será utilizada a biblioteca de origem ou a biblioteca onde o exemplar se encontra atualmente.

  • Se IndependentBranches estiver definido para “Sim”, o valor de HomeOrHoldingBranch será utilizado para determinar se o exemplar pode ser emprestado. Se a biblioteca de origem do exemplar não corresponder à biblioteca em que o utilizador está ligado, o exemplar não poderá ser emprestado, a menos que possua a permission de superbibliotecário.

    Importante

    No mínimo, terá de definir uma regra de circulação por omissão. Esta regra deve ser configurada para todos os tipos de documento, todas as bibliotecas e todas as categorias de leitor. Abrangerá todos os casos que não se enquadrem numa regra específica. Se, ao realizar um empréstimo, não existir uma regra que contemple todas as bibliotecas, tipos de documento e categorias de leitor, é possível que os utilizadores sejam impedidos de fazer reservas.

Definir regras de circulação

Utilizando a matriz de regras de empréstimo, pode definir regras que dependem de combinações de categoria de leitor e tipo de documento.

Nota

Como a matriz é muito larga, pode exportar as regras existentes nos formatos Microsoft Excel ou CSV para as analisar, utilizando o botão ‘Exportar’ no topo da tabela.

Para definir as suas regras, escolha uma biblioteca no menu suspenso (ou “Regras padrão para todas as bibliotecas”, caso pretenda aplicar estas regras a todas as bibliotecas):

Menu suspenso 'Selecionar uma biblioteca'

A partir da tabela pode escolher qualquer combinação de categorias de leitores e tipo de documentos aos quais deseja aplicar as regras

Tabela de regras de circulação

  • Primeiro escolha qual a categoria do leitor que deseja aplicar a regra. Senão é aplicada a todas as categorias

  • Escolha o tipo de documento ao qual pretende aplicar esta regra. Se mantiver a opção “Todos”, esta será aplicada a todos os tipos de documento para esta categoria de leitor.

    • Se um tipo de documento tiver um tipo de documento pai, a regra é apresentada como Pai -> Filho. O número de levantamentos atuais será limitado ao valor máximo do pai (incluindo os tipos irmãos) ou à regra do tipo específico, prevalecendo o menor dos dois valores.

      Tabela de regras de circulação com uma regra para DVDs, cujo limite é de 5 empréstimos, e uma regra para Blu-rays (subcategoria de DVD), cujo limite é de 2 empréstimos

      In the example above, there is a rule for the DVD item type with a maximum of 5 checkouts and a rule for Blu-ray, a child of DVD, with a maximum of 2 checkouts. A patron at this library will be able to check out a maximum of 2 Blu-rays in a total of 5 items of either DVD or Blu-ray types.

      To summarize, a patron at this library would be able to take either : - 0 Blu-ray and a maximum of 5 DVDs - 1 Blu-ray and a maximum of 4 DVDs - 2 Blu-ray and a maximum of 3 DVDs

  • Add notes about your circulation rule into the notes field. This can be helpful to remember why and when something was last changed.

  • Limit the number of items of this type a patron of this category can have checked out at the same time by entering a number in the “Current checkouts allowed” field.

  • If you’re allowing on-site checkouts then you may also want to set a limit on the number of items of this type patrons of this category can have on-site.

  • Define the period of time an item of this type can be checked out to a patron of this category by entering the number of units (days or hours) in the “Loan period” box.

  • Define if the loan period should include closed days or not in the “Days mode” column. The option chosen here will override the useDaysMode system preference for this particular rule.

    • The “Default” option will take the option defined in the useDaysMode system preference

    • Choose the “Calendar” option if you want to use the calendar to skip the days when the library is closed

    • Choose the “Datedue” option if you want to push the due date to the next open day

    • Choose the “Days” option if you want to ignore the calendar and calculate the due date directly

    • Choose the “Dayweek” option if you want to use the calendar to push the due date to the next open matching weekday for weekly loan periods, or the next open day otherwise

  • Choose which unit of time, days or hours, that the loan period and fines will be calculated in in the “Unit” column

    Nota

    If using “hours”, you can set library opening hours for each library and determine how the due time is calculated should it fall outside of opening hours.

  • You can also define a hard due date for a specific patron category and item type. The hard due date offers three options:

    • Exactly on: The due date of any item checked out with this rule will be set to the hard due date.

    • Before: Koha will calculate the normal loan period. If the calculated due date would be after or on the hard due date, the hard due date will be used instead.

    • After: Koha will calculate the normal loan period. If the calculated due date would be before the hard due date, the hard due date will be used instead.

  • “Fine amount” should have the amount you would like to charge for overdue items.

    Importante

    Enter only numbers and decimal points (no currency symbols).

  • Enter the “Fine charging interval” in the unit you set (ex. charge fines every 1 day, or every 2 hours). The finesCalendar system preference controls whether the days the library is closed will be taken into account or not.

  • “When to charge” is most handy in libraries that have a fine charging interval of more than 1 day.

    • End of interval: Given a grace period of 2 days and a fine interval of 7 days, the first fine will appear 7 days after the due date, it will always take one fine interval (7 days), before the first fine is charged.

    • Start of interval: Given a grace period of 2 days and a fine interval of 7 days, the first fine will appear 2 days after the due date and the second fine 7 days after the due date.

  • The “Fine grace period” is the period of time an item can be overdue before you start charging fines. The FinesIncludeGracePeriod system preference controls if the grace period will be included when calculating the fine or not.

    Importante

    This can only be set for the “Day” unit, not in “Hours”

  • The “Overdue fines cap” is the maximum fine per item for this patron and item type combination.

    Importante

    If this field is left blank then Koha will not put a limit on the fines this item will accrue. A maximum fine amount for all overdues can be set using the MaxFine system preference.

  • If you would like to prevent overcharging patrons for a lost items, you can check the box under “Cap fine at replacement price.” This will prevent the patron’s fines from going above the replacement price on the item.

    Nota

    If the “Overdue fines cap” is also set, the fine will be the lesser of the two, if both apply to the given overdue checkout.

  • If you charge patrons a fine when they don’t come to pick up their waiting holds in time (see below the number of days set in “Holds pickup period (day)”), enter the amount of the fine in “Expired hold charge”.

    If this field is left empty, the value in the ExpireReservesMaxPickUpDelayCharge system preference is used.

    Versão

    This option was added to Koha in version 25.05.

  • If your library “fines” patrons by suspending their account you can enter the number of days their fine should be suspended in the “Suspension in days” field.

    Importante

    This can only be set for the “Day” unit, not in “Hours”

  • You can also define the maximum number of days a patron will be suspended in the “Max suspension duration” setting

  • The “Suspension charging interval” option is just like the “Fin charging interval”. For example, you could “fine” a patron one day suspension for every two days overdue.

  • Next decide if the patron can renew this item type and if so, enter how many times they can renew it in the “Renewals allowed” box.

  • If you allow unseen renewals (see UnseenRenewals), enter how many “unseen” renewals patrons can make. This is not in addition to the regular renewals, but rather how many “unseen” renewals can be made among the total number of renewals.

  • If you’re allowing renewals you can control how long the renewal loan period will be (in the units you have chosen) in the “Renewal period” box.

  • If you’re allowing renewals you can control how soon before the due date patrons can renew their materials with the “No renewals before” box.

    • Items can be renewed at any time if this value is left blank. Otherwise items can only be renewed if the item is due after the number in units (days/hours) entered in this box.

    • To control this value on a more granular level please set the NoRenewalBeforePrecision preference.

  • If you enable automatic renewals (see below), enter how much time before the due date the automatic renewal takes place.

  • You can enable automatic renewals for certain items/patrons if you’d like. This will renew automatically following your circulation rules unless there is a hold on the item.

    Importante

    You will need to enable the automatic renewal cron job for this to work.

    Importante

    This feature needs to have the «no automatic renewal before» column filled in or it will auto renew every day after the due date.

  • If you are using automatic renewals, you can use the “No automatic renewals after” to limit the time a patron can have the item. For example: don’t allow automatic renewals after a checkout period of 80 days.

  • Similar to the hard due date setting, you can also stop automatic renewals after a specific date using the “No automatic renewal after (hard limit)” setting.

  • If patrons of this category can place holds on items of this type, enter the total numbers of items (of this type) that can be put on hold in the “Holds allowed” field.

    • Leave empty to have unlimited holds.

    • If you’d rather put a hold limit per patron category, independent of the item type, see the default checkout and hold policy by patron category section below.

    • If you want to have a hard hold limit, independent of patron category and item type, for this particular library, see the Default checkout, hold, and return policy section below.

    • If you want to have a hard hold limit, independent of patron category, item type, and across all libraries, see the maxreserves system preference.

  • You can also set a daily limit on the number of holds a patron can place.

  • While the two settings before limit the holds that can be placed across various records, the next setting is used to limit the number of holds that can be placed on one record at the same time. For example, for fiction books you might want to allow only one item to be placed on hold at the same time by the same user. But for serials where items represent different issues more than one hold at the same time is fine.

    Nota

    If this is set to a number that is greater than 1, but not Unlimited, then staff will have the option of placing multiple holds at once when placing a hold on the next available item in the staff interface

  • Next you can decide how the availability of items influences the ability to place a hold. The “On shelf holds allowed” option has three settings:

    • Yes: This will allow to place holds on items at all times. It doesn’t matter if they are available or checked out.

    • If any unavailable: This will allow to place a hold as soon as one or more items of the record are checked out. It doesn’t matter if there are still one or more items available on the shelf.

    • If all unavailable: This will allow to place a hold as soon as all items on the record are checked out that could fill the hold. This is especially useful for libraries that don’t offer the service of getting items placed on hold off the shelf for patrons.

  • Under “OPAC item level hold” you can decide if patrons are allowed to place item specific holds on the item type in question. The options are:

    • Allow: Will allow patrons the option to choose next available or a specific item.

    • Don’t allow: Will only allow patrons to choose next available item.

    • Force: Will only allow patrons to choose a specific item.

  • You can set the number of days patrons have to come pick up their holds in the “Holds pickup period (day)” column. This value will set the hold’s “expiration date”. After that period, holds will be marked as problematic and will appear in the “Holds waiting past their expiration date” tab in the Holds awaiting pickup report.

    • The default period is set in the ReservesMaxPickUpDelay system preference, but this column allows to have more granular rules for various library, patron category, and item type combinations.

  • Hold fee: if you charge for placing holds, enter the amount the patron should be charged per hold matching this rule.

    Versão

    This circulation rule option was first introduced in version 26.05 of Koha. In previous versions, hold fees are part of the patron categories settings.

  • If you want to allow patrons of this category to be able to place article requests on items of this type, choose an option in the “Article requests” column

    • No: patrons of this category will not be able to place article requests on items of this type

    • Yes: patrons of this category will be able to place article requests on items of this type, either on specific items (for example in the case of serial issues) or on entire records (for example in the case of monographs)

    • Record only: patrons of this category will be able to place article requests on records of this type, but not on specific items

    • Item only: patrons of this category will be able to place article requests on items of this type, but not on entire records

    Aviso

    This column will only appear if the ArticleRequests system preference is enabled.

    If you want to use the article request functionality you need to enable it using the ArticleRequests system preference and configure the form using the other related preferences.

  • If you charge a rental fee for the item type and want to give this specific patron category a discount on that fee, enter the percentage discount (without the % symbol) in the “Rental discount” field

    Nota

    Enter the discount percentage using a decimal point.

    Discounts must be a positive number with no more than two digits after the decimal. Whole numbers are also allowed. For example: 5, 10, 0.50, 3.25, 99.99.

    Values like 0.5, 25.123, or -10 are not accepted.

  • If the UseRecalls system preference is enabled, you will have several options to control recalls.

    • Recalls allowed (total): enter the number of current recalls a patron of this category can have on items or records of this item type.

    • Recalls per record (count): enter the number of current recalls a patron of this category can have on any one record of this item type.

    • On shelf recalls allowed: choose if patrons can recall items on records that have available items

      • If any unavailable: if a record has more than one item and at least one is unavailable, the patron will be able to recall items from this record

      • If all unavailable: all items of a record must be unavailable in order for a patron to recall an item from this record

    • Recall due date interval (day): enter the number of days a patron has to return an item that has been recalled

    • Recall overdue fine amount: enter the fine amount a patron will be charged if they don’t return the recalled item by the due date

    • Recall pickup period: enter the number of days a patron has to come pick up the item they have recalled, once it has been marked as awaiting pickup.

      Nota

      This value supersedes the value in the RecallsMaxPickUpDelay system preference.

When finished, click “Save” to save your changes. To modify a rule, simply click the “Edit” button either at the beginning or at the end of the row. The row of the rule being edited will be highlighted in yellow and the values will appear filled in at the bottom of the table. Edit the values at the bottom and click save.

Tabela de regras de circulação na qual a regra que está a ser editada está destacada e também aparece na parte inferior para edição

Nota

If, while editing a rule, you change either the patron category or the item type, it will create a new rule. You can do this to duplicate rules instead of creating new ones if the values are similar.

Alternatively, you can create a rule with the same patron category and item type and it will edit the existing one, as there can only be one rule per library- patron category-item type combination.

If you would like to delete your rule, click the “Delete” button at the beginning or at the end of the rule row.

To save time you can clone rules from one library to another by choosing the clone option above the rules matrix. Please note that this will overwrite all rules already configured for that library.

Menu suspenso 'Clonar estas regras para' junto à seleção da biblioteca

Depois de escolher você será presenteado com uma mensagem de confirmação.

Mensagem de confirmação que diz 'As regras foram clonadas.'

Default checkout, hold, and return policy

You can set a default maximum number of checkouts, a default maximum number of holds and a hold policy that will be used if none is defined below for a particular item type or category. This is the fall back rule for defaults.

Tabela de políticas de empréstimo, reserva e devolução na página de regras de circulação e multas.

From this menu you can set a default to apply to all item types and patrons in the library if no other option is set in the forms below.

  • Total current checkouts allowed: enter the total number of items patrons can have checked out at one time

  • Total current on-site checkouts allowed: enter the total number of items patrons can have checked out on site at a time (OnSiteCheckouts needs to be set to “Enable”)

  • Maximum total holds allowed (count): enter the total number of pending holds patrons can have at the same time.

  • Hold policy: control where patrons can place holds from

    • From any library: patrons from any library may put items on hold (default if none is defined)

    • From local hold group: only patrons from a library in the item home library’s local hold group may put this book on hold

    • From home library: only patrons from the item’s home library may put items on hold.

    • No holds allowed: no patron may put items on hold.

  • Hold and booking pickup library match: control where patron can pick up holds and bookings

    • qualquer biblioteca

    • item’s hold group

    • patron’s hold group

    • biblioteca de origem do exemplar

    • biblioteca de empréstimo do exemplar

  • Booking pre-processing (days): enter a number of days to prevent a new booking from starting too soon after an existing booking ends. This gives staff time to prepare the item between two bookings.

    Versão

    Esta opção foi adicionada ao Koha na versão 24.11.

  • Booking post-processing (days): enter a number of days to prevent a new booking from ending too close to the start of an existing booking. This gives staff time to receive and process the item between two bookings.

    Versão

    Esta opção foi adicionada ao Koha na versão 24.11.

  • Return policy: control where the item returns to once it is checked in

    • Exemplar retorna à origem

    • Exemplar retorna à biblioteca de empréstimo

    • Item floats: when an item floats, it stays where it was checked in and does not ever return “home”

    • Item floats by library group: The item will not be transferred and will stay at the library it was checked in at, if the check-in library is within the same “float group” in library groups as the item’s home library. If the library is not in the same float group, the item will be transferred back to its home library.

Once your policy is set, you can unset it by clicking the “Unset” button to the right of the rule.

Default checkout and hold policy by patron category

For this library, you can specify the maximum number of checkouts, on-site checkouts and holds that a patron of a given category can have, regardless of the item type.

image162

Nota

If the total amount of checkouts, on-site checkout and holds for a given patron category is left blank, no limit applies, except possibly for a limit you define in the circulation rules above.

For example, if you have a rule in the matrix that says Board patrons are allowed 10 books and 5 DVDs but you want to make it so that Board patrons only have a total of 12 things checked out at once. If you enter 12 here and the patron has 10 books out already they will only be allowed 2 DVDs to equal the 12 total they’re allowed.

Default waiting hold cancellation policy

For this library, you can specify if patrons can cancel holds that are already awaiting pickup.

Formulário da política de cancelamento de reservas em espera na página de regras de circulação e multas

For each patron category and item type combination, choose if these patrons can cancel holds that are already waiting for pickup.

Just like the circulation rules, the more specific rules will apply before the more generic rules (i.e. the «all» patron categories / «all» item types rule will apply only if no other rule exists for this combination).

Default open article requests limit

If ArticleRequests is enabled, you can set a maximum number of open article requests a patron of a category can have at one time.

Limite padrão de pedidos de artigos em aberto por categoria de leitor no formulário da página de regras de circulação e multas

Nota

This will only appear if the ArticleRequests system preference is enabled.

  • Choose the patron category you want to limit.

  • Enter the number of open article requests a patron of this category can have at one given time

  • Click “Add”

Default article request fees

If ArticleRequests is enabled, you can set the fee a patron from a given category (or any category) needs to pay in order to request the article.

Formulário de taxa padrão de pedido de artigos por categoria de leitor na página de regras de circulação e multas

Nota

This will only appear if the ArticleRequests system preference is enabled.

  • Choose the patron category for which you want to add a fee, or choose “All” to set an overall fee for all patrons

    Nota

    The fee specific to a patron category will supersede the fee for all categories.

    For example, if you set a fee for all categories to 2$ and a fee for Faculty to 3$, Faculty members will be charged 3$ and any other patron will be charged 2$.

  • Enter the fee amount (use a period as the decimal and don’t enter any symbols, e.g. enter 5.00 for 5$)

  • Click “Add”

The fee is charged to the patron when the request is placed.

When placing the request, either through the staff interface or the OPAC, a message appears to inform the staff member or the patron that the patron will be charged for every request and the amount of the fee.

Política por omissão para reembolso de devoluções de exemplares perdidos

Here, you can specify the default policy for lost item fees on return.

Política padrão de reembolso da taxa de artigos perdidos mediante devolução, com opções para definir a política de reembolso tanto para a taxa de substituição como para a taxa de processamento

  • Refund lost item replacement fee: choose whether or not the item’s replacement cost is refunded when the lost item is returned.

    • Refund lost item charge: the replacement cost is refunded. This might create a credit to be paid out to the patron if they had already paid the fee.

    • Refund lost item charge (only if unpaid): the replacement cost is refunded only if it hasn’t yet been paid.

    • Refund lost item charge and charge new overdue fine: the replacement cost is refunded and overdue fines are calculated as of today.

    • Refund lost item charge and restore overdue fine: the replacement cost is refunded and fines are restored as of the day the item was declared lost.

    • Leave lost item charge: the replacement cost stays in the patron’s account.

  • Refund lost item processing fee: choose whether or not the item’s processing fee is refunded when the lost item is returned.

    • Refund lost item processing charge: the processing fee is refunded. This might create a credit to be paid out to the patron if they had already paid the fee.

    • Refund lost item processing charge (only if unpaid): the processing fee is refunded only if it hasn’t yet been paid.

    • Leave lost item processing charge: the processing fee stays in the patron’s account.

This policy will apply to this library. This rule is to be used with the RefundLostOnReturnControl system preference.

Nota

You can limit refunds based on age:

Default holds and bookings policies by item type

You can set and edit holds and bookings policies for a given item type, regardless of the patron’s category.

  1. Select the item type from the dropdown menu.

  2. Set policies as explained below.

  3. Click “Add” to save this rule.

  4. Add as many rules as you need.

Secção de políticas padrão de reservas e pedidos por tipo de artigo nas regras de circulação

  • Hold policy: the various hold policies have the following effects.

    • From any library: patrons from any library may put this item on hold. (default if none is defined)

    • From local hold group: only patrons from libraries in the same item’s home library hold groups may put this book on hold.

    • From home library: only patrons from the item’s home library may put this book on hold.

    • No holds allowed: no patron may put this book on hold.

If the system preference AllowHoldPolicyOverride is set to “allow”, these hold policies can be overridden by staff.

Nota

The hold policies are applied based on the ReservesControlBranch system preference.

  • Hold and booking pickup library match: control where a patron can collect holds and bookings of the specified item type.

    • qualquer biblioteca

    • item’s hold group

    • patron’s hold group

    • biblioteca de origem do exemplar

    • biblioteca de empréstimo do exemplar

  • Booking pre-processing (days): add a buffer period before a new booking, to give staff time to prepare the item in-between two bookings.

    • Enter a number of days. This will prevent a new booking from starting too soon after an existing booking ends.

  • Booking post-processing (days): add a buffer period after a new booking, to give staff time to receive the item in-between two bookings.

    • Enter a number of days. This will prevent a new booking from ending too close to the start of an existing booking.

  • Return policy: the various return policies have the following effects.

    • Item returns home: on check-in at another library, the librarian will be prompted to transfer the item to its home library.

    • Item returns to issuing branch: on check-in, the librarian will be prompted to transfer the item to the library where it was checked out.

    • Item floats: the item will not be transferred from the library it was checked in at. It will remain at the check-in library until transferred manually or checked in at another library.

    • Item floats by library group: the item will not be transferred and will stay at the library it was checked in at, if the check-in library is within the same “float group” in library groups as the item’s home library. If the library is not in the same float group, the item will be transferred back to its home library.

      • When return policy is set to “item floats by library group” the item’s homebranch will be used to find groups.

Nota

The library whose return policy is used is determined by the CircControlReturnsBranch system preference.

Example

You may allow holds in your library service generally. However, you do not want brand new stock in the “New items” item type to be reserved by patrons at libraries other than the one to which the new stock belongs.

For the “New items” item type, you will set the “Hold policy” to “From home library” so that those items can only be placed on hold if the items” owning library and the patron’s home library are the same. You can set “Hold and booking pickup library match” to “item’s home library” to ensure the items on hold can only be collected from their home library. You should also set “Return policy” to “item returns home”.

Tipos de atributos de leitor

  • Get there: More > Administration > Patrons and circulation > Patron attribute types

Nota

Only staff with the manage_patron_attributes permission (or the superlibrarian permission) will have access to this section.

Patron attributes can be used to define custom fields to associate with your patron records. In order to enable the use of custom fields you need to set the ExtendedPatronAttributes system preference.

Um uso comum para este campo será o identificador do aluno ou o número/identificador da carta de condução.

Tabela de todos os tipos de atributos de leitor já configurados

Adding patron attribute types

To add a new patron attribute type, click the “New patron attribute type” button at the top of the page

Formulário de novo tipo de atributo de leitor

  • Patron attribute type code: enter a short code to identify this field

    Aviso

    This setting cannot be changed after an attribute is defined

  • Description: enter a longer (plain text) explanation of what this field will contain

  • Repeatable: check this box if a patron record can have multiple values of this attribute.

    Aviso

    This setting cannot be changed after an attribute is defined

  • Unique identifier: check this box if a value is given to a patron record, the same value cannot be given to a different record.

    Aviso

    This setting cannot be changed after an attribute is defined

  • Is a date: check this box if the attribute value should be a date. A date picker will be available.

    Importante

    Date attribute types cannot be linked to authorized value categories.

    Versão

    The date option was added to Koha in version 24.05.

  • Display in OPAC: check this box to display this attribute on a patron’s details page in the OPAC.

  • Editable in OPAC: check this box to enable patrons to edit this information in the OPAC.

  • Searchable: check this box to make this attribute searchable in the staff interface’s patron search.

  • Search by default: check this box to make this attribute searchable in the staff interface’s “standard” patron search, i.e., not a search on a particular field.

    • This option requires that the attribute type be searchable (see previous option).

  • Mandatory: check this box if the attribute must be filled for every patron

  • Display in patron’s brief information: check this box to make this attribute visible in the patron’s short detail display on the left of the checkout screen and other patron pages

    A apresentação resumida das informações do leitor, à esquerda da ficha do utilizador, inclui uma linha adicional com o número do funcionário

  • Authorized value category: if one is selected, the patron record input page will only allow values to be chosen from the authorized value list.

    Aviso

    An authorized value list is not enforced during batch patron import.

  • Library limitations: if you would like this attribute to only be used by specific branches you can choose those branches from this list. Choose “All branches” to show it for all libraries.

    Aviso

    Patrons with attributes already set for them will not be altered. The branch limitation only limits the field based on the library at which the current staff is logged in.

    If an attribute is set for a patron, it will be displayed in their file to all staff. However, only staff from the selected branches will be able to edit it.

  • Category: if you’d like to only show this attribute on patrons of one type choose that patron category here

  • Class: if you have a lot of attributes it might be handy to group them so that you can easily find them for editing. If you create an authorized value for PA_CLASS it will show in the “Class” drop-down menu and you can then change your attributes page to have sections of attributes

    Tabelas de todos os tipos de atributos de leitor já configurados, divididas em duas tabelas: 'Tipos não classificados' e 'Identificador adicional'

Click “Save” to save your new attribute.

Once added, your attribute will appear on the list of attributes and also on the patron record add/edit form

Secção 'Atributos adicionais' do formulário de leitor, existe um atributo denominado 'Departamento' com um menu suspenso e um subtítulo 'ID adicional', com outro atributo denominado 'N.º de funcionário'

Editing/deleting patron attribute types

Each patron attribute has an edit and a delete button beside it on the list of attributes.

Tabela de todos os tipos de atributos de leitor já configurados

Alguns campos no atributo não podem ser editados após a criação:

  • Código do tipo de atributo de leitor

  • Repetível

  • Identificador único

Não poderá remover um atributo se estiver em uso.

Mensagem a informar 'Não foi possível eliminar o tipo de atributo de leitor "STAFFID" — está a ser utilizado por 1 registo de leitor'

Limites da biblioteca

Limitar a opção de transferir itens entre as biblioteca através da biblioteca de origem, a biblioteca de destino e o tipo de documento envolvido.

  • Get there: More > Administration > Patrons and circulation > Library transfer limits

Nota

Only staff with the manage_transfers permission (or the superlibrarian permission) will have access to this section.

These rules only go into effect if the preference UseBranchTransferLimits is set to “enforce”.

Antes de começar defina a biblioteca para a qual deseja definir os limites.

image171

Transfer limits are set based on the collections codes you have applied via the Authorized values administration area.

image172

Collection codes will appear as tabs above the checkboxes:

image173

Check the boxes for the libraries you allow your items to be transferred to for the collection code you have selected at the top (in the example below - FIC)

image174

In the above example, Centerville library will allow patrons from all libraries except Liberty and Franklin to request items from their branch.

Tabela de custos de transporte

The transport cost matrix lets a library system define relative costs to transport books to one another.

Nota

Only staff with the manage_transfers permission (or the superlibrarian permission) will have access to this section.

In order for the system to use this matrix you must first set the UseTransportCostMatrix preference to “Use”.

Importante

The transport cost matrix takes precedence in controlling where holds are filled from, if the matrix is not used then Koha checks the StaticHoldsQueueWeight.

Custos são valores decimais entre um valor máximo arbitrário (ex. 1 ou 100) e 0 que o custo mínimo (sem custo). Por exemplo, pode usar a diferença entre cada biblioteca em milhas como o seu “custo”, se isso reflectir com precisão o custo de transferência. Talvez os correios sejam uma melhor medida. Bibliotecas compartilhando uma estação de correios teriam um custo de 1, correios adjacentes teria um custo de 2, etc

Para inserir os custos de transporte clique na célula que deseja alterar, desmarque a caixa “Desactivo” e insira o “custo”

image175

Após inserir o custo, pressione o botão Enter do seu teclado ou clique no botão “Guardar” no fundo da tabela para guardar as alterações.

Nota

A NULL value will make no difference where the From and To libraries are the same library. However, as a best practice, you should put a 0 in there. For all other To/From combinations, a NULL value will cause that relationship to act as if it has been disabled. So, in summary, don’t leave any of the values empty. It’s best to always put a number in there ( even if you choose to disable that given To/From option ).

Avisos de empréstimo

As bibliotecas podem decidir se desejam que os seus leitores sejam notificados automaticamente nos eventos de circulação (empréstimos e devoluções).

  • Get there: More > Administration > Patrons and circulation > Item circulation alerts

Nota

Only staff with the manage_item_circ_alerts permission (or the superlibrarian permission) will have access to this section.

These preferences are set based on patron types and item types.

Importante

These preference can be overridden by changes in the individual patron’s messaging preferences.

Para definir os avisos de empréstimo:

  • Choose your library from the pull down at the top of the screen

    image176

    • Para definir as preferências para todas as bibliotecas, mantenha o menu definido para “Omissão”

  • By default all item types and all patrons are notified of check ins and check outs. To change this, click on the item/patron type combo that you would like to stop notices for.

    image177

    • In the above example, Juveniles and Kids will not receive check out notices.

Cidades

Para uniformizar a introdução de leitor pode definir cidades, para que quando criar novo leitores simplesmente seleccione a cidade da lista em vez de ter que introduzir a cidade e o código postal.

  • Get there: More > Administration > Patrons and circulation > Cities and towns

Nota

Only staff with the manage_cities permission (or the superlibrarian permission) will have access to this section.

Adding a city

To add a new city, click the “New city” button at the top of the page and enter the city name, state, zip/postal code and country.

image178

One you click Submit, your city will be saved and will be listed on the Cities and towns page

image179

Cidades pode ser editadas e eliminadas a qualquer altura.

Viewing cities on patron add form

If you have defined local cities using the “New city” form, then when adding or editing a patron record you will see those cities in a pull down menu to make city selection easy.

image180

Isto permitirá uma inserção mais fácil de cidades nos registos de leitores sem risco de inserção de cidades ou códigos postais incorrectos.

Curbside pickup

The curbside pickup feature is used to set up appointments with patrons for them to pick up their holds. This section is used to configure the pickup windows

  • Get there: More > Administration > Patrons and circulation > Curbside pickup

Nota

In order to use this module, you must enable it with the CurbsidePickup system preference.

Nota

Only staff with the manage_curbside_pickups permission (or the superlibrarian permission) will have access to this section.

Setting up curbside pickup

  • From the configuration page, click the tab corresponding to the library for which you’re setting up curbside pickup

    Página de configuração de levantamento: existem separadores na parte superior da página para cada biblioteca do sistema, com um formulário por baixo

  • Preencher o formulário

    • Enable: check this box to enable curbside pickup at this library

    • Pickup interval: enter the number of minutes each curbside pickup interaction will take

    • Maximum patrons per interval: enter the number of patrons who can pickup in the same interval

    • Patron-scheduled pickup: check this box if you want to allow patrons to set up their own curbside pickup appointment through the OPAC

    • Enable for waiting holds only: check this box if curbside pickup should be limited to patrons who have holds awaiting pickup

  • Create curbside pickup slots

    • For each slot, enter the day of the week, the starting and ending hours of the time slot in which patrons can come

      • these can be your opening hours, if you allow curbside pickup throughout the day, or specific time slots in which you allow patrons to come by

      • For the hours, the format must be XX:XX (numbers with a colon) and it must be in 24-hour format (e.g. 1 PM is 13:00)

    • Click “Add”

  • Click “Save configuration”

Do this for every library that offers curbside pickup.

Patron restriction types

If you are using patron restriction types, you can manage the restriction types available from here.

Patron restriction types are enabled by the PatronRestrictionTypes system preference.

  • Get there: More > Administration > Patrons and circulation > Patron restriction types

Página de administração de tipos de restrição de utilizador antes de adicionar um novo tipo de restrição; tabela com os tipos de restrição, em que cada tipo tem um botão de ação Editar

Nota

Only staff with the manage_patron_restrictions permission (or the superlibrarian permission) will have access to this section.

Adding a restriction type

To add a new restriction type, click the “New restriction type” button at the top of the page.

Formulário de novo tipo de restrição de leitor

  • Code: enter a code for the restriction. Codes are limited to 50 characters and should not contain spaces, diacritics, or special characters.

  • Label: enter the label for the restriction. The label will be the one displayed throughout Koha.

  • Lift after payment: if set to “Yes”, restrictions using this type will be automatically lifted after payments equal to or exceeding the amount defined in “Fee Limit”.

  • Fee Limit: enter the amount that must be paid in order to lift a restriction of this type. This field is only used if “Lift after payment” is set to “Yes”.

Once you click “Save”, your restriction type will be saved and will be listed in the table of restriction types.

Página de administração de tipos de restrição de utilizador; tabela exibindo os tipos de restrição após a inclusão de um novo tipo. Cada tipo possui um botão de ação Editar, e os tipos adicionados manualmente contam também com botões para Apagar e Definir como predefinição

Locally created restriction types can be set to set as the default restriction type to use when manually adding a restriction to a patron account. This can be achieved using the “Make default” button.

You can also delete any locally created restriction types using the “Delete” so long as they have not been assigned as the default.

Contabilidade

  • Acesso: Mais > Administração > Contabilidade

This section deals with the parameters used in managing the patron accounts.

Debit types

  • Get there: More > Administration > Accounting > Debit types

Nota

Only staff with the manage_accounts permission (or the superlibrarian permission) will have access to this section.

This is where you define the manual fees you can charge patrons.

Tabela que mostra os tipos de débito (tipos de débito do sistema filtrados)

When you first get to the page, you will only see the manual fees that are already defined in your system.

You can see the default system fees by clicking «Show all debit types».

Tabela que mostra todos os tipos de débito, incluindo os tipos de débito do sistema

You can go back to seeing only the manual fees by clicking «Filter system debit types».

System debit types

Several debit types come installed with Koha. Most of them are automatic fees that are added according to the policies you set up elsewhere in Koha.

  • ACCOUNT (Account creation fee): this is charged to the patron’s account upon registration. The fee can be changed in the patron category settings under “Enrollment fee”.

  • ACCOUNT_RENEW (Account renewal fee): this is charged to the patron’s account when their account is renewed. Like the ACCOUNT debit type above, this can be changed in the patron category settings under “Enrollment fee”.

  • LOST (Lost item): this is charged to the patron’s account when an item in their file is declared lost. The amount depends on the item’s “replacement cost” field or on the item type’s default replacement cost. It can also be added manually in the manual invoices tab.

  • MANUAL (Manual fee): this is the default manual fee installed with Koha. This is not charged automatically by Koha, but can be added to a patron’s account manually in the manual invoices tab.

  • NEW_CARD (New card fee): this is another default manual fee installed with Koha. This will not be charged automatically by Koha, but can be added to a patron’s account manually in the manual invoices tab.

  • OVERDUE (Overdue fine): this is charged automatically to the patron’s account when they have overdue items. The amount for overdue fines are set in the circulation and fines rules.

  • PAYOUT (Payment from library to patron): this is used when the library reimburses the patron (for an over payment for example).

  • PROCESSING (Lost item processing fee): this is charged automatically to the patron’s account when an item in their file is declared lost. The amount is set by item type under “Processing fee (when lost)”.

  • RENT (Rental fee): this is charged automatically to the patron’s account upon checkout if the item type has a rental charge.

  • RENT_DAILY (Daily rental fee): this is charged automatically to the patron’s account upon checkout if the item type has a daily rental charge.

  • RENT_DAILY_RENEW (Renewal of daily rental item): this is charged automatically to the patron’s account upon renewal if the item type has a daily rental charge.

  • RENT_RENEW (Renewal of rental item): this is charged automatically to the patron’s account upon renewal if the item type has a rental charge.

  • RESERVE (Hold fee): this is charged automatically to the patron’s account upon placing a hold. The amount depends on the “Hold fee” amount in the patron’s category settings.

  • RESERVE_EXPIRED (Hold waiting too long): this is charged automatically to the patron’s account if they haven’t picked up their hold after the number of days defined in the ExpireReservesMaxPickUpDelay system preference. The amount is set in the ExpireReservesMaxPickUpDelayCharge system preference.

Adding a new debit type

To add a new debit type:

  • Click “New debit type”

    Formulário de novo tipo de débito

    • Debit type code: enter a code (limited to 64 letters).

      Aviso

      Codes should be limited to letters, numbers, and underscores (_).

      Avoid spaces, diacritics, and special characters.

    • Default amount: enter the default amount.

      Nota

      Staff will be able to change this amount when adding the charge to the patron’s account, if necessary.

      Importante

      Do not enter currency symbols. Only write the amount with a decimal point (for example, 5 or 5.00 instead of $5).

    • Description: write a description, this description will be used in the drop-down menu when adding a new charge to a patron’s account or when making a sale in the point of sale as well as in their transaction history.

    • Can be manually invoiced: check this box if this debit type can be added manually by staff to a patron’s account via the manual invoices.

    • Can be sold: check this box if this debit type can be used in the point of sale.

    • Included in noissuescharge: check this box if this debit type should be included when calculating the amount owed by the patron for the noissuescharge system preference. This system preference is used to block checkouts when a patron owes over a certain amount of money to the library.

    • Libraries limitation: if necessary, select the libraries where this debit type can be used. Choosing “All libraries” will make the debit type available everywhere.

      Nota

      You can select more than one library by pressing the “Ctrl” key while selecting.

    • If you have any additional fields for account debit types (account_debit_types), they will be displayed here.

  • Clicar em “Guardar”

Editing an existing debit type

You can only modify the debit types you have added, as well as the “Manual fee”.

To edit a debit type:

  • Click the “Edit” button to the right of the debit type

  • Modify any field

  • Clicar em “Guardar”

Archiving a debit type

If there is a debit type you don’t need anymore, you can archive it.

Nota

There is no way to delete a debit type since they are used in the patron’s accounting section.

To archive a debit type, simply click the “Archive” button to the right of the debit type.

Restoring an archived debit type

If you need to use an archived debit type again, simply click on the “Restore” button to the right of the debit type.

This will make it available again.

Credit types

  • Get there: More > Administration > Accounting > Credit types

Nota

Only staff with the manage_accounts permission (or the superlibrarian permission) will have access to this section.

This is where you define the manual credits you can give patrons.

When you first get to the page, you will only see the credits that are already defined in your system.

You can see the default system credit types by clicking «Show all credit types».

Lista de todos os tipos de crédito, incluindo os tipos de crédito por omissão do sistema

You can go back to seeing only the manual credit types by clicking «Filter system credit types».

System credit types

Several credit types come installed with Koha. Most of them are automatic credits that are added according to the policies you set up elsewhere in Koha. They can not be deleted.

Adding a new credit type

To add a new credit type:

  • Click “New credit type”

    Formulário de novo tipo de crédito

    • Enter a code (limited to 64 letters)

      Aviso

      Codes should be limited to letters, numbers, and underscores (_).

      Avoid spaces, diacritics, and special characters.

    • Write a description

      This description will be used in the drop-down menu when adding a new credit to a patron’s account as well as in their transaction history

    • If this credit type can be added manually by staff to a patron’s account via the manual credit, check the “Can be added manually?” check box

    • If you need this credit type to be sequentially numbered, check the “Enable credit number”. The format of the number is defined in the AutoCreditNumber system preference.

    • If this credit type is only to be used in specific branches, you can select the libraries in “Libraries limitation”

      Nota

      You can select more than one library by pressing the “Ctrl” key while selecting.

    • If you have any additional fields for account credit types (account_credit_types), they will be displayed here.

    • Clicar em “Guardar”

Editing an existing credit type

You can only modify the credit types you have added.

To edit a credit type:

  • Click the “Edit” button to the right of the credit type

  • Modify any field

  • Clicar em “Guardar”

Archiving a credit type

If there is a credit type you don’t need anymore, you can archive it.

Nota

There is no way to delete a credit type since they are used in the patron’s accounting section.

To archive a credit type, simply click the “Archive” button to the right of the credit type.

Restoring an archived credit type

If you need to use an archived credit type again, simply click on the “Restore” button to the right of the credit type.

This will make it available again.

Cash registers

  • Get there: More > Administration > Accounting > Cash registers

This feature is enabled through the UseCashRegisters system preference.

Nota

Only staff with the manage_cash_registers permission (or the superlibrarian permission) will have access to this section.

If you have no cash registers already defined, you will be invited to create one.

Otherwise, you will see the list of all your cash registers.

Lista de caixas registradoras

In the “Actions” columns, you can choose to edit your cash registers, make one of them default or remove the default status, and archive or restore an archived register.

The default status is only useful in libraries that have more than one register per branch. The default register will be preselected when entering a payment. If there is only one cash register per branch, the branch’s cash register will be selected when paying.

Adding a new cash register

  • Click on “New cash register”

    Formulário de adição de nova caixa

  • Give your cash register a name

  • Optionally you can also add a description

  • Choose in which library this cash register is located

  • And finally, enter the initial float, i.e. the amount in the cash register

  • Click “Add”

Plugins

This section is used to manage all types of plugins.

Importante

Before using plugins, make sure that they are enabled in the configuration file.

Nota

Only staff with the manage permission, the configure permission, or the admin permission (or the superlibrarian permission) will see this section.

See also the tool plugins and report plugins sections.

  • Acesso: Mais > Administração > Plugins

If there are any administrative plugins installed, they will appear under this section.

Nota

Only staff with the admin permission (or the superlibrarian permission) will be able to use administrative plugins.

Managing plugins

This section is used to view, manage and configure all types of plugins.

Nota

Only staff with the manage permission (or the superlibrarian permission) will be able to install and uninstall plugins.

The page will show all currently installed plugins.

Página de administração de plugins exibindo uma tabela de todos os plugins atualmente instalados

If you have a lot of plugins, you can view a subset by clicking “View plugins by class”.

Ao clicar no botão 'Ver plugins por classe', as opções são: visualizar todos os plugins, visualizar plugins de relatórios, visualizar plugins de ferramentas, visualizar plugins de conversão MARC, visualizar plugins de pagamento online, visualizar plugins de melhoria de registos bibliográficos para a interface dos técnicos, visualizar plugins de disponibilidade de empréstimo interbibliotecas e visualizar plugins de backend de ILL

Installing a plugin

To install a new plugin manually,

  • Click “Upload plugin”.

    Página para fazer o carregamento de um plugin

  • Choose the KPZ file on your computer and click “Upload”.

If you configured external plugin repositories, you will have a search box at the top of the page to search these repositories and install directly from there without having to download and upload the KPZ file. To install a plugin from a repository,

  • Enter a search term in the search box.

    Resultados de pesquisa de plugins em repositórios externos

  • Click “Install” to the right of the plugin.

Some plugins might need to be enabled before usage.

To enable a plugin,

  • Click the “Actions” button to the right of the plugin and choose “Enable”

    Página de administração de plugins, ao clicar no botão Ações, as opções são: executar relatório, executar ferramenta, executar ferramenta de administração, configurar, desinstalar, ativar

Using a plugin

All plugins are different. Some might need configuration before usage, others are simply run.

  • Click the “Actions” button and choose “Configure” or “Run”.

  • Follow the instructions issued by the plugin’s creator.

Nota

Only staff with the configure permission (or the superlibrarian permission) will be able to access plugin configuration.

Disabling a plugin

If you need to temporarily stop the plugin from taking effect, you can disable it.

  • Click the “Actions” button to the right of the plugin and choose “Disable”

This will not uninstall the plugin. It will remain installed, but will not have any effect on your Koha installation.

Deleting a plugin

To delete or uninstall a plugin,

  • Click the “Actions” button to the right of the plugin and choose “Delete”

This will remove the plugin from your Koha installation. Any action or effect it had will stop. If you need to, you can reinstall it later, provided it is still available.

Jobs

This section is used to manage background jobs. Jobs are tasks that are queued in the system to be treated when the server has the resources to do it, such as batch record modification and others.

  • Get there: More > Administration > Jobs

Nota

Only staff with the manage_background_jobs permission (or the superlibrarian permission) will have access to this section.

Managing jobs

By default, when accessing the page, you will only see current jobs and jobs enqueued in the last hour.

Visualização predefinida da página de gestão de tarefas: as caixas de selecção na parte superior estão marcadas para apresentar apenas os trabalhos actuais e recentes, e a tabela está vazia

To see all jobs, uncheck the boxes at the top of the page.

  • Current jobs only: uncheck this to include finished jobs

  • Only include jobs enqueued in the last hour: uncheck this to include jobs enqueued earlier

You can search for jobs using the search boxes under the table headings.

To the right of each job, there are action buttons.

  • View: this will display the details of the job, including, but not limited to:

    Visualização detalhada de uma tarefa

    • Job ID: this is the identifier of the job in the Koha database, an incremental number

    • Status: the status of the job

      • New: the job has been queued

      • Cancelled: the job was canceled by a user

      • Finished: the job was successfully carried out

      • Started: the job was started, but it is not yet finished

      • Running: the job is currently being executed

      • Failed: the job was started, but failed for some reason

    • Progress: indicates how much of the job is done

    • Type: indicates the type of job

    • Queued: date and time when the job was queued

    • Started: date and time when the job was started

    • Ended: date and time when the job was finished

    • Report: this section will contain messages specific to the type of job (for example, number of records modified, in the case of batch record modification)

    • Detailed messages: this section will contain messages specific to the type of job (for example, which records were modified, in the case of batch record modification)

  • Cancel: for jobs that are still new or have started, it’s possible to cancel them

Catalog administration

Set these controls before you start cataloging on your Koha system.

  • Get there: More > Administration > Catalog

MARC bibliographic frameworks

Think of frameworks as templates for creating new bibliographic records. Koha comes with some predefined frameworks that can be edited or deleted, and librarians can create their own frameworks for content specific to their libraries.

  • Get there: More > Administration > Catalog > MARC bibliographic frameworks

Lista de modelos bibliográficos MARC

Nota

Only staff with the manage_marc_frameworks permission (or the superlibrarian permission) will have access to this section.

Importante

Do not delete or edit the Default framework since this will cause problems with your cataloging records - always create a new template based on the Default framework, or alter the other frameworks.

Adding a new framework

Para adicionar um novo modelo

  • Click “New framework”

    Formulário de nova estrutura bibliográfica MARC

    • Code: enter a code of 4 or fewer characters, avoiding spaces, diacritics, or other special characters.

    • Description: enter a more detailed definition of your framework, this is what will be displayed in Koha.

  • Clicar em “Submeter”

  • Once your framework is added click “Actions” to the right of it on the list of frameworks and choose “MARC structure”

    • You will be asked to choose a framework to base your new framework on, this will make it easier than starting from scratch

    Menu suspenso para escolher em que modelo existente basear o novo modelo

  • Once your framework appears on the screen you can edit or delete each field by following the instructions for editing fields and subfields

Editing existing frameworks

Clicking “Actions” and then “Edit” to the right of a framework will only allow you to edit the description for the framework.

Formulário para editar a descrição do modelo

Editing framework fields and subfields

Frameworks are made up of MARC fields (tags) and subfields. To make edits to the fields and subfields associated with the framework you must click on “Actions” and then “MARC structure”.

Importante

Whenever you make changes to the framework fields and subfields, make sure to run the MARC bibliographic framework test.

Editing a MARC field (tag)

After clicking on “MARC structure” you will be taken to a screen listing all the available tags for that framework and you can search for the tag you need. To make edits to a MARC field click on “Actions” on the right of the field and choose “Edit tag”.

Formulário para editar um campo MARC

The next screen shows details of the tag.

  • Tag: the MARC tag, or field number, is uneditable.

  • Label for lib: text that will show in the staff interface MARC view, and in the basic editor if the advancedMARCeditor system preference is set to display labels.

    Nota

    If you use XSLT (see the XSLTDetailsDisplay system preference), the labels for the “Normal” view are defined in the XSLT stylesheet.

    This will not affect the “Normal” view unless you don’t use XSLT.

  • Label for OPAC: text that will show on the MARC view in the OPAC.

    Nota

    If you use XSLT (see the OPACXSLTDetailsDisplay system preference), the labels for the “Normal” view are defined in the XSLT stylesheet.

    This will not affect the “Normal” view unless you don’t use XSLT.

  • Repeatable: when checked, the field will have an icon next to it in the basic editor, allowing you to add multiples of that tag.

  • Mandatory: when checked, the record cannot be saved unless the field has a value. In the basic editor, a “Required” flag will display as a prompt.

  • Important: when checked, the field will generate a warning if it is not filled, but unlike “Mandatory”, you will still be able to save your record nonetheless. In the basic editor, an “Important” flag will display as a prompt.

  • Indicator default values: add default values for indicators here so that they will be prefilled to save time when cataloging, but can still be edited if required.

  • Authorized value: define an authorized value pull down list for the catalogers

    Aviso

    The authorized value option at field level does not work.

Click “Save changes” to save any modification.

Editing a MARC subfield

To edit the subfields associated with the tag, click “Actions” then “Edit subfields” to the right of the tag on the framework field list. Each subfield has its own tab which contains three sections - Basic constraints, Advanced constraints and Other options.

Formulário de edição de subcampo

  • For each subfield you can set the following basic constraint options

    • Subfield code: this is the MARC subfield code, this wouldn’t normally be changed.

    • Text for librarian: text that will show in the staff interface MARC view, and in the basic editor if the advancedMARCeditor system preference is set to display labels.

      Nota

      If you use XSLT (see the XSLTDetailsDisplay system preference), the labels for the “Normal” view are defined in the XSLT stylesheet.

      This will not affect the “Normal” view unless you don’t use XSLT.

    • Text for OPAC: text that will show on the MARC view in the OPAC.

      Nota

      If left empty, the “Text for librarian” is used instead

      Nota

      If you use XSLT (see the OPACXSLTDetailsDisplay system preference), the labels for the “Normal” view are defined in the XSLT stylesheet.

      This will not affect the “Normal” view unless you don’t use XSLT.

    • Repeatable: when checked, the field will have an icon next to it in the basic editor, allowing you to add multiples of this subfield.

    • Mandatory: when checked, the record cannot be saved unless the subfield has a value. In the basic editor, a “Required” flag will display as a prompt.

    • Important: when checked, the field will generate a warning if it is not filled, but unlike “Mandatory”, you will still be able to save your record nonetheless. In the basic editor, an “Important” flag will display as a prompt.

    • Managed in tab: defines the tab where the subfield is shown.

      Importante

      All subfields of a given field must be in the same tab or ignored. Ignore means that the subfield is not managed.

      Aviso

      When importing records, or editing existing records, subfields that are managed in tab “ignore” will be deleted. If you still wish to keep the subfields, but hide them, use the “Visibility” options below.

  • For each subfield you can set the following advanced constraint options

    • Default value: defines what you want to appear in the field by default, this will be editable, but it saves time if you use the same text over and over or the same value in a field often.

      Nota

      There are several values that you can use here that will be replaced automatically when a new record is created:

      • <<MM>> - the current month, 2 digits

      • <<DD>> - the current day of month, 2 digits

      • <<YY>> - the current year, 2 digits

      • <<YYYY>> - the current year, 4 digits

      • <<USER>> - the username of the currently logged in user

      For example: a default of «<<MM>>/<<DD>>/<<YYYY>>» (without quotes) will print the current date in the form of «01/21/2021»

      Nota

      When those default values are filled depends on the ApplyFrameworkDefaults system preference.

    • Max length: enter a value here to limit the number of characters that can be entered in the subfield.

    • Visibility: allows you to select from where this subfield is visible or hidden. Check the boxes where you would like the field to show, and uncheck the boxes where you would like it hidden.

      • OPAC: when checked, this will make the subfield available for display in the OPAC. For non-XSLT views, the field will be displayed. For XSLT views, it will depend on the stylesheet.

      • Staff interface: when checked, this will make the subfield available for display in the staff interface. For non-XSLT views, the field will be displayed. For XSLT views, it will depend on the stylesheet.

      • Editor: when checked, this will make the subfield available for modification in the basic editor.

      • Collapsed: when checked, the subfield will be hidden in the basic editor, but will display when the field label is clicked to expand all subfields.

      • Flagged: when checked, the subfield will be unavailable and hidden from all views (equivalent to all boxes being unchecked).

    • Is a URL: if checked, it means that the subfield is a URL and can be clicked.

    • Link: if you enter an index name here, a link appears after the subfield in the MARC detail view in the staff interface. If the librarian clicks on the link, a catalog search is done using the index and the content of the subfield.

    • Koha link: this field is used to create a link between the MARC subfield and a column in the items, biblioitems, and biblio database tables. The mappings can be changed from the Koha to MARC mapping page.

  • For each subfield you can set the following Other option values

    • Authorized value: means the value must be chosen from a drop-down menu generated from the authorized value list.

      In the example below, the LANG authorized value category has been set to 041$a.

      Secção Outras opções do formulário de modificação de subcampos na estrutura bibliográfica MARC; o valor autorizado é LANG

      This creates a drop-down menu in the basic editor.

      Campo 041 do editor básico, o subcampo 041$a apresentava um menu suspenso de idiomas.

    • Thesaurus: means that the value is linked to the authority catalog of the selected category. Authority categories are managed in the Authority types section.

    • Plugin: means the value is calculated or managed by a cataloging plugin. Cataloging plugins, or value builders, can do almost anything.

      • Examples:

        • For call numbers there is an option to add a call number browser next to the call number subfield so that you can identify which call numbers are in use and which are not. Simply choose the cn_browser.pl plugin. Learn more in the cataloging section of this manual.

        • If you’d like to let file uploads via cataloging you can choose the upload.pl plugin and this will allow you to upload files to Koha to link to your records.

        • In UNIMARC there are plugins for every 1xx fields that are coded fields. The plugin is a huge help for cataloger! There are also two plugins (unimarc_plugin_210c and unimarc_plugin_225a that can «magically» find the editor from an ISBN, and the collection list for the editor)

        • If you would like to enable an autocomplete search for publishers in 260b and 264b you can set the plugin to marc21_field_260b.pl. When you start typing in a publisher name you will be given search results based on publisher names already in the catalog.

  • To save your changes, click “Save changes”.

Dica

You can drag and drop the subfield tabs to change the order in which they appear when cataloging with the basic editor.

By default, they will appear in alphanumeric order (0-9, then a-z).

Adding fields to frameworks

If a framework doesn’t contain a field that you require, you may need to add it. To add a field to a framework click the “New tag” button at the top of the framework definition.

Lista de campos na estrutura MARC padrão

Isto abrirá um formulário em branco para inserir os dados do campo MARC

Formulário para adicionar uma nova etiqueta MARC a uma estrutura bibliográfica MARC

Enter the field number for your new tag. The process for entering the remainder of the settings for the new tag is the same as those found in the editing fields and subfields in frameworks section of this manual.

When you’re finished, click “Save changes” and your new tag will be displayed in the framework field list.

You will need to add at least one subfield to your new tag before it will appear in your framework when you are cataloging.

Click on the “Actions” button for your new tag and then “Edit subfields”. Click on the “New” tab and enter your subfield code. The process for entering the remainder of the settings for the new subfield is the same as those found in the editing fields and subfields in frameworks section of this manual.

Importing and exporting frameworks

Junto a cada modelo existe um link para importar ou exportar o modelo.

Export framework

To export a framework, click the “Export” option in the “Actions” button to the right of the framework title.

Para o botão 'Ações' de uma estrutura MARC, as opções são: Estrutura MARC, Editar, Apagar, Exportar, Importar

Quanto clicar em “Exportar” o sistema vai perguntar qual o formato no qual deseja exportar o ficheiro.

Pedido para escolher o formato de exportação do modelo com as opções: exportar para uma folha de cálculo CSV ou exportar para o formato de folha de cálculo OpenDocument

Um modelo exportado desta forma pode ser importado noutra instalação do Koha usando a opção de importar modelo.

Import framework

An easy way to create a new framework is to import one created for your or another Koha installation. This framework would need to be exported from the other system using the instructions above to be available for import here.

To import a framework you first need to create a new framework. Once you have that framework, click “Actions” then “Import” to the right of the new framework.

Para o botão 'Ações' de uma estrutura MARC, as opções são: Estrutura MARC, Editar, Apagar, Exportar, Importar

Será pedido para escolher um ficheiro do seu computador a importar para o modelo.

Janela pop-up para selecionar o ficheiro a importar para uma estrutura MARC

Será pedido para confirmar as suas ações antes do ficheiro ser carregado.

Mensagem de aviso: Tem a certeza de que pretende substituir os campos e subcampos da estrutura da framework XXX? A estrutura existente será sobrescrita! Por segurança, recomenda-se a utilização da opção de exportação para realizar um backup antes.

As your file is uploaded, you will see a spinning icon to indicate that the system is working.

Janela pop-up para selecionar o ficheiro a importar para uma estrutura MARC; abaixo, existe um ícone de carregamento animado com o texto Importando para a estrutura

Once your import is complete you will be brought to the framework edit tool where you can make any changes you need to the framework you imported.

Ligações Koha => MARC

While Koha stores the entire MARC record, it also stores common fields for easy access in various tables in the database (mainly the items, biblioitems, and biblio tables). Koha to MARC mapping is used to tell Koha where to find these values in the MARC record. Whenever a record is added or changed, this mapping will be used to update the linked database column. The information from the database columns is used as a way to quickly look up important information without having to parse the full MARC record. It is used for displaying information in a lot of pages and can also be used in reports.

In many cases, you will not have to change the default values set at the time of the installation, but it is important to know that the tool is here and can be used at any time.

Aviso

If you change mappings after data has been added to your catalog, ask your system administrator to run misc/batchRebuildBiblioTables.pl. This will update the values in the database columns for all your records.

  • Get there: More > Administration > Catalog > Koha to MARC mapping

Nota

Only staff with the manage_marc_frameworks permission (or the superlibrarian permission) will have access to this section.

The table shows all the database fields that can be mapped to MARC fields.

Tabela de mapeamento do Koha para MARC, mostrando o campo da base de dados com a etiqueta MARC, o subcampo e o rótulo associados

To add a new mapping, click on the “Add” button to the right of the appropriate field.

Formulário para adicionar novo mapeamento

Write in the MARC field and subfield you would like to map, separated by a comma, to this Koha field (for example, «264,a») and click the “OK” button.

Nota

It is possible to link more than one MARC field to a database field. For example, you could link both 260$a and 264$a to the biblioitems.place field.

If you would like to clear the mapping for a database field, click the “Remove” button.

Nota

All changes are immediate. Records created or edited after the change will immediately have the new mappings. However, if you want to update the mappings for records already in the catalog, ask your system administrator to run misc/batchRebuildBiblioTables.pl. This will update the values in the database columns for all your records.

Teste do modelo bibliográfico MARC

The tool checks the MARC structure of bibliographic frameworks.

  • Get there: More > Administration > Catalog > MARC bibliographic framework test

Nota

Only staff with the manage_marc_frameworks permission (or the superlibrarian permission) will have access to this section.

If you change your MARC bibliographic framework, it’s recommended that you run this tool to test for errors in your definition.

Resultados do teste do modelo

Tipos de autoridade

Authority types are basically MARC frameworks for authority records and because of that they follow the same editing rules found in the MARC bibliographic frameworks section of this manual. Koha comes with many of the necessary authority frameworks already installed. To learn how to add and edit authority types, simply review the MARC bibliographic frameworks section of this manual.

  • Get there: More > Administration > Catalog > Authority types

Nota

Only staff with the manage_marc_frameworks permission (or the superlibrarian permission) will have access to this section.

Fontes de classificação

Source of classification or shelving scheme are mapped to field 952$2 and 942$2 in Koha’s MARC bibliographic frameworks and stored in the items.cn_source and biblioitems.cn_source fields in the database.

  • Get there: More > Administration > Catalog > Classification sources

Tabelas de fontes de classificação, regras de preenchimento de classificação e regras de separação de classificação

Nota

Only staff with the manage_classifications permission (or the superlibrarian permission) will have access to this section.

Commonly used classification sources are:

  • ddc - Dewey Decimal Classification

  • lcc - Library of Congress Classification

Se escolher instalar as fontes de classificação durante a instalação do Koha, verá outros valores também:

  • ANSCR (gravações de som)

  • Classificação SuDOC

  • Classificação Decimal Universal

  • Outra classificação (genérica)

Adding/editing classification sources

You can add your own source of classification by using the “New classification source” button. To edit use the “Edit” button.

Formulário para adicionar uma nova fonte de classificação

Quando criar ou editar:

  • Enter a code. The code is limited to 10 characters and must be unique.

Nota

The code is not editable once it has been created.

  • Enter a description. The description is used in the drop-down lists in the cataloging module.

  • Check the “Source in use?” checkbox if you want the value to appear in the drop-down list for this category.

  • Select the appropriate filing rule from the drop-down list.

  • Select the appropriate splitting rule from the drop-down list.

Classificação das regras de preenchimento

Filing rules determine the order in which items are placed on shelves. Filing rules normalize call numbers in order for Koha to be able to compare them and sort them in the right order.

For example, a Dewey call number such as “636.8/07 SHAW” will become “636_800000000000000_07_SHAW” in order to be sorted.

A cota classificada é guardada nos campos items.cn_sort ou biblioitems.cn_sort na base de dados

Values that are preconfigured in Koha are:

  • Dewey

  • LCC

  • Genérico

Filing rules are mapped to Classification sources. You can setup new filing rules by using the “New filing rule” button. To edit, use the “Edit” button.

Quando criar ou editar:

  • Enter a code. The code is limited to 10 characters and must be unique.

Nota

The code is not editable once it has been created.

  • Enter a description. The description is used in the drop-down list when creating or editing a classification source.

  • Escolha uma rotina de preenchimento apropriada - dewey, genérico ou lcc

    • The Dewey filing routine generates a sorted call number by following these rules:

      • Concatenates classification and item parts.

      • Converts to uppercase.

      • Removes any leading or trailing white spaces, and forward slashes (/)

      • Separates alphabetic prefix from the rest of the call number

      • Splits into tokens on white spaces and periods.

      • Leaves first digit group as is.

      • Converts second digit group to 15-digit long group, padded on right with zeroes.

      • Converts each whitespace to an underscore.

      • Removes any remaining non-alphabetical, non-numeric, non-underscore characters.

    • The generic filing routine generates a sorted call number by following these rules:

      • Concatenates classification and item parts.

      • Removes any leading or trailing white spaces.

      • Converts each whitespace to an underscore.

      • Converts to uppercase.

      • Removes non-alphabetical, non-numeric, non-underscore characters.

    • The LCC filing routine generates a sorted call number by following these rules:

Classification splitting rules

Splitting rules determine how call numbers are split when printed on a spine label.

Nota

Splitting rules are only used if your label layout specifies to split call numbers.

For example, a Dewey call number such as “636.8/07 SHAW” will become

636.807
SHAW

once printed on a spine label.

Values that are preconfigured in Koha are:

  • Dewey

  • LCC

  • Genérico

Splitting rules are mapped to Classification sources. You can setup new splitting rules by using the “New splitting rule” button. To edit, use the “Edit” button.

Quando criar ou editar:

  • Enter a code. The code is limited to 10 characters and must be unique.

Nota

The code is not editable once it has been created.

  • Enter a description. The description is used in the drop-down list when creating or editing a classification source.

  • Choose an appropriate splitting routine - Dewey, Generic, LCC or RegEx

    • The Dewey splitting routine looks for the three digits and the decimal, puts it on one line with the other parts (Cutter, prefix, etc.) each on a separate line (generally split on spaces).

    • The Generic splitting routine splits on spaces.

    • The LCC splitting routine puts each component on a separate line.

    • The RegEx splitting routine allows you to create a custom splitting routine.

      • Some examples of RegEx splitting routines:

        • Split on spaces:

        s/\s/\n/g
        
        • Split on equal signs (=):

        s/(\s?=)/\n=/g
        
        • Split on forward slashes (/):

        s/(\s?\/)/\n/g
        
        • Remove first split if call number starts with J or K:

        s/^(J|K)\n/$1 /
        
        • Cut after 9 characters:

        s/(^.{9})/$1\n/
        

It is possible to mix and match RegEx splitting routines by clicking the “New” link just under the RegEx input box.

For example, if you want to cut after nine characters AND split on spaces, you can write both and the call number “971.42805092 C669r” will be split

971.42805
092
C669r

O exemplo acima, apresentado na interface

Regras de concordância

Regras de concordância são usadas quando se importam registos MARC para o Koha.

  • Get there: More > Administration > Catalog > Record matching rules

Nota

Only staff with the manage_matching_rules permission (or the superlibrarian permission) will have access to this section.

The rules that you set up here will be referenced with you Stage MARC records for import.

It is important to understand the difference between “Match points” and “Match checks” before adding new matching rules to Koha.

Match points are the criteria that you enter that must be met in order for an incoming record to match an existing MARC record in your catalog. You can have multiple match points on an import rule each with its own score. An incoming record will be compared against your existing records (“one record at a time”) and given a score for each match point. When the total score of the match points matches or exceeds the threshold given for the matching rule, Koha assumes a good match and imports/overlays according your specifications in the import process. An area to watch out for here is the sum of the match points. Double check that the matches you want will add up to a successful match.

Example:

Threshold of 1000

Match point on 020$a 1000

Match point on 022$a 1000

Match point on 245$a 500

Match point on 100$a 100

In the example above, a match on either the 020$a or the 022$a will result in a successful match. A match on 245$a title and 100$a author (and not on 020$a or 022$a) will only add up to 600 and not be a match. And a match on 020$a and 245$a will result in 1500 and while this is a successful match, the extra 500 point for the 245$a title match are superfluous. The incoming record successfully matched on the 020$a without the need for the 245$a match. However, if you assigned a score of 500 to the 100$a Match Point, a match on 245$a title and 100$a author will be considered a successful match (total of 1000) even if the 020$a is not a match.

Match checks are not commonly used in import rules. However, they can serve a couple of purposes in matching records. First, match checks can be used as the matching criteria instead of the match points if your indexes are stale and out of date. The match checks go right for the data instead of relying on the data in the indexes. (If you fear your indexes are out of date, a rebuild of your indexes would be a great idea and solve that situation!) The other use for a match check is as a “double check” or “veto” of your matching rule. For example, if you have a matching rule as below:

Threshold of 1000

Match point on 020$a 1000

Match check on 245$a

Koha will first look at the 020$a tag/subfield to see if the incoming record matches an existing record. If it does, it will then move on to the Match Check and look directly at the 245$a value in the incoming data and compare it to the 245$a in the existing “matched” record in your catalog. If the 245$a matches, Koha continues on as if a match was successful. If the 245$a does not match, then Koha concludes that the two records are not a match after all. The Match Checks can be a really useful tool in confirming true matches.

When looking to create matching rules for your authority records the following indexes will be of use:

Index name

Matches MARC tag

LC-cardnumber

010$a

Personal-name

100$a

Corporate-name-heading

110$a

Meeting-name

111$a

Title-uniform

130$a

Chronological-term

148$a

Subject-topical

150$a

Name-geographic

151$a

Term-genre-form

155$a

Table: Authority indexes

Adding matching rules

To create a new matching rule :

  • Click “New record matching rule”

    Formulário de regra de correspondência de registos

    • Escolha um nome único e insira-o no campo “Código da regra de correspondência”

    • “Descrição” pode ser o que quiser de forma a tornar claro qual a regra a ser escolhida

    • “Match threshold” is the total number of “points” a biblio must earn to be considered a “match”

    • “Record type” is the type of import this rule will be used for - either authority or bibliographic

    • As concordâncias são definidas para determinar o campo a comparar

    • “Search index” can be found by looking at the index configuration on your system. For Zebra you might find the right index names in your ccl.properties file. You can also find useful information in the Koha search indexes chapter of this manual.

    • “Score” - The number of “points” a match on this field is worth. If the sum of each score is equal or greater than the match threshold, the incoming record is a match to the existing record.

    • Enter the MARC tag you want to match on in the “Tag” field.

    • Enter the MARC tag subfield you want to match on in the “Subfields” field. For matching on controlfields like 001 the subfields input field can be left empty.

    • “Offset” - Para usar com campos de controle, “001-009”

    • “Tamanho” - É usado com os campos de controlo, 001-009

    • There are currently several options for “Normalization rules”:

      • None - no normalization rule will be applied

      • Remove spaces

      • Uppercase

      • Lowercase

      • Legacy default - this option was added to maintain the behavior form before the other normalization rules became available.

      • ISBN - using this option will improve matching on ISBN. If your incoming records ISBN fields contain extra text, like “9780670026623 (alk. paper)”, they will still match correctly.

    • “Required match checks” - While match points work on the search index, match checks work directly on the data and can be used as the matching criteria instead of the match points or in addition to them to confirm true matches.

Sample bibliographic record matching rule: Control number

Formulário de adição de regra de correspondência de registos preenchido com os dados de exemplo

  • Limite para correspondência: 100

  • Record type: Bibliographic record

    Nota

    In order to match on the 001 in authority records, you will need to create a second rule, repeating all of these values and change just the record type to “Authority record”.

  • Concordância:

  • Search index: control-number

  • Score: 100

  • Tag: 001

    Nota

    In MARC21, this field is for the control number assigned by the organization creating, using, or distributing the record.

  • Subfields: empty

  • Offset: 0 or empty

  • Length: 0 or empty

  • Normalization rule: None

  • Required match checks: none (click “Remove this match check”)

Record sources

Versão

This section was added to Koha in version 24.05.

Record sources are used to indicate where records come from and optionally prevent records from specific sources to be edited in Koha.

This is particularly useful in instances where records are cataloged in another system and pushed to Koha. Sometimes, in those cases, it’s best to edit the records in the source system rather than in Koha.

Nota

Only staff with the manage_record_sources permission (or the superlibrarian permission) will have access to this section.

Lista de fontes de registos. A tabela apresenta o idenficador, o nome e se os registos podem ou não ser editados. A tabela inclui também botões de edição e eliminação para cada fonte.

Adding a record source

To add a record source,

  • Click “New record source”

Formulário para adicionar uma fonte de registo

  • Preencher o formulário

    • Name: enter the name of the source

    • Can be edited: if this box is checked, records from this source will be editable in Koha. If it is not checked, only staff members with the edit_locked_records permission will be able to edit the records.

  • Clicar em “Submeter”

Editing a record source

To edit a record source, click the “Edit” button next to the source.

Lista de fontes de registos. A tabela apresenta o idenficador, o nome e se os registos podem ou não ser editados. A tabela inclui também botões de edição e eliminação para cada fonte.

Deleting a record source

To delete a record source, click the “Delete” button next to the source and confirm.

Lista de fontes de registos. A tabela apresenta o idenficador, o nome e se os registos podem ou não ser editados. A tabela inclui também botões de edição e eliminação para cada fonte.

Record overlay rules

Record overlay rules allow for defining rules for how incoming and original MARC records should be merged on a field tag and context basis when a MARC record is updated.

Nota

Only staff with the manage_marc_overlay_rules permission (or the superlibrarian permission) will have access to this section.

Contexts

Let’s first focus on understanding the concept of contexts.

Contexts are defined by «module» and «filter» enabling separate rule sets for different contexts.

By setting different filter values for these modules, rules are applied only when the filter value matches for a particular module. A wildcard; «*», can be used to match all possible filter values.

There are three different context modules:

borrower

Allows for defining rules that will be applied if the currently logged in user’s borrowernumber matches the filter condition.

categorycode

Allows for defining rules that will be applied if the currently logged in users’s category code matches the filter condition.

source

Allows for defining rules that will be applied if the record is updated in a particular part of Koha. The following update methods are supported:

  • batchimport

  • z39.50

  • intranet

  • bulkmarcimport

  • import_lexile

  • batchmod

A context is really nothing but a module and filter combination. Every time a record is updated i Koha, a context is set an filter values populated with context dependent values.

Examples of two different contexts are saving record in the staff client or the currently logged in user having a particular borrowernumber, for example «12».

These two contexts are define as:

Module: source, filter: intranet
Module: borrower, filter: 12

Only the rules of one context, that is a module and filter combination, are applied. If multiple contexts matches they are not merged together.

If we have the following rules:

Module: source, filter: *, tag: 650, preset: Protect
Module: source, filter: *, tag: 500, preset: Protect
Module: borrower, filter: 12, tag: *, preset: Overwrite

And the context of the update where the rules are applied is:

source => "intranet" (wildcard match)
borrower => 1 (no match)

Only the first two rules will be applied.

If instead the context of rule evaluation was:

source => "intranet" (wildcard match)
borrower => 12 (an exact match, which is considered more specific than a wildcard match)

Only the second rule would be applied, even though the first two rules also matches they will be discarded since the context match of that rule set is of lower specificity because of the wildcard.

Context specificity is ranked in the following way:

  • First all the rules are grouped into rule sets identified by a unique filter and module combination.

  • If one or more contexts have a non wildcard filter condition match, the rule set of the context with the module of highest specificity is selected. (The modules are listed in order of specificity above).

  • If no exact context match is found, but one or more wildcard matches are, the rule set of the context with the module of highest specificity is selected.

  • If no context matches the default behavior is to overwrite, the original record with the incoming record.

Rules

A rule consists of a three different parts:

Context

A module and filter to match against as described above.

Tag

A field tag expression for defining which tag(s) the rule should be applied on. Three different tag expressions are supported:

  • An exact tag, for example «650».

  • A regular expression, for example «6..» matching all 6XX tags.

  • A wildcard, «*», matching all tags

When rules for a specific context are evaluated, the most specific match is selected. The tag expressions above are listed in order of specificity.

Actions

Each rule defines a set of actions to take depending on the type of update. There are four types of update events: Added, Appended, Removed and Deleted. For each event an action is specified, whether to perform the update, or to skip it.

By enabling/disabling updates for these different events 16 different update behaviors can be defined. There are presets available for the most common/useful combinations:

Preset

Added

Appended

Removed

Deleted

Protect

Skip

Skip

Skip

Skip

Overwrite

Adicionar

Append

Remove

Eliminar

Add new

Adicionar

Skip

Skip

Skip

Add and append

Adicionar

Append

Skip

Skip

Protect from deletion

Adicionar

Append

Remove

Eliminar

Protect

Added: Skip, Appended: Skip, Removed: Skip, Deleted: Skip

The «Protect» preset will prevent all updates on matching fields, protecting them from being overwritten.

Given this rule:

Module: source, filter: *, Tag: 650, Preset: Protect

And the following original and incoming records:

100 1#$aTerrace, Vincent,$d1948-
650 #0$aTelevision serials$zUnited States$vCatalogs.
100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision pilot programs$zUnited States$vCatalogs.

The 650 field of the original record will retain its original value after the update (but since the default behavior if no rule matches is to overwrite, the 500 field will be added):

100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision serials$zUnited States$vCatalogs.

Overwrite

Added: Add, Appended: Append, Removed: Remove, Deleted: Delete

The «Overwrite» preset will allow all updates on matching fields.

Since the default behavior is to overwrite if no rule matches, adding a rule with the overwrite preset only makes sense if there is some other rule with a lower tag specificity with a different behavior, for example a wildcard tag rule.

So given these two rules:

Module: source, filter: *, Tag: *, Preset: Protect
Module: source, filter: *, Tag: 650, Preset: Overwrite

And the following original and incoming records:

500 ##$aIncludes index.
650 #0$aTelevision serials$zUnited States$vCatalogs.

Incoming record:

100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision pilot programs$zUnited States$vCatalogs.

All fields but 650 will be protected on the original record, and the resulting record will be:

500 ##$aIncludes index.
650 #0$aTelevision pilot programs$zUnited States$vCatalogs.

Add new

Added: Add, Appended: Skip, Removed: Skip, Deleted: Skip

The «Add new» allow updates only if the incoming field is new, that is there exists no fields with this tag in the original record.

Given this rule:

Module: source, filter: *, Tag: 650, Preset: Add

And the following original and incoming records:

100 1#$aTerrace, Vincent,$d1948-
650 #0$aTelevision serials$zUnited States$vCatalogs.
100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision pilot programs$zUnited States$vCatalogs.

The 650 in the incoming record will not overwrite the 650 field in the original record since the original record contains one or more 650 fields. The 500 field will be added since the default rule is to overwrite. The resulting record will be:

100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision serials$zUnited States$vCatalogs.

On the other hand, if the original record was:

100 1#$aTerrace, Vincent,$d1948-

The resulting record will be:

100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision pilot programs$zUnited States$vCatalogs.

This is because there were no 650 fields in the original record, so adding new ones is permitted.

Add and append

Added: Add, Appended: Append, Removed: Skip, Deleted: Skip

In the «Add and append» preset, appending is also permitted, but not removing or deleting.

So if we have the following rule:

Module: source, filter: *, Tag: 650, Preset: Add and append

And the following original and incoming records:

100 1#$aTerrace, Vincent,$d1948-
650 #0$aTelevision serials$zUnited States$vCatalogs.
100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision pilot programs$zUnited States$vCatalogs.

The resulting record will be:

100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision serials$zUnited States$vCatalogs.
650 #0$aTelevision pilot programs$zUnited States$vCatalogs.

Note that the «old» 650 field from the original record was not removed since we only allow adding or appending new values.

If we instead used the «Overwrite» preset the resulting record would instead be:

100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision pilot programs$zUnited States$vCatalogs.

with the 650 field of the original record removed.

Protect from deletion

Added: Add, Appended: Append, Removed: Remove, Deleted: Skip

The preset «Protect from deletion» will allow all update operations except deletion. Deletion is defined as when there are no fields of the matching tag in the incoming record so that all of the fields with this tag would be removed on the original record.

So given the following rule:

Module: source, filter: *, Tag: 650, Preset: Protect from deletion

And the following original and incoming records:

100 1#$aTerrace, Vincent,$d1948-
650 #0$aTelevision serials$zUnited States$vCatalogs.
100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision pilot programs$zUnited States$vCatalogs.

The resulting record will be:

100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision pilot programs$zUnited States$vCatalogs.

On the other hand, if the incoming record was:

100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.

In this case the deletion of 650 would not be permitted and the value of the field on the original record would be protected. The resulting record would instead be:

100 1#$aTerrace, Vincent,$d1948-
500 ##$aIncludes index.
650 #0$aTelevision serials$zUnited States$vCatalogs.

Custom presets

To work with custom presets, a more complete understanding of the update events is required:

Added

For a matching rule with a tag, the action configured for the «Added» event is applied for new fields in the incoming record if the original record has no fields with that tag. If the action is «Add» they will be added to the original record, if «Skip» they will be thrown away.

Appended

If the two record have common fields with the rule tag, that is one or more fields with identical subfield and identifier values, the action configured for the «Appended» event is applied for fields found in incoming record but not in original record. If the action is «Append» they will be added to the original record, if «Skip» they will be thrown away.

Removed

If the two records have common fields with the rule tag, the action configured for the «Removed» action is applied for fields found in original record but not in incoming record. If the action is «Remove» they will removed from the original record, if «Skip» they will be kept.

Deleted

If the original record have fields with the rule tag, but no fields with this tag is found in the incoming record, the action configured for the «Deleted» event is applied for the fields in the incoming record. If the action is «Delete» the fields will be removed from the original record, if «Skip» they will be kept.

Configuração dos conjuntos OAI

Nesta página pode criar, modificar e eliminar conjuntos OAI-PMH

Nota

Only staff with the manage_oai_sets permission (or the superlibrarian permission) will have access to this section.

Criar um conjunto

To create a set:

  • Clicar no link “Adicionar um novo conjunto”

  • Preencha os campos obrigatórios “setSpec” e “setName”

  • Depois pode adicionar descrições ao conjunto. Para fazer isto clique em “Adicionar descrição” e preencha nova caixa de texto. Pode adicionar as descrições que desejar.

  • Clicar em “Guardar”

Modify/delete a set

Para modificar um conjunto, clique na ligação “Modificar” na mesma linha do conjunto que deseja modificar. Um formulário similar ao de criação irá aparecer e permitirá modificar os detalhes do conjunto.

Para eliminar um conjunto, clique na ligação “Eliminar” na mesma linha do conjunto que deseja eliminar.

Definir mapeamentos

Here you can define how a set will be build (what records will belong to this set) by defining mappings. Mappings are a list of conditions on record content.

  • Fill the fields “Field”, “Subfield” and “Value”. For example if you want to include in this set all records that have a 999$9 equal to “XXX”. Fill “Field” with 999, “Subfield” with 9 and “Value” with XXX.

  • If you want to add another condition, click on “Add” button and repeat step 1. You can choose between “and” or “or” Boolean operators to link your conditions.

  • Clicar em “Guardar”

To delete a condition, just leave at least one of “Field”, “Subfield” or “Value” empty and click on “Save”.

Nota

Actually, a condition is true if value in the corresponding subfield is strictly equal to what is defined if “Value”. A record having 999$9 = “XXX YYY” will not belong to a set where condition is 999$9 = “XXX”.

E é sensível a maiúsculas : um registo com 999$9 = “xxx” não pertence a um conjunto cuja condição é 999$9 = “XXX”.

Construir conjuntos

Once you have configured all your sets, you have to build the sets. This is done by calling the script misc/migration_tools/build_oai_sets.pl.

Campos de pesquisa de exemplar

  • Get there: More > Administration > Catalog > Item search fields

This section allows you to add custom search fields to the item search option in the staff interface.

Nota

Only staff with the manage_item_search_fields permission (or the superlibrarian permission) will have access to this section.

Adding a custom item search field

To add a new search field, click the “New search field” button.

Formulário de novo campo de pesquisa de exemplar

  • Name: enter the search field’s name

  • Label: enter the label of the search field as it will appear on the item search page

  • MARC field: enter the MARC field number to search in; the MARC field will also appear on the item search page

  • MARC subfield: enter the MARC subfield code to search in

  • Authorized value category: if needed, choose an authorized value category for this search field; this will effectively turn this search field in a dropdown menu instead of a free text field

Clique em “Submeter”.

Once the new field is added, it will be visible on the item search page, in the dropdown that starts with “Barcode”.

Menu suspenso de campos de pesquisa de exemplares aberto, exibindo os campos de pesquisa personalizados

Editing a custom item search field

To edit an item search field, click the “Edit” button next to the search field in the table.

Tabela de campos de pesquisa de exemplares personalizados existentes. As colunas são: Nome, Rótulo, campo MARC, subcampo MARC, Categoria de valor autorizado e Ações. A coluna Ações contém botões 'Editar' e 'Apagar'.

Make the changes and click “Submit”.

Deleting a custom item search field

To delete an item search field, click the “Delete” button next to the search field in the table and confirm the deletion.

Tabela de campos de pesquisa de exemplares personalizados existentes. As colunas são: Nome, Rótulo, campo MARC, subcampo MARC, Categoria de valor autorizado e Ações. A coluna Ações contém botões 'Editar' e 'Apagar'.

Search filters

Search filters are custom searches or filters that can be applied to search results.

This functionality is enabled on using the SavedSearchFilters system preference.

Nota

This section will only be visible if the SavedSearchFilters system preference is enabled.

Nota

Only staff with the manage_search_filters permission (or the superlibrarian permission) will have access to this section.

Search filters are added by searching the catalog through the staff interface.

This page is used to manage existing search filters.

Página de administração de filtros de pesquisa

You can make changes to each search filter by clicking on the action buttons on the right.

  • Edit filter: change the name of the filter, and its availability in the OPAC or staff interface

    Janela de edição de filtros, com opção para editar o nome e a visibilidade no OPAC e na interface dos técnicos. Botões: Guardar e Cancelar.

  • Edit search: clicking this button will bring you to the advanced search form, with the filter already applied. You can change the search parameters, and click “Save filter” at the top of the page.

    Parte superior do formulário de pesquisa avançada, intitulado Editar o filtro de e-books de Shakespeare, com opções de visibilidade no OPAC e na interface dos técnicos. Os botões são: Guardar filtro, Pesquisar utilizando o filtro e Cancelar.

  • Delete: clicking this button will delete the filter.

    Aviso

    There is no confirmation when deleting a search filter. Once you click “Delete”, the filter will be deleted immediately.

Nota

Search filters can be used as predefined search URLs that you can use on your website or in HTML customizations.

Search filters are available through relatively short links.

<OPACBaseURL>/cgi-bin/koha/opac-search.pl?limit=search_filter:<Id of filter>

Use this URL anywhere to link directly to the search.

Search engine configuration

Once you have switched to Elasticsearch in your SearchEngine system preference, you’ll see a new link for Search engine configuration in the Catalog section of Administration. Here you will manage indexes, facets, and their mappings to MARC fields and subfields.

Nota

Only staff with the manage_search_engine_config permission (or the superlibrarian permission) will have access to this section.

The page is separated in three tabs: search fields, bibliographic records, and authority records.

Importante

If you change anything in this page, you need to completely reindex your records, otherwise, only records added or edited after the change will be affected.

Perigo

Any change done through the interface will be lost if you click on “Reset mappings” or if the rebuild command is run with the --reset or -r parameter. The “Reset mappings” button and the --reset parameter reset the settings to the defaults.

Search fields

The search fields tab in the search engine configuration page show all the search fields used by Elasticsearch in Koha.

The table shows:

  • Name: the name of the search field, as defined in the mappings file.

  • Aliases: some fields have aliases, for example, «author» can also be «au». These are hard-coded and cannot be changed.

  • Label: some fields have labels that are different from their name. These are used as the facet header when the field is used as a facet.

  • Type: the type influences how the data is stored and how it is searched.

    • Boolean: a 0 / 1 (no / yes) value.

    • Call Number: a call number influenced by the classification source.

    • Date: a date stored in ISO format.

    • Geo point: a geographic latitude and longitude value.

      Versão

      The Geo point type was added to Koha in version 24.05.

    • ISBN: ISBN standard number.

    • Number: a number.

    • Std. Number: a number.

    • String: a simple string of characters.

    • Sum: a sum of values.

    • Year: a four-digit year number.

  • Weight: a positive numerical value assigned to that search field to make it more «important» in a simple search. The higher the value, the more «important» this field is in the relevancy sorting.

    Nota

    Weighted search only works for bibliographic search, not authority search. It also only works for the simple search, unless the “Apply field weights to search” option in the advanced search is selected.

  • Searchable: whether this field is used in the staff interface or the OPAC.

Adding search fields

Versão

The possibility of adding search fields was added to Koha in version 24.05.

It is possible to add search fields from this table. Add the search field information in the last row of the table, and click the “Add” button at the end of the row.

Deleting search fields

Versão

The possibility of deleting added search fields was added to Koha in version 24.05.

It is possible to delete search fields that were added manually. The default search fields cannot be deleted because they are necessary for Koha to work properly.

To delete a search field, click the “Delete” button at the end of the row.

Bibliographic records

The bibliographic records tab in the search engine configuration page shows the MARC mappings for each search field used by Elasticsearch in Koha.

Nota

The default mappings are described in the Elasticsearch indexes section of the Searching chapter.

The table shows:

  • Search field: the corresponding search field (as defined in the search fields tab). Search fields can be repeated to include several MARC fields.

  • Sortable: indicates whether this mapping should be used in the sorting for this search field. For example, in MARC21, the title index has several different title fields, but only the 245 field is used for sorting.

  • Facetable: indicates whether this mapping can be used in the facets.

    Versão

    Facet configuration was added to Koha in version 24.05.

  • Suggestible: indicates whether this mapping is used in the browse search.

  • Searchable: indicates whether this mapping is used for searching.

  • Filter: the type influences the way values are indexed.

  • Punctuation: removes punctuation.

  • None: values are indexed as they are.

  • Mapping: indicates the MARC field mapped to that search field.

    Nota

    Mappings can include whole fields or only specific subfields. In the case of subfields, they can be indexed individually or as a single value.

    Por exemplo:

    • 520 will index all the contents of the 520 field. Each subfield in the field will be indexed individually.

    • 100a will index only the contents of 100$a.

    • 020az will index only the contents of subfields $a and $z of field 020. They will be indexed individually.

    • 245(abp) will index only the contents of subfields $a, $b and $p of field 245. They will be indexed as one entry.

    For fixed-length fields, the syntax is as follows :

    • leader_/6 will index position 6 of the leader (000).

    • 007_/0 will index position 0 of field 007.

    • 008_/39 will index position 39 of field 008.

    • 008_/15-17 will index positions 15 to 17 of field 008, as one entity.

Adding mappings

To add a mapping, add the information in the last row of the table and click the “Add” button at the end of the row.

Importante

Remember that if you change anything in this page, you need to completely reindex your records, otherwise, only records added or edited after the change will be affected.

Perigo

Any change done through the interface will be lost if you click on “Reset mappings” or if the rebuild command is run with the --reset or -r parameter. The “Reset mappings” button and the --reset parameter reset the settings to the defaults.

Deleting mappings

To delete a mapping, click the “Delete” button at the end of the row.

Some mappings are necessary for Koha to function properly and cannot be deleted.

Importante

Remember that if you change anything in this page, you need to completely reindex your records, otherwise, only records added or edited after the change will be affected.

Perigo

Any change done through the interface will be lost if you click on “Reset mappings” or if the rebuild command is run with the --reset or -r parameter. The “Reset mappings” button and the --reset parameter reset the settings to the defaults.

Facet order

This section allows you to customize the facets, as displayed in the search results in the OPAC and staff interface.

  • Search field: the corresponding search field (as defined in the search fields tab).

  • Label: the search field’s label (as defined in the search fields tab).

  • Authorized value category: for some facets, it is possible to define an authorized value category that will manage the text displayed for the facet items. Some facets have hard-coded authorized value categories, such as LOC for location and CCODE for collections.

To reorder the facets, simply drag and drop the row where you want it.

To rename facets, you need to change the label in the search fields tab.

To delete a facet, click the “Delete” button.

To add a new facet,

Versão

The option to add facets was added to Koha in version 24.05.

Autoridades

The authorities tab in the search engine configuration page shows the MARC mappings for authority search fields used by Elasticsearch in Koha.

Nota

The default mappings are described in the Elasticsearch indexes section of the Searching chapter.

The table shows:

  • Search field: the corresponding search field (as defined in the search fields tab). Search fields can be repeated to include several MARC fields.

  • Sortable: indicates whether this mapping should be used in the sorting for this search field.

  • Facetable: indicates whether this mapping can be used in the facets.

    Nota

    There are no facets in authority search, therefore this column should always be set to “No” for authorities.

  • Suggestible: indicates whether this mapping is used in the browse search.

    Nota

    There is no browse search for authorities, therefore this column should always be set to “No” for authorities.

  • Searchable: indicates whether this mapping is used for searching.

  • Filter: the type influences the way values are indexed.

  • Punctuation: removes punctuation.

  • None: values are indexed as they are.

  • Mapping: indicates the MARC field mapped to that search field.

    Nota

    Mappings can include whole fields or only specific subfields. In the case of subfields, they can be indexed individually or as a single value.

    Por exemplo:

    • 520 will index all the contents of the 520 field. Each subfield in the field will be indexed individually.

    • 100a will index only the contents of 100$a.

    • 020az will index only the contents of subfields $a and $z of field 020. They will be indexed individually.

    • 245(abp) will index only the contents of subfields $a, $b and $p of field 245. They will be indexed as one entry.

    For fixed-length fields, the syntax is as follows :

    • leader_/6 will index position 6 of the leader (000).

    • 007_/0 will index position 0 of field 007.

    • 008_/39 will index position 39 of field 008.

    • 008_/15-17 will index positions 15 to 17 of field 008, as one entity.

You can add mappings and delete mappings for authorities, the process is the same as for bibliographic records (see above).

Aquisições

O módulo de Aquisições do Koha fornece uma forma para os técnicos registar encomendas feitas a fornecedores e gerir os orçamentos de compra.

Before using the acquisitions module, you will want to make sure that you have completed all of the set up.

  • Acesso: Mais > Administração > Aquisições

Moedas e câmbios

Se desejar realizar encomendas de mais que um país deverá inserir as taxas de câmbio para que o seu módulo de aquisições calcule os totais correctamente.

Nota

Only staff with the currencies_manage permission (or the superlibrarian permission) will have access to this section.

  • Get there: More > Administration > Acquisitions > Currencies and exchange rates

Tabela de moedas atualmente definidas

Nota

You can customize the columns of this table in the Table settings section of the Administration module (table id: currency).

  • Currency: this is the code for the currency. For default currencies, the ISO code is used as currency code (for example “USD” for the US dollar). The ISO code will be used when importing MARC files via the staging tools. The tool will attempt to find and use the price of the currently active currency.

  • Rate: the rate will be used to calculate the price in the active currency.

    Nota

    This data is not automatically updated, so be sure to keep it up to date so that your accounting is kept correct.

  • Symbol: this is the symbol for the currency (for example, $ for USD, or € for EUR).

  • Last updated: this is the date when the currency was last updated in Koha.

  • Active: the active currency is the main currency you use in your library. The active currency will have a check mark in the “Active” column. If you don’t have an active currency you will see an error message telling you to choose an active currency.

    Mensagem de aviso: "Nenhuma moeda ativa está definida. Por favor, edite uma moeda e marque-a como ativa."

    The active currency must have a rate of 1. There can only be one active currency.

  • Archived: archived currencies will have “Yes” in this column. Archived currencies cannot be used in the acquisitions module.

    Nota

    It is currently not possible to manually archive currencies. Currencies will be archived if Koha is updated and a currency that was used previously in the acquisitions module was deleted.

  • Actions: use the buttons to edit or delete currencies.

    Nota

    If a currency was used at least once, it will not be possible to delete it.

Adding a new currency

If a currency that you use is not already in your system, you can create it.

  • Click “New currency”.

Formulário para adicionar uma nova moeda

  • Fill out the form.

    • Currency: enter a code for the currency, this can be the ISO code, or another code. This is what will be displayed in the acquisitions module.

      Nota

      If you decide to use a custom code here, make sure to fill out the ISO code with the correct code for the currency. This will ensure that prices are calculated according to the rate.

      Nota

      This field is limited to 10 characters.

    • Rate: enter the rate of this currency relative to your active currency.

    • Symbol: enter the symbol for the currency (for example, $ for USD, or € for EUR).

    • ISO code: enter the ISO code for the currency (for example “USD” for the US dollar). This field is optional. If this field is empty, Koha will use the currency code (above) as the ISO code for price calculations.

    • Last updated: this will be filled automatically with today’s date, it is not possible to manually change this date.

    • Space separation between symbol and value: if checked, Koha will display the price with a space before the currency symbol (for example, 10.99 $ rather than 10.99$).

    • Currency symbol precedes value: if checked, Koha will display the currency symbol before the price (for example, $10.99 rather than 10.99$).

      Versão

      Esta opção foi adicionada ao Koha na versão 24.11.

    • Active: check this box if this currency is the default currency used in the acquisitions module. Note that there can only be one active currency and that the active currency’s rate must be 1.

  • Clique em “Submeter”.

Editing a currency

If you often order from other countries, it will be necessary to update the exchange rate regularly in order to calculate the prices precisely.

To edit an existing currency,

  • Click the “Edit” button to the right of the currency in the currencies table.

  • Change the rate, or other value.

    Nota

    Note that the currency code and the last updated date cannot be edited.

  • Clique em “Submeter”.

Deleting a currency

If there are currencies that you never use, it is possible to delete them.

From the currencies table, click the “Delete” button to the right of the currency.

Aviso

Currencies that have been used at least once in the acquisitions module cannot be deleted.

Orçamentos

Budgets are used for tracking accounting values related to acquisitions. For example you could create a budget for the current year (ex. 2015) and then break that into funds for different areas of the library (ex. Books, Audio, etc).

  • Get there: More > Administration > Acquisitions > Budgets

Nota

Staff members must have the period_manage permission (or the superlibrarian permission) in order to access the budgets administration page.

It is recommended to minimally give the following permissions to staff members who need to manage budgets, since these are interdependent:

Quando visitar a administração principal de orçamento verá dois separadores, um para os orçamentos activos e outro para os inactivos.

Página principal de administração de orçamentos, com um botão Novo orçamento no topo, seguido de dois separadores, um para orçamentos ativos e outro para inativos. O separador orçamentos ativos está selecionado e apresenta uma tabela com informação sobre os orçamentos (nome do orçamento, data de início, data de fim e valor)

Adding budgets

Budgets can either be created from scratch or by duplicating the previous year’s budget.

Nota

Staff members must have the period_manage permission (or the superlibrarian permission) in order to create new budgets or duplicate existing budgets.

Adding a new budget

If you haven’t used Koha before for acquisitions, you’ll need to start fresh with a new budget.

To add a new budget,

  • Click the “New budget” button.

    Formulário para adicionar um novo orçamento

  • Preencha o formulário:

    • Start date (mandatory): choose the starting date for the time period this budget is for. This can be the start of the calendar year, fiscal year, academic year, quarter, etc.

    • End date (mandatory): choose the ending date for the time period this budget is for.

    • Description (mandatory): enter a description for this budget. The description should be something that will help you identify the budget when ordering.

    • Total amount: enter the amount for the budget. Do not use any symbols, simply enter the amount of the budget with numbers and decimals.

    • Make budget active: marking a budget as active makes it usable when placing orders in the acquisitions module, even if the order is placed after the budget end date. This will allow you to record orders that were placed in a previous budget period.

    • Lock budget: locking a budget means that you will not be able to add funds or add sub funds to this budget, and you will not be able to plan spending. Lock the budget once it is set as you wish.

  • Clique em “Guardar”.

You will be brought back to the list of existing budgets.

Proceed to add funds to the budget.

Duplicating a budget

At the end of the year, or the end of your budget period, you can duplicate the current budget. This will also duplicate all funds, so you don’t have to start from scratch each year or period.

To duplicate a budget,

  • From the list of budgets, click the “Actions” button on the right.

    Página principal de administração de orçamentos, com um botão Novo orçamento no topo, seguido de dois separadores, um para orçamentos ativos e outro para inativos. O separador orçamentos ativos está selecionado e apresenta uma tabela com informação sobre os orçamentos (nome do orçamento, data de início, data de fim e valor)

  • Choose “Duplicate”.

    Na tabela de orçamentos ativos, o botão Ações está aberto e o cursor do rato está sobre a opção Duplicar

Alternatively,

  • From the list of budgets, click on the budget name.

    Página principal de administração de orçamentos, com um botão Novo orçamento no topo, seguido de dois separadores, um para orçamentos ativos e outro para inativos. O separador orçamentos ativos está selecionado e apresenta uma tabela com informação sobre os orçamentos (nome do orçamento, data de início, data de fim e valor)

  • On the screen listing the budget breakdown, click the “Edit” button at the top and choose to “Duplicate budget”.

    Na página de detalhes do fundo do orçamento, o botão Editar está aberto e o cursor do rato está sobre a opção Duplicar orçamento

  • In both cases, you will be presented with a form to duplicate the budget.

    Formulário para duplicar um orçamento

    • Start date (mandatory): choose the starting date for the time period this new budget is for.

    • End date (mandatory): choose the ending date for the time period this budget is for.

    • Description (mandatory): enter a description for this new budget.

    • Change amounts by: by default, the total amount from the duplicated budget and the original amounts for each fund will be used. However, if needed, you can indicate to change the amounts by a percentage, that can be positive or negative. For example, if your new budget was increased by 2%, enter 2. Inversely, if your new budget was decreased by 2%, enter -2.

    • If amounts changed, round to a multiple of: if you entered a value in “Change amounts by”, Koha will calculate the amounts automatically. You can force it to round down the amounts. For example, entering “100”, will round down the amounts to the hundreds (5542 will become 5500).

    • Mark the original budget as inactive: check this box if the original budget should no longer be used, effective immediately. You can always edit the budget later to make it inactive.

    • Set all funds to zero: check this box if you wish the new budget to contain all the same fund structures as the previous budget but no allocations until you manually enter an amount in the fund.

This will not only duplicate the budget, but all of the funds associated with that budget so that you can reuse budgets and funds from year to year.

When the time comes, you can close the previous budget to move unreceived orders, and, if desired, unspent funds to the new budget.

Editar um orçamento

Nota

Staff members must have the period_manage permission (or the superlibrarian permission) in order to edit existing budgets.

You can edit existing budgets to make them inactive or lock them to prevent fund changes, for example.

To edit a budget,

  • From the list of budgets, click the “Actions” button on the right.

    Página principal de administração de orçamentos, com um botão Novo orçamento no topo, seguido de dois separadores, um para orçamentos ativos e outro para inativos. O separador orçamentos ativos está selecionado e apresenta uma tabela com informação sobre os orçamentos (nome do orçamento, data de início, data de fim e valor)

  • Choose “Edit”.

    Na tabela de orçamentos ativos, o botão Ações está aberto e o cursor do rato está sobre a opção Editar

Alternatively,

  • From the list of budgets, click on the budget name.

    Página principal de administração de orçamentos, com um botão Novo orçamento no topo, seguido de dois separadores, um para orçamentos ativos e outro para inativos. O separador orçamentos ativos está selecionado e apresenta uma tabela com informação sobre os orçamentos (nome do orçamento, data de início, data de fim e valor)

  • On the screen listing the budget breakdown, click the “Edit” button at the top and choose to “Edit budget”

    Na página de detalhes do fundo do orçamento, o botão Editar está aberto e o cursor do rato está sobre a opção Editar orçamento

  • In both cases, you will be presented with a form to duplicate the budget.

  • Make your changes (see the field descriptions above).

  • Clique em “Guardar”.

Closing a budget

Close a budget to move or roll over unreceived orders and if desired unspent funds from a previous budget to a new budget. Before closing your budget you might want to duplicate the previous year’s budget so that you have somewhere for the unreceived orders to roll to.

Nota

Staff members must have the period_manage permission (or the superlibrarian permission) in order to close existing budgets.

To close a budget,

  • From the list of budgets, click the “Actions” button on the right.

    Página principal de administração de orçamentos, com um botão Novo orçamento no topo, seguido de dois separadores, um para orçamentos ativos e outro para inativos. O separador orçamentos ativos está selecionado e apresenta uma tabela com informação sobre os orçamentos (nome do orçamento, data de início, data de fim e valor)

  • Choose “Close”

    Na tabela de orçamentos ativos, o botão Ações está aberto e o cursor do rato está sobre a opção Fechar

    Nota

    Budgets without unreceived orders cannot be closed.

    Mensagem a informar "Não há encomendas não recebidas para este orçamento", com um endereço para voltar atrás.

  • Fill out the form.

    Formulário para fecho de orçamento, exibindo a quantidade de encomendas não recebidas em cada fundo, um menu suspenso para selecionar o orçamento de destino para essas encomendas e a opção de transferir também os valores não utilizados

    • Select a budget: choose the new budget for the unreceived orders from the dropdown.

      Nota

      In order for the unreceived orders to be automatically moved to the new budget, the fund structures in the previous budget must exist in the new budget.

    • Move remaining unspent funds: check this box to move the unspent amounts from the funds of the budget being closed to the selected budget.

  • Click the “Move unreceived orders” button.

You will be presented with a dialog box that says “You have chosen to move all unreceived orders from “Budget X” to “Budget Y”. This action cannot be reversed. Do you wish to continue?” Budget X is the budget to be closed and Budget Y is the selected budget.

Mensagem de aviso a informar: "Optou por mover todos as encomendas não recebidos de '2023' para '2024'. Esta ação não pode ser revertida. Deseja continuar?"

Se tudo estiver correto pode clicar em “Ok” e as encomendas não recebidas e, se selecionados, os fundos não gastos serão movidos.

Espere até que o “Relatório após mover as encomendas não recebidas do orçamento X to Y” termine e mostre os resultados. Irá listar os números de encomendas que foram influenciados (agrupados por fundos) e detalhar se a encomenda não recebida foi movida ou ocorreu algum problema. Por exemplo, se o novo orçamento não contem o fundo com o mesmo nome que no orçamento anterior, a encomenda não será movida.

Relatório de fecho de orçamento apresentando os números de encomenda e a indicação "Movido!" para cada encomenda em cada fundo

Deleting a budget

In order to delete a budget, it must not have funds. Start by deleting the funds.

Aviso

This cannot be undone. Make sure you are certain this budget needs to be deleted. You can make it inactive or close it, instead.

To delete a budget,

  • From the list of budgets, click the “Actions” button on the right.

    Página principal de administração de orçamentos, com um botão Novo orçamento no topo, seguido de dois separadores, um para orçamentos ativos e outro para inativos. O separador orçamentos ativos está selecionado e apresenta uma tabela com informação sobre os orçamentos (nome do orçamento, data de início, data de fim e valor)

  • Choose “Delete”.

    Na tabela de orçamentos ativos, o botão Ações está aberto e o cursor do rato está sobre a opção Apagar

  • Click “Yes, delete”.

    Aviso com a mensagem "Apagar orçamento '2024'?"; as opções são "Sim, eliminar" e "Não, não eliminar"

Fundos

Funds are divisions of a budget. For example you could have a budget for the current year (ex. 2015) and then break that into funds for different areas of the library (ex. Books, Audio, etc).

  • Get there: More > Administration > Acquisitions > Funds

Adding a fund to a budget

A fund is added to a budget. Make sure to add a budget before adding funds.

Nota

If a budget is locked, it will not be possible to add funds.

To add a new fund,

  • From the list of budgets, click the “Actions” button on the right.

    Página principal de administração de orçamentos, com um botão Novo orçamento no topo, seguido de dois separadores, um para orçamentos ativos e outro para inativos. O separador orçamentos ativos está selecionado e apresenta uma tabela com informação sobre os orçamentos (nome do orçamento, data de início, data de fim e valor)

  • Choose “Add fund”.

    Na tabela de orçamentos ativos, o botão Ações está aberto e o cursor do rato está sobre a opção Adicionar fundo

Alternatively,

  • From the list of budgets, click on the budget name.

    Página principal de administração de orçamentos, com um botão Novo orçamento no topo, seguido de dois separadores, um para orçamentos ativos e outro para inativos. O separador orçamentos ativos está selecionado e apresenta uma tabela com informação sobre os orçamentos (nome do orçamento, data de início, data de fim e valor)

  • On the screen listing the budget breakdown, click the “New” button at the top and choose the “New fund for…” option.

    Na página de detalhes dos fundos do orçamento, o botão Novo está aberto e o cursor do rato está sobre a opção Novo fundo

  • In both cases, you will be presented with a form to create the new fund.

    Formulário para adicionar um novo fundo

    • Fund code (mandatory): enter a unique identifier for your fund.

    • Fund name (mandatory): enter a name for the fund. This should be something that staff will understand, as this is what will be displayed when ordering.

    • Amount (mandatory): enter the amount with only numbers and decimals, no other characters.

    • Warning at (%): enter a percentage value to have Koha warn you when you have spent this percentage of the fund, to prevent overspending. For example, if you enter 90%, Koha will warn you for each order after 90% of the fund is spent.

    • Warning at (amount): same as above but for a specific amount of money spent. For example, if you enter 5000, Koha will warn you for each order after 5000 is spent in the fund.

    • Owner: you can choose to assign this fund to a staff member.

      • Click “Select owner”.

      • Search for the staff member in the patron search form.

        Nota

        Only staff with the budget_modify permission (or the superlibrarian permission) are returned in the search results.

      • Click “Select” to the right of the staff member’s result.

      Nota

      A fund can only have one owner.

      Nota

      In order to limit the use of this fund to the owner, you must choose either “Owner”, “Owner and users” or “Owner, users and library” in the “Restrict access to” field below. Otherwise, adding users will not have any restricting effect.

      Nota

      Staff members with the order_manage_all permission (or the superlibrarian permission) will be able to use funds regardless of restrictions.

      Make sure your staff doesn’t have that permission if you want to restrict access to funds.

    • Users: you can also add users who will be able to spend in that fund.

      Nota

      In order to limit the use of this fund to the users, you must choose either “Owner and users” or “Owner, users and library” in the “Restrict access to” field below. Otherwise, adding users will not have any restricting effect.

      Nota

      Staff members with the order_manage_all permission (or the superlibrarian permission) will be able to use funds regardless of restrictions.

      Make sure your staff doesn’t have that permission if you want to restrict access to funds.

      • Click “Add users”

      • Search for the staff member in the patron search form.

        Nota

        Only staff with the budget_modify permission (or the superlibrarian permission) are returned in the search results.

      • Click “Add” to the right of the staff member’s result.

      Nota

      You can add as many users as you need.

      • Click “Close” once all the users have been added.

    • Library: If this fund is for a specific library, choose it here.

      Nota

      In order to limit the use of this fund to the library, you must choose “Owner, users and library” in the “Restrict access to” field below. Otherwise, choosing a library will not have any restricting effect.

      Nota

      Staff members with the order_manage_all permission (or the superlibrarian permission) will be able to use funds regardless of restrictions.

      Make sure your staff doesn’t have that permission if you want to restrict access to funds.

    • Restrict access to: you can restrict who can order from this fund by choosing either the “owner”, “owner and users” or “owner, users and library”.

      Aviso

      To use the access restriction setting you must also set the associated library, user, or owner fields.

      Nota

      Staff members with the order_manage_all permission (or the superlibrarian permission) will be able to use funds regardless of restrictions.

      Make sure your staff doesn’t have that permission if you want to restrict access to funds.

    • Notes: any descriptive notes about this fund.

      Nota

      Notes will only appear on this screen (when editing the fund).

    • Statistic 1 done on: this is used for statistical purposes. Choose an authorized value category from which to choose values when placing orders using this fund. You will then be able to plan spending and report on spending according to those categories. The default authorized value category Asort1 is created specifically for this purpose, but you can use any authorized value category in this field (CCODE for example to plan spending according to collections).

    • Statistic 2 done on: same as above, for a second statistical category. The default authorized value category Asort2 is created specifically for this purpose, but you can use any authorized value category.

      Nota

      To learn more about planning categories, check out the Planning category FAQ.

  • Clique em “Submeter”.

You will be brought to a list of all of the funds for the budget.

Lista de fundos num orçamento

The monetary columns in the fund table break down as follows:

  1. Base-level allocated is the “Amount” value you defined when creating the fund

  2. Base-level ordered is the ordered amount for this fund (without child funds)

  3. Total ordered is the base-level ordered for this fund and all its child funds

  4. Base-level spent is the spent amount for this fund (without child funds)

  5. Total spent is the base-level spent for this fund and all its child funds

  6. Base-level available is 1 - 2

  7. Total available is 1 - 3

To the right of each fund you will find the “Actions” button under which you will find the “Edit,” “Delete,” and “Add sub fund” options.

Na tabela de fundos de um orçamento, está aberto o botão Ações e as opções são Editar, Apagar e Adicionar subfundo

Adding a sub fund

A sub fund is a more granular division of the fund. An example would be to have a fund for “Fiction” and under that have a fund for “New releases” and a fund for “Science Fiction.” It is an optional way to further organize your finances.

Nota

If a budget is locked, it will not be possible to add sub funds.

To add a sub fund to a fund,

  • From the list of all funds, or from the list of funds of a specific budget, click the “Actions” button on the right.

    Lista de fundos num orçamento

  • Choose “Add sub fund”.

    Na tabela de todos os fundos, o botão Ações está aberto e o cursor do rato está sobre a opção Adicionar subfundo

  • Fill out the new sub fund form. Fields are the same as for adding a new fund. The only difference is that the form will state the “parent” fund.

  • Clique em “Submeter”.

Funds with sub funds will show with a small arrow to the left. Clicking that will show you the sub funds.

Lista de fundos num orçamento: existem dois fundos, AV e PRINT; o AV tem três subfundos: DVD, AUDIOBOOK e MUSIC; o PRINT tem dois sub-fundos: PRINT-ADULT e PRINT-CHILD

Deleting funds

It is possible to delete funds, if necessary.

Aviso

Deleting a fund in which there are orders will delete those orders. Only delete funds if you are certain it needs to be deleted. It is not possible to undo this.

To delete a fund,

  • From the list of all funds, or from the list of funds of a specific budget, click the “Actions” button on the right.

    Lista de fundos num orçamento

  • Choose “Delete”.

    Na tabela de fundos de um orçamento, o botão Ações está aberto e o cursor do rato está sobre a opção Apagar

  • Click “Yes, delete this fund” in the warning message.

    Aviso: "Apagar o fundo Material audiovisual? Se apagar este fundo, serão excluídos todos as encomendas a ela vinculadas! Valor do fundo: 400.000,00"; as opções são "Sim, eliminar este fundo" e "Não, não eliminar"

Budget planning

Nota

Staff members must have the planning_manage permission, the budget_manage permission, and the period_manage permission (or the superlibrarian permission) in order to access budget planning.

Quando estiver a visualizar os fundos clique no botão de planeamento para escolher como deseja gastar o orçamento.

Na página da lista de fundos de um orçamento, o botão Planeamento está aberto e as opções são: Planear por meses, Planear por bibliotecas e Planear por tipos de documento

If you choose “Plan by months” you will see the budgeted amount broken down by months.

Tabela para planeamento de gastos de fundos por mês onde as linhas representam os fundos, e as colunas incluem o valor total do fundo, seguidas de uma coluna para cada mês e uma coluna com o saldo remanescente no fundo. Cada linha possui dois botões de ação: Preencher linha automaticamente e Limpar.

On the left are filters that can be used to limit what is shown in the table.

Opções de filtragem na página de planeamento orçamental. As opções são: tipo de planeamento, apresentar apenas os meus fundos, apresentar apenas os fundos ativos e apresentar os valores reais/estimados.

  • Select planning type: choose to plan by months, libraries, item types, or any authorized value category used as statistic 1 or 2 in the funds.

  • Show my funds only: this will filter out funds of which you are not the owner.

  • Show active funds only: this will filter out funds that have not been used (no ordered amount).

  • Show actual/estimated values: this will alter the table to show the ordered amounts as well.

To hide some of the columns, uncheck the boxes at the top of the table.

From here, you can plan your budget spending by manually entering values or by clicking the “Auto-fill row” button. If you choose to auto-fill the form the system will try to divide the amount accordingly, you may have to make some edits to split things more accurately.

Tabela para o planeamento das despesas de um fundo ao longo dos meses: as linhas representam os fundos e as colunas indicam o valor total do fundo, seguidas de uma coluna para cada mês e uma coluna com o saldo remanescente no fundo. O valor do fundo foi distribuído igualmente pelos meses, e o saldo remanescente é agora zero.

Once your changes are made, click the “Save” button.

Nota

If a budget is locked, it will not be possible to edit the values.

To export your data as a CSV file, enter a file name in the “Output to a file named” field, in the “Export” section on the left, and click the “Submit” button.

Opções de exportação para o planeamento orçamental, os campos são Gerar ficheiro (definido como Exportar por omissão), Enviar para aplicação (definido como CSV por omissão) e um campo sem etiqueta para o separador CSV (definido como vírgula por defeito).

Contas EDI

From here you can set up the information needed to connect to your acquisitions vendors.

Nota

This section will only appear if the EDIFACT system preference is enabled.

Nota

Only staff with the edi_manage permission (or the superlibrarian permission) will have access to this section.

Nota

Before you begin you will need at least one vendor set up in acquisitions.

To add account information click the “New account” button.

Enter your vendor’s information in the form.

See the EDI questions for vendors section of the acquisitions module chapter for a description of each field.

Cada fornecedor terá uma conta.

EANs

Um EAN é o identificador que o fornecedor dá à biblioteca para que seja retornado a eles de forma a conhecer a conta a usar na faturação. Um conta EDI pode ter vários EANs.

Nota

This section will only appear if the EDIFACT system preference is enabled.

Nota

Only staff with the edi_manage permission (or the superlibrarian permission) will have access to this section.

To add an EAN click the “New EAN” button.

In the form that appears enter the information provided by your vendor.

See the EDI questions for vendors section of the acquisitions module chapter for a description of each field.

Parâmetros adicionais

  • Acesso: Mais > Administração > Parâmetros adicionais

Identity providers

This section is used to define and manage external identity providers for Koha users. This is used when your users come from an external source, such as student management system, active directory, or other similar databases.

  • Acesso: Mais > Administração > Parâmetros adicionais > Fornecedores de identidade

Nota

Only staff with the manage_identity_providers permission (or the superlibrarian permission) will have access to this section.

Adding an identity provider

To add an identity provider, click the “New identity provider” button.

Formulário de novo provedor de identidade

  • Basic configuration

    • Code: enter a code for this provider.

      Nota

      The code for the identity provider is limited to 20 characters and can only be composed of letters, numbers, and underscore (_).

    • Description: enter a name for this provider. This is what you will see in the interface.

    • Protocol: choose which protocol this identity provider uses.

      • OAuth

      • OIDC

  • Configuração avançada

    • Configuration: Use this field to enter the configuration specific to the protocol chosen above.

      You can click on the “Add default OAuth configuration” button or the “Add default OIDC configuration” button to prefill the field with some default values, which you can change for your own values.

      The default OAuth configuration is:

      {
       "key": "<enter client id>",
       "secret": "<enter client secret>",
       "authorize_url": "<enter authorization endpoint>",
       "token_url": "<enter token endpoint>",
       "userinfo_url": "<enter user info endpoint (optional)>",
       "scope": "email"
      }
      

      The default OIDC configuration is:

      {
       "key": "<enter client id>",
       "secret": "<enter client secret>",
       "well_known_url": "<enter openid configuration endpoint>",
       "scope": "openid email"
      }
      
    • Mapping: Use this field to define the field mappings from the external database to the Koha borrower fields.

      The key is the Koha field from the borrowers table, and the value is the external field.

      Nota

      You can find all fields for the borrowers table in the database structure [https://schema.koha-community.org/].

      You can click on the “Add default OAuth mapping” button or the “Add default OIDC mapping” button to prefill the field with some default values, which you can change for your own values.

      Both the default OAuth mapping and default OIDC mapping are:

      {
       "email": "email",
       "firstname": "given_name",
       "surname": "family_name"
      }
      

      If the external fields are nested, you can use periods to separate the levels.

      For example, if the firstname is nested like so:

      <user>
         <given_name>First name</given_name>
         <family_name>Family name</family_name>
         <email>Email address</email>
      </user>
      

      Use:

      "firstname": "user.0.given_name"
      

      This will fetch the «given_name» field in the first «user» field (0 = first).

      Importante

      If you plan on using the auto register function (see below), make sure either «userid» or «cardnumber» are present in the mappings.

      Importante

      Make sure the field for the matchpoint (see below) is included in the mappings.

    • Matchpoint: choose which field is used to match incoming users to existing users.

      Nota

      The field chosen here must be included in the mappings (see above).

    • Icon URL: if you want an icon to show on the login screen for this provider, enter the URL to the image file here.

  • Domain configuration

    Nota

    Enter at least one domain for this provider. Once it is saved, you will be able to add more domains to this provider.

    • Domain: enter the email domain for incoming users.

      Nota

      Enter an asterisk (*) to include all domains.

    • Default library: if auto register is enabled, choose at which library new users will be registered.

    • Default category: if auto register is enabled, choose which patron category will be assigned to new users.

    • Allow OPAC: choose if patrons of this domain can log into the OPAC with their credentials from this identity provider.

    • Allow staff: chose if staff members of this domain can log into the staff interface with their credentials from this identity provider.

    • Auto register: choose whether or not a new patron account is created in Koha when a user from this domain logs in for the first time with their credentials from this identity provider.

      Nota

      If auto register is enabled, make sure the «userid» or «cardnumber» fields are included in the mappings (see above).

      Also make sure the default library and default category are set correctly for new patrons. These will be assigned to the new patrons.

    • Update on login: choose whether or not the patron account in Koha is updated with the external information when a user from this domain logs in with their credentials from this identity provider.

      Aviso

      Information may be lost if you change it directly in Koha.

Once the form is completed, click “Submit” to save the new identity provider.

You will need to restart Koha once the identity provider is added.

Adding an email domain to an existing identity provider

You will need to add at least one email domain when creating a new identity provider. You can add more by clicking the “Manage domains” button to the right of the identity provider from the main identity providers page, and clicking “New email domain”.

Formulário de novo domínio de email

  • Domain: enter the email domain for incoming users.

    Nota

    Enter an asterisk (*) to include all domains.

  • Update on login: choose whether or not the patron account in Koha is updated with the external information when a user from this domain logs in with their credentials from this identity provider.

    Aviso

    Information may be lost if you change it directly in Koha.

  • Auto register: choose whether or not a new patron account is created in Koha when a user from this domain logs in for the first time with their credentials from this identity provider.

    Nota

    If auto register is enabled, make sure the «userid» or «cardnumber» fields are included in the mappings of the identity provider.

    Also make sure the default library and default category are set correctly for new patrons. These will be assigned to the new patrons.

  • Default library: if auto register is enabled, choose at which library new users will be registered.

  • Default category: if auto register is enabled, choose which patron category will be assigned to new users.

  • Allow OPAC: choose if patrons of this domain can log into the OPAC with their credentials from this identity provider.

  • Allow staff: chose if staff members of this domain can log into the staff interface with their credentials from this identity provider.

Once the form is completed, click “Submit” to save the new email domain.

Servidores Z39.50/SRU

Z39.50 is a client/server protocol for searching and retrieving information from remote computer databases. In short, it’s a tool used for copy cataloging.

SRU (Search/Retrieve via URL) is a standard XML-based protocol for search queries, utilizing CQL (Contextual Query Language), a standard syntax for representing queries.

Using Koha you can connect to any Z39.50 or SRU target that is publicly available or that you have the log in information to and copy bibliographic or authority records from that source.

  • Get there: More > Administration > Additional parameters > Z39.50/SRU servers

Nota

Only staff with the manage_search_targets permission (or the superlibrarian permission) will have access to this section.

Koha comes with a default list of Z39.50/SRU targets set up that you can add to, edit or delete.

Lista de servidores Z39.50 e SRU

Adding a Z39.50 target

To find additional Z39.50 targets, you can use Index Data’s IRSpy https://irspy.indexdata.com [https://irspy.indexdata.com/] or the Library of Congress’s list of targets https://www.loc.gov/z3950/. You can also contact individual libraries and ask for their Z39.50 information.

  • From the main Z39.50 page, click “New Z39.50 server”.

    Formulário de novo servidor Z39.50

    • Server name: enter a name that will help you identify the source (such as the library name). It will be saved in capital letters.

    • Hostname: enter the address to the Z39.50 target.

    • Port: enter the port number to listen on to get results from this target.

    • Database: enter the name of the database.

    • Userid: some servers might be password protected. If that is the case for the server you are trying to add, enter your user ID for that source.

    • Password: if the server is password protected, enter your password for that source.

    • Preselected: check this box if you want this target to always be selected by default.

    • Rank: enter a number representing where in the list you’d like this target to appear. 0 is the top position, then 1, 2, etc.

      • If this is left blank the targets will be in alphabetical order.

    • Attributes: enter PQF attributes to be added to all queries.

    • Syntax: choose the MARC flavor used by this target.

    • Encoding: choose the character encoding used by this target.

      Nota

      If you notice special characters don’t appear correctly when you import records through Z39.50, it means the encoding is wrong. Change it to another and try importing again.

    • Timeout: enter a number of seconds after which to stop trying to search the target if results aren’t found in a reasonable amount of time. It is helpful for targets that take a long while.

    • Record type: choose if this is a bibliographic or an authority target.

    • XSLT file(s) for transforming results: enter one or more (comma-separated) XSLT file names that you want to apply on the search results.

      • When retrieving records from external targets you may wish to automate some changes to those records. XSLT’s allow you to do this. Koha ships with some sample XSLT files in the /koha-tmpl/intranet-tmpl/prog/en/xslt/ directory ready for use:

        • Del952.xsl: Remove Koha items (field 952) (MARC21)

        • Del995.xsl: Remove Koha items (field 995) (UNIMARC)

        • Del9LinksExcept952.xsl: Remove links to authorities in bibliographic records ($9), except in the case of 952$9 (itemnumber) (MARC21)

        • Del9LinksExcept995.xsl: Remove links to authorities in bibliographic records ($9), except in the case of 995$9 (itemnumber) (UNIMARC)

  • Clique em “Guardar”.

Suggested bibliographic Z39.50 targets

Koha libraries that have shared their Z39.50 targets are listed on the Koha wiki at https://wiki.koha-community.org/wiki/Koha_Open_Z39.50_Sources.

Known publicly available targets are listed on the Koha wiki at https://wiki.koha-community.org/wiki/Configure_Z39.50/SRU_targets.

You can also find open Z39.50 targets listed on the IRSpy website at https://irspy.indexdata.com/.

These targets are known to work:

  • LIBRARY OF CONGRESS

    Nome do servidor:

    LIBRARY OF CONGRESS

    Servidor:

    lx2.loc.gov

    Porta:

    210

    Base de dados:

    LCDB

    Pré-selecionado:

    select to search by default

    Classificação:

    enter a value for the display order, for example 1

    Sintaxe:

    MARC21/USMARC

    Codificação:

    utf8

    Tempo limite:

    0

    Tipo de registo:

    Bibliographic

  • OHIOLINK

    Nome do servidor:

    OHIOLINK

    Servidor:

    olc1.ohiolink.edu

    Porta:

    210

    Base de dados:

    INNOPAC

    Pré-selecionado:

    select to search by default

    Classificação:

    enter a value for the display order, for example 1

    Sintaxe:

    MARC21/USMARC

    Codificação:

    utf8

    Tempo limite:

    0

    Tipo de registo:

    Bibliographic

Suggested authority Z39.50 targets

These targets are known to work:

  • LIBRARY OF CONGRESS NAME AUTHORITIES

    Nome do servidor:

    LIBRARY OF CONGRESS NAMES

    Servidor:

    lx2.loc.gov

    Porta:

    210

    Base de dados:

    NAF

    Pré-selecionado:

    select to search by default

    Classificação:

    enter a value for the display order, for example 1

    Sintaxe:

    MARC21/USMARC

    Codificação:

    utf8

    Tempo limite:

    0

    Tipo de registo:

    Authority

  • LIBRARY OF CONGRESS SUBJECT AUTHORITIES

    Nome do servidor:

    LIBRARY OF CONGRESS SUBJECTS

    Servidor:

    lx2.loc.gov

    Porta:

    210

    Base de dados:

    SAF

    Pré-selecionado:

    select to search by default

    Classificação:

    enter a value for the display order, for example 1

    Sintaxe:

    MARC21/USMARC

    Codificação:

    utf8

    Tempo limite:

    0

    Tipo de registo:

    Authority

Adding an SRU target

  • From the main Z39.50/SRU page, click “New SRU server”

    Formulário de novo servidor SRU

    • Server name: enter a name that will help you identify the source (such as the library name).

    • Hostname: enter the address (URL) to the SRU target.

    • Port: enter which port to listen on to get results from this target.

    • Database: enter the name of the database.

    • Userid: some servers might be password protected. If that is the case for the server you are trying to add, enter your user ID for that source.

    • Password: if the server is password protected, enter your password for that source.

    • Preselected: check this box if you want this target to always be selected by default.

    • Rank: enter a number representing where in the list you’d like this target to appear. 0 is the top position, then 1, 2, etc.

      • If this is left blank the targets will be in alphabetical order.

    • Syntax: choose the MARC flavor used by this target.

    • Encoding: choose the character encoding used by this target.

      Nota

      If you notice special characters don’t appear correctly when you import records through Z39.50, it means the encoding is wrong. Change it to another and try importing again.

    • Timeout: enter a number of seconds after which to stop trying to search the target if results aren’t found in a reasonable amount of time. It is helpful for targets that take a long while.

    • Record type: choose if this is a bibliographic or an authority target.

    • Additional SRU options: enter additional options of the external server here, like sru_version=1.1 or schema=marc21, etc. Note that these options are server dependent.

    • SRU Search field mapping: click “Modify” to add or update the mapping from the available fields on the Koha search form to the specific server dependent index names.

      Janela para adicionar o mapeamento de campos de pesquisa SRU para registos bibliográficos; os campos visíveis são o título, autor, ISBN, ISSN, cota LC, assunto, número de controlo, Dewey, qualquer um e identificador padrão. Cada campo tem um campo de texto a preencher.

      Janela para adicionar mapeamento de campos de pesquisa SRU para autoridades; os campos são: palavra-chave (qualquer), nome (qualquer), autor (qualquer), autor (pessoa), autor (entidade), autor (evento/conferência), número de controlo, cabeçalho de assunto, subdivisão de assunto, título (qualquer) e título (uniforme). Cada campo tem um campo de texto a preencher.

      • Para refinar as suas pesquisas, pode adicionar os seguintes índices ao mapeamento de campos de pesquisa SRU. Para fazer isso, edite o servidor e clique no botão Modificar junto ao campo.

        Título

        dc.title

        ISBN

        bath.isbn

        Qualquer

        cql.anywhere

        Autor

        dc.author

        ISSN

        bath.issn

        Assunto

        dc.subject

        ID por omissão

        bath.standardIdentifier

        Table: SRU mapping

    • XSLT file(s) for transforming results: enter one or more (comma-separated) XSLT file names that you want to apply on the search results.

      • When retrieving records from external targets you may wish to automate some changes to those records. XSLT’s allow you to do this. Koha ships with some sample XSLT files in the /koha-tmpl/intranet-tmpl/prog/en/xslt/ directory ready for use:

        • Del952.xsl: Remove Koha items (field 952) (MARC21)

        • Del995.xsl: Remove Koha items (field 995) (UNIMARC)

        • Del9LinksExcept952.xsl: Remove links to authorities in bibliographic records ($9), except in the case of 952$9 (itemnumber) (MARC21)

        • Del9LinksExcept995.xsl: Remove links to authorities in bibliographic records ($9), except in the case of 995$9 (itemnumber) (UNIMARC)

  • Clique em “Guardar”.

OAI repositories

Versão

Esta preferência de sistema foi introduzida na versão 24.11 do Koha.

  • Acesso: Mais > Administração > Parâmetros adicionais > Repositórios OAI

This section is used to define which OAI repositories to harvest metadata from in order to create records in Koha.

OAI-PMH harvesting is a protocol to retrieve records from an OAI-PMH repository. OAI-PMH repositories may be used by libraries for local history collections, thesis repositories… This functionality allows you to host and manage a collection outside of Koha but include the records in your Koha catalogue.

Once one or more OAI repositories are set up, use the harvest_oai.pl cronjob to harvest the records.

Adding an OAI repository to harvest

You will need to add a new OAI repository for each set you want to harvest. Click on the button “+ New OAI repository”.

Formulário de novo repositório OAI

  • Repository name: enter a name that will help you identify the source

  • Endpoint: enter the URL.

    • The repository should provide you with its base endpoint; for example https://doaj.org/oai?verb=Identify for the Directory of Open Access Journals. In the Koha endpoint field, simply enter the information before ?verb, e.g. https://doaj.org/oai.

  • Set: the name of the set you want to harvest.

    • You can usually find all the sets available by adding ?verb=ListSets to the endpoint you entered in the previous field.

  • Data format: choose the format to harvest in the list.

    • You can check the formats available for a repository by adding ?verb=ListMetadataFormats to the endpoint you entered previously.

  • Record type: choose if you will harvest bibliographic or authority records in this set.

  • XSLT file for transforming results: type the path of the XSLT file you want to apply to transform Dublin Core XML to MARC. Several XSLT files are provided by default:

    • For bibliographic records: <path_to_src>/koha-tmpl/intranet-tmpl/prog/en/xslt/OAIDCtoUNIMARCXML.xsl or <path_to_src>/koha-tmpl/intranet-tmpl/prog/en/xslt/OAIDCtoMARC21XML.xsl

    • For authority records: <path_to_src>/koha-tmpl/intranet-tmpl/prog/en/xslt/AuthOAIDCtoUNIMARCXML.xsl or <path_to_src>/koha-tmpl/intranet-tmpl/prog/en/xslt/AuthOAIDCtoMARC21XML.xsl

  • Click “Save” to save the new OAI repository.

SMTP servers

  • Acesso: Mais > Administração > Parâmetros adicionais > Servidores SMTP

This section is used to configure SMTP servers to send emails through Koha.

Nota

Only staff with the manage_smtp_servers permission (or the superlibrarian permission) will have access to this section.

The default STMP configuration is set in the koha-conf.xml file. But this section allows you to add additional servers.

Página principal da seção de configuração de servidores SMTP, não há servidores, exceto o por omissão

To add a new server,

  • Click “New SMTP server”

    Formulário de novo servidor SMTP

    • Name (required): give the server a significant name, this is the name that will be displayed in Koha

    • Host (required): enter the host name or IP address of the server

    • Port (required): enter the port number provided by your administrator

    • Timeout (seconds): enter the number of seconds after which an unsent email will result in an error

    • SSL: choose the security protocol provided by your administrator

      • Disabled: no security (not recommended)

      • SSL

      • STARTTLS

    • Username: enter the username provided by your administrator

    • Password: enter the password provided by your administrator

    • Debug mode: choose whether to enable the debug mode to send additional output to the logs

    • Default server: choose whether this server is the default one to be used by all libraries

  • Clicar em “Submeter”

Once the server is added, you can select it in the library’s details.

Testing the SMTP configuration

Versão

This option was first introduced to Koha in version 26.11.

Note that the change was added to version 26.05.01 as well.

Once you have added the SMTP server information, you can click on “Send test email” to test the server information. This will send a test message to the address in the KohaAdminEmailAddress system preference and will report either success or failure.

In the case of failure, you will need to check the log files for more information.

Quis dizer?

Acesso: Mais > Administração > Parâmetros adicionais > Quis dizer?

Nota

Only staff with the manage_didyoumean permission (or the superlibrarian permission) will have access to this section.

Koha can offer “Did you mean?” options on searches based on values in your authorities.

Importante

Did you mean? only works in the OPAC at this time. The intranet options are here for future development.

Usando esta página pode controlar quais as opções que o Koha dá ao leitor nos resultados de pesquisa.

image235

Para activar a barra “Quis dizer?” nos resultados de pesquisa precisa de marcar a caixa à beira de cada plugin de que deseja usar. Os dois plugins que pode escolher são:

  • O plugin ExplodedTerms sugere ao utilizador a pesquisa por termos mais abrangentes/mais restritos/relacionados para uma determinada pesquisa feita. Isto é apenas relevante para bibliotecas com dados de autoridade altamente estruturados hierarquicamente.

  • O plugin AuthorityFile pesquisa o ficheiro de autoridade e sugere ao utilizador que talvez esteja interessado nos registos ligados ao top 5 das autoridades

Se deseja que um plugin tome prioridade face a outro simplesmente arraste um para cima do outro.

image236

If you choose both plugins you will see several options at the top of your search results

image237

If you choose just the AuthorityFile you’ll see just authorities.

image238

Table settings

This administration area will help you hide or display columns on fixed tables throughout the staff interface and OPAC.

  • Acesso: Mais > Administração > Parâmetros adicionais > Configurações de tabelas

Captura de ecrã da página de definições de tabelas, onde é possível ver todos os módulos do Koha que têm tabelas personalizáveis

Nota

Only staff with the manage_column_config permission (or the superlibrarian permission) will have access to this section.

Clique no módulo no qual deseja editar tabelas e será mostrado as opções disponíveis.

This area lets you control the columns that show in the table in question. If nothing is hidden you will see no check marks in the “is hidden by default” column.

Nas configurações da tabela de moedas, nenhuma coluna está marcada como oculta

And will see all of the columns when viewing the table on its regular page.

Na tabela de administração de moedas, todas as colunas estão visíveis

If columns are hidden they will have checks in the “is hidden by default” column.

Nas configurações da tabela de moedas, as colunas de símbolo e código ISO estão marcadas como ocultas

And hidden when you view the table.

Na tabela de administração de moedas, as colunas de símbolo e código ISO estão ocultas

The “Cannot be toggled” column is used to prevent individual users from showing or hiding this column when viewing the table.

Individual users can toggle columns using the “Columns” button at the top of the table.

O botão 'Colunas', localizado acima da tabela de administração de moedas, está clicado e são apresentados todos os nomes das colunas

For example, in the Currencies table, the “Currency” and “Rate” columns cannot be toggled. When the user clicks on the “Columns” button, they are not able to choose whether these two columns are hidden or visible.

Note that using the “Columns” button show or hide columns will only toggle them for the current user and session. Once the user logs out, the columns will go back to their default settings as set in the table settings administration page. It will not affect any other user.

Module

Tables

Aquisições

Administração

Autoridades

There aren’t any tables that can be configured from the Authorities module.

Catalog

  • Acquisition details (acquisitiondetails-table)

  • Item bundles (bundle_tables)

  • Checkout history (checkoutshistory-table)

  • Holdings/items (holdings_table)

  • Holdings/items from other libraries (otherholdings_table) (when SeparateHoldings is enabled)

Cataloging

Circulation

Reservas de curso

  • Courses (courses page, course_reserves_table)

  • Reserves (reserves page, course_reserves_table)

E-resource management

Interlibrary loans

Patrons

Ponto de venda

Ferramentas

OPAC

Relatórios

Periódicos

Nota

Patrons in the OPAC can’t toggle column visibility. For OPAC tables this feature only allows to control the visibility of columns.

Nota

Any tables with columns listed here also have the option to export to Excel, export to CSV, copy, or print within the table header.

Alertas de áudio

If you have your AudioAlerts preference set to “Enable” you will be able to control the various alert sounds that Koha uses from this area.

  • Acesso: Mais > Administração > Parâmetros adicionais > Alertas de áudio

Nota

Only staff with the manage_audio_alerts permission (or the superlibrarian permission) will have access to this section.

Each dialog box in Koha has a CSS class assigned to it that can be used as a selector for a sound.

image1213

You can edit the defaults by clicking the “Edit” button to the right of each alert.

image1214

You can assign alerts to other CSS classes in Koha by entering that information in the selector box. For example if you enter

body:contains('Check in message')

Then when you visit the check-in page you will hear an alert.

Every page in Koha has a unique ID in the body tag which can be used to limit a sound to a specific page

Any ID selector (where HTML contains id=»name_of_id» ) and can also be a trigger as: #name_of_selector

Operadores de serviços móveis

Importante

This option will only appear if the

SMSSendDriver, SMSSendMaxChar preference is set to “Email”.

Nota

Only staff with the manage_sms_providers permission (or the superlibrarian permission) will have access to this section.

Nota

Many mobile providers have deprecated support for the SMS::Send::Email feature. It is not recommended for use unless you have a dedicated SMS to Email gateway.

From here you can enter as many cellular providers as you need to send SMS notices to your patrons using the email protocol.

image1215

Some examples in the US are:

Mobile carrier

SMS gateway domain

Alltel

sms.alltelwireless.com

AT&T

txt.att.net

Boost Mobile

sms.myboostmobile.com

Project Fi

msg.fi.google.com

Republic Wireless

text.republicwireless.com

Sprint

messaging.sprintpcs.com

T-Mobile

tmomail.net

U.S. Cellular

email.uscc.net

Verizon Wireless

vtext.com

Virgin Mobile

vmobl.com

Table: SMS provider examples

To add new providers enter the details in the form and click “Add new” to save.

image1216

These options will appear in the OPAC for patrons to choose from on the Messaging tab if you have EnhancedMessagingPreferences enabled.

image1217

Share your usage statistics

You can share your Koha usage statistics with the Hea community. Sharing your usage statistics helps with the development of Koha as the community regularly checks these statistics to make decisions.

Nota

Only staff with the manage_usage_stats permission (or the superlibrarian permission) will have access to this section.

Note that statistics are anonymized and no patron information is shared.

Worldwide statistics can be viewed at https://hea.koha-community.org/

image1479

  • Share my Koha usage statistics:

    • The default choice is “Undecided”, this make the message appear on the administration main page.

    • Choose “yes” if you want to share your usage statistics

    • Choose “no” if you don’t want to share your statistics and you don’t want to see the message on the administration page

  • Your country: choose the country where your library is located

  • Library name: enter your library’s name

  • Library type: choose your library’s type

  • Library URL: enter your library’s Web site URL

  • Last update: here your will see the last date when your data was uploaded to the Hea website

  • Geolocation: use the map on the right to put the marker where your main library is situated. The coordinates will appear in the Geolocation field.

  • Libraries information: if you have more than one branch, you can choose “yes” here to put all your branches on the map

  • See your public page: this is the URL to your information on the Hea website.

Click “Update your statistics usage” to save the information.

Partilhar conteúdo com a Mana KB

O Mana KB é uma base de conhecimento global utilizada para partilhar conteúdos específicos para bibliotecas. Atualmente, o Koha está ligado ao Mana KB para partilhar modelos de assinaturas de periódicos e relatórios. Esta secção é utilizada para configurar a ligação com o Mana KB.

Acesso: Mais > Administração > Parâmetros adicionais > Partilhar contéudos com o Mana KB

image1426

Nota

Apenas os colaboradores com a permissão manage_mana (ou superbibliotecários) terão acesso a esta secção.

No formulário, escolha se pretende utilizar o Mana KB para partilhar conteúdo ou não. A opção predefinida é «Não, deixe-me pensar sobre isso». Se pretender utilizar o Mana KB, altere a opção para «Sim». Se não quiser partilhar com o Mana KB, escolha «Não»; isto removerá o retângulo azul da página inicial de administração.

O resto desta secção pressupõe que escolheu «Sim».

Escolha se pretende partilhar os seus modelos de assinatura automaticamente. Isto significa que, sempre que criar uma assinatura no módulo de periódicos, esta será automaticamente partilhada com a Mana KB e outras bibliotecas poderão copiá-la.

Para configurar o Mana KB, deve obter um token do Mana KB para autenticar a sua instalação do Koha no servidor do Mana KB.

Introduza o seu nome ou o nome da sua organização no campo «O seu nome».

Insira o seu email no campo «Email». Certifique-se de que tem acesso a esta caixa de entrada, pois receberá mais informações por email.

Assim que enviar as suas informações para a Mana KB, receberá um token da Mana KB.

image1427

No e-mail que receber, clique no endereço de confirmação e confirme que não é um robot para completar a configuração do Mana KB.

Campos adicionais

Esta secção é utilizada para adicionar campos personalizados a cestos de encomendas, faturas, assinaturas de periódicos e linhas de conta.

Nota

Apenas os colaboradores com a permissão manage_additional_fields (ou superbibliotecários) terão acesso a esta secção.

Para adicionar um novo campo, primeiro escolha a tabela à qual pretende adicioná-lo.

Aquisições

Administração

  • Bibliotecas (branches): um campo adicionado a branches aparecerá ao editar bibliotecas.

    Versão

    Campos adicionais para bibliotecas foram incluídos no Koha na versão 25.05.

ERM

  • Contratos (erm_agreements): um campo adicionado a erm_agreements aparecerá ao criar ou editar contratos no módulo ERM.

    Versão

    Campos adicionais para acordos de ERM foram adicionados ao Koha na versão 24.11.

  • Licenças (erm_licenses): um campo adicionado a erm_licenses aparecerá ao criar ou editar licenças no módulo ERM.

    Versão

    Campos adicionais para licenças de ERM foram adicionados ao Koha na versão 24.11.

  • Pacotes (erm_packages): um campo adicionado a erm_packages aparecerá ao criar ou editar pacotes no módulo ERM.

    Versão

    Campos adicionais para pacotes de ERM foram adicionados ao Koha na versão 24.11.

Leitores

  • Linhas de conta (crédito) (accountlines:credit): um campo associado aos créditos nas linhas de conta que aparecerá ao pagar ou cancelar multas na conta de um utilizador ou ao criar créditos manuais.

    Formulário para pagamento de uma multa individual

  • Linhas de conta (débito) (accountlines:debit): um campo adicionado à linha de débito da conta aparecerá ao criar uma fatura manual

    Formulário de fatura manual

  • Tipos de crédito de conta (account_credit_types): um campo adicionado aos tipos de crédito de conta aparecerá ao adicionar ou editar tipos de crédito.

    Versão

    Campos adicionais para tipos de crédito foram adicionados ao Koha na versão 25.05.

  • Tipos de débito de conta (account_debit_types): um campo adicionado aos tipos de débito de conta aparecerá ao adicionar ou editar tipos de débito.

    Versão

    Campos adicionais para tipos de débito foram incluídos no Koha na versão 25.05.

Periódicos

Clique em “Novo campo”.

Fill out the form.

Formulário de adição de campo

  • Nome: este é o nome do campo, da forma como você deseja que ele apareça.

  • Categoria de valores autorizados: se quiser adicionar um menu suspenso ao campo, escolha uma categoria de valores autorizados aqui (pode também criar uma nova categoria de valores autorizados, se necessário).

  • Repetível: se quiser que o campo seja repetível, marque esta caixa. Para campos de texto livre, será adicionado um botão «Novo» ao lado do campo, permitindo que a equipa o repita e insira um novo valor. Para campos com categorias de valores autorizados, será criada uma lista de caixas de seleção em vez de um menu suspenso, permitindo que a equipa escolha mais de uma opção.

    Versão

    Esta opção foi adicionada ao Koha na versão 24.11.

  • Campo MARC: para campos de assinatura adicionais, é possível ligar o campo a um campo MARC. O campo adicional será preenchido automaticamente com o valor desse campo MARC presente no registo correspondente.

Nota

Só pode escolher uma das duas opções (valor autorizado OU campo MARC)

Aviso

Se escolher o campo MARC, certifique-se de inseri-lo neste formato: campo$subcampo

Por exemplo: 590$a

  • Pesquisável: marque esta caixa se quiser poder pesquisar cestos ou assinaturas com base neste campo

Exemplos de campos adicionais

Exemplo 1: Campo de assinatura adicional utilizando valores autorizados

Talvez queira registar para qual departamento está encomendando este periódico

  • No campo “Nome”, digite “Departmento”

  • No campo “Categoria de valor autorizado”, escolha DEPARTAMENT

  • Marque a caixa “Pesquisável”

Formulário de adição de campo, preenchendo Department como o Nome, DEPARTMENT como a categoria de valor autorizado e marcando a opção Pesquisável

Ao adicionar uma assinatura, o campo aparecerá na secção “Campos adicionais”, acompanhado de um menu suspenso com os valores autorizados.

Formulário para adicionar uma nova assinatura (2 de 2), com campos adicionais na parte inferior

Ao visualizar a assinatura, o campo aparecerá em “Campos adicionais”.

Página de detalhes da assinatura, separador Informação, com botões na parte superior (Nova assinatura para este periódico, Editar, Renovar, Receber, Fechar) e menu à esquerda (Coleção de periódicos, Criar lista de circulação, Reclamações, Verificar término, Gerir frequências, Gerir padrões de numeração, Gerir campos da assinatura, Assistente de estatísticas de periódicos)

Como tornamos o campo pesquisável, ele também aparecerá na pesquisa de assinaturas de periódicos.

Formulário de pesquisa avançada de periódicos

Exemplo 2: Campo de assinatura adicional utilizando campo MARC

Isto é particularmente útil se quiser visualizar informações bibliográficas na página de detalhes da assinatura. Neste exemplo, adicionaremos o campo 521$a, que corresponde, no formato MARC21, à nota de público-alvo.

  • No campo “Nome”, insira “Público-alvo”

  • No campo “Campo MARC”, insira “521$a”

Formulário de adição de campo, preenchido com Target audience no campo Nome e 521$a no campo MARC

Nota

Não poderá editar este campo a partir do formulário de assinatura. Se precisar adicionar ou alterar o valor deste campo, deverá utilizar o módulo de catalogação.

Ao visualizar a assinatura, o campo e as informações do registo bibliográfico aparecerão em “Campos adicionais”.

Página de detalhes da assinatura, separador Informação, com botões na parte superior (Nova assinatura para este periódico, Editar, Renovar, Receber, Fechar) e menu à esquerda (Coleção de periódicos, Criar lista de circulação, Reclamações, Verificar término, Gerir frequências, Gerir padrões de numeração, Gerir campos da assinatura, Assistente de estatísticas de periódicos)

Exemplo 3: Campo adicional de fatura de texto livre

Se precisar de inserir informações adicionais nas faturas, como o número do cheque utilizado para o pagamento, pode optar por não utilizar nenhum valor autorizado.

  • No campo “Nome”, digite “# Cheque”

  • Marque a caixa “Pesquisável”

Formulário de adição de campo, preenchendo Check # no campo Nome e marcando a opção Pesquisável

Os novos campos serão exibidos ao visualizar a fatura no módulo de aquisições.

Página de fatura detalhada, com campos adicionais e AcqEnableFiles ativo

Como tornamos o campo pesquisável, ele também aparecerá na pesquisa de faturas.

Formulário de pesquisa de faturas, campos adicionais pesquisáveis estão disponíveis nesta busca

Atalhos de teclado

Esta secção é usada para redefinir os atalhos de teclado utilizados no editor de catalogação avançada.

Nota

Esta secção só aparecerá se a preferência de sistema EnableAdvancedCatalogingEditor estiver ativa.

Nota

Apenas os utilizadores com a permissão manage_keyboard_shortcuts (ou superbibliotecários) terão acesso a esta secção.

Para alterar um atalho, insira a combinação de teclas a ser utilizada no campo da coluna “Teclas de atalho” e clique em “Salvar atalhos”.

Certifique-se de seguir as regras de mapeamento de teclas ao inserir suas combinações de teclas:

  • Separe as teclas usando um hífen “-”

  • A tecla de controle é “Ctrl”

  • A tecla Alt é a “Alt”

  • A tecla Shift é “Shift”

  • Ao combinar várias teclas, elas devem estar na ordem especificada: Shift-Cmd-Ctrl-Alt