Guias - Editar Cargo

O que é

A tela Editar Cargo permite ajustar as informações de um cargo já cadastrado dentro de Configurações > Cargos - o nome exibido, o ícone visual associado e o status ativo/inativo. É usada quando a agência precisa renomear uma função (por exemplo, trocar Guia por Guia de Turismo), atualizar o ícone para algo mais representativo ou desativar um cargo que não é mais utilizado.

O usuário normalmente chega aqui vindo da listagem de cargos, ao clicar no botão de edição na linha do cargo desejado, ou logo após cadastrar um cargo novo usando a opção Cadastrar e continuar editando. As alterações salvas refletem imediatamente em todos os guias que já têm o cargo atribuído.

Como usar

1. Vá em Configurações > Cargos no sidebar.
2. Localize o cargo desejado na listagem e clique no botão de edição (ícone de lápis) na linha correspondente.
3. Ajuste os campos do formulário:
   • Nome do Cargo - obrigatório. O novo nome não pode coincidir com o nome de outro cargo já cadastrado.
   • Ícone - opcional. Abre o seletor de ícones para escolher (ou trocar) a representação visual do cargo nas listagens.
   • Cargo ativo - toggle verde. Quando desligado, o cargo deixa de aparecer como opção ao cadastrar ou editar guias, mas continua vinculado a quem já o possui.
4. Confirme em Salvar Alterações (rodapé do formulário) para gravar e voltar à lista de cargos.

Casos especiais

Continuar editando depois de salvar

Use Salvar e continuar editando no rodapé quando precisar fazer vários ajustes seguidos no mesmo cargo. O sistema grava as alterações e mantém a tela de edição aberta com os dados atualizados.

Desativar um cargo em uso

Para tirar um cargo da lista de opções sem excluí-lo, desligue o toggle Cargo ativo e salve. Os guias que já possuem esse cargo continuam com ele registrado normalmente, mas novos cadastros e edições não vão mais conseguir selecioná-lo. Para excluir de fato o cargo, use a ação de exclusão na listagem de cargos.

Renomear sem perder os vínculos

A mudança no campo Nome do Cargo é refletida automaticamente em todos os guias vinculados - não é preciso editar os perfis dos guias um a um.

Erros comuns e como resolver

• "The nome has already been taken." - Causa: o nome digitado é igual ao de outro cargo já cadastrado. Solução: escolha um nome diferente ou consulte a listagem em Configurações > Cargos para confirmar qual cargo já usa esse nome.
• "The nome field is required." - Causa: o campo Nome do Cargo ficou em branco. Solução: preencha o nome antes de clicar em Salvar Alterações.
• "The nome may not be greater than 255 characters." - Causa: o nome digitado ultrapassou 255 caracteres. Solução: encurte o nome para algo mais objetivo.

Onde encontrar

• URL: /admin/cargos/{id}/edit
• Caminho no menu: Configurações > Cargos > (editar item da lista)
• Permissão necessária: cargos.edit
• Módulo necessário: nenhum

Veja também

• Cargos de Guias
• Cadastrar Cargo
• Cadastrar Guia