Relatorio De XML - ATPS

1. APRESENTAÇÃO

Este Manual de Instruções tem como objetivo auxiliar os técnicos e gestores da área de Tecnologia da empresa Vassoura Vassourinha XXI LTDA no processo de registro e armazenamento dos dados relativos aos procedimentos de venda e outros serviços ofertados.

2. CONTEXTUALIZAÇÃO

Com o intuito de oferecer possibilidades de inserções de dados no Sistema de Informação de Dados Comerciais da empresa, foi desenvolvido um módulo de transferência de arquivos em formato XML. Este formato permite que os dados a serem enviados sejam preenchidos através de tags em arquivo separado que pode ser obtido como resultado de um sistema de gestão local, sem a necessidade de digitar os dados.

Essa nova possibilidade de inserção de dados visa automatizar e substituir a forma como está sendo feita atualmente, contribuindo com maior velocidade e confiabilidade no armazenamento e distribuição de dados. Insere-se no sistema de informação da companhia e gera-se o arquivo XML com o formato conforme instruído neste manual.

3. O QUE É O XML

XML é a sigla para Extensible Markup Language, que significa em português, Linguagem Extensível de Marcação, é uma linguagem de marcação recomendada pela W3C1 para a criação de documentos com dados organizados hierarquicamente, tais como textos e banco de dados. A linguagem XML é classificada como extensível porque permite definir os elementos de marcação.

O XML traz uma sintaxe básica que pode ser utilizada para compartilhar informações entre diferentes computadores e aplicações. Quando combinado com outros padrões, torna possível definir o conteúdo de um documento separadamente de seu formato, tornando simples para reutilizar o código em outras aplicações para diferentes propósitos.

O XML agrupa-se em tags, que é um identificador dos elementos presentes no documento. Por exemplo <nome> é uma tag inicial e o termo </nome> é a final.

Toda tag inicial tem uma final correspondente. Assim se um texto tem a tag inicial <nome> ele tem que ter também, em algum lugar mais adiante, a final </nome>. Entre as duas tags ficam as informações do elemento. Observe o exemplo para que se entenda melhor a utilização e posição.

É importante saber que, para que o computador entenda que o arquivo é do formato XML é necessário no momento em que o usuário for salvar o arquivo, utilizar a extensão (.xml), por exemplo, cras.xml.

4. CRIAÇÃO DO ARQUIVO XML

Para criar o arquivo XML, basta abrir um editor de texto puro, como o programa Bloco de Notas presente no Windows, e inserir todas as variáveis contidas no formulário em formato de tags (pode-se utilizar as tags utilizadas como no exemplo contido no anexo deste manual), não se esquecendo de sempre de abri-las com os símbolos <> (menor que e maior que) e fechar com </> (menor que, barra e maior que) as tags utilizadas e salvar o arquivo dando um nome qualquer e utilizando a extensão (.xml).

Sempre que um arquivo XML for criado, é necessário iniciá-lo com a tag de abertura <cras>, assim informa-se que os dados inseridos são do CRAS e após as tags que contém os dados estarem inseridas é necessário utilizar, ao final, a tag de fechamento </cras>

Padrão de documento XML

a) Padrão de Codificação

A especificação do documento XML adotada é a recomendação W3C para XML 1.0, disponível em www.w3.org/TR/REC-xml e a codificação dos caracteres será em UTF-8, assim todos os documentos XML serão iniciados com a seguinte declaração:

<?xml version="1.0" encoding="UTF-8"?>

OBS: Lembrando que cada arquivo XML somente poderá ter uma única declaração <?xml version="1.0" encoding="UTF-8"?>. Nas situações em que um documento XML pode conter outros documentos XML, como ocorre com o documento XML de lote de envio de NF-e, deve-se tomar o cuidado para que exista uma única declaração no início do lote.

b) Declaração namespace

A declaração de namespace da NF-e deverá ser realizada no elemento raiz de cada documento XML como segue:

<NFe xmlns=”http://www.portalfiscal.inf.br/nfe” > (exemplo para o XML da NF-e)

Não é permitida a utilização de prefixos de namespace. Essa restrição visa otimizar o tamanho do arquivo XML. Assim, ao invés da declaração:

<NFe:NFe xmlns:NFe=”http://www.portalfiscal.inf.br/nfe” > (exemplo para o XML da NF-e e com prefixo NFe) deverá ser adotado a declaração:

<NFe xmlns =”http://www.portalfiscal.inf.br/nfe”