Tutorial Completo

Guia completo apresentando todas as funcionalidades do aplicativo de planejamento integrado, incluindo fluxos de uso, funcionalidades principais e detalhamento dos planejamentos

📋 Tutorial Completo - Aplicativo de Planejamento Integrado

Este guia completo apresenta todas as funcionalidades do aplicativo de planejamento integrado, incluindo fluxos de uso, funcionalidades principais e detalhamento dos planejamentos. Siga este tutorial para dominar completamente o sistema.

O Que Você Vai Aprender

  • Como navegar pela tela inicial e suas funcionalidades
  • Como gerenciar iniciativas e seus componentes
  • Como trabalhar com itens de custo e cenários
  • Como utilizar os relatórios automatizados
  • Como funciona a integração com Power Automate
  • Como gerenciar permissões de usuários

Visão Geral do Sistema

O Aplicativo de Planejamento Integrado é uma solução completa que conecta PowerApps, SharePoint, Power BI e Teams para oferecer um ambiente integrado de planejamento orçamentário. Este sistema permite desde o cadastro de iniciativas até a geração automatizada de relatórios analíticos.

graph TD
    A[Tela Inicial]--> B[Iniciativas]
    B--> C[Itens de Custo]
    C --> D[Cenários]
    D--> E[Relatórios]
    E --> F[Power BI Dataset]
    F --> G[Excel + SharePoint]
    G --> H[Notificação Teams]

🏠 Tela Inicial

📱 Visão Geral da Interface Principal

A tela inicial é o ponto de partida do seu trabalho. Aqui você encontra todos os recursos necessários para começar.

Principais Elementos da Tela Inicial

✨ Tutorial Interativo

Guia dinâmico que ensina você a utilizar o aplicativo passo a passo, ideal para novos usuários. Oferece orientação contextual e exemplos práticos para facilitar o aprendizado.

📋 Fluxo de Registro de Informação

Redireciona para documento no SharePoint em nova aba, mantendo o aplicativo aberto para consulta. Permite acesso rápido à documentação oficial sem perder o contexto de trabalho.

▶️ Iniciar Preenchimento

Direciona você diretamente para a tela de iniciativas onde o trabalho efetivo começa. Este é o caminho mais rápido para usuários experientes iniciarem suas atividades.


📋 Tela de Iniciativas

🎯 Centro de Controle das Suas Iniciativas

Esta é a tela mais importante do sistema, onde você gerencia todas as suas iniciativas de planejamento.

🎛️ Controles de Seleção Inteligentes

🔄 Seletor de Programa

Funcionalidade: Filtro baseado no perfil do usuário

💡 Como funciona:

O sistema verifica automaticamente se você é um gestor. Se for, você vê todos os programas disponíveis. Caso contrário, apenas os programas autorizados para seu perfil são exibidos, garantindo segurança e organização.

🔄 Seletor de Ação

Funcionalidade: Filtragem de ações baseada no programa selecionado

💡 Como funciona:

Após selecionar um programa, o sistema filtra automaticamente as ações disponíveis, mostrando apenas aquelas relacionadas ao programa escolhido. Isso mantém a interface limpa e focada.

⚡ Ações Principais

➕ Adicionar Nova Iniciativa

O que faz: Cria uma nova iniciativa vinculada ao programa e ação selecionados

🔧 Processo:

  • Registra automaticamente seu e-mail como responsável
  • Vincula ao programa e ação selecionados
  • Atualiza a lista de iniciativas instantaneamente

📊 Propor Programa

O que faz: Permite sugerir novos programas para compor a revisão do PPAG

🔧 Processo:

  • Cria uma proposta baseada em suas permissões
  • Registra a sugestão para análise posterior
  • Mantém histórico de propostas

📝 Propor Ação

O que faz: Sugere novas ações para programas existentes ou cria propostas completas

🔧 Processo:

  • Verifica se deve vincular a programa existente ou criar proposta
  • Numera automaticamente as propostas
  • Organiza sugestões para aprovação

🛠️ Ferramentas de Gestão por Iniciativa

📊 Detalhar Resultados

Abre uma visão detalhada da iniciativa selecionada com todas as informações relevantes, incluindo métricas de desempenho e status atual.

💰 Itens de Custo

Navega para a tela especializada em gerenciamento de custos da iniciativa, onde você pode detalhar todos os aspectos orçamentários.

🔄 Cenários

Acessa o módulo de criação e comparação de diferentes cenários, permitindo análise estratégica e tomada de decisões informadas.

🗑️ Excluir Iniciativa

Remove a iniciativa após confirmação, com sistema de segurança integrado para evitar exclusões acidentais.


💰 Tela Itens de Custo

💼 Gestão Financeira Detalhada

Aqui você controla todos os aspectos orçamentários da sua iniciativa, desde custos unitários até premissas de cálculo.

🎯 Funcionalidades Principais

➕ Adicionar Novo Item de Custo

Processo automático:

  • Cria novo item vinculado à iniciativa atual
  • Atualiza dados em tempo real
  • Mantém histórico de alterações

📝 Detalhamento Completo

Campos gerenciados:

  • Forma de contratação e quantitativo
  • Valores unitários e frequência
  • Códigos de elementos e grupos
  • Premissas de volume e preço
  • Fontes de financiamento e instrumentos

🧮 Sistema de Cálculo Automático

📊 Cálculo do Valor Total

O sistema calcula automaticamente o valor total usando a fórmula:

Valor Total = Valor Unitário × Quantitativo × Frequência

O resultado é arredondado para 2 casas decimais e salvo automaticamente.


📊 Tela Cenários

🎭 Planejamento com Múltiplas Perspectivas

Esta tela permite criar e comparar diferentes cenários para sua iniciativa, facilitando a tomada de decisões estratégicas.

🔧 Ferramentas de Cenário

👁️ Ver Itens de Custo

Retorna rapidamente à tela de custos para consultas ou ajustes, mantendo o contexto da iniciativa atual.

➕ Adicionar Cenário

Sistema inteligente de numeração:

  • Identifica o maior número de cenários existentes
  • Adiciona automaticamente o próximo número na sequência
  • Vincula o cenário à iniciativa atual

🔄 Fluxo Power Automate

🌟 Automação Inteligente de Relatórios

O sistema inclui um fluxo automatizado que gera relatórios personalizados integrando PowerApps, Power BI, SharePoint e Teams.

🎯 Objetivo Principal

Automatizar completamente o processo de extração, processamento e distribuição de relatórios analíticos com dados sempre atualizados das iniciativas de planejamento.

📋 Fluxo Detalhado de Automação

1️⃣ Acionamento do Fluxo

O processo inicia quando você clica no botão "Gerar Relatório OBZ" no PowerApps. O sistema captura automaticamente suas ações selecionadas e seu e-mail para personalização.

2️⃣ Consulta ao Power BI

Uma consulta DAX é executada no dataset "TesteOBZ" do Power BI, filtrando os dados conforme suas seleções e extraindo apenas informações relevantes.

3️⃣ Processamento Inteligente

Os dados brutos são extraídos e processados, convertendo-os em formato estruturado através de Parse JSON para garantir organização e consistência.

  // Código utilizado no "Inputs" da ação:
  outputs('Gerar_uma_consulta_no_dataset_do_PowerBI')?['body']?['results']?[0]?['tables']?[0]?['rows']

4️⃣ Personalização dos Dados

As informações são reformatadas especificamente para seu relatório, incluindo identificadores, descrições, valores orçamentários e métricas de desempenho.

5️⃣ Criação do Excel

Um arquivo Excel é criado automaticamente no SharePoint com nome padronizado incluindo data e hora.

  // Código utilizado no "File Name" da ação, para garantir um nome único para cada arquivo:
  formatDateTime(utcNow(), 'dd-MM-yyyy HH:mm:ss')

6️⃣ Estruturação da Tabela

Uma tabela estruturada é criada no Excel com cabeçalhos predefinidos e os dados processados são inseridos através de requisição HTTP otimizada.

  // Para acessarmos a biblioteca de cada usuário, é necessário passar o identificador obtido na etapa anterior:
  split(outputs('Recuperar_informações')?['body/Id'],'.')?[0]

7️⃣ Compartilhamento Automático

O sistema cria um link de compartilhamento do arquivo e envia uma notificação personalizada via Teams diretamente para você, incluindo acesso direto ao relatório.


🔐 Gerenciamento de Permissões de Usuários

👥 Controle de Acesso Inteligente

Sistema completo para gerenciar permissões e controlar o acesso dos usuários às diferentes funcionalidades do aplicativo.

📋 Tela Principal de Permissões

🆕 Nova Permissão

Funçã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.

✏️ Editar Permissão

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

Este botão executa três ações em sequência para garantir a edição correta das permissões do usuário selecionado.

🚫 Desativar Usuário

Função: Remove(PlanejamentoIntegrado_Usuarios; ThisItem)

Remove permanentemente o usuário selecionado da base de dados, desativando completamente seu acesso ao sistema.

💾 Sistema de Salvamento de Permissões

🔧 Como Funciona o Salvamento

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)

🎯 Processo de Verificação

Sistema inteligente que:

  • Verifica se o usuário será gestor ou comum
  • Para gestores: define acesso total (Programas e Ações em branco)
  • Para usuários comuns: coleta permissões específicas marcadas
  • Utiliza Distinct() para remover duplicatas
  • Usa Left(Acao; 4) para otimizar armazenamento

💡 Dicas e Boas Práticas

🎯 Planejamento Eficiente

  • Sempre defina claramente programa e ação antes de criar iniciativas
  • Use nomes descritivos para suas iniciativas
  • Mantenha informações atualizadas regularmente

💰 Gestão de Custos

  • Preencha todas as premissas de cálculo
  • Verifique regularmente os valores totais calculados
  • Documente fontes de informação para auditoria

📊 Cenários Estratégicos

  • Crie cenários realistas e fundamentados
  • Compare regularmente diferentes alternativas
  • Documente premissas de cada cenário

🔄 Automação e Relatórios

  • Gere relatórios periodicamente para acompanhamento
  • Verifique dados antes de gerar relatórios finais
  • Mantenha histórico de versões importantes

👥 Gerenciamento de Usuários

  • Revise permissões regularmente
  • Gestores têm acesso total automaticamente
  • Cuidado ao desativar usuários - ação irreversível

🔒 Segurança do Sistema

  • Verifique permissões antes de compartilhar dados
  • Mantenha backup regular das configurações
  • Monitore acessos e atividades dos usuários

⚙️ Considerações Técnicas

👤 Sistema de Permissões

O aplicativo controla automaticamente o acesso baseado no seu perfil (gestor/não gestor), garantindo que você veja apenas as informações apropriadas ao seu nível de acesso.

💾 Integração de Dados

Todos os dados são integrados com SharePoint para garantir persistência, backup automático e acesso controlado às informações do seu planejamento.

📈 Relatórios Dinâmicos

O sistema de relatórios se conecta ao Power BI em tempo real, garantindo que você sempre trabalhe com as informações mais atualizadas disponíveis.

🔔 Notificações Inteligentes

As notificações via Teams são enviadas automaticamente, mantendo você informado sobre o status dos seus relatórios e processos em andamento.


🚀 Fluxo de Trabalho Recomendado

1️⃣ Configuração Inicial

Configure permissões de usuários e defina programas e ações disponíveis no sistema.

2️⃣ Criação de Iniciativas

Utilize os controles inteligentes para criar iniciativas vinculadas aos programas apropriados.

3️⃣ Detalhamento Financeiro

Acesse a tela de itens de custo para detalhar todos os aspectos financeiros da iniciativa.

4️⃣ Análise de Cenários

Crie diferentes cenários para análise comparativa e tomada de decisões estratégicas.

5️⃣ Geração de Relatórios

Utilize o fluxo automatizado para gerar relatórios personalizados e compartilhá-los via Teams.

6️⃣ Monitoramento

Acompanhe regularmente o progresso através dos relatórios e ajuste as iniciativas conforme necessário.

Resumo das Funcionalidades

TelaFuncionalidade PrincipalDescrição
InicialPortal de entradaAcesso a tutoriais, documentação e início do trabalho
IniciativasGestão centralCriação, edição e organização de todas as iniciativas
Itens de CustoControle financeiroDetalhamento completo de custos com cálculos automáticos
CenáriosAnálise estratégicaCriação e comparação de diferentes cenários de planejamento
PermissõesControle de acessoGerenciamento completo de usuários e suas permissões
AutomaçãoRelatórios inteligentesGeração e distribuição automatizada de relatórios via Teams

🚀 Próximos Passos

Agora que você domina todas as funcionalidades do aplicativo, está pronto para:

  1. Criar suas primeiras iniciativas usando os controles inteligentes
  2. Gerenciar custos detalhadamente com cálculos automáticos
  3. Desenvolver cenários estratégicos para melhor tomada de decisão
  4. Gerar relatórios automatizados para acompanhamento e análise

🎉 Conclusão

🎉 Parabéns!

Você agora possui conhecimento completo para utilizar eficientemente o Aplicativo de Planejamento Integrado. Use este tutorial como referência sempre que precisar relembrar alguma funcionalidade.

Última modificação June 17, 2025: tutorial completo (ea24890)