search

CamaraDosDeputados / dados-abertos

Repositório do serviço de Dados Abertos da Câmara. Consulte as "Issues" para atendimento a dúvidas e sugestões.
http://dadosabertos.camara.leg.br
196 stars 13 forks source link

proposicoes - fornecer campo com título da proposição (ex. "SBT-A 1 CCULT => PL 1/2019") #281

Open jeslopes72 opened 4 years ago

jeslopes72 commented 4 years ago

Problema: Com os dados do endpoint proposicoes, não se consegue gerar facilmente o texto que identifica corretamente a proposição, no caso de proposições subordinadas a outras (ex. substitutivos, emendas, etc.).

Esse campo seria útil para endpoints que retornam uma lista de proposições também. Ex. https://dadosabertos.camara.leg.br/api/v2/proposicoes/2190407/relacionadas

Gerar a identificação correta pode não ser trivial (ex. "SBE-A 1 CCJC => SBT 4 CSSF => PL 1549/2003", https://www.camara.leg.br/proposicoesWeb/fichadetramitacao?idProposicao=2216354) e gerar chamadas adicionais ao endpoint...

EquipeDadosAbertosCD commented 4 years ago

Olá de novo, Jes!

Demorei um pouco para entender, mas acho que você está falando do "título", esse nome que é dado a cada proposição, composto de siglas, números e ano.

Apesar de tradicional, essa forma de montar uma string como "SBE-A 1 CCJC => SBT 4 CSSF => PL 1549/2003" não é oficial, isto é, não é estabelecida pelo Regimento Interno nem por qualquer resolução, portaria ou Ato da Mesa a que tivemos acesso. Provavelmente por esta mesma razão não há, nas bases de dados da Câmara, um título com esse ou qualquer outro formato para as proposições. Não é da competência, da autoridade do serviço de Dados Abertos criar informação, e para aplicações de dados abertos os identificadores corretos são sempre URLs ou URNs – mesmo que não sejam em nada amigáveis para pessoas.

Nas comissões, as proposições acessórias por elas criadas recebem oficialmente apenas uma atribuição de tipo (representada pela sigla) e uma numeração exclusiva de cada comissão.

Esse formato de título para "leitura humana em ASCII" é montado pelo servidor do Portal da Câmara, ou seja, na camada de aplicação. Alguém achou conveniente representar a subordinação de uma proposição a outra por meio dos caracteres "=>". Essa relação poderia ser exibida de forma gráfica ou algébrica, conforme a conveniência de cada aplicação.

Em tempo: ainda vamos aperfeiçoar o fornecimento de dados sobre o relacionamento entre as proposições, o que pode ajudar na criação dessas formas inovadoras de representar as relações.

Abraço!

Fabricio Rocha Equipe Dados Abertos - Câmara

jeslopes72 commented 4 years ago

Oi Fabricio! Revistando este ticket. Mantendo aberto pois mesmo que não seja intenção entregar o título completo, o serviço de dados abertos deveria entregar os dados e orientações suficientes para que pudessemos montar o título adequadamente, para que as pessoas entendam a que proposição se refere a informação no nosso sistema. Mesmo que nosso sistema use a identificação numérica para se comunicar com o dados abertos, as pessoas vão se comunicar usando o título (ou identificação mnemônica). Assim, precisamos entender:

EquipeDadosAbertosCD commented 4 years ago

Olá de novo, Jes!

Conseguimos achar uma fonte para a informação desse "título" das proposições e estamos o inserindo aos poucos nas respostas que incluem referências a proposições.

De toda forma, respondendo:

Abraço!

Fabricio Rocha Equipe Dados Abertos - Câmara