Arquivo, CI, ERP, Funcionários, Professores, Burocratas, Administradores
2 810
edições
Mudanças
Ir para navegação
Ir para pesquisar
Linha 1:
Linha 1: − + − + − # Caso o arquivo não esteja na estrutura descrita no item ''Observações'' deste manual, ajuste-o para que ele fique (ou seja, deixe-o com as colunas na ordem especificada lá e também com os dados iniciando na linha lá especificada).+ − # Clique na primeira pasta existente no arquivo.<p>[[File:ClipCapIt-250501-171641.PNG]]</p>+ − # Clique em '''Arquivo''' > '''Salvar como'''. − # Informe um nome para este arquivo (1) e escolha o tipo '''Texto (separado por tabulações) (*.txt)''' (2). Em seguida, clique em '''Salvar''' (3).<p>[[File:ClipCapIt-180910-180608.PNG]]</p> − # O Excel irá solicitar confirmação para salvar o arquivo como um txt. Confirme-as clicando em '''Ok''' ou em '''Sim'''.<p>[[File:ClipCapIt-180910-180800.PNG]]</p><p>[[File:ClipCapIt-180910-181015.PNG]]</p> − # Repita os passos 2 a 5 para as demais pastas da planilha, salvando cada uma em um arquivo separado. − − Linha 21:
Linha 15: − + − − Com relação à estrutura do arquivo, o script espera que os arquivo fornecidos possuam as seguintes colunas, na ordem especificada a seguir (o nome da coluna não é importante, apenas a sua ordem). Caso o arquivo possua um número diferente de colunas, um erro será gerado. As colunas com * não são importadas, mas devem existir no arquivo (nem que estejam em branco). Assim, antes de salvar o arquivo, confira se ele possui as colunas nesta ordem para garantir que elas sejam importadas corretamente. − − <ol type="A"> − <li>ISBN digital</li> − <li>ISBN impresso*</li> − <li>Selo</li> − <li>Editora*</li> − <li>Título</li> − <li>Autor</li> − <li>Data</li> − <li>Local</li> − <li>Resumo</li> − <li>Área do conhecimento</li> − </ol> − − Os dados devem iniciar na linha nº 2 (a linha 1 é ignorada, pois contém o cabeçalho das colunas). Linha 47:
Linha 24: − + Linha 57:
Linha 34: − − Outro detalhe importante é com relação às áreas de conhecimento. Como as áreas utilizadas na minhabiblioteca.com.br não são iguais as nossas áreas de conhecimento, foi montado um "de-para", mapeando uma para a outra: − − * Área "Ciências Exatas" do arquivo de importação será mapeado para "Ciências Exatas e da Terra" no ERP; − * Área "Saúde e Biológicas" do arquivo de importação será mapeado para a área "Ciências Biológicas" e "Ciências da Saúde" no ERP (publicações que utilizem esta área receberão as 2 áreas do conhecimento no nosso ERP). − * Demais casos: − ** Se o nome bater com um nome existente no ERP, ele será utilizado; − ** Demais publicações ficarão sem área do conhecimento preenchido no ERP.
Importação de publicações da biblioteca digital (ver código-fonte)
Edição das 16h50min de 15 de outubro de 2025
, 15 outubroRevisado para refletir a versão 2.0 do aplicativo de sincronização.
'''ITCI110''' - Esta instrução mostra como fazer para importar os livros da biblioteca digital para dentro do Totvs Gestão Bibliotecária a partir do arquivo disponibilizado pelo suporte da plataforma MinhaBiblioteca.com.br.
'''ITCI110''' - Esta instrução mostra como fazer para importar os livros da biblioteca digital para dentro do Totvs Gestão Bibliotecária a partir dos arquivos ''MRC'' fornecidos pela MinhaBiblioteca no padrão ''MARC''.
== O processo de importação ==
== O processo de importação ==
# Abra o arquivo ''.xlsx'' fornecido no Microsoft Excel.
# Coloque o executável '''importa-biblioteca.exe''' e os arquivos '''MRC''' em um mesmo diretório do seu computador.
# Depois de exportados os arquivos, abra o diretório com o Windows Explorer, selecione o(s) arquivo(s) ''MRC'', arraste-os e solte-os sobre o executável '''importa-biblioteca.exe'''.<p>[[File:3C1B62BD-4A5F-4B8D-9C4C-22477121D164.PNG]]</p><p>Obs: caso prefira, pode-se também executar o script através do prompt de comando, informando:</p><pre>importa-biblioteca.exe arquivo1.mrc arquivo2.mrc arquivo3.mrc ...</pre><p>onde arquivo1.mrc arquivo2.mrc... são os arquivos fornecidos pela MinhaBiblioteca. Pode-se informar vários arquivos ao mesmo tempo, sendo que os arquivos serão processados todos juntos.</p>
# A etapa anterior produziu um arquivo '''.sql''' no diretório. Abra este arquivo no SQL Server Management Studio.<p>[[File:7D4B35A2-D685-483E-BC89-FEF61EE827BF.PNG]]</p>
# Depois de exportados os arquivos, abra o diretório com o Windows Explorer, selecione os arquivos gerados na etapa anterior e arraste-os para cima do executável '''importa-biblioteca.exe'''.<p>[[File:ClipCapIt-180910-181516.PNG]]</p><p>Obs: caso prefira, pode-se também executar o script através do prompt de comando, informando:</p><pre>importa-biblioteca.exe arquivo1.txt arquivo2.txt arquivo3.txt</pre><p>onde arquivo1.txt arquivo2.txt... são os arquivos exportados do Excel. Pode-se informar vários arquivos ao mesmo tempo, sendo que os arquivos serão processados todos juntos.</p>
#A etapa anterior produziu um arquivo '''.sql''' no diretório. Abra este arquivo no SQL Server Management Studio.<p>[[File:ClipCapIt-180910-182202.PNG]]</p>
# Dentro do SQL Server Manager Studio, procure pela linha '''declare @ESPELHO bit = 0;'''. Utilize:
# Dentro do SQL Server Manager Studio, procure pela linha '''declare @ESPELHO bit = 0;'''. Utilize:
#* '''declare @ESPELHO bit = 0;''': irá fazer apenas inclusões de publicações/exemplares que ainda não estão cadastradas no Totvs Gestão Bibliotecária. Utilize esta opção quando foi utilizado como fonte de dados um dos arquivos contendo apenas as atualizações das publicações, ou seja, apenas as publicações que foram incluídas no acervo da biblioteca digital. Esta é a opção padrão; assim, se não for feita nenhuma alteração manual, é este o modo que será utilizado.
#* '''declare @ESPELHO bit = 0;''': irá fazer apenas inclusões de publicações/exemplares que ainda não estão cadastradas no Totvs Gestão Bibliotecária. Utilize esta opção quando foi utilizado como fonte de dados um dos arquivos contendo apenas as atualizações das publicações, ou seja, apenas as publicações que foram incluídas no acervo da biblioteca digital. Esta é a opção padrão; assim, se não for feita nenhuma alteração manual, é este o modo que será utilizado.
O script executa em uma transação, que é desfeita automaticamente em caso de erro. Verifique as mensagens produzidas pelo processo para verificar se houve algum erro durante o processo.
O script executa em uma transação, que é desfeita automaticamente em caso de erro. Verifique as mensagens produzidas pelo processo para verificar se houve algum erro durante o processo.
O script sempre produzirá um único arquivo '''.sql''' por execução, independente do número de arquivos '''.txt''' fornecidos para ele.
O script sempre produzirá um único arquivo '''.sql''' por execução, independente do número de arquivos '''.mrc''' fornecidos para ele.
=== Casos tratados pelo script de importação ===
=== Casos tratados pelo script de importação ===
** Cadastrar publicação e demais registros associados (editoras, locais, autores, etc.) caso eles ainda não existam;
** Cadastrar publicação e demais registros associados (editoras, locais, autores, etc.) caso eles ainda não existam;
** Cadastrar um exemplar para esta publicação. Isso é necessário porque a publicação apenas é listada na pesquisa do acervo caso exista pelo menos um exemplar ativo.
** Cadastrar um exemplar para esta publicação. Isso é necessário porque a publicação apenas é listada na pesquisa do acervo caso exista pelo menos um exemplar ativo.
* Alteração 02: remover um título:
* Alteração 02: remover um título (somente quando a variável '''@ESPELHO''' for definida como '''1''')
** Essa situação pode acontecer caso uma obra seja removida da biblioteca digital;
** Essa situação pode acontecer caso uma obra seja removida da biblioteca digital;
** Nestes casos, o exemplar será baixado (preenchida data de baixa) e a situação do exemplar será alterada para ''Removido do acervo digital''.
** Nestes casos, o exemplar será baixado (preenchida data de baixa) e a situação do exemplar será alterada para ''Removido do acervo digital''.
É importante ressaltar que o script não faz atualização dos campos. Assim, caso algum campo específico do arquivo de importação esteja diferente do ERP, ele '''não será atualizado'''. Isso foi feito porque a bibliotecária irá revisar os livros importados, acertando erros do processo de importação e complementando o cadastro destes. Não alterar os campos evita que alterações feitas por ela sejam sobrescritas caso seja executada uma nova importação.
É importante ressaltar que o script não faz atualização dos campos. Assim, caso algum campo específico do arquivo de importação esteja diferente do ERP, ele '''não será atualizado'''. Isso foi feito porque a bibliotecária irá revisar os livros importados, acertando erros do processo de importação e complementando o cadastro destes. Não alterar os campos evita que alterações feitas por ela sejam sobrescritas caso seja executada uma nova importação.
== O processo de baixa de exemplares ==
== O processo de baixa de exemplares ==