Dados e Interações

Os widgets baseados em dados utilizam uma Fonte de dados guardada na Visão do Utilizador. Uma fonte pode ser reutilizada por vários widgets da mesma visão.

Tipos de Fonte

Ambiente

Utiliza uma ligação pré-configurada e disponibilizada pelo administrador. É a opção recomendada quando a mesma ligação deve ser gerida centralmente.

Manual

Permite registar uma ligação protegida diretamente na visão, quando esta possibilidade foi ativada pelo administrador.

O ecrã permite guardar, verificar, revogar ou eliminar a ligação. Os valores reservados não são exibidos após o salvamento. Para Oracle, é necessário indicar se o nome do banco de dados representa um SID ou um Service name.

Modelo Semântico

Utiliza campos e medidas de um Modelo Semântico publicado e acessível. É possível:

• seguir automaticamente a última versão publicada;
• manter a versão atual;
• selecionar dimensões, colunas e medidas através de caixas de seleção;
• personalizar o alias de cada campo, inicialmente igual ao nome do campo;
• consultar as diferenças quando o modelo publica uma nova versão.

Criar uma fonte relacional

1. Selecionar Dados e depois Fontes de dados privadas.
2. Inserir um nome reconhecível.
3. Escolher o tipo de ligação.
4. Selecionar uma ligação autorizada.
5. Usar Testar ligação.
6. Carregar o catálogo disponível; o indicador animado confirma que a leitura está em curso.
7. Configurar a consulta.
8. Guardar e usar Pré-visualizar dados. A pré-visualização pode ser fechada com o comando relativo e fecha-se automaticamente ao passar para outra fonte.
9. Associar a fonte ao widget selecionado.

O catálogo mostra todos os esquemas que contêm tabelas ou visões legíveis, até 500 objetos por esquema.

Se o carregamento exceder o tempo máximo do servidor, o Editor mostra uma mensagem explícita: tentar novamente e, se o problema persistir, contactar o administrador indicando a hora da tentativa.

Com uma ligação SAP HANA, o catálogo mostra as tabelas, visões e colunas visíveis ao utilizador configurado na ligação. Os objetos selecionados podem ser usados no Query Builder e na Pré-visualização de dados. Se um objeto esperado não aparecer, verificar com o administrador as permissões atribuídas no banco de dados.

Query Builder

O Query Builder permite configurar uma leitura sem escrever SQL. Estão disponíveis:

• esquema e tabela de partida;
• dimensões e colunas;
• medidas e agregações;
• aliases;
• joins;
• condições organizadas em grupos AND/OR;
• ordenações;
• limite opcional de linhas.

Verificar a Pré-visualização após cada alteração relevante, especialmente quando existem joins ou condições aninhadas.

SQL personalizado

O modo SQL custom aceita exclusivamente consultas de leitura. Usar parâmetros declarados em vez de concatenar valores inseridos pelos utilizadores.

Ao passar do Query Builder para SQL custom, o Sybot gera a sintaxe coerente com a ligação selecionada. Para SAP HANA, os identificadores são delimitados por dois apóstrofos; uma consulta modificada manualmente permanece sob o controlo do utilizador.

O editor permite:

• formatar a consulta;
• declarar parâmetros e valores iniciais;
• usar parâmetros nos filtros da visão;
• verificar o resultado na Pré-visualização.

As consultas não admitidas são recusadas com uma mensagem; não tentar contornar os controlos.

Associar os dados aos widgets

No painel Dados e visualização do widget:

1. selecionar a fonte;
2. escolher dimensão, categoria ou hierarquia; os menus mostram nome_entità.nome_campo em ordem alfabética;
3. selecionar as medidas a exibir;
4. configurar agregação e formato;
5. verificar o resultado na Pré-visualização.

As definições de um único widget não modificam a definição da fonte partilhada.

Quando os dados estão a carregar, cada widget exibe um indicador animado no centro com o texto A carregar…. O indicador permanece visível até que a solicitação seja concluída; com fontes LIVE, o tempo de espera também depende dos tempos de resposta do sistema consultado.

Ordenar um gráfico

Para cada gráfico, é possível escolher no Editor uma ordenação padrão crescente ou decrescente por categoria ou por uma das medidas exibidas. Esta é a ordem inicial usada em Pré-visualização e na vista publicada; quando o gráfico usa uma hierarquia, a ordenação por categoria segue o nível exibido.

Durante a consulta, abra o menu de três pontos ou o menu de contexto do gráfico e selecione Ordenação. É possível aplicar temporariamente uma ordem diferente ou selecionar Padrão da vista. A escolha temporária não modifica a Vista do Utilizador e é perdida ao recarregar a página.

Em gráficos de pizza e donut, as cores configuradas estão associadas ao valor da categoria. Mudar a ordenação altera o arranjo das categorias, mas não a sua cor: a correspondência visual permanece, portanto, estável.

Cores e imagens das categorias

Os gráficos usam uma paleta padrão estendida, modificável no painel Propriedades. Em gráficos de pizza, donut e barras, é possível substituir a cor de uma categoria por uma imagem escolhida no Catálogo de imagens da vista.

Imagem e cor são alternativos:

• ao selecionar uma imagem, a cor e o respetivo comando fx da mesma categoria são desativados;
• durante o carregamento do recurso, não é exibida uma cor provisória;
• ao remover a imagem, a configuração da cor volta a estar disponível;
• para cada imagem, é possível escolher Preencher, Contenha ou Repetir.

Verifique em Pré-visualização se o recorte e a legibilidade da imagem são adequados ao tamanho e à forma dos elementos do gráfico.

Filtros

Estão disponíveis filtros para:

• categoria;
• valor livre;
• intervalo de datas;
• intervalo numérico.

Cada filtro pode ser ligado a um ou mais widgets de destino. Os widgets Filtros ativos e Repor filtros tornam visíveis e anuláveis as seleções do utilizador.

Quando Filtro categorias usa uma fonte derivada de um Modelo Semântico, o filtro é aplicado como campo do modelo: o Sybot usa, portanto, as relações definidas no modelo para alcançar os widgets de destino alimentados pelo mesmo modelo, mesmo que as respetivas fontes selecionem campos diferentes.

No painel Propriedades, Seleção categorias permite escolher entre:

• Única, para aplicar um valor de cada vez;
• Múltipla, para abrir um menu suspenso com caixas de seleção e aplicar até cem valores em conjunto.

O resumo do menu suspenso indica quantos valores estão selecionados. O widget Filtros ativos exibe-os no mesmo filtro e Repor filtros remove-os numa única operação. O menu suspenso não se filtra sozinho: após a primeira seleção, as outras categorias compatíveis permanecem disponíveis para adicionar mais caixas de seleção.

O painel Filtros avançados, quando ativado nas propriedades da vista, recolhe os campos filtráveis da página mesmo sem um widget dedicado.

Interações entre widgets

Gráficos e tabelas podem enviar uma seleção para outros widgets.

Exemplos:

• selecionar uma barra para filtrar uma tabela;
• escolher uma linha para mostrar o seu detalhe num drawer;
• usar uma hierarquia para passar de uma categoria geral a um nível mais específico;
• mostrar ou ocultar um grupo de widgets através de Visibilidade widget.

A seleção é um contexto da interface e não substitui os controlos de autorização executados pelo Sybot.

Na Tabela de dados, a seleção única ocorre clicando diretamente na linha e não exibe botões de rádio. A seleção múltipla mantém as caixas de seleção, úteis para verificar quais linhas participam de uma ação em massa.

Mapas

O Mapa de pontos cluster usa coordenadas geográficas e agrupa automaticamente os pontos durante o zoom e o redimensionamento.

A Mapa coroplético colore áreas com base num valor agregado. Estão disponíveis áreas geográficas predefinidas; para necessidades específicas, pode ser usada uma mapa personalizada compatível. Os predefinidos reconhecem códigos geográficos e nomes tanto em italiano como em inglês. Os limiares são configurados através de limite, rótulo e seletor de cor; apenas o último pode ser sem limite superior.

Verifique sempre em Pré-visualização se as chaves geográficas, coordenadas e limiares correspondem aos dados disponíveis.

Widget Fluxo de Trabalho

Os widgets Fluxo de Trabalho permitem, dependendo das permissões:

• iniciar um Fluxo de Trabalho;
• passar parâmetros estáticos ou valores do registo selecionado;
• executar uma ação num ou mais registos;
• mostrar estado, progresso e registo de eventos (log);
• interromper uma execução ativa;
• atualizar outros widgets após a conclusão.

Para os widgets que iniciam um Fluxo de Trabalho, o Editor carrega os parâmetros configurados no Fluxo de Trabalho, excluindo os de tipo ficheiro. É possível:

• definir um valor predefinido diretamente nas propriedades do widget;
• ativar fx para calcular o valor predefinido a partir de filtros e contextos disponíveis;
• escolher se mostrar o painel de parâmetros antes do início e em Pré-visualização;
• deixar o painel desativado para usar diretamente os valores predefinidos e o mapeamento configurados.

Quando ativado, o painel aparece como um overlay compacto: o utilizador pode controlar e modificar os valores editáveis num único passo. Em Pré-visualização, o painel mostra o resultado da configuração, mas não inicia o Fluxo de Trabalho. Os valores protegidos não são guardados na Visão; se forem deixados vazios, é mantido o valor predefinido protegido do Fluxo de Trabalho.

Antes de publicar:

1. selecionar o Fluxo de Trabalho autorizado;
2. configurar valores predefinidos, fórmulas ou mapeamento dos parâmetros;
3. adicionar um texto de confirmação para as ações relevantes;
4. verificar o painel de parâmetros em Pré-visualização;
5. testar o início, o erro e a interrupção a partir da versão publicada;
6. verificar o comportamento com um utilizador não proprietário.

Diagnóstico

Quando uma fonte falha, a visão mostra uma mensagem de erro e, se disponível, uma referência para comunicar ao administrador.

Verificar:

• se a fonte ainda está ativa;
• se o Modelo Semântico está publicado;
• se os parâmetros necessários têm um valor;
• se o utilizador dispõe dos projetos e papéis necessários;
• se a estrutura dos dados não mudou.