--- title: 12. Dados: console SQL, consultas, cargas e portais slug: 12-dados-console-sql-consultas-cargas-e-portais docTags: createdAt: 2026-10-09T19:11:31.911Z --- A área **Dados do Bússola/BSC** é onde a organização trabalha o dado que sustenta a estratégia: o Analista de Integração de Dados experimenta consultas no console SQL, publica consultas salvas com versão, traz dados de outros sistemas por cargas e mantém o catálogo dos portais do governo. Indicadores, controles diários, execução de ações e painéis passam a ser alimentados por essas consultas, sem extrações manuais. Tudo roda sobre uma **base de leitura** preparada para isso: somente leitura, sem dado pessoal e sem o que é sigiloso. Cada execução fica registrada e pode ser acompanhada no **Monitor de integrações**, junto com os serviços agendados da plataforma. As conexões com os outros sistemas (bancos, arquivos, APIs, SEI, SIAFI) são cadastradas no hub de integrações, descrito no capítulo seguinte. ## 12.1 Área de dados e base de leitura ID BSC-DAD-01 ### Para que serve A área **Dados do Bússola/BSC** reúne o que se faz com dados dentro do BSC: experimentar consultas, publicar consultas com versão, trazer dados de outros sistemas por cargas, apurar indicadores automaticamente e manter o catálogo dos portais do governo. As conexões com os outros sistemas ficam no menu **Integrações**; aqui fica o uso do dado. Todas as consultas leem a **base de leitura**: um conjunto de visões preparadas sobre os dados de gestão do Bússola/BSC (ciclos, perspectivas, objetivos, indicadores, metas, medições, planos de ação, ações, programas, vínculos estratégicos, linhas importadas pelas cargas e itens dos portais). As tabelas internas do sistema, outros ambientes e o catálogo do servidor de banco não aparecem. A base é preparada uma única vez por ambiente pelo administrador de banco da organização, com um usuário de banco que só lê. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Diretoria de Estratégia; Administrador do sistema. ### Passo a passo 1. Peça ao administrador do sistema que confirme que a base de leitura foi preparada no ambiente (tarefa única do administrador de banco). 2. Abra o menu **Dados do Bússola/BSC** e confira os itens disponíveis para o seu cargo: Console SQL, Consultas salvas, Cargas de dados, Portais do governo, Itens de portais e Categorias de itens. 3. Use o **Console SQL** para experimentar e as **Consultas salvas** para o que vai ser usado por indicadores, controles, painéis e cargas. 4. Acompanhe o resultado das execuções em **Integrações › Monitor de integrações**. ### Observações - A base de leitura deixa de fora indicadores e objetivos sigilosos e tudo o que depende deles (metas, medições, planos e ações). - Nenhum dado de pessoa aparece nas visões: nem responsável, nem quem registrou, nem quem aprovou. - O usuário de banco da base de leitura é somente leitura: mesmo que algo escape da conferência do texto, o próprio banco recusa a escrita. - Se a tela disser que a base de leitura não está disponível ou não está configurada, o roteiro de preparação ainda não rodou no ambiente; se disser que as visões serão criadas no próximo início, a aplicação precisa ser reiniciada. Nos dois casos, acione o administrador do sistema. ## 12.2 Console SQL ID BSC-DAD-02 ### Para que serve O console SQL permite que o Analista de Integração de Dados escreva uma consulta de leitura sobre a base de leitura e veja o resultado na hora, para desenhar a apuração de um indicador sem pedir extração à TI. A consulta roda num ambiente cercado: só leitura, no máximo 1.000 linhas na pré-visualização, interrupção após 30 segundos e registro de toda execução, aceita ou recusada. **Quem usa:** Analista de Integração de Dados. ### Passo a passo 1. Dados do Bússola/BSC › Console SQL › abra o console (o item aparece só para quem pode escrever e executar SQL na área de dados). 2. No cartão **Tabelas e colunas**, abra uma visão para ver as colunas e o tipo de cada uma, ou use a busca. 3. Clique numa coluna ou em **Inserir o nome** para colocá-la na consulta no ponto do cursor. 4. Escreva uma única consulta de leitura (select ou with … select). Use **Ctrl+Espaço** para abrir as sugestões de visões e colunas; setas escolhem, **Enter** ou **Tab** aceitam, **Esc** fecha. 5. Para cada parâmetro escrito como \:nome, informe em **Parâmetros** o tipo (data, número, texto, lista de textos ou unidade organizacional) e o valor. 6. Clique em **Pré-visualizar** e confira as colunas, as linhas, o tempo gasto e o eventual aviso de corte em 1.000 linhas. 7. Se o resultado foi cortado, filtre ou agrupe a consulta para ver o total. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/nDuzljZk7u6wljX3ejnHm_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 126 — Console SQL com o cartão Tabelas e colunas, o editor e o resultado da pré-visualização ### Observações - A lista de tabelas e colunas é lida com o próprio usuário de leitura: o que aparece é exatamente o que a consulta consegue ler. - O valor de um parâmetro vai ao banco como dado, nunca como parte do texto: um valor malicioso não altera a consulta. - São recusadas: instruções de inclusão, alteração, exclusão ou criação; duas instruções no mesmo texto; funções que leem arquivos do servidor, esperam de propósito, mudam a sessão ou alcançam outro servidor; objetos fora das visões publicadas; ponto de interrogação solto (use \:nome ou as funções de JSON equivalentes). - Subconsultas só são aceitas no FROM, no WHERE ou na lista de colunas. - O limite é de duas execuções simultâneas por ambiente; se aparecer o aviso, aguarde e tente de novo. - Quem atua em mais de uma empresa deve escolher a empresa no seletor do topo antes de pré-visualizar. ## 12.3 Consultas salvas: criar uma consulta ID BSC-DAD-03 ### Para que serve O console serve para experimentar; o que vai ser usado (pela apuração de um indicador, por um controle diário, por um painel ou por uma carga) vira uma **consulta salva**, com nome, finalidade, fonte e versões numeradas. O texto de uma versão publicada nunca muda, e quem usa a consulta continua na versão que escolheu até alguém trocá-la. Assim um número já apresentado à diretoria não muda em silêncio. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Diretoria de Estratégia. ### Passo a passo 1. Dados do Bússola/BSC › Consultas salvas › clique em **Nova consulta**. 2. Informe um **nome** único (sem diferença entre maiúsculas e minúsculas) e uma descrição. 3. Escolha a **finalidade**: Apuração de indicador (exige a coluna de valor), Controle diário (exige referência, data e valor ou percentual), Conjunto de dados para painéis ou Carga de dados. 4. Escolha a **fonte**: **Base própria (somente leitura)** ou uma integração de banco de dados cadastrada no hub. 5. Clique em **Criar e abrir o editor** para ir à ficha da consulta. 6. Para mudar nome ou descrição depois, use **Renomear**. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/QaKEeCnacMHCldG5ZqGF__image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 127 — Lista de consultas salvas com finalidade, fonte e versão atual ### Observações - Finalidade e fonte não mudam depois de criada a consulta. - A finalidade Carga de dados exige uma integração de banco de dados como fonte. - Uma integração de banco só executa SQL daqui depois de um teste com resultado OK: uma conta que pode escrever no banco nunca executa SQL escrito por uma pessoa. - O Analista de Integração de Dados escreve, publica e desativa; a Diretoria de Estratégia e o Gestor de Desempenho veem lista, ficha, texto e versões e podem pré-visualizar a versão publicada informando só valores. ## 12.4 Consultas salvas: escrever e publicar uma versão ID BSC-DAD-04 ### Para que serve Na ficha da consulta o analista escreve o texto, declara os parâmetros, pré-visualiza, diz o papel de cada coluna e publica uma versão numerada com nota explicando o porquê da mudança. **Quem usa:** Analista de Integração de Dados. ### Passo a passo 1. Dados do Bússola/BSC › Consultas salvas › abra a consulta. 2. Comece do zero, de uma consulta pronta em **Consultas pré-formatadas** (por exemplo, Medições do período, Meta versus realizado por período, Indicadores aprovados sem medição no período, Percentual de ações concluídas no período, Execução das ações com prazo no período) com **Usar no editor**, ou de uma tabela. 3. Para montar o SELECT sem escrever SQL, clique em **Usar esta tabela** no cartão Tabelas e colunas, desmarque as colunas que não interessam, dê a cada uma o nome de exibição e clique em **Colocar o SELECT no editor**. 4. Em **Parâmetros**, clique em **Declarar \:nome** para cada parâmetro do texto e escolha tipo, obrigatoriedade e valor padrão. 5. Clique em **Pré-visualizar**; se quiser, troque os valores em **Valores para a pré-visualização** (em branco vale o padrão). 6. Em **Colunas do resultado**, indique qual coluna é o valor (e os demais papéis exigidos pela finalidade) e os nomes de exibição. 7. Escreva a **nota da versão** e clique em **Publicar v1** (ou v2, v3…). ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/RHMDYjTJ_brVqCrA8PZ3o_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 128 — Ficha da consulta salva com editor, parâmetros, colunas do resultado e versões ### Observações - Os parâmetros do período de apuração (início e fim do período, indicador e unidade) são preenchidos pelo Bússola/BSC e não se declaram; declará-los gera recusa. - Na pré-visualização o período é o mês corrente e não há indicador nem unidade: um resultado vazio pode significar apenas que nada foi medido neste mês. - O botão de publicar só se habilita depois de uma pré-visualização bem-sucedida do mesmo texto e dos mesmos parâmetros; ao publicar, o servidor executa e confere tudo de novo. - Mensagens comuns: parâmetro usado e não declarado (ou declarado e não usado); coluna do papel que não aparece no resultado; valor que precisa ser numérico pelo tipo da coluna (converta no texto); "Nada mudou desde a versão N". ## 12.5 Consultas salvas: versões, comparação e desativação ID BSC-DAD-05 ### Para que serve Cada consulta guarda todas as versões publicadas. Quem só lê a área de dados pode executar a versão publicada informando valores, sem mexer no texto, e comparar versões antigas com a atual. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Diretoria de Estratégia. ### Passo a passo 1. Dados do Bússola/BSC › Consultas salvas › abra a consulta. 2. No cartão **Versão atual**, confira texto, parâmetros, papéis, nomes das colunas, quem publicou e quando. 3. Clique em **Pré-visualizar esta versão** e informe os valores dos parâmetros para executar o texto publicado. 4. Em **Versões**, clique em **Comparar com a atual** para ver o texto de uma versão antiga ao lado da atual. 5. Abra o **Histórico** para ver criação, publicações (número e impressão digital do texto) e desativações, com autor e data. 6. Para retirar a consulta das escolhas, clique em **Desativar**. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/RHMDYjTJ_brVqCrA8PZ3o_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 129 — Versões da consulta com a comparação de textos ### Observações - Desativar impede novas publicações e tira a consulta das escolhas; as versões continuam legíveis. - Uma consulta em uso por indicador, carga ou painel não pode ser desativada. - Na pré-visualização de uma versão publicada viajam só valores, nunca texto; por isso leitores da área de dados podem usá-la. ## 12.6 Consulta sobre banco externo ID BSC-DAD-06 ### Para que serve Uma consulta salva pode ter como fonte uma integração de **banco de dados** cadastrada no hub. Nesse caso a consulta lê o banco de outro sistema, pela conta somente leitura daquela integração, com os mesmos limites do console e sem armazenar nada. **Quem usa:** Analista de Integração de Dados. ### Passo a passo 1. Cadastre e teste a integração de banco de dados em **Integrações › Integrações** até o teste dar OK. 2. Dados do Bússola/BSC › Consultas salvas › **Nova consulta** › escolha a integração de banco como fonte. 3. No cartão **Tabelas e colunas**, confira o que a conta da integração consegue ler, com nomes no formato esquema.tabela. 4. Escreva a consulta usando as sugestões do editor e clique em **Pré-visualizar**. 5. Declare parâmetros, papéis das colunas e publique como em qualquer consulta salva. ### Observações - Enquanto a integração não tiver teste OK, o cartão explica o motivo e o editor continua aberto para escrever. - Falhas de conexão aparecem como "O banco recusou o usuário ou a senha", "O banco informado não existe nesse servidor" ou "Não foi possível conectar ao banco": confira e teste a integração no hub. - Um servidor fora da lista de saída aparece como "Endereço não aprovado", sem o nome do servidor; o analista vê o detalhe no teste da integração. - O catálogo do servidor de banco não é exibido. ## 12.7 Cargas de dados: cadastrar uma carga ID BSC-DAD-07 ### Para que serve Uma **carga** traz linhas de outro sistema para dentro do Bússola/BSC, de um arquivo (CSV, TXT ou Excel), de um banco de dados (por uma consulta salva de finalidade Carga) ou de uma API REST, e guarda cada linha com a sua origem. O dado bruto importado alimenta depois consultas SQL, indicadores e painéis. Não confunda com **Indicadores importados**, que recebe valores já calculados por chave de indicador. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Diretoria de Estratégia. ### Passo a passo 1. Cadastre antes, em **Integrações › Integrações**, a integração de onde o dado vem: Arquivo, Banco de dados ou API REST. 2. Para banco, publique em **Consultas salvas** uma consulta de finalidade Carga sobre essa integração. 3. Dados do Bússola/BSC › Cargas de dados › clique em **Nova carga**, dê um nome e escolha a integração (e a consulta, se for banco). 4. Em **Origem dos dados**, para arquivo, diga **Como o arquivo chega** (enviado pelo analista ou baixado do endereço da integração), o **Formato**, a **Aba** (Excel) e a **Linha dos nomes das colunas** (0 = sem cabeçalho). 5. Em **Roda sozinha**, deixe vazio para seguir a periodicidade da integração, escolha outra periodicidade (por exemplo, diária às 06:00 de Brasília) ou **Só à mão**. 6. Em **Execuções com linhas guardadas** (1 a 50, padrão 10), defina quantas execuções mantêm as linhas. 7. Para arquivo enviado, em **Arquivo da carga**, escolha o arquivo e clique em **Enviar**. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/-kbTbo27005kFzcZKPmKF_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 130 — Lista de cargas de dados ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/MTTXeCmf4qFGWTd2j_QqH_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 131 — Carga aberta com origem dos dados, colunas e execuções ### Observações - O tipo da integração define o tipo da carga e não muda depois. - O Analista de Integração de Dados cadastra e configura; o analista e o Gestor de Desempenho executam; a Diretoria de Estratégia e o Gestor de Desempenho leem cargas, execuções e dados importados. - As execuções mais antigas perdem as linhas guardadas, mas o histórico de execuções permanece. - Limites: arquivo de até 20 MB e 200 mil linhas, até 200 colunas; Excel com compactação suspeita é recusado. - Um endereço de arquivo fora da lista de saída é recusado; peça a aprovação ao administrador do sistema. ## 12.8 Cargas de dados: pré-visualizar e nomear as colunas ID BSC-DAD-08 ### Para que serve Antes da primeira execução, o analista pré-visualiza a fonte e confirma o nome e o tipo de cada coluna. Cada execução aplica sempre o que foi confirmado, de modo que o mesmo arquivo é lido do mesmo jeito todo dia. **Quem usa:** Analista de Integração de Dados. ### Passo a passo 1. Dados do Bússola/BSC › Cargas de dados › abra a carga e clique em **Pré-visualizar** (até 50 linhas, sem gravar nada). 2. Confira o tipo sugerido para cada coluna e as células destacadas que não converteram. 3. Para cada coluna, ajuste **Importar**, **Chave no SQL** (minúsculas sem acento, números e \_), **Nome de exibição** e **Tipo** (Automático, Texto, Número, Data ou Sim/não). 4. Em **Como os números estão escritos**, escolha 1.234,56 (padrão brasileiro) ou 1,234.56. 5. Clique em **Confirmar N colunas**. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/MTTXeCmf4qFGWTd2j_QqH_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 132 — Pré-visualização da carga com tipos sugeridos e células não convertidas ### Observações - Sem confirmar as colunas a carga não executa. - Uma célula não convertida não impede a carga: a linha entra inteira, com o texto original guardado e a célula marcada. - Fixe o tipo Número numa coluna de valores para que textos como "-" ou "a apurar" fiquem marcados como não convertidos. - Datas são lidas como dd/mm/aaaa ou aaaa-mm-dd, nunca com o mês primeiro. - Arquivo que não é UTF-8 é lido como Windows-1252 e a pré-visualização avisa: confira os acentos. - Se o cabeçalho do arquivo mudar, a execução fica Parcial com "Colunas nomeadas que não vieram na fonte": pré-visualize e confirme de novo. ## 12.9 Cargas de dados: executar e acompanhar ID BSC-DAD-09 ### Para que serve A execução lê a fonte inteira e grava as linhas. O cartão **Execuções** mostra cada execução com resultado, contagens e o que exatamente foi lido, e garante que uma execução incompleta nunca substitua a última completa. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Diretoria de Estratégia. ### Passo a passo 1. Dados do Bússola/BSC › Cargas de dados › abra a carga e clique em **Executar agora**. 2. Confira o resultado no topo e no cartão **Execuções**: quando, como (à mão ou agendada, e por quem), resultado, linhas importadas, células não convertidas e o que foi lido (arquivo com impressão digital, endereço e páginas da API, ou consulta e versão). 3. Interprete o resultado: **Concluída** (vira a execução corrente), Concluída com teto atingido, **Parcial (não corrente)** ou **Falhou** (com o motivo). 4. Para a execução automática, aguarde o horário configurado; a execução aparece como **Agendada**. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/MTTXeCmf4qFGWTd2j_QqH_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 133 — Cartão Execuções com resultado e origem de cada leitura ### Observações - Uma execução parcial ou com falha nunca substitui a última completa: as consultas continuam vendo o dado anterior. - Tetos: banco, 100 mil linhas ou 2 minutos; API, 100 páginas e 100 mil registros. Ao atingir o teto a execução entra até o limite e vira corrente, marcada como teto atingido. - Duas execuções da mesma carga ao mesmo tempo não acontecem: a segunda é recusada com "já está em execução". - Recusas do outro sistema aparecem com o código do hub (credencial recusada, pedido para diminuir o ritmo, erro interno), nunca com o texto devolvido por ele. - O agendador verifica as cargas a cada 15 minutos. ## 12.10 Dados importados e consulta em SQL ID BSC-DAD-10 ### Para que serve O cartão **Dados importados** mostra as linhas trazidas pela carga com a cadeia completa de origem. As mesmas linhas ficam disponíveis na base de leitura para o console SQL e as consultas salvas. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Diretoria de Estratégia. ### Passo a passo 1. Dados do Bússola/BSC › Cargas de dados › abra a carga e vá ao cartão **Dados importados**. 2. Veja as linhas da execução corrente ou escolha outra execução em **Ver linhas**. 3. Marque **Só linhas com célula não convertida** para revisar o que não converteu (o texto original aparece destacado). 4. Para usar o dado em SQL, consulte no console a visão de linhas importadas, filtrando pelo nome da carga e pela execução corrente, e leia os valores pelas Chaves no SQL confirmadas. 5. Publique a consulta como consulta salva se ela for alimentar indicador, controle ou painel. ### Observações - A visão de linhas importadas traz o nome da carga, o início da execução, o número da linha, os valores convertidos, o texto original e a marca de execução corrente. - Filtre pela execução corrente para ler só a última execução completa de cada carga. - As linhas importadas não têm sigilo por linha: quem lê a área de dados e quem consulta a base de leitura vê todas. Carregar dado pessoal é decisão da organização, que deve limitar quem recebe esses cargos. ## 12.11 Apuração de indicador por consulta SQL ID BSC-DAD-11 ### Para que serve Uma consulta salva de finalidade **Indicador** alimenta um indicador calculado. O gestor escolhe a consulta no cartão do indicador e o serviço diário apura o valor na periodicidade do indicador, guardando o valor e uma nota de origem completa. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho. ### Passo a passo 1. Escreva a consulta para devolver uma linha por período, usando os parâmetros de período, indicador e unidade preenchidos pelo Bússola/BSC. 2. Indique a coluna do valor no papel **VALUE**; se a consulta devolve várias linhas (uma por mês, por exemplo), indique a coluna de data no papel **PERIOD**. 3. Declare os parâmetros que o gestor vai preencher (por exemplo, o código da unidade) e publique a versão. 4. Gestão por indicadores › Indicadores › abra o indicador e, em **Origem do cálculo**, escolha **Consulta SQL** e a consulta. 5. Preencha os parâmetros exigidos e use **Testar** para conferir o valor. 6. Mantenha o indicador aprovado e com apuração automática marcada; use **Recalcular agora** para refazer o período corrente. 7. Quando o cartão avisar que uma nova versão da consulta está disponível, decida se religa o indicador à nova versão. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/2-8CPcQEZJAX2yX7Bi_Lv_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 134 — Ficha do indicador com a origem do cálculo por consulta SQL ### Observações - O serviço diário roda às 02:00: atualiza o período em aberto e, na virada, consolida o anterior com o último valor apurado. - O cartão fixa a versão da consulta: publicar uma versão nova não muda o número de quem usa a anterior. Religar à nova versão devolve o cartão a rascunho. - Sem o papel PERIOD, mais de uma linha é recusada. - Zero linhas não é zero: o período fica sem valor e o registro diz "sem dado". - Falha (banco fora do ar, mais de dois minutos, mais de uma linha para o período, valor não numérico) não grava nada naquele indicador; os demais seguem sendo apurados. - Numa consulta sobre banco externo nenhuma linha do outro sistema é copiada; ficam só o valor e a nota de origem, que seguem o sigilo do indicador. ## 12.12 Consultas de controle e retratos diários ID BSC-DAD-12 ### Para que serve Uma consulta de finalidade **Controle** (execução financeira ou cronograma) roda todo dia e guarda o resultado como o **retrato daquele dia**. A mesma consulta pode alimentar a execução física e financeira de entregas e atividades de uma ação estratégica. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Responsável por ação/área. ### Passo a passo 1. Dados do Bússola/BSC › Consultas salvas › crie a consulta com finalidade Controle diário, indicando as colunas de referência, data e valor ou percentual, e publique. 2. Na ficha da consulta, acompanhe o cartão **Retratos diários** (dias, linhas, versão, hora e quem executou). 3. Clique em **Ver as linhas** para abrir um retrato. 4. Use **Executar agora** para guardar ou substituir o retrato de hoje. 5. Para alimentar uma ação estratégica, no cartão de execução automática da entrega ou atividade escolha a fonte **Consulta salva** e a consulta de controle; salve a configuração. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/TwPd0l_RoJZt1qZcpQeAp_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 135 — Execução automática de uma entrega alimentada por consulta salva ### Observações - O serviço roda às 03:30, do primeiro dia do mês até o dia; acima de 1.000 linhas o retrato é marcado **Cortado em 1.000 linhas**. - Declare só parâmetros com valor padrão: o serviço diário não tem quem preencha um parâmetro obrigatório e a execução é recusada. - Na ação estratégica: PERIOD vira a data de cada linha, REF a chave, VALUE o valor executado, PERCENT o percentual físico e ACTUAL\_END a conclusão real. Atividade exige PERCENT; entrega exige VALUE ou PERCENT. - A versão publicada no momento fica fixada na configuração da ação; para usar uma nova versão, salve a configuração de novo. - Mais de 1.000 linhas, linha sem data ou percentual fora de 0 a 100 faz a sincronização falhar sem copiar nada; o motivo aparece com o número da linha. - Executar agora exige a permissão de executar cargas. ## 12.13 Portais do governo: ver e configurar ID BSC-DAD-13 ### Para que serve Os portais da administração pública que a organização usa (como SEI, Gov.br e SIAFI) publicam produtos e serviços. O Bússola/BSC guarda esses itens, permite classificá-los em categorias próprias e vinculá-los à estratégia. O Bússola/BSC não lê os portais por conta própria nesta tela: o catálogo de cada portal chega por uma **carga de dados** ou pelo **hub de integrações**. A maioria dos portais exige credencial ou adesão formal da organização; até lá, o portal aparece como **Não configurado**. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Diretoria de Estratégia. ### Passo a passo 1. Dados do Bússola/BSC › Portais do governo › veja cada portal com situação (Não configurado, Pronto, Suspenso), origem dos itens, itens publicados e última sincronização. 2. Para um portal que não está na lista, clique em **Novo portal**. 3. Capture o catálogo do portal numa carga de dados e execute-a até ter uma execução completa. 4. Clique no nome do portal e, em **De onde vêm os itens**, escolha **Carga de dados** e a carga (ou a integração do hub, quando o portal for alimentado por conector). 5. Indique qual coluna é cada campo: **Código do item** e **Nome** (obrigatórios), Descrição, Categoria no portal, Tipo (produto ou serviço, com os textos que significam cada um) e Endereço (https). 6. Clique em **Salvar** e em **Pré-visualizar os primeiros itens** para ver os 20 primeiros e quantas linhas ficaram de fora. 7. Clique em **Ativar**: o portal fica Pronto e entra na sincronização diária. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/1ClcqxLAgXCtsmLYx2fLP_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 136 — Lista de portais do governo com situação e última sincronização ### Observações - Não configurado significa dependência de credencial ou adesão, não "portal sem itens". - Sem itens na pré-visualização, a ativação é recusada. - Um portal alimentado pelo hub (API REST, SEI ou SIAFI) recebe os itens pelo De-Para do conector; aqui só se escolhe a integração. - Mensagens comuns: "A carga ainda não tem uma execução completa" (execute a carga antes) e "As primeiras linhas da carga não viraram nenhum item" (confira as colunas de código e nome). ## 12.14 Portais do governo: sincronização ID BSC-DAD-14 ### Para que serve A sincronização atualiza os itens de cada portal pronto com a última execução completa da carga correspondente, preservando categorias e vínculos. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho. ### Passo a passo 1. Dados do Bússola/BSC › Portais do governo › abra o portal. 2. Clique em **Sincronizar agora** para sincronizar na hora (ou aguarde a sincronização diária). 3. Confira o resultado: novos, alterados, inativados, publicados de novo e linhas deixadas de fora. 4. Acompanhe cada sincronização em **Integrações › Monitor de integrações**. ### Observações - A sincronização automática roda todo dia às 04:00 para os portais prontos alimentados por carga. - Item novo é incluído; item com qualquer campo diferente é alterado, com a data da alteração. - Item que deixou de aparecer numa sincronização completa fica **Inativo na origem**: nunca é apagado e mantém categoria e vínculos; se voltar a ser publicado, fica ativo sozinho. - Se a carga não trouxe o catálogo inteiro, a sincronização fica **Incompleta**: grava o que leu e não inativa nada. - Uma falha no meio não grava nada; os itens continuam como estavam. ## 12.15 Categorias de itens e regras de classificação ID BSC-DAD-15 ### Para que serve As categorias próprias organizam os itens dos portais do jeito da organização. Regras atribuem uma categoria automaticamente aos itens que chegam sem categoria, a partir da categoria informada pelo portal. **Quem usa:** Diretoria de Estratégia; Gestor de Desempenho; Analista de Integração de Dados. ### Passo a passo 1. Dados do Bússola/BSC › Categorias de itens › clique em **Nova categoria** e informe código, nome e descrição. 2. Em **Regras**, acrescente linhas: categoria no portal (texto), portal específico ou qualquer portal, e a categoria a atribuir. 3. Salve; a regra age na próxima sincronização. 4. Consulte o **Histórico** para ver cada mudança, inclusive nas regras. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/kmHGrN4C1E7WbVdGluIBi_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 137 — Categorias de itens com as regras de classificação ### Observações - A comparação da categoria no portal ignora diferenças entre maiúsculas e minúsculas. - A regra nunca troca uma categoria escolhida por uma pessoa. - A mesma categoria no portal não pode ter regra em duas categorias: retire a regra da outra antes. - Uma categoria inativa continua nos itens que já a têm, mas deixa de ser oferecida. - Quem lê a área de dados apenas consulta as categorias. ## 12.16 Itens de portais: classificar e vincular à estratégia ID BSC-DAD-16 ### Para que serve A lista de itens permite filtrar, classificar em lote e abrir cada item para definir a categoria e os vínculos com programas, objetivos, indicadores e ações. **Quem usa:** Diretoria de Estratégia; Gestor de Desempenho; Analista de Integração de Dados. ### Passo a passo 1. Dados do Bússola/BSC › Itens de portais › filtre por portal, categoria (inclusive Sem categoria), tipo, situação no portal e nome ou código. 2. Para classificar em lote, marque os itens, escolha a categoria e clique em **Classificar**. 3. Abra um item e, em **Nossa categoria**, escolha em **Classificar como** e clique em **Salvar categoria**. 4. Em **Vínculos com a estratégia**, escolha **Vincular a** (programa ou subprograma, objetivo estratégico, indicador, ação ou projeto), procure o **Destino** pelo nome, escreva uma observação e clique em **Vincular**. 5. Para desfazer, use **Desfazer vínculo**; marque **Mostrar vínculos desfeitos** para consultar os anteriores. 6. Consulte **Histórico da categoria** e **Histórico dos vínculos**. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/5nzKwZpJ3ocRCDN7n8LIT_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 138 — Itens de portais com filtros e classificação em lote ### Observações - A classificação em lote aceita até 500 itens por vez; cada item registra a mudança no próprio histórico. - Escolher **Sem categoria (volta para as regras)** devolve o item às regras automáticas. - Desfazer vínculo mantém o registro de quem desfez e quando. - Um vínculo com objetivo, indicador ou ação sigilosa que você não lê aparece como **Reservado**; o título nunca aparece, nem no histórico. - "Destino não encontrado" ao vincular indica que o destino não existe ou é sigiloso para você. ## 12.17 Conteúdo da base de leitura ID BSC-DAD-17 ### Para que serve A base de leitura publica visões sobre os dados de gestão, sempre sem dado pessoal e sem o que é sigiloso. Conhecer o que entra e o que fica de fora evita surpresas ao montar consultas e painéis. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Leitor/Auditor. ### Passo a passo 1. Dados do Bússola/BSC › Console SQL › abra o cartão **Tabelas e colunas** para ver as visões disponíveis. 2. Abra cada visão para conferir as colunas e os tipos. 3. Use a lista abaixo para saber o que cada grupo de visões traz e o que fica de fora. ### Observações - Ciclos, perspectivas e programas/subprogramas: completos. - Objetivos: sem os sigilosos e sem responsável. Indicadores: sem os sigilosos (ou de objetivo sigiloso), sem responsável, sem quem aprovou e sem fórmula interna. - Metas: sem as de indicador oculto, sem quem aprovou e sem critério de aceite. Medições: só a medição corrente de cada período, sem versões antigas, sem quem registrou e sem nota. - Planos de ação e ações: sem os sigilosos ou de indicador oculto, sem responsável e sem quem executa. Vínculos estratégicos: sem vínculos com objetivo ou indicador oculto. - Linhas importadas pelas cargas: texto original e valor convertido, com carga, execução e marca de corrente; sem execuções que falharam sem importar e sem quem executou. - Itens dos portais: com portal, categoria própria, situação e contagem de vínculos por tipo de destino; sem o nome dos destinos vinculados. - Métricas de outros módulos entram sempre agregadas e sem pessoa, à medida que cada módulo publicar a sua visão. ## 12.18 Acesso de leitura para ferramentas de BI ID BSC-DAD-18 ### Para que serve A mesma base de leitura pode ser lida diretamente no banco pela ferramenta de análise da organização (como Power BI, Metabase ou DBeaver), com uma conta de banco própria para BI. Essa conta é separada da usada pelo console SQL: tem senha própria e pode ser revogada sem afetar o Bússola/BSC. **Quem usa:** Administrador do sistema; Analista de Integração de Dados. ### Passo a passo 1. Solicite ao administrador de banco da organização a criação da conta de leitura para BI, com o mesmo roteiro de preparação da base de leitura. 2. Solicite a liberação de rede necessária (só cabe em instalação dedicada). 3. Configure a ferramenta de BI com a conta recebida e aponte para as visões da base de leitura. 4. Para trocar a senha ou revogar o acesso, acione o administrador de banco. ### Observações - A conta de BI lê as mesmas visões da base de leitura e executa SQL sobre elas; não escreve nem enxerga as tabelas do sistema, e o próprio banco recusa. - Valem as mesmas exclusões de sigilo e de dado pessoal da base de leitura. - Criar, trocar a senha e revogar são tarefas do administrador de banco, fora das telas do Bússola/BSC. ## 12.19 Registro das execuções ID BSC-DAD-19 ### Para que serve Toda execução de dados gera uma linha num registro único do ambiente, que responde "quem executou o quê, quando e com que resultado". É desse registro que o monitor de integrações e os sinais de falha de apuração nos painéis leem. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Diretoria de Estratégia; Leitor/Auditor. ### Passo a passo 1. Execute qualquer operação de dados (pré-visualização, publicação, carga, apuração, retrato, sincronização). 2. Integrações › Monitor de integrações › localize a linha da execução pelos filtros. 3. Abra o detalhe para ver tipo, origem, quem executou, início, fim, duração, linhas lidas, corte, resultado e motivo. ### Observações - Entram no registro: pré-visualizações do console e das consultas, a execução de conferência ao publicar, cada execução de carga (e a consulta da carga por banco), cada apuração de indicador, cada retrato diário, cada sincronização de portal, os testes e execuções das integrações do hub, a sincronização da execução das ações e cada lote de valores recebido por chave de integração (indicadores importados). - Na recusa ou falha fica o código do motivo, nunca a mensagem técnica do banco. - O texto das consultas ad hoc e dos rascunhos fica registrado; a execução de uma versão publicada aponta a versão. - Os painéis marcam falha de apuração no indicador cuja última apuração falhou. ## 12.20 Monitor de integrações ID BSC-DAD-20 ### Para que serve O monitor reúne numa lista só todas as execuções do registro (cargas, apurações, controles diários, sincronizações das ações e dos portais, lotes recebidos, testes de conexão, execuções do hub e disparos de conectores), com sucesso ou falha por execução, e permite executar de novo o que falhou. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Diretoria de Estratégia. ### Passo a passo 1. Integrações › Monitor de integrações › confira o resumo **Últimas 24 horas** (sucesso, parciais, falhas, interrompidas e em andamento). 2. No cartão **Falhas seguidas**, veja cada carga, consulta, indicador, ação ou serviço cuja última execução falhou, com a contagem desde o último sucesso; clique em **Ver as execuções** para filtrar. 3. Use os **Filtros** (tipo, resultado, integração e período); copie o endereço da página para compartilhar o filtro. 4. Abra o **Detalhe** (ícone de olho) para ver início, fim, duração, registros lidos e gravados, origem do dado, quem disparou, integração, parâmetros, contadores e o motivo traduzido. 5. Clique em **Executar novamente** no detalhe de uma carga, consulta de controle, sincronização de portal ou serviço agendado. 6. Para apuração de indicador, sincronização de ação ou teste de conexão, siga a indicação do detalhe (Recalcular agora no indicador, Sincronizar agora na ação, Testar na integração). ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/GLws9oVTanUCRmt_Y5kuH_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 139 — Monitor de integrações com resumo, falhas seguidas e lista de execuções ### Observações - Se o resumo não puder ser lido, a tela diz que não conseguiu; nunca mostra "0 falhas". - Falhas seguidas ficam em vermelho a partir de três. - O filtro "qualquer falha" junta falha, tempo esgotado, recusa e interrompida. - O motivo é sempre traduzido: nunca a mensagem técnica do banco ou do outro sistema, nem senha, token ou cabeçalho de autenticação. - Executar novamente exige a permissão de executar cargas; quem não a tem vê quem pode. - Execuções de indicador ou objetivo sigiloso e de ações fora do seu alcance aparecem como **Registro sigiloso**, sem nome nem parâmetros, e o detalhe não abre. - As pré-visualizações do console SQL ficam fora da lista; só quem escreve consultas pode pedi-las pelo filtro de tipo. - No cartão do indicador apurado automaticamente, **Últimas apurações** mostra resultado, origem, duração e motivo, com link para o monitor filtrado; se a execução já saiu do registro, o detalhe avisa que expirou. ## 12.21 Serviços agendados e manutenção do registro ID BSC-DAD-21 ### Para que serve O cartão **Serviços agendados** do monitor lista o que a plataforma executa sozinha, com a próxima execução e a última nesta organização, e permite rodar um serviço na hora. A manutenção diária do registro encerra execuções presas e apaga registros antigos. **Quem usa:** Analista de Integração de Dados; Gestor de Desempenho; Administrador do sistema. ### Passo a passo 1. Integrações › Monitor de integrações › vá ao cartão **Serviços agendados**. 2. Confira, para cada serviço, a próxima execução e a última (resultado, quando, se foi agendada ou quem executou). 3. Clique em **Executar agora** para rodar o serviço só nesta organização, em segundo plano. 4. Acompanhe a linha **Em andamento** até ela mudar sozinha ao terminar. ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/GLws9oVTanUCRmt_Y5kuH_image.png" size="62" isUploading="false" width="620" height="387" showCaption="false"} Figura 140 — Cartão Serviços agendados no monitor de integrações ### Observações - Horários (Brasília): apuração automática dos indicadores 02:00; alertas de desvio 02:30; sincronização da execução das ações 02:30; cargas agendadas a cada 15 minutos; consultas de controle 03:30; sincronização dos portais 04:00; manutenção do registro 05:00; prazos de apuração dos indicadores 07:00; resumo programado de hora em hora, aos 5 minutos. - O botão Executar agora só aparece para quem tem a permissão do ato do serviço (gerir indicadores, registrar execução das ações, executar cargas ou configurar a mensageria). A execução fica registrada com o nome de quem clicou. - Se o serviço já estiver rodando nesta organização, a tela pede para tentar de novo em um minuto; a execução da madrugada pula a organização cujo Executar agora ainda está rodando. - Cargas agendadas e resumo programado só deixam linha quando trabalharam. - Manutenção: execução que ficou em andamento por parada do servidor passa a **Interrompida** após 2 horas (6 horas para sincronização de portais); registros com mais de dois anos são apagados em lotes, exceto os de cargas e retratos que ainda existem. - Parâmetros de texto livre podem conter dado pessoal digitado e seguem o mesmo prazo de retenção.