Método gravarCoordenadasGeograficas
- Objetivo do Método:
Inscrever informações de uma Coordenada Geográfica. Para realizar uma alteração em um registro, basta que o método de inserção seja usado. O WS ao localizar um registro já existente irá realizar o merge (mescla) das informações, atualizando os dados.
- Pré-condição:
Estabelecimento cadastrado
Propriedade cadastrada
Aglomeração cadastrada
Unidade de Produção cadastrada
Unidade de Consolidação cadastrada
OESA cadastrada
- Campos de Entrada:
Atributo |
Tipo de Dados |
Chave |
Regras |
Valor Padrão |
Observação |
ID_COORDENADA |
NUMBER(10) |
PK |
|
Identificador único do Registro |
|
ID_ESTABELECIMENTO_POA |
NUMBER(10) |
|
|
Identificador de Estabelecimento de POA |
|
ID_PROPRIEDADE |
VARCHAR(11) |
|
|
Identificador de Propriedade (Estabelecimento) Rural |
|
ID_AGLOMERACAO |
NUMBER(10) |
|
|
Identificador de Aglomeração |
|
ID_UNIDADE_PRODUCAO |
NUMBER(17) |
|
|
Identifica a Unidade de Produção |
|
ID_UNIDADE_CONSOLIDACAO |
NUMBER(12) |
|
|
Identifica a Unidade de Consolidação |
|
ID_OESA |
NUMBER(10) |
|
|
Identificador de OESA |
|
DS_ORIENT_LATITUDE |
VARCHAR(1) |
|
|
Descrição da descrição de Latitude (Item 3.2.5) |
|
DS_GRAUS_LATITUDE |
NUMBER(10,4) |
|
|
|
Graus - Latitude |
DS_MINUTOS_LATITUDE |
NUMBER(10,4) |
|
|
|
Minutos - Latitude |
DS_SEGUNDOS_LATITUDE |
NUMBER(10,4) |
|
|
|
Segundos - Latitude |
DS_ORIENT_LONGITUDE |
VARCHAR(1) |
|
|
Descrição da orientação de Longitude (Item 3.2.6) |
|
DS_GRAUS_LONGITUDE |
NUMBER(10,4) |
|
|
|
Graus - Longitude |
DS_MINUTOS_LONGITUDE |
NUMBER(10,4) |
|
|
|
Minutos - Longitude |
DS_SEGUNDOS_LONGITUDE |
NUMBER(10,4) |
|
|
|
Segundos - Longitude |
DS_COORD_PRINCIPAL |
VARCHAR(1) |
|
|
Identifica se a coordenada é a principal do estabelecimento |
|
DS_UTM_LATITUDE |
VARCHAR(25,15) |
|
|
|
Descrição de UTM - Latitude |
DS_UTM_LOGINTUDE |
VARCHAR(25,15) |
|
|
|
Descrição de UTM - Longitude |
DS_COORDENADA |
VARCHAR(60) |
|
|
|
Descrição da coordenada |
SYS_KEY |
VARCHAR(39) |
|
|
Chave de sistema do estado correspondente ao ambiente |
- Campos de Saída:
Nome do Campo |
Tipo de Dados |
Observação |
Mensagem |
Mensagem de Retorno |
|
Status |
Status do Retorno |
ERRO: Quando há alguma falha no resultado, ou o resultado esperado não é alcançado SUCESS: Quando o resultado esperado é alcançado |
- Exemplo de XML de Entrada:
O XML do método, gerado pelo WSDL, apresentará o sinal “?” para as tags. O “?” deverá ser substituído pelo valor do campo correspondente.
IMPORTANTE: Caso o campo não tenha valor, o mesmo não deverá ser enviado, sob pena de geração de erro na tentativa de consumo do método.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.ws.pga.id2.inf.br/">
<soapenv:Header/>
<soapenv:Body>
<web:gravarCoordenadasGeograficas>
<!--Optional:-->
<idCoordenada>5300000001</idCoordenada>
<!--Optional:-->
<idEstabelecimentoPoa>?</idEstabelecimentoPoa>
<!--Optional:-->
<idPropriedadeRural>53000000001</idPropriedadeRural>
<!--Optional:-->
<idAglomeracao>?</idAglomeracao>
<!--Optional:-->
<idOesa>?</idOesa>
<!--Optional:-->
<idUnidadeProducao>?</idUnidadeProducao>
<!--Optional:-->
<idUnidadeConsolidacao>?</idUnidadeConsolidacao>
<!--Optional:-->
<dsOrientLatitude>S</dsOrientLatitude>
<!--Optional:-->
<dsGrausLatitude>15</dsGrausLatitude>
<!--Optional:-->
<dsMinutosLatitude>46</dsMinutosLatitude>
<!--Optional:-->
<dsSegundosLatitude>46</dsSegundosLatitude>
<!--Optional:-->
<dsOrientLongitude>O</dsOrientLongitude>
<!--Optional:-->
<dsGrausLongitude>47</dsGrausLongitude>
<!--Optional:-->
<dsMinutosLongitude>55</dsMinutosLongitude>
<!--Optional:-->
<dsSegundosLongitude>46</dsSegundosLongitude>
<!--Optional:-->
<dsCoordPrincipal>1</dsCoordPrincipal>
<!--Optional:-->
<dsUtmLatitude>-15.7797200°</dsUtmLatitude>
<!--Optional:-->
<dsUtmLongitude>-47.9297200°</dsUtmLongitude>
<!--Optional:-->
<dsCoordenada>Teste</dsCoordenada>
<!--Optional:-->
<sysKey>{Syskey do Estado}</sysKey>
</web:gravarCoordenadasGeograficas>
</soapenv:Body>
</soapenv:Envelope>
- Exemplo de XML de Saída:
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:gravarCoordenadasGeograficasResponse xmlns:ns2="http://webservice.ws.pga.id2.inf.br/">
<return><mensagem>MS0002</mensagem>
<status>SUCESSO</status></return>
</ns2:gravarCoordenadasGeograficasResponse>
</S:Body>
</S:Envelope>