PROCEDIMENTOS PARA ENVIO DOS DADOS HIDROLGICOS EM TEMPO REAL DAS ESTAES TELEMTRICAS

Repblica Federativa do Brasil Dilma Vana Rousseff Presidenta Ministrio do Meio Ambiente (MMA) Izabella Mnica Vieira Teixeira Ministra Agncia Nacional de guas (ANA) Diretoria Colegiada Vicente Andreu Guillo (Diretor-Presidente) Dalvino Troccoli Franca Paulo Lopes Varella Neto Joo Gilberto Lotufo Conejo Paulo Rodrigues Vieira Superintendncia de Gesto da Rede Hidrometeorolgica SGH Valdemar Santos Guimares Superintendente

Agncia Nacional de guas

Ministrio do Meio do Meio Ambiente

PROCEDIMENTOS PARA ENVIO DOS DADOS HIDROLGICOS EM TEMPO REAL DAS ESTAES TELEMTRICAS
Verso Junho 2012

SUPERINTENDNCIA DE GESTO DA REDE HIDROMETEOROLGICA (SGH) BRASLIA-DF, 2012

 2012 Agncia Nacional de guas (ANA). Setor Policial Sul, rea 5, Quadra 3, Blocos B, L, M e T. CEP: 70610-200, Braslia DF PABX: (61) 2109-5400 / (61) 2109-5252 Endereo eletrnico: www.ana.gov.br

Equipe editorial Superintendncia de Gesto da Rede Hidrometeorolgica SGH Valdemar Santos Guimares Superintendente Eurides de Oliveira Superintendente Adjunto

Gerncia de Planejamento da Rede Hidrometeorolgicos GPLAN Fabrcio Vieira Alves Gerente

Reviso Final Leny Simone Tavares Mendona

Todos os direitos reservados. permitida a reproduo de dados e informaes contidos nesta publicao, desde que citada a fonte.

A265p

Agncia Nacional de guas (Brasil). Procedimentos para envio dos dados hidrolgicos em tempo real das estaes telemtricas / Agncia Nacional de guas, Superintendncia de Gesto da Rede Hidrometeorolgica. -- Braslia: ANA, SGH, 2012. 19p. : il.

1. Dados hidrolgicos 2. Telemetria I. Agncia Nacional de guas (ANA) II. Ttulo CDU 556.04(81)

Sumrio 1 Apresentao 2 Introduo 3 Cadastro de Usurios e Gerao de Senhas 4 Envio dos Dados Hidrolgicos em Tempo Real 4 4 6 6

2.1 Como entrar em contato com a ANA ........................................................................ 5

4.1 Layout do Arquivo ....................................................................................................... 9 4.2 Critrios para Formatao dos Dados ........................................................................ 11 4.3 Requisitos Gerais do Envio de Dados ........................................................................ 12 4.4 Orientaes para o Envio dos Dados no Ambiente de Homologao (Teste) ......... 12 4.5 Orientaes para o Envio dos Dados no Ambiente de Produo ............................ 13

5 Relatrio de Acompanhamento 6 Orientaes Finais

13 16

1 Apresentao
A Resoluo Conjunta ANEEL/ANA n 03, de 10 de agosto de 2010, publicada em 20 de outubro de 2010, estabelece as condies e os procedimentos a serem observados pelos concessionrios e autorizados de gerao de energia hidreltrica para a instalao, operao e manuteno de estaes hidromtricas visando ao monitoramento pluviomtrico, limnimtrico, fluviomtrico, sedimentomtrico e de qualidade da gua associado a aproveitamentos hidreltricos. A ANA, com tal Resoluo, assume a funo de orientar os agentes do setor eltrico sobre os procedimentos de coleta, tratamento e armazenamento dos dados hidromtricos objetos do normativo, bem como sobre a forma de envio dessas informaes em formato compatvel com o Sistema Nacional de Informaes sobre Recursos Hdricos (SNIRH), o que permitir a difuso dos dados em tempo real oriundos do monitoramento hidrolgico realizado pelos agentes do setor eltrico. A reviso realizado no documento em maro de 2012 objetivou apresentar o ambiente de teste para a conexo dos sistemas de transmisso de dados em tempo real, bem como informar sobre os procedimentos para inicio dos testes e recebimento das senhas de acesso. Esta reviso de junho de 2012 objetiva revisar o modelo gerado pelo protocolo SOAP para envio dos dados, o modelo da solicitao de um relatrio de acompanhamento dos dados enviados para o banco de dados da ANA e o exemplo de uma consulta resposta do sistema acerca do relatrio de acompanhamento dos dados enviados para o banco de dados do SNIRH.

