Commit c4eae2e40bdcb998cf9dc99e5da75970b422f74b

Authored by Edmar Moretti
1 parent 3783c439

Documentacao dos codigos

Showing 1 changed file with 72 additions and 3 deletions   Show diff stats
admin/php/classe_metaestat.php
... ... @@ -2212,6 +2212,22 @@ class Metaestat{
2212 2212 }
2213 2213 return false;
2214 2214 }
  2215 + /**
  2216 + * Insere dados de um arquivo CSV em uma tabela no padrão usado pelo METAESTAT
  2217 + * O arquivo ja deve estar no servidor
  2218 + * A medida de variavel ja deve ter sido criada
  2219 + * A tabela deve ter a estrutura de colunas utilizada como padrao do METAESTAT
  2220 + * @param nome do arquivo csv (no servidor)
  2221 + * @param ID da medida da variavel
  2222 + * @param codigo do tipo de regiao
  2223 + * @param nome da coluna no CSV que contem os valores
  2224 + * @param substituir|adicionar os dados
  2225 + * @param (opcional) nome da coluna no arquivo csv que contem o ano do dado
  2226 + * @param (opcional) nome da coluna no arquivo csv que contem o mes do dado
  2227 + * @param (opcional) nome da coluna no arquivo csv que contem o dia do dado
  2228 + * @param (opcional) nome da coluna no arquivo csv que contem a hora do dado
  2229 + * @return string
  2230 + */
2215 2231 function inserirDados($nomearquivoserv,$id_medida_variavel,$codigoregiao,$valor,$tipoinclusao,$ano="",$mes="",$dia="",$hora=""){
2216 2232 if(!file_exists($nomearquivoserv)){
2217 2233 return "Arquivo de dados nao encontrado";
... ... @@ -2320,6 +2336,16 @@ class Metaestat{
2320 2336 }
2321 2337 return "Processo concluido para ".count($linhas)." linhas";
2322 2338 }
  2339 + /**
  2340 + * Edita a tabela com os dados de um tipo de regiao
  2341 + * @param codigo do tipo de regiao no cadastro
  2342 + * @param nome da coluna que identifica cada registro na tabela de regioes
  2343 + * @param valor do indicador
  2344 + * @param nome da regiao
  2345 + * @param wkt
  2346 + * @param excluir|alterar tipo de operacao
  2347 + * @return string
  2348 + */
2323 2349 function mantemDadosRegiao($codigo_tipo_regiao,$identificador,$identificadornovo,$nome,$wkt="",$tipo=""){
2324 2350 if($tipo != "excluir" && ($identificadornovo == "" || $nome == "")){
2325 2351 return array("erro");
... ... @@ -2397,6 +2423,13 @@ class Metaestat{
2397 2423 }
2398 2424 return array("ok");
2399 2425 }
  2426 + /**
  2427 + * Obtem o valor de um registro de uma tabela de regiao com base na coordenada de longitude e latitude
  2428 + * @param codigo do tipo de regiao
  2429 + * @param longitude
  2430 + * @param latitude
  2431 + * @return array
  2432 + */
2400 2433 function xy2regiao($codigo_tipo_regiao,$x,$y){
2401 2434 //pega a tabela, esquema e conexao para acessar os dados da regiao
2402 2435 $regiao = $this->listaTipoRegiao($codigo_tipo_regiao);
... ... @@ -2412,6 +2445,14 @@ class Metaestat{
2412 2445 return "";
2413 2446 }
2414 2447 }
  2448 + /**
  2449 + * Busca os dados de uma medida de variavel para uma regiao
  2450 + * Identificador da regiao e o valor a ser encontrado na coluna de
  2451 + * ligacao da tabela da medida da variavel com a tabela com as localidades (tipo de regiao)
  2452 + * @param identificador da regiao
  2453 + * @param id da medida da variavel
  2454 + * @return multitype:unknown multitype: string
  2455 + */
2415 2456 function listaAtributosMedidaVariavelRegiao ($identificador_regiao,$id_medida_variavel){
2416 2457 $medida = $this->listaMedidaVariavel("",$id_medida_variavel);
2417 2458 $c = $this->listaConexao($medida["codigo_estat_conexao"],true);
... ... @@ -2439,6 +2480,16 @@ class Metaestat{
2439 2480 $r = $q->fetchAll();
2440 2481 return array("dados"=>$r,"aliascolunas"=>$alias,"colunas"=>$colunas,"descricao"=>$descricao);
2441 2482 }
  2483 + /**
  2484 + * Salva os atributos de uma medida de variavel com base em uma localizacao
  2485 + * @param id da medida de variavel
  2486 + * @param codigo do tipo de regiao
  2487 + * @param identificador da regiao
  2488 + * @param array contendo os identificadores unicos de cada registro na tabela com os dados da medida de variavel
  2489 + * @param array com as colunas que contem os dados que serao modificados
  2490 + * @param array com os valores para as colunas
  2491 + * @return string
  2492 + */
2442 2493 function salvaAtributosMedidaVariavel($id_medida_variavel,$codigo_tipo_regiao,$identificador_regiao,$idsunicos,$colunas,$valores){
2443 2494 $medida = $this->listaMedidaVariavel("",$id_medida_variavel);
2444 2495 if($medida["esquemadb"] != "i3geo_metaestat"){
... ... @@ -2489,7 +2540,13 @@ class Metaestat{
2489 2540 }
2490 2541 return array("ok");
2491 2542 }
2492   - //altera os registros de uma medida de variavel (muda para negativo)
  2543 + /**
  2544 + * Transforma em um valor negativo o id de uma medida de variavel na tabela com os dados
  2545 + * A tabela com os dados deve ter uma coluna chamada id_medida_variavel
  2546 + * Utilizado para marcar como removido os registros de uma medida de variavel
  2547 + * @param id da medida de variavel
  2548 + * @return string
  2549 + */
2493 2550 function negativaValoresMedidaVariavel($id_medida_variavel){
2494 2551 $medida = $this->listaMedidaVariavel("",$id_medida_variavel);
2495 2552 if($medida["esquemadb"] != "i3geo_metaestat"){
... ... @@ -2514,8 +2571,15 @@ class Metaestat{
2514 2571 }
2515 2572 return array("ok");
2516 2573 }
2517   -
2518   - //exclui o valor de uma medida em uma regiao especifica (utilizado pelo editor de limites)
  2574 + /**
  2575 + * Exclui o valor de uma medida em uma regiao especifica
  2576 + * Utilizado pelo editor de limites
  2577 + * @param id da medida de variavel
  2578 + * @param codigo do tipo de regiao
  2579 + * @param identificador da regiao
  2580 + * @param identificador do registro que sera removido da tabela com os dados
  2581 + * @return string
  2582 + */
2519 2583 function excluiAtributosMedidaVariavel($id_medida_variavel,$codigo_tipo_regiao,$identificador_regiao,$id){
2520 2584 $medida = $this->listaMedidaVariavel("",$id_medida_variavel);
2521 2585 if($medida["esquemadb"] != "i3geo_metaestat"){
... ... @@ -2545,6 +2609,11 @@ class Metaestat{
2545 2609 }
2546 2610 return array("ok");
2547 2611 }
  2612 + /**
  2613 + * Converte um tipo de regiao em shapefile
  2614 + * @param codigo do tipo de regiao
  2615 + * @return nome do arquivo criado
  2616 + */
2548 2617 function regiao2shp($codigo_tipo_regiao){
2549 2618 $regiao = $this->listaTipoRegiao($codigo_tipo_regiao);
2550 2619 $dados = $this->obtemDadosTabelaDB($regiao["codigo_estat_conexao"],$regiao["esquemadb"],$regiao["tabela"],"sim");
... ...