1. arquivo xml

Transcrição

1. arquivo xml
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
<
&lt;
>
&gt;
'
&apos;
"
&quot;
/
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.