<\/div>

<\/div><\/div>

<\/p>\n

layer = iface.activeLayer()<\/p>\n

<\/div><\/div>\n\n\n\n

A primeira regra de seguran\u00e7a \u00e9 simples:<\/p>\n\n\n

<\/div>

<\/div><\/div>

<\/p>\n

if not layer:
\nreturn<\/p>\n

<\/div><\/div>\n\n\n\n

\n
Sem uma camada ativa, nenhuma a\u00e7\u00e3o deve ser executada.<\/p>\n<\/blockquote>\n\n\n\n
\n\n\n\n
<\/span>Verificando se existem fei\u00e7\u00f5es selecionadas<\/span><\/h2>\n\n\n\n
Antes de iniciar qualquer processamento, o plugin deve verificar se o usu\u00e1rio realmente selecionou alguma coisa.<\/p>\n\n\n
<\/div>
<\/div>
<\/div><\/div>
<\/p>\n
selected_features = layer.selectedFeatures()<\/p>\n
if not selected_features:
\n# nenhuma fei\u00e7\u00e3o selecionada
\nreturn<\/p>\n
<\/div><\/div>\n\n\n\n
Nesse momento, o plugin j\u00e1 sabe se deve:<\/p>\n\n\n\n
\n
continuar o processamento;<\/li>\n\n\n\n
ou encerrar a opera\u00e7\u00e3o de forma segura.<\/li>\n<\/ul>\n\n\n\n
Essa simples verifica\u00e7\u00e3o evita muitos erros de utiliza\u00e7\u00e3o.<\/p>\n\n\n\n
\n\n\n\n
<\/span>Processando as fei\u00e7\u00f5es selecionadas<\/span><\/h2>\n\n\n\n
O m\u00e9todo selectedFeatures()<\/code> retorna uma lista de objetos QgsFeature<\/code>.<\/p>\n\n\n\n
Portanto, \u00e9 poss\u00edvel percorr\u00ea-las facilmente:<\/p>\n\n\n
<\/div><\/div><\/div><\/div><\/p>\nfor feature in selected_features: \n# processar cada fei\u00e7\u00e3o<\/p>\n <\/div><\/div>\n\n\n\n Cada fei\u00e7\u00e3o cont\u00e9m:<\/p>\n\n\n\n \nseus atributos;<\/li>\n\n\n\n sua geometria;<\/li>\n\n\n\n seu identificador \u00fanico.<\/li>\n<\/ul>\n\n\n\nTudo o que o plugin precisa para executar opera\u00e7\u00f5es espec\u00edficas sobre os dados selecionados.<\/p>\n\n\n\n \n\n\n\n<\/span>Um exemplo simples: lendo um atributo<\/span><\/h2>\n\n\n\nDepois de obter as fei\u00e7\u00f5es selecionadas, voc\u00ea pode acessar seus atributos da mesma forma que faria com qualquer outro objeto QgsFeature<\/code>.<\/p>\n\n\n\n Por exemplo:<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\nfor feature in selected_features: \nvalue = feature[\u00ab\u00a0population\u00a0\u00bb]<\/p>\n <\/div><\/div>\n\n\n\n Neste exemplo, o plugin l\u00ea o valor do campo population<\/code> para cada fei\u00e7\u00e3o selecionada.<\/p>\n\n\n\n Se o campo n\u00e3o existir, ocorrer\u00e1 um erro.<\/p>\n\n\n\n \n Por isso, \u00e9 importante verificar previamente a estrutura da camada. Um plugin nunca deve presumir que um determinado campo estar\u00e1 sempre presente.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>Modificando atributos com seguran\u00e7a<\/span><\/h2>\n\n\n\nPara modificar fei\u00e7\u00f5es selecionadas, a camada precisa estar em modo de edi\u00e7\u00e3o.<\/p>\n\n\n\n Antes de realizar altera\u00e7\u00f5es, \u00e9 recomend\u00e1vel verificar se a edi\u00e7\u00e3o j\u00e1 est\u00e1 ativa.<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\nif not layer.isEditable(): \nlayer.startEditing()<\/p>\n <\/div><\/div>\n\n\n\n Em seguida, as fei\u00e7\u00f5es podem ser atualizadas:<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\nfor feature in selected_features: \nfeature[\u00ab\u00a0status\u00a0\u00bb] = \u00ab\u00a0processed\u00a0\u00bb \nlayer.updateFeature(feature)<\/p>\n <\/div><\/div>\n\n\n\n Por fim, as altera\u00e7\u00f5es devem ser gravadas:<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\nlayer.commitChanges()<\/p>\n <\/div><\/div>\n\n\n\n \n Um plugin nunca deve modificar dados silenciosamente sem que o usu\u00e1rio saiba.<\/p>\n<\/blockquote>\n\n\n\n Mais adiante nesta s\u00e9rie veremos como solicitar confirma\u00e7\u00e3o antes de salvar as altera\u00e7\u00f5es.<\/p>\n\n\n\n \n\n\n\n<\/span>Sele\u00e7\u00e3o ativa \u2260 filtro \u2260 camada tempor\u00e1ria<\/span><\/h2>\n\n\n\nO QGIS oferece diferentes maneiras de trabalhar com um subconjunto dos dados.<\/p>\n\n\n\n Embora possam parecer semelhantes visualmente, esses mecanismos se comportam de forma muito diferente dentro de um plugin.<\/p>\n\n\n\n Compreender essas diferen\u00e7as \u00e9 essencial para desenvolver ferramentas confi\u00e1veis.<\/p>\n\n\n\n \n\n\n\n<\/span>Sele\u00e7\u00e3o ativa<\/span><\/h3>\n\n\n\nA sele\u00e7\u00e3o ativa:<\/p>\n\n\n\n \npertence \u00e0 camada;<\/li>\n\n\n\n \u00e9 destacada visualmente;<\/li>\n\n\n\n pode ser acessada atrav\u00e9s de selectedFeatures()<\/code>;<\/li>\n\n\n\n muda sempre que o usu\u00e1rio altera a sele\u00e7\u00e3o.<\/li>\n<\/ul>\n\n\n\n\n Este \u00e9 o mecanismo mais seguro e expl\u00edcito para a maioria dos plugins.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>Filtro de camada<\/span><\/h3>\n\n\n\nUm filtro:<\/p>\n\n\n\n \noculta as fei\u00e7\u00f5es que n\u00e3o atendem a uma condi\u00e7\u00e3o;<\/li>\n\n\n\n faz a camada parecer menor;<\/li>\n\n\n\n influencia apenas o que o usu\u00e1rio v\u00ea.<\/li>\n<\/ul>\n\n\n\nEntretanto, salvo precau\u00e7\u00f5es espec\u00edficas, um plugin ainda pode acessar fei\u00e7\u00f5es ocultas pelo filtro.<\/p>\n\n\n\n \n Um plugin mal projetado pode modificar fei\u00e7\u00f5es invis\u00edveis para o usu\u00e1rio.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>Camada tempor\u00e1ria<\/span><\/h3>\n\n\n\nUma camada tempor\u00e1ria:<\/p>\n\n\n\n \nnormalmente \u00e9 criada por uma ferramenta de processamento;<\/li>\n\n\n\n cont\u00e9m uma c\u00f3pia ou subconjunto dos dados originais;<\/li>\n\n\n\n \u00e9 independente da camada de origem;<\/li>\n\n\n\n pode desaparecer quando o projeto \u00e9 fechado.<\/li>\n<\/ul>\n\n\n\n\n Camadas tempor\u00e1rias s\u00e3o excelentes para testes, visualiza\u00e7\u00e3o e an\u00e1lises intermedi\u00e1rias, mas nem sempre s\u00e3o adequadas para modificar os dados originais.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>O que voc\u00ea deve lembrar<\/span><\/h2>\n\n\n\nEsses tr\u00eas conceitos s\u00e3o fundamentalmente diferentes:<\/p>\n\n\n\n \nSele\u00e7\u00e3o<\/strong> = inten\u00e7\u00e3o expl\u00edcita do usu\u00e1rio<\/li>\n\n\n\n Filtro<\/strong> = vis\u00e3o parcial dos dados<\/li>\n\n\n\n Camada tempor\u00e1ria<\/strong> = c\u00f3pia de trabalho<\/li>\n<\/ul>\n\n\n\n\n Na maioria dos plugins voltados para processos de neg\u00f3cio, a sele\u00e7\u00e3o ativa \u00e9 o melhor ponto de partida.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>E se nenhuma fei\u00e7\u00e3o estiver selecionada?<\/span><\/h2>\n\n\n\nMais cedo ou mais tarde, todo desenvolvedor de plugins enfrenta a mesma situa\u00e7\u00e3o:<\/p>\n\n\n\n O usu\u00e1rio executa a ferramenta sem selecionar nenhuma fei\u00e7\u00e3o.<\/p>\n\n\n\n O que o plugin deve fazer?<\/p>\n\n\n\n Existem duas abordagens comuns.<\/p>\n\n\n\n \n\n\n\n<\/span>Op\u00e7\u00e3o 1 \u2013 Bloquear a a\u00e7\u00e3o<\/span><\/h3>\n\n\n\nA solu\u00e7\u00e3o mais segura consiste em interromper o processamento e informar o usu\u00e1rio.<\/p>\n\n\n\n Por exemplo:<\/p>\n\n\n\n \nSelecione pelo menos uma fei\u00e7\u00e3o antes de executar esta ferramenta.<\/p>\n<\/blockquote>\n\n\n\n Essa abordagem evita ambiguidades e previne altera\u00e7\u00f5es acidentais.<\/p>\n\n\n\n \n Na maioria dos casos, esta \u00e9 a op\u00e7\u00e3o mais segura.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>Op\u00e7\u00e3o 2 \u2013 Oferecer uma alternativa<\/span><\/h3>\n\n\n\nOutra possibilidade consiste em perguntar ao usu\u00e1rio o que ele deseja fazer.<\/p>\n\n\n\n Por exemplo:<\/p>\n\n\n\n \nNenhuma fei\u00e7\u00e3o est\u00e1 selecionada. Deseja aplicar esta opera\u00e7\u00e3o a toda a camada?<\/p>\n<\/blockquote>\n\n\n\n Essa abordagem oferece mais flexibilidade sem retirar o controle do usu\u00e1rio.<\/p>\n\n\n\n \n O importante \u00e9 que o plugin nunca tome essa decis\u00e3o sozinho.<\/p>\n<\/blockquote>\n\n\n\n O usu\u00e1rio deve sempre ter a palavra final.<\/p>\n\n\n\n \n\n\n\n<\/span>Casos de uso t\u00edpicos<\/span><\/h2>\n\n\n\nTrabalhar apenas com fei\u00e7\u00f5es selecionadas \u00e9 essencial para muitas tarefas SIG.<\/p>\n\n\n\n Por exemplo:<\/p>\n\n\n\n \nrecalcular um atributo para um subconjunto de fei\u00e7\u00f5es;<\/li>\n\n\n\n corrigir geometrias espec\u00edficas;<\/li>\n\n\n\n aplicar regras de neg\u00f3cio a um grupo espec\u00edfico de objetos;<\/li>\n\n\n\n preparar dados antes de uma exporta\u00e7\u00e3o;<\/li>\n\n\n\n validar registros espec\u00edficos.<\/li>\n<\/ul>\n\n\n\nNa pr\u00e1tica, uma grande parte dos plugins profissionais deveria funcionar dessa forma.<\/p>\n\n\n\n Os usu\u00e1rios esperam que a ferramenta atue apenas sobre os elementos que selecionaram explicitamente.<\/p>\n\n\n\n \n\n\n\n<\/span>Por que isso \u00e9 importante?<\/span><\/h2>\n\n\n\nRespeitar a sele\u00e7\u00e3o ativa n\u00e3o \u00e9 apenas um detalhe t\u00e9cnico.<\/p>\n\n\n\n \u00c9 um princ\u00edpio de design.<\/p>\n\n\n\n Uma sele\u00e7\u00e3o representa uma a\u00e7\u00e3o expl\u00edcita realizada pelo usu\u00e1rio.<\/p>\n\n\n\n Ignor\u00e1-la frequentemente gera confus\u00e3o, resultados inesperados e perda de confian\u00e7a na ferramenta.<\/p>\n\n\n\n Por outro lado, um plugin que respeita a sele\u00e7\u00e3o ativa comporta-se de maneira previs\u00edvel e profissional.<\/p>\n\n\n\n \n\n\n\n<\/span>Pontos principais para lembrar<\/span><\/h2>\n\n\n\nAntes de prosseguir, lembre-se destas ideias essenciais:<\/p>\n\n\n\n \nUma sele\u00e7\u00e3o representa a inten\u00e7\u00e3o do usu\u00e1rio.<\/li>\n\n\n\n Um plugin bem projetado deve respeitar essa inten\u00e7\u00e3o.<\/li>\n\n\n\n O c\u00f3digo necess\u00e1rio \u00e9 simples e f\u00e1cil de compreender.<\/li>\n\n\n\n A seguran\u00e7a resulta de boas decis\u00f5es de projeto, n\u00e3o da complexidade do c\u00f3digo.<\/li>\n<\/ul>\n\n\n\nMuitos iniciantes acreditam que tornar um plugin mais seguro exige programa\u00e7\u00e3o avan\u00e7ada.<\/p>\n\n\n\n Na realidade, a melhor prote\u00e7\u00e3o costuma vir de algumas verifica\u00e7\u00f5es simples realizadas no momento certo.<\/p>\n\n\n\n \n\n\n\n<\/span>O que voc\u00ea aprendeu<\/span><\/h2>\n\n\n\nAo final deste artigo, voc\u00ea agora sabe:<\/p>\n\n\n\n \ncomo recuperar a camada ativa;<\/li>\n\n\n\n como detectar fei\u00e7\u00f5es selecionadas;<\/li>\n\n\n\n como processar apenas as fei\u00e7\u00f5es selecionadas;<\/li>\n\n\n\n como modificar fei\u00e7\u00f5es selecionadas com seguran\u00e7a;<\/li>\n\n\n\n por que sele\u00e7\u00e3o, filtro e camada tempor\u00e1ria s\u00e3o conceitos diferentes.<\/li>\n<\/ul>\n\n\n\nSeu plugin agora pode trabalhar sobre um subconjunto espec\u00edfico de dados, em vez de processar toda a camada indiscriminadamente.<\/p>\n\n\n\n Este \u00e9 um passo importante rumo ao desenvolvimento de plugins QGIS mais profissionais e confi\u00e1veis.<\/p>\n\n\n\n \n\n\n\n<\/span>E no pr\u00f3ximo artigo?<\/span><\/h2>\n\n\n\nNo pr\u00f3ximo artigo, veremos um tema diretamente relacionado:<\/p>\n\n\n\n como modificar fei\u00e7\u00f5es sem colocar os dados em risco.<\/p>\n\n\n\n Aprenderemos a:<\/p>\n\n\n\n \ntrabalhar com seguran\u00e7a no modo de edi\u00e7\u00e3o;<\/li>\n\n\n\n confirmar ou cancelar altera\u00e7\u00f5es;<\/li>\n\n\n\n proteger os dados dos usu\u00e1rios;<\/li>\n\n\n\n desenvolver plugins nos quais os usu\u00e1rios possam confiar.<\/li>\n<\/ul>\n\n\n\n Um plugin \u00fatil n\u00e3o \u00e9 apenas aquele que executa corretamente uma tarefa, mas tamb\u00e9m aquele que protege os dados que modifica.<\/p>\n\n\n\n \n","protected":false},"excerpt":{"rendered":"No QGIS, muitas opera\u00e7\u00f5es devem ser aplicadas apenas a uma parte dos dados: um conjunto espec\u00edfico de fei\u00e7\u00f5es selecionadas pelo usu\u00e1rio. Neste artigo, veremos como um plugin QGIS pode detectar, verificar e processar apenas as fei\u00e7\u00f5es…<\/p>\n","protected":false},"author":1,"featured_media":16333,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"sfsi_plus_gutenberg_text_before_share":"","sfsi_plus_gutenberg_show_text_before_share":"","sfsi_plus_gutenberg_icon_type":"","sfsi_plus_gutenberg_icon_alignemt":"","sfsi_plus_gutenburg_max_per_row":"","_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[3418,2134],"tags":[4834,4772,4702,4832,4830,4700,4774],"class_list":["post-16842","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin-pt","category-qgis","tag-camadas-vetoriais","tag-commitchanges","tag-desenvolvimento-de-plugins-qgis","tag-edicao-de-atributos","tag-modo-de-edicao","tag-pyqgis-es","tag-rollback"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t