📋 Passo 1: Tela Principal de Permissões

Esta é a tela central onde você visualiza todos os usuários e suas respectivas permissões. A partir daqui, você pode realizar todas as operações de gerenciamento de forma centralizada e organizada.

🆕 Nova Permissão

Navigate(Screen_Permissoes_Adicionar)

Direciona o usuário para a tela onde poderá adicionar uma nova permissão ao sistema, configurando um novo usuário com seus respectivos acessos.

✏️ Passo 2: Editando Permissões Existentes

Para modificar as permissões de um usuário já cadastrado, utilize o botão "Editar" que executa uma sequência de ações para garantir a integridade dos dados.

Select(Parent);
Set(currUsuario; ThisItem);
Navigate(Screen_Permissoes_Editar)

Este código executa três ações em sequência:

• Select(Parent) - Seleciona o item pai da galeria para garantir o foco correto
• Set(currUsuario; ThisItem) - Define o usuário atual como variável global para uso na tela de edição
• Navigate(Screen_Permissoes_Editar) - Navega para a tela de edição de permissões

🚫 Passo 3: Desativando Usuários

Quando necessário remover completamente o acesso de um usuário ao sistema, utilize a função de desativação com cuidado, pois esta ação é permanente.

Remove(PlanejamentoIntegrado_Usuarios; ThisItem)

⚠️ Atenção: Esta função remove permanentemente o usuário da base de dados, desativando completamente seu acesso ao sistema. Esta ação não pode ser facilmente desfeita.

🔍 Passo 4: Localizando Usuários no Sistema

O sistema oferece uma funcionalidade de busca que permite localizar usuários existentes na base de dados através de um ComboBox inteligente.

// Código usado no ComboBox para listar usuários
PlanejamentoIntegrado_Usuarios.Usuario

Este código lista todas as opções do campo Usuario da fonte de dados, permitindo selecionar um usuário válido existente para edição.

💾 Passo 5: Salvando Configurações de Permissões

O sistema de salvamento é inteligente e diferencia automaticamente entre gestores e usuários comuns, aplicando as configurações apropriadas para cada tipo.

If(Checkbox3_1.Value;
  // Se for gestor
  Patch(PlanejamentoIntegrado_Usuarios; currUsuario; {
    Título: "Sim";
    Gestor: true;
    Programas: Blank();
    Acoes: Blank()
  });
  // Se não for gestor  
  Patch(PlanejamentoIntegrado_Usuarios; currUsuario; {
    Título: "Sim";
    Usuario: ComboBox1_2.Selected;
    Programas: Concat(Distinct(Filter(Gallery1_1.AllItems; Checkbox1_1.Value = true); Programa); Value; "; ");
    Acoes: Concat(Filter(Gallery1_1.AllItems; Checkbox1_1.Value = true); Left(Acao; 4); "; ")
  })
);
Navigate(Screen_Permissoes_Gestao)

🎯 Passo 6: Como o Sistema Funciona Internamente

O processo de salvamento segue uma lógica estruturada que garante a integridade e consistência dos dados.

1. Verificação de Tipo de Usuário

O sistema verifica se o Checkbox3_1 está marcado para determinar se o usuário será um gestor ou usuário comum.

2. Configuração para Gestores 👑

Se for um gestor, o sistema define:

• Título: "Sim" (usuário ativo)
• Gestor: true (permissão de gestor)
• Programas e Ações: Blank() (gestores têm acesso total)

3. Configuração para Usuários Comuns 👤

Para usuários comuns, o sistema:

• Define o usuário selecionado no ComboBox
• Coleta os Programas marcados na galeria, removendo duplicatas com Distinct()
• Coleta as Ações marcadas, usando apenas os 4 primeiros caracteres
• Separa os itens com ponto e vírgula usando Concat()

🔧 Passo 7: Detalhamento das Funções Utilizadas

Compreenda as funções principais que tornam o sistema de permissões robusto e confiável:

Concat() - Concatena (junta) valores em uma string separada por delimitador

Distinct() - Remove valores duplicados de uma lista

Filter() - Filtra itens com base em uma condição (checkbox marcado)

Left(Acao; 4) - Extrai apenas os 4 primeiros caracteres do campo Acao

Gallery1_1.AllItems - Referência a todos os itens da galeria

Checkbox1_1.Value = true - Condição para filtrar apenas itens marcados

➕ Passo 8: Adicionando Novas Permissões

A tela de adição oferece uma interface limpa e intuitiva para cadastrar novos usuários no sistema e definir suas permissões iniciais.

Esta interface utiliza a mesma lógica de salvamento explicada anteriormente, mas para criação de novos registros ao invés de edição de existentes.

🔄 Passo 9: Finalização e Navegação

Após salvar as configurações, o sistema retorna automaticamente para a tela principal de gestão de permissões, permitindo verificar imediatamente se as alterações foram aplicadas corretamente.

Navigate(Screen_Permissoes_Gestao)