• Movimentações

Características do Requisito

Descrição

Implementada melhoria para possibilitar que as movimentações bibliotecárias (empréstimos, renovações, devoluções, cancelamentos e reservas) sejam consumidas via webservices disponibilizada pelos dataservers. 

Procedimento para Implantação

Estas melhorias estão disponíveis à partir da versão 12.1.18, é necessário somente ter os webservices publicados e disponíveis para acesso. 

Procedimento para Utilização

É possível realizar todas as movimentações bibliotecárias utilizando os dataserver consumindo via webservice, para que seja possível estas tarefas foram criados dataservers de movimentações e ajustado o dataserver de reserva. 

DataServers utilizados: 

BibMovimentacaoWSEmprestimo - Exclusivo para a movimentação de empréstimo.

BibMovimentacaoWSDevRenCan - Exclusivo para as movimentações de devoluções, renovações e cancelamento de empréstimos.

BibReservaData - Exclusivo para realizar reservas.

Exemplo de utilização

BibMovimentacaoWSEmprestimo:

Este dataserver realiza somente empréstimos, ou seja, define uma publicação e um exemplar como emprestado para um determinado usuário, segue abaixo a descrição da funções: 

ReadView: Retorna exatamente o mesma visão que o menu "visão de empréstimo" no RM.exe, neste item é possível obter informações sobre todos os empréstimos utilizando qualquer filtro possível. 

Utilizando a ferramenta SOAP UI é possível verificar os resultados da função readview:

ReadRecord: A função readrecord carrega o objeto empréstimo validando regras de empréstimos e carregando todas as informações necessárias para a chamada da função saverecord para de fato confirma a operação, caso existam impedimentos com relação ao usuário ou a publicação e exemplar estes já serão validados também nesta função, estas mesmas regras também serão revalidadas na função saverecord, para garantir o máximo de integridade na operação. 

Esta operação requer como chave primária o código do usuário, código da publicação e código do exemplar conforme pode ser verificado abaixo: 

Exemplo de validação de impedimento financeiro: (parâmetro para validar impedimentos habilitado)

SaveRecord: Esta função utiliza os dados gerados pelo readrecord para confirmar a operação de empréstimo, ao confirmar o empréstimo será retornado a chave primária enviada na operação do readrecord. 

BibMovimentacaoWSDevRenCan:

Este dataserver realiza somente as operações de devoluções, renovações e cancelamentos, ou seja, utiliza de  empréstimos existentes para realizar as operações

ReadView: Retorna exatamente a mesma visão que o menu "visão de empréstimo" no RM.exe, neste item é possível obter informações sobre todos os empréstimos utilizando qualquer filtro possível. Exatamente como descrito no item readview do dataserver BibMovimentacaoWSEmprestimo.

ReadRecord: Esta função carrega o empréstimo que já existe no formato corretado para devolução, renovação ou cancelamento, é necessário que o empréstimo exista e esteja como "emprestado" (STATUSEMP = E), nesta função é necessário informar qual tipo de operação (TIPOMOVIMENTACAO) está sendo realizada:

• D = Devolução
• R = Renovação
• C = Cancelamento

Este campo é obrigatório e compõem a chave primária pois o sistema já irá fazer validações para cada tipo de operação, principalmente para o tipo de movimentação renovação. 

Para a execução desta operação é necessário passar a chave primária como o tipo da operação, código do empréstimo, código do usuário, código da publicação e código do exemplar, os dados retornados devem ser utilizados para a operação de saverecord. 

SaveRecord: A operação saverecord utiliza o xml gerado pelo readrecord para confirmar a operação definida no campo TIPOMOVIMENTACAO, ao confirmar a operação será retornado a chave informada no readrecord.

Se a devolução gerar algum tipo de valor financeiro é necessário configurar a tag <add key="WebServiceCulture" value="Invariant" /> conforme o documento: Como Expor os Web Services.

BibReservaData

Este dataserver é responsável por criar reservas.

ReadView: Retorna a visão de reservas exatamente como no RM.exe.

ReadRecord: Carrega os dados de uma determinada reserva, neste método é necessário utilizar o código da coligada e o código da reserva como chave primária.

SaveRecord: Este método utiliza a estrutura gerada pelo readrecord para confirmar a reserva.