2 Introduo
A Resoluo Conjunta ANA ANEEL 3/2010 estabelece, no que concerne o envio dos dados coletados das estaes pluviomtricas, linmtricas e fluviomtricas, em seu Art. 5: Art. 5 Todas as estaes hidromtricas com monitoramento pluviomtrico, limnimtrico e fluviomtrico devero ser automatizadas e telemetrizadas, devendo as informaes coletadas serem registradas em intervalo horrio, ou menor, com disponibilizao horria ANA, por meio de servios de transferncia via internet no formato e endereo indicado pela ANA Sendo assim, a ANA neste documento estabelece as regras, procedimentos e etapas para o envio das medies realizadas em tempo real pelas estaes pluviomtricas, limnimtricas e fluviomtricas automticas e com transmisso telemtricas, operadas pelas empresas de gerao hidreltricas.

Aps envio dos dados em tempo real pelas operadoras, recepo, anlise e aprovao automtica pelos sistemas da ANA, os dados sero inseridos na base de dados hidrometeorolgicos da ANA Banco de Dados Hidrolgicos de Referncia - BDHR, sendo posteriormente disponibilizados na internet, por meio do sitio www.ana.gov.br/telemetria

2.1 Como entrar em contato com a ANA

Os contatos e informaes referentes Resoluo Conjunta ANA ANEEL n 3/2010 podem ser obtidos nos Endereos que se seguem:

Endereo: Agncia Nacional de guas (ANA) Valdemar Santos Guimares Superintendncia de Gesto da Rede Hidrometeorolgica (SGH) Setor Policial, rea 5, Quadra 3, Bloco L Braslia DF, Brasil. CEP 70610-200

Na Internet: Para o correio eletrnico resolucaoconjunta3@ana.gov.br (casos especficos do monitoramento em tempo real das estaes hidrolgicas objeto da Resoluo Conjunta ANA ANEEL n 3/2010) e para sgh@ana.gov.br quando se tratar dos demais assuntos sobre a Rede Hidrometeorolgica da ANA.

3 Cadastro de Usurios e Gerao de Senhas

O cadastramento das entidades ser realizado internamente pela ANA com base no Cadastro Nacional da Pessoa Jurdica - CNPJ de cada empresa detentora das Usinas Hidreltricas. S ser permitido o envio dos dados hidrolgicos da empresa cadastradas na ANA, isto por CNPJ. O sistema estar bloqueado para envio, em um mesmo pacote de dados, de estaes de empresas diferentes, visto que o tratamento ser realizado por CNPJ. Para realizar esse cadastramento a ANA necessita que cada empresa envie para o correio eletrnico resolucaoconjunta3@ana.gov.br as seguintes informaes: nome, CNPJ e telefone da Empresa detentora da(s) Usina(s) nome, telefone e e-mail de tcnicos autorizados pela empresa a receber o login e senha para acesso aos sistema de recebimento de dados hidrolgicos em tempo real. Neste cadastro sero gerados, automaticamente, pelo Sistema Nacional de Informaes de Recursos Hdricos - SNIRH, uma senha para cada Empresa, com base no CNPJ fornecido. Tais senhas sero enviadas para o(s) e-mail(s) cadastrados anteriormente em resposta ao Oficio Circular n 2/2011/SGH. Ressalta-se que cada entidade responsvel por manter as informaes cadastrais atualizadas de seus contatos, bem como garantir a segurana da senha disponibilizada pela ANA. As atualizaes cadastrais que ocorrero ao longo do tempo podero ser efetivadas por meio do correio eletrnico da Resoluo citado anteriormente.

4 Envio dos Dados Hidrolgicos em Tempo Real

Os dados coletados pelos equipamentos automticos e telemtricos devero ser transmitidos para uma central de apoio, de responsabilidade das entidades operadoras das estaes de monitoramento, em intervalos mnimos de 01 hora, onde devero ser armazenados em uma base local, processados, qualificados e transmitidos para a ANA. Na Figura 1 apresentado o diagrama esquemtico geral da coleta e transmisso de dados para a ANA

Figura 1 - Diagrama esquemtico geral da coleta e transmisso de dados para a ANA.

Os dados devero ser enviados pela Internet, utilizando o servio de comunicao denominado Web Service1, disponibilizado pelo Sistema de Recepo de dados da ANA. Na primeira fase de configurao e conexo dos sistemas, os dados sero enviados para um ambiente de teste, conforme detalhado no item 4.4 deste documento. A troca de mensagens entre os WebServices do ambiente e o aplicativo da empresa ser realizada no padro SOAP2. O fluxo de comunicao dever ser iniciado pelo aplicativo do usurio por meio do envio de uma mensagem ao Web Service com a solicitao do servio desejado. O Web Service devolver uma mensagem de resposta confirmando o recebimento da solicitao de servio ao aplicativo do usurio na mesma conexo. A solicitao de servio poder ser atendida na mesma conexo ou armazenada em filas de processamento nos servios mais crticos para um melhor aproveitamento dos recursos de comunicao e de processamento da Agncia Nacional de guas. O processamento da solicitao de servios ser utilizado na forma sncrona, ou seja, a solicitao concluda na mesma conexo, com a devoluo de uma mensagem com o resultado do processamento do servio solicitado. Na Figura 2 apresentado o fluxo do envio dos dados para o Web Service da ANA.

Web service uma soluo tecnolgica utilizada na integrao de sistemas e na comunicao entre diferentes aplicaes. Com esta tecnologia possvel que novas aplicaes possam interagir com aquelas j existentes e que sistemas desenvolvidos em diferentes plataformas sejam compatveis, permitindo. Os Web Services so identificados por um URI (Uniform Resource Identifier) cujo modelo baseia-se em tecnologias padres, em particular XML e HTTP (Hypertext Transfer Protocol) ou HTTPS (HyperText Transfer Protocol Secure ), sendo utilizados para disponibilizar servios interativos na internet que podem ser acessados por outras aplicaes usando, por exemplo, o protocolo SOAP (Simple Object Access Protocol). Fonte : http://www.w3.org/standards/webofservices/ SOAP( Simple Object Access Protocol,) um protocolo para troca de informaes estruturadas em uma plataforma descentralizada e distribuda. Sua especificao define um framework que prov maneiras para se construir mensagens que podem trafegar atravs de diversos protocolos, e que foi especificado de forma a ser independente de qualquer modelo de programao ou outra implementao especfica. Fonte : http://www.w3.org/standards/techs/soap#w3c_all 8
2

Figura 2 - Fluxo do envio dos dados para o Web Service da ANA.

4.1 Layout do Arquivo

Os parmetros utilizados para consumir o web service so: a) Login e senha do usurio (CNPJ da empresa e senha) usado para autenticar o usurio no SNIRH e garantir a segurana e procedncia das informaes enviadas; b) Cdigo pluviomtrico de 08 dgitos da estao (Exemplo: 00212223); c) Cdigo fluviomtrico de 08 dgitos da estao (Exemplo: 10100000); d) O formato para a Data - Hora - Minuto - Segundo da medio (hora de Braslia sem correo do horrio de vero) : dd/mm/yyyy hh:mm:ss (Exemplo: 16/03/2011 05:00:00);
9

e) Chuva acumulada no perodo de coleta na referida data/hora em milmetros com 01 casa decimal (Exemplo: 12.5); f) Nvel do corpo d'gua na referida data/hora em centmetros e sem casa decimal (Exemplo: 210); g) Vazo medida ou calculada a partir da curva de descarga para a referida data/hora em metros cbicos por segundo com 02 casas decimais (Exemplo: 120.25). Segue um modelo gerado pelo protocolo SOAP para envio dos dados, revisado nessa verso do documento apresentada: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:q0="http://ws.integracao.ana.gov.br/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <soapenv:Body> <q0:inserirMedicao> <login>login1</login> <senha>senha1</senha> <estacao> <codigoFlu>10100000</codigoFlu> <codigoPlu>00212223</codigoPlu> <medicao> <chuva>0.0</chuva> <dataMedicao>16/03/2011 05:05:00</dataMedicao> <nivel>345.6</nivel> <vazao>1234.5</vazao> </medicao> <medicao> <chuva>1.0</chuva> <dataMedicao>16/03/2011 06:05:00</dataMedicao> <nivel>345.9</nivel> <vazao>1234.9</vazao> </medicao> </estacao> </q0:inserirMedicao> </soapenv:Body> </soapenv:Envelope>

Ao trmino da transferncia do arquivo de dados, o sistema disponibilizar uma resposta referente quantidade de informaes recebidas, com sucesso, pelo WebService do SNIRH.

10

Segue exemplo de consulta resposta do sistema acerca da quantidade de dados recebidos pelo WebService do SNIRH e que foi revisado nesta verso do documento. <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns1:inserirMedicaoResponse xmlns:ns1="http://ws.integracao.ana.gov.br/"> <retorno> <mensagem>Dados transmitidos com sucesso.</mensagem> <quantidadeInserida>6</quantidadeInserida> </retorno> </ns1:inserirMedicaoResponse> </soap:Body> </soap:Envelope>

4.2 Critrios para Formatao dos Dados

Os seguintes critrios devero ser observados durante o processo de formatao dos dados hidrolgicos a serem enviados para o banco de dados da ANA: a) Os dados devero ser coletados nas estaes em intervalos de 1 (uma) hora, 30 (trinta) minutos ou quarto de hora (a critrio da entidade), tendo como referncia a hora cheia (Exemplo: para coleta horria 1:00, 2:00, 3:00..., e etc, ou para quartos de hora 1:00, 1:15, 1:30, 1:45, 2:00, ...). A coleta em intervalos diferentes dos mencionados, desde que inferiores a 60 minutos, e/ou a coleta defasada da hora cheia (Exemplo: 1:50, 2:50, 3:50, 4:50 ...) dever ser devidamente justificada ANA para avaliao tcnica; b) Os dados de chuva devero ser acumulados no intervalo de transmisso. Por exemplo, para uma coleta com intervalo horrio a chuva registrada s 14:00h dever corresponder ao valor total da precipitao ocorrida entre as 13:00h e 14:00h; c) A medio do nvel do corpo dgua dever corresponder ao valor instantneo medido no momento da coleta; d) Os dados de vazo devero corresponder ao valor instantneo medido de vazo ou obtidos a partir dos dados de cota aplicados s curvas-chave ajustada para cada seo de medio; e) Os dados de nvel do rio devero ser informados em centmetro (cm), vazo em metros cbicos por segundo (m3/s) e a chuva em milmetros (mm); f) A hora referente a 24:00h deve ser preenchida como 00:00h; g) Os dados coletados nas estaes devero ser transmitidos para o WebService do SNIRH em intervalos mximos de 1 (uma) hora; h) Os dados enviados para a ANA devero estar na hora de Braslia, sem o ajuste para o horrio de vero; i) O separador decimal dever ser o ponto (.) e no deve ser usado separador para o milhar; j) Caso a estao no tenha uma das informaes (chuva, nvel ou vazo), o campo correspondente dever ser deixado em branco; e k) A identificao dos dados transmitidos de chuva ser feita a partir do cdigo de 08 (oito) dgitos fornecido pela ANA para estaes pluviomtricas e os dados de nvel do
11

corpo dgua e vazo sero feitas a partir do cdigo de 08 dgitos fornecido pela ANA para estaes fluviomtricas.

4.3 Requisitos Gerais do Envio de Dados

a) O tempo de atraso no envio dos dados de cada estao telemtrica no dever ultrapassar o mximo de 3 (trs) horas; b) O tempo de interrupo no envio dos dados de cada estao telemtrica no dever ultrapassar o mximo de 96 (noventa e seis) horas; c) A taxa mensal de falhas no envio dos dados de cada estao telemtrica, tomando como referncia um intervalo padro de transmisso de 01 (uma) hora, no dever exceder 15%; d) A no observncia de qualquer um dos trs requisitos mencionados anteriormente nas letras a, b e c, dever ser devidamente justificada ANA para avaliao tcnica; e) Os dados transmitidos para a ANA recebero um status de qualificao (aprovado e reprovado) e status de atraso na transmisso (verdadeiro ou falso); f) Visando evitar o trfego desnecessrio de informaes no se deve realizar a transmisso de dados repetidos (j transmitidos anteriormente) para o WebService do SNIRH; g) As informaes armazenadas localmente nas estaes telemetrizadas devero ser mantidas pela entidade e disponibilizadas para a Agncia caso seja solicitado; h) de responsabilidade dos concessionrios e autorizados manter atualizadas as curvaschave utilizadas em cada estao para o clculo dos dados de vazo a partir das cotas medidas, informando prontamente ANA as alteraes realizadas nos seu ajuste; e i) A qualidade dos dados gerados, bem como sua disponibilizao horria, so de responsabilidade dos concessionrios e autorizados do setor eltrico.

4.4 Orientaes para o Envio dos Dados no Ambiente de Homologao (Teste)

Para iniciar o registro das informaes coletadas utilizando o Web Service que atende a Resoluo Conjunta, o primeiro passo a ser realizado pelos agentes do setor eltrico, aps receber o login e senha de acesso por e-mail, utilizar o ambiente de homologao (ambiente de teste) disponibilizado para realizar todos os testes necessrios. A empresa poder realizar, por tempo indeterminado, experimentos com sua soluo tecnolgica em um ambiente de testes, denominado ambiente de homologao. Este ambiente, em termos computacionais, similar ao de produo. Os dados devero ser enviados pelo servio de comunicao disponibilizado pelo Sistema de Recepo de dados da ANA hospedado no seguinte endereo eletrnico: http://smh.ana.gov.br:8090/ws-telemetria-htc/services e o mesmo servio disponvel via protocolo de envio criptografado em https://smh.ana.gov.br:8443/ws-telemetriahtc/services

12

4.5 Orientaes para o Envio dos Dados no Ambiente de Produo

Aps todos os testes realizados no ambiente de homologao, a empresa dever aguardar comunicado oficial da ANA que ser publicado no sitio http://www2.ana.gov.br/Paginas/servicos/informacoeshidrologicas/monitoramentohidro.aspx, autorizando o incio do registro das informaes coletadas utilizando o Web Service. Desta forma o agente poder enviar os dados de forma definitiva para o ambiente de produo hospedado no seguinte endereo eletrnico: http://smh.ana.gov.br:8090/ws-telemetria/services e o mesmo servio disponvel via protocolo de envio criptografado em https://smh.ana.gov.br:8443/ws-telemetria/services No ambiente de produo dever ser utilizado o mesmo login e senha do ambiente de homologao.

5 Relatrio de Acompanhamento
Durante o processo de envio dos dados ANA o concessionrio ou autorizado ter como retorno somente a quantidade de dados transferidos com sucesso para o SNIRH. Para realizar o acompanhamento da quantidade de dados efetivamente inseridos no banco de dados da ANA, o usurio dever acessar o relatrio de acompanhamento e que estar disponvel no seguinte endereo eletrnico: http://smh.ana.gov.br:8090/ws-telemetria/services e o mesmo servio disponvel via protocolo de envio criptografado em https://smh.ana.gov.br:8443/ws-telemetria/services . Na Figura 3 apresentado o fluxo de acesso ao relatrio de acompanhamento dos dados enviados para o banco de dados da ANA.

13

Figura 3 - Esquema do fluxo para consulta do relatrio de dados enviados ANA.

Para acessar este servio (consumir o web service) o usurio dever fornecer os seguintes parmetros: Usurio e senha (CNPJ e senha); Cdigo Pluviomtrico; Cdigo Fluviomtrico; Data inicial da consulta; e Data final da consulta.

Segue um modelo da solicitao de um relatrio de acompanhamento dos dados enviados para o banco de dados da ANA e que foi revisado nesta verso. <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:q0="http://ws.integracao.ana.gov.br/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <soapenv:Header/> <soapenv:Body>
14

<q0:consultarMedicao> <login>login1</login> <senha>senha1 </senha> <codigoPLU>10100000</codigoPLU> <codigoFLU>00212223</codigoFLU> <dataInicial>16/03/2010 00:00:00</dataInicial> <dataFinal>17/03/2012 00:00:00</dataFinal> </q0:consultarMedicao> </soapenv:Body> </soapenv:Envelope>

Segue um exemplo de uma consulta resposta do sistema acerca do relatrio de acompanhamento dos dados enviados para o banco de dados do SNIRH, revisado nesta verso. <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns1:consultarMedicaoResponse xmlns:ns1="http://ws.integracao.ana.gov.br/"> <retorno> <mensagem>mensagem1</mensagem> <quantidadeInserida>45</quantidadeInserida> </retorno> </ns1:consultarMedicaoResponse> </soap:Body> </soap:Envelope>

Posteriormente a ANA disponibilizar um portal para o acompanhamento do status de qualificao dos dados (aprovado ou reprovado) e o status de atraso na transmisso (verdadeiro ou falso). As informaes retornadas pelo sistema, para cada estao e varivel, sero: Data-hora-minuto da medio; Data-hora-minuto de insero do registro no banco de dado da ANA; Valor da medio; Status da qualificao; e Status do atraso na transmisso.

O status da qualificao ser aprovado ou reprovado, de acordo com o resultado de um filtro de qualidade dos dados aplicado pelo sistema da ANA. O status do atraso na transmisso (verdadeiro ou falso) ser a indicao que houve um atraso de mais de 03 horas no envio dos dados.

15

6 Orientaes Finais
O WebService do Sistema Nacional de Informaes sobre Recursos Hdricos - SNIRH est sendo ajustado para que os dados enviados, sejam visualizados nos sistemas de disponibilizao da dados da ANA. Dvidas tcnicas relativas implantao dos sistemas de transmisso podero ser enviadas para o endereo eletrnico resolucaoconjunta3@ana.gov.br, contendo alm do questionamento, o nome e telefone de contato do interessado, visando facilitar a implantao dos sistemas de transmisso e o auxilio da equipe da ANA. As atualizaes cadastrais (endereo, telefone, tcnico responsvel, correio eletrnico) devero ser enviadas tambm para o correio eletrnico da Resoluo citado anteriormente.

16