1. ARQUIVO XML 1.1. O arquivo XML deverá possuir o seguinte formato: <?xml version="1.0" encoding="iso-8859-1"?> <BancoLight> <Individuo> <NOME>ABIAS FRANCISCO DE SOUZA</NOME> <CNPJCPF>68884087872</CNPJCPF> <NMATRICULA>101264</NMATRICULA> </Individuo> <Individuo> <NOME>ABILIO ASHCAR</NOME> <CNPJCPF>00106356887</CNPJCPF> <NMATRICULA>148012</NMATRICULA> </Individuo> <Individuo> <NOME>ABYARA PLANEJAMENTO IMOBILIARIO S/A</NOME> <CNPJCPF>07794351000160</CNPJCPF> <NMATRICULA>345608</NMATRICULA> * O formato do encoding do arquivo foi alterado da primeira versão desse documento, pois o formato anterior (UTF 8) não aceita acentos. Com o novo formato adotado (iso-8859-1), o arquivo aceita acentuação, cedilha, etc. Só devem ser observados os caracteres especiais, que estão sendo listados no item 2.1.2. 1.2. Desta forma, o cartório irá disponibilizar somente o Nome/Razão Social e o CNPJ/CPF de cada registro disponível no banco de dados do cartório 1.3. Caso o CNPJ/CPF não esteja cadastrado no banco do cartório, este campo deverá vir em branco. 1.4. Para carga inicial de dados, deverá ser gerado um arquivo contendo todos os registros disponíveis nos bancos de dados de cada cartório. 1.5. Uma vez gerado esse primeiro arquivo, os demais deverão conter somente os novos registros que foram inseridos no banco de dados do cartório 1.6. O sistema não fará exclusão dos registros que eventualmente deixaram de fazer parte do banco de dados dos cartórios, assim como não fará atualização de dados de um indivíduo que já existe no banco de dados do sistema. Sendo assim, os registros que sofreram alteração no banco de dados dos cartórios não precisam fazer parte dos arquivos gerados 2. GERAÇÃO DO ARQUIVO XML 2.1. Abaixo iremos enumerar alguns problemas em relação ao formato de arquivo XML que comumente encontramos: 2.1.1. Alteração de letras maiúsculas e minúsculas – como o XML é CASE SENSITIVE (ou seja, para ele as letras “A” e “a” são caracteres totalmente diferentes), temos que ficar atentos em seguir exatamente o padrão que foi informado anteriormente. Por exemplo, se a tag “<NOME>” do arquivo vier em letras minúsculas (mesmo que seja somente uma delas) esse arquivo não poderá ser lido pelo sistema. 2.1.2. Caracteres inválidos – existem certos caracteres que não são válidos no formato XML. Nesse caso, eles devem ser alterados por caracteres especiais, que no XML são lidos e interpretados da forma correta. Segue abaixo uma lista destes caracteres: CARACTERES NÃO ACEITOS ALTERAR PARA < < > > ' ' " " / Não e permitido Exemplo ( S/A) & E Obs.: Arquivos que porventura possuírem os caracteres não aceitos, não serão lidos pelo sistema. 2.1.3. Fechamento correto das tags – As tags do XML devem estar devidamente fechadas, senão o arquivo se torna inválido. Veja o exemplo abaixo: <Individuo> <NOME>GDR7 IT SOLUTIONS S/A</NOME> <CNPJCPF>05095034000120</CNPJCPF> <Individuo> Nesse caso, o arquivo estaria em formato inválido, pois a tag Individuo não está sendo devidamente encerrada. Veja abaixo o formato correto: <Individuo> <NOME>GDR7 IT SOLUTIONS S/A</NOME> <CNPJCPF>05095034000120</CNPJCPF> </Individuo> Mesmo tomando cuidado com os detalhes acima citados, que são os problemas mais comuns encontrados, é interessante que todos os arquivos XML gerados, pelo menos num primeiro momento, sejam verificados quanto à consistência. Para isso, basta abrir este arquivo no browser, e verificar se ele abre até o último registro. Caso ocorra algum erro, ele será interrompido, e exibirá uma mensagem de erro, como podemos ver no exemplo abaixo: The XML page cannot be displayed Cannot view XML input using XSL style sheet. Please correct the error and then click the Refresh button, or try again later. Whitespace is not allowed at this location. Error processing resource 'file:///C:/Documents and Settings/alexandre/My Docum... <Nome>RAMIRO & CIA LTDA</Nome> --------------------^ AN></Nome> <CNPJCPF>047439388</CNPJCPF> </Individuo> - <Individuo> Desta forma, evitamos perda de tempo fazendo o upload de um arquivo com problemas, que não poderá ser lido pelo sistema. 3. PROCESSO DE ENVIO DE ARQUIVO 3.1. Para fazer o Envio do Arquivo, o usuário irá utilizar a seguinte interface: 3.2. Menu – Cartório/Envio de Arquivo. 3.3. O sistema irá reconhecer automaticamente, através do usuário logado, a qual cartório ele pertence 3.4. A data será gravada automaticamente pelo sistema (Data Atual) 3.5. O usuário poderá selecionar o arquivo desejado, que poderá estar na rede ou na própria estação do usuário 3.6. Só serão aceitos arquivos no formato XML. Caso não seja nesse formato, será gerada uma crítica ao usuário 3.7. Assim que o usuário clicar OK, o sistema irá validar o arquivo e disparar o processo de importação dos dados. Então será exibida a seguinte interface ao usuário: 3.8. Nesse momento, o processo de leitura dos dados estará sendo processado no servidor da Arisp. 3.9. Para o usuário consultar o status do processo, ele deverá acessar a seguinte interface: 3.10. 1. Menu Cartório/Controle de Arq. Env. Nessa interface o usuário poderá visualizar a data do envio de arquivo, qual o usuário que disparou o processo, qual o Status (Processando ou Concluído), qual a quantidade de registros importados (somente para os processos concluídos), e também poderá abrir o arquivo XML para visualização.