Histórico da Página

...

O objetivo deste dataserver é possibilitar a consulta ao acervo através de webservice, será retornado exatamente a mesma consulta ao acervo utilizada na pesquisa geral do TOTVS Gestão Bibliotecária. 

Através do dataserver "BibConsultaAcervoDataWS" é possível por meio dos métodos ReadView e ReadRecord é possível realizar  realizar uma busca que retorne vários resultados e detalhar um resultado específico, assim como na tela de consulta ao acervo disponibilizada pelo TOTVS Gestão Bibliotecária.

Método ReadView

Este método realiza a busca geral ao acervo, deve ser informando o campo que será buscado e o termo que será pesquisado o . O sistema irá realizar uma busca e se encontrar publicações irá retornar um dataset (XML) com quatro tabelas, a primeira com os detalhes da publicação ou das publicações encontradas, a segunda com as unidades bibliotecárias que as publicações encontradas possuem exemplares, a terceira e quarta respectivamente com os autores e assuntos vinculados as publicações. 

As tabelas Unidades, Assuntos e Autores são relacionadas com a tabela Publicação, os relacionamento relacionamentos de ambas as tabelas é feito dado pelas colunas CODIGOITEMPESQUISA, CODCOLIGADA e CODPUBLIC.

Image RemovedImage Added

Método ReadRecord

Este método é responsável por carregar os detalhes  de uma única publicação, além de carregar os mesmos dados que já são retornados pelo ReadView porém exclusivoo deuma determinada publicação, carregará serão retornados também todos os exemplares disponíveis para a publicação, bem como, os dados de sumário, marc21, volumes, áreas e subáreas de conhecimento.

Os exemplares retornados por para uma determinada publicação poderão ter artigos e fascículos, estes dados estão vinculados com a tabela de exemplares, e este vínculo poderá ser utilizado pelas colunas CODCOLIGADA, CODPUBLIC e CODEXEMPLAR.

Os demais dados são únicos por publicação e sendo assim não precisam de vínculos diretos com a publicação pois já são vinculados a ela. 

Image Modified

Campos permitidos para a pesquisa

Para a pesquisa (readviewReadView) devem ser informados dois campos (detalhados no próximo item), um deles é qual o campo que será utilizado para a busca, ou seja, qual campo o sistema irá utilizar para pesquisar o termo de uma publicação.

Abaixo segue a lista de campos que são permitidos, se for informado um campo que não existe nesta lista o sistema não retornará resultados. 

Utilização do WebService

Pesquisa ao acervo

Para realizar uma buscar por um determinado termo deve ser utilizado a operação de ReadView, esta operação deve ter como filtro o campo que será pesquisado  pesquisado e o termo da pesquisa, separados por ";" (ponto e vírgula) .

Exemplo: realizar busca pelo título principal que contenha o nome Teste Pesquisa, assim o filtro do método ReadView deve ser "TituloPrincipal;Teste Pesquisa". 

...

Image Modified

Exemplo do retorno da chamada da pesquisa

Image Modified

Detalhar um exemplar da pesquisa

É possível detalhar uma publicação utilizando o método ReadRecord ReadRecord após realizar a operação de ReadView, assim como na atual tela de pesquisa do TOTVS Gestão Bibliotecária, o sistema retorna uma lista de publicações (ReadView) e permite selecionar uma publicação para o detalhamento (ReadRecord).

O método ReadRecord para este dataserver BibConsultaAcervoDataWS dataserver BibConsultaAcervoDataWS obriga o preenchimento de seis (6) campos que existem na operação de pesquisa (ReadView) para compor a chave primária do registro, são eles:

• CODCOLIGADA (Código da coligada)
• CODPUBLIC (Código da publicação)
• CODVOLUME (Código do volume)
• EDICAO (Edição)
• ANO (Ano)
• NPAGINAS (Número de páginas)
  
  

Exemplo de utilização:

Com base no retorno do ReadView será passado chamado o  deverá ser feita a chamada do método ReadRecord, este método terá como filtro os campos: 

• CODCOLIGADA;CODPUBLIC;CODVOLUME;EDICAO;ANO;NPAGINAS

O código da coligada (CODCOLIGADA) e da publicação (CODPUBLIC) são obrigatórios na chave primária do método (PrimaryKey), os demais podem ser nulos, mas caso de fato sejam nulos, deve ser passado o valor "-1' pois sempre devem existir valores na composição da chave.

No exemplo abaixo é possível identificar que para a publicação em questão foi utilizado os seguintes itens para a chave primária:

• CODCOLIGADA = 1
• CODPUBLIC = 2990
• CODVOLUME = -1 (retornado nulo pelo ReadView)
• EDICAO = -1 (retornado nulo pelo ReadView)
• ANO = 20102017
• NPAGINAS = -1 (retornado nulo pelo ReadView)

Image Modified

Retorno do webservice a à chamada do ReadRecord

Conforme descrito, no ReadRecord é carregado o detalhamento da publicação, assim o retorno contará com todas as tabelas retornadas pelo ReadView e também as específicas do ReadRecord que são as de exemplares , sumário(exemplares, fascículos e artigos), áreas de conhecimento e sumário. 

Image Modified