Gerir painéis¶

About the Dashboards app¶

The Dashboards app makes it possible to present a high level overview of your data, including displaying analytical objects such as maps, charts, reports, tables, and line lists, as well as displaying text-based information, resource links, plugins and app widgets.

Os recursos do aplicativo Dashboards incluem:

• Visualizar e imprimir painéis
• Slideshow
• Criar e editar painéis
• Partilhar painéis com utilizadores e grupos de utilizadores
• Aplicar filtros temporários ao visualizar os painéis
• Visualização responsiva em dispositivos móveis e telas pequenas
• Acesse os painéis enquanto estiver off-line

Layout do aplicativo de painéis¶

Dashboards have a title, description, dashboard items. The title and actions bar is at the top of the page under the header bar, and shows the title, a dropdown for searching and selecting dashboards, and actions that can be taken with the current dashboard. There is also a + button for creating a new dashboard.

The Dashboards app has two modes: view and edit/create. When you first log in to DHIS2, your most recently used dashboard will be displayed in view mode, if you are on the same computer as you were previously. If you are using a different computer or browser, then the first starred dashboard will be displayed. If there are no starred dashboards, then the first dashboard (alphabetically) will be displayed. Starred dashboards always show first in the dashboard list.

Below is a dashboard named "Antenatal Care", which has been populated with charts and maps:

Personalization¶

To adjust the Dashboards app to suit your needs, you can:

• Painéis com estrela para acesso rápido aos seus painéis favoritos
• Mostrar ou ocultar a descrição do painel

Responsive view on small screens¶

When viewing dashboards on small screens like mobile phones, the dashboard will adapt to the screen and show all items in a single column. Some options, including editing, filtering and sharing, will not be available.

Searching for a dashboard¶

You can search for a specific dashboard using the search field available from the Dashboards dropdown selector in the title bar. The search is case insensitive, and as you type, the list of dashboards will be narrowed down to those that match your search text.

Creating and editing a dashboard¶

To create a new dashboard, click the + button in the upper corner of the title bar to enter create/edit mode:

To edit an existing dashboard, click the Edit button (you must have edit access to see this button):

In create/edit mode, you can add or change the dashboard title, description, dashboard code and dashboard items. If you do not add a title, the dashboard will automatically be titled "Untitled dashboard".

If the system has been configured to support embedded dashboards, then you will have the option of creating a regular (internal) dashboard or embedding a dashboard from an external source. See this section for more information.

Adicionando itens ao painel¶

Add items to the dashboard by searching for items using the Search for items to add to this dashboard dropdown selector. Item types are:

• Visualizations (charts and pivot tables)
• Mapas
• Line lists
• Relatórios de eventos
• Gráficos de eventos
• Relatórios
• Recursos
• Third party plugins and app widgets
• Mensagens
• Caixas de texto
• Espaçadores

The list of items in the dropdown initially displays 10 visualizations (charts and tables), and 5 from each of the other categories, based on the search text you enter. To view more items, click on Show more, and the list for that type will be extended to 25 items. If you still do not find the item you want, try typing a more specific search text. Messages (Email), text boxes and spacer items can also be chosen from the list.

Dashboard layout and placement of new items¶

Ao adicionar itens ao painel, pode escolher um layout geral clicando no botão Alterar layout. Pode alterar essa configuração de layout a qualquer momento.

• Com o layout Freeflow, os itens adicionados podem ser movidos usando o mouse clicando no item e arrastando-o para a posição desejada. Os itens também podem ser redimensionados com o mouse clicando na alça de arrastar no canto inferior direito do item e arrastando para o tamanho desejado.
• With Fixed columns layout, you can choose the number of columns to have on the dashboard, and the dashboard will automatically be layed out for you. Items cannot be moved or resized in Fixed columns layout. If you want to make custom adjustments to a Fixed columns layout, return to a Freeflow layout.

Também pode configurar se os itens recém-adicionados são colocados automaticamente no início ou no final do painel, escolhendo a opção desejada. Esta opção pode ser alterada a qualquer momento.

Itens espaçadores¶

Ao adicionar itens ao painel usando o layout Freeflow, eles irão "subir" até esbarrar em outro item. Para forçar o espaço vertical vazio entre os itens (como uma linha vazia), pode adicionar itens espaçadores ao painel. Eles são visíveis apenas no modo de edição/criação. No modo de visualização, eles não são exibidos, mas ocupam o espaço definido.

Espaçador em modo de edição/criação:

Espaçador em modo de visualização:

Removendo itens¶

Remove items by clicking on the red trash can at the upper right of the item. Be aware that when you remove an item while in Freeflow layout, the items that are positioned below the removed item will "rise" upwards until they bump into an item above. in Fixed columns layout, the items will be adjusted to fill every column in the layout so there are no empty column slots.

Actions in create/edit mode¶

No modo de criação/edição, verá os seguintes botões na barra de ações na parte superior da página: Salvar alterações, Visualizar impressão, Configurações de filtro, Traduzir, Apagar e Sair sem salvar. Os botões Traduzir e Apagar são exibidos apenas se estiver editando um painel existente.

Salvando o painel¶

Ao criar ou editar um painel, as alterações são salvas quando clica no botão Salvar alterações. Se não quiser salvar suas alterações, clique no botão Sair sem salvar. Em seguida, retornará ao modo de visualização com o painel que estava visualizando anteriormente.

Print preview¶

Clique no botão **Visualizar impressão ** para ver a aparência do painel ao ser impresso com a Opção de layout do painel.

Clique em Sair da visualização de impressão para retornar à edição do painel.

Observe que alguns itens podem ser movidos para a próxima página para evitar a divisão entre duas páginas. Os itens também podem ser encurtados para caber em uma página. Os itens encurtados mostram um ícone de informações no canto superior direito do item na visualização. O ícone de informações não é visível na impressão real.

Restringindo filtros do painel¶

Por padrão, os utilizadores serão capazes de filtrar itens do painel por qualquer dimensão definida na instância DHIS2. As configurações de filtro do painel podem ser editadas para um painel clicando em Configurações de filtro.

Para restringir os filtros disponíveis, pode clicar em Permitir apenas a filtro por dimensões selecionadas e selecionar os filtros que deseja permitir no painel. O período e a unidade organizacional são selecionados por padrão, mas podem ser removidos, se desejado. Quando o painel é visualizado, os utilizadores só poderão escolher entre os filtros selecionados.

Para salvar as atualizações nas configurações do filtro, precisa primeiro clicar em Confirmar para fechar a caixa de diálogo Configurações do filtro e, em seguida, clicar em Salvar alterações para salvar as alterações do painel.

Tradução do título e da descrição do painel¶

If you are editing an existing dashboard, then there will be a Translate button. Click on this button to open the Translation dialog, which provides a list of languages to translate to, and shows the original dashboard title and description. First choose the language you want to translate for, then fill in the dashboard name and description translation.

Excluindo um painel¶

Se tiver acesso para apagar o painel, haverá um botão Apagar. Ao clicar no botão Apagar, uma caixa de diálogo de confirmação será exibida primeiro para confirmar que deseja excluir o painel.

Creating and editing an external dashboard¶

If the system has been configured to support embedded (Superset) dashboards, and you start creating a new dashboard by clicking the + button, you will be presented with a choice:

If you choose the "External" option here and click "continue", you will be taken to a modal form where you can create an embedded dashboard:

The "Title", "Code" and "Description" fields in this form are identical to the fields with the same names you see when creating a regular (internal) dashboard, but there are also some notable differences:

• Since the dashboard content is coming from an external system (Superset), there is no need to add dashboard items
• A "Superset Embed ID" needs to be provided so the app can retrieve the correct dashboard from the external Superset service
• The "Show chart controls on dashboard items" checkbox controls whether or not each embedded dashboard item has a dropdown menu
• The "Expand filters" checkbox controls whether or not the filter section of the embedded dashboard is initially expanded or collapsed
• The "Restrict data by organisation unit hierarchy" checkbox controls whether or not organisation unit user access will be applied to the external data source. Only visible in this dialog when it is supported by the Superset Gateway.

Once the dashboard is created, you can star/unstar, edit and share it. You can also show and hide the description and close the dashboard. It is not possible to show it in slideshow mode, filter it, or enter print view mode.

Configuring the system for embedded Superset dashboards¶

In order for the embedded Superset dashboards feature to work, the following prerequisites need to be met:

• The system must have access to a Superset service (installation instructions)
• The Superset Gateway must be installed (instructions)
• Support for embedded dashboards must be enabled in the "Analytics" section of the DHIS2 System Settings App

Visualizando um painel¶

The following actions are available on the dashboard in view mode:

• Set the show/hide description setting
• Star the dashboard so it appears first in the dashboard list
• Filter the dashboard
• Print the dashboard
• Display the dashboard in a slideshow
• Make the dashboard available offline
• Share the dashboard with other users and user groups
• Close the dashboard

Mostrar descrição¶

To toggle the description, open the ... menu and choose Show description (or Hide description). This setting will be remembered for all dashboards that you open. This setting applies to you, not other users.

Painéis favoritos{ #dashboard-star-dashboard }¶

Your starred dashboards are listed first in the list of dashboards for quick access. To star a dashboard, click on the star button to the right of the title. You can also toggle the star from the ... menu. When the star is “filled”, that means the dashboard is starred. Starring a dashboard only applies to you, not other users.

Filter a dashboard¶

Aplicar filtros a um painel altera os dados exibidos nos itens do painel que contêm visualizações. Os filtros são aplicados a cada item do painel da mesma maneira: cada filtro adicionado substitui o valor original para aquela dimensão no gráfico, tabela ou mapa original. É possível filtrar por unidades organizacionais e períodos, bem como por dimensões dinâmicas, dependendo da instância do DHIS2. Pode aplicar vários filtros ao painel.

To add a filter, click on the Filter button and choose a dimension:

Uma caixa de diálogo é aberta onde a seleção do filtro pode ser feita.

Click on Confirm in the dialog to apply the filter to the current dashboard.

Os filtros não são armazenados, portanto, ao alternar para um painel diferente, eles são redefinidos. Os emblemas de filtro pretos aparecem acima dos itens do painel para indicar quais filtros foram aplicados às visualizações do painel.

Pode editar um filtro clicando no ícone do filtro para abrir a caixa de diálogo de seleção de filtro. Um filtro pode ser removido clicando no botão Remover no emblema. Sempre que um filtro é adicionado, editado ou removido, os itens do painel são recarregados para mostrar os dados atualizados. Os emblemas do filtro estão sempre visíveis na parte superior da página ao rolar o conteúdo do painel.

Por padrão, os utilizadores podem filtrar itens do painel por qualquer dimensão definida na instância DHIS2. Para limitar os filtros disponíveis, consulte Restringindo filtros do painel.

Display the dashboard in a slideshow¶

The dashboard can be displayed in a slideshow by clicking on the Slideshow button. Once in slideshow mode, you'll find all the slideshow controls, including the manual navigation buttons, autoplay controls, and exit button in the slideshow control bar at the bottom of the page.

Slideshow control bar:

The slideshow can be autoplayed, or navigated manually.

When you enter the slideshow, it is paused. Click the play/pause button in the control bar to start the autoplay, and the slides will automatically advance according to the timing setting. A countdown bar is visible on the play/pause button while the slideshow is playing. Once the slideshow has reached the last slide, it will restart automatically. If 24 hours has passed since the slideshow began, a message stating as such will appear in the control bar, since data does not refresh during the slideshow and may be considered out of date for certain visualizations.

The autoplay controls include the play/pause button and the timing settings button. The user's most recent selected timing setting is remembered for the next time the slideshow is started.

You can also navigate the slides manually both when the slideshow is playing and paused. Use the manual navigation buttons or forward/back arrow keys on the keyboard to navigate through the slides. If the slideshow is playing, the timer resets when manually navigating, and the slideshow will automatically advance unless you click pause.

Exit the slideshow with the esc key or by pressing the exit button.

Any filters that are applied will be displayed in the slideshow control bar. Note that messages and spacer items are not displayed in the slideshow.

Make dashboards available offline¶

To make a dashboard available offline, choose the Make available offline option in the ... menu. This will cause a reload of the dashboard where requests to the server are recorded and saved in browser storage. Note that offline dashboards are only available on the computer and browser where you set it to offline. If you currently have a filter applied when requesting the dashboard be made available offline, a dialog will appear to confirm the removal of the filters.

Note that some dashboard items may not be displayed when offline. Specifically, third party plugins that have not implemented offline handling, as well as maps with Google Earth Engine layers will not be displayed when offline.

Dashboards that have been saved for offline display a tag next to the dashboard title showing the time it was saved. In the dashboard selector, an icon is displayed if the dashboard is available offline.

If the dashboard has been changed since you made it available offline, either by you or someone else, you'll need to choose Sync offline data now from the ... menu to save the latest version of the dashboard.

You can remove a dashboard from offline storaged by choosing Remove from offline storage in the ... menu.

Other notes about Dashboards app when you are offline¶

Se desconectar se manualmente da instância DHIS2, todos os painéis em cache serão limpos e não estarão mais disponíveis offline.

Se estiver offline, quaisquer botões ou ações que requeiram uma conexão para ser concluída com êxito serão desativados. Eles serão reativados assim que a conectividade for restaurada.

Printing a dashboard¶

From the ... menu you can print the current dashboard. There are two styles of dashboard print: Dashboard layout and One item per page. For both styles, a title page is added that shows the dashboard title, description (if the Show description setting is enabled), and any applied dashboard filters.

Para melhores resultados de impressão:

• usar Chrome ou Edge
• espere até que todos os itens do painel sejam carregados antes de imprimir
• usar configuração paisagem A4 com margens padrão definidas e gráficos de fundo ativados

Layout do painel de impressão¶

Dashboard layout print aproximar-se-á do layout do painel conforme mostrado no navegador. Observe que alguns ajustes podem precisar ser feitos no layout para evitar que os itens sejam divididos em várias páginas: os itens que seriam cortados por uma quebra de página são movidos para a próxima página e os itens mais altos do que uma página são encurtados para caber em uma página.

Uma vez no modo de impressão, clique no botão Imprimir no canto superior direito para acionar a funcionalidade de impressão do navegador.

Print one item per page¶

Este estilo de impressão imprimirá cada item do painel em uma página separada, maximizando o uso do tamanho do papel.

Clique no botão Imprimir no canto superior direito para acionar a funcionalidade de impressão do navegador.

Dashboard items with charts, pivot tables, maps and line lists¶

Dashboard items with charts, pivot table, maps, line lists, event reports and event charts may have an item menu button in the upper right corner of the item with additional viewing options, depending on the system settings that have been configured for the DHIS2 instance. If all the relevant system settings have been disabled by the DHIS2 instance, then there will not be an item menu button. Here are the possible item menu options:

Alternando entre visualizações¶

It is possible to toggle the visualization view of charts, pivot tables and maps, and between event charts and reports. Click on the item menu button and choose the desired view (e.g., View as Table, View as Map, View as Chart):

View item in fullscreen¶

To view the chart, table, map or line list in fullscreen, click on the View fullscreen option. To exit fullscreen, you can either press esc key or click the exit button in the upper right corner of the fullscreen view. Note that you actually enter the slideshow in a paused state, and can then use the navigation bar or click the play button as described in the Slideshow section to navigate to other dashboard items in fullscreen.

Open in app¶

Para abrir a visualização em seu aplicativo correspondente (por exemplo, Data Visualizer, Maps), clique na opção Abrir no aplicativo [nome do aplicativo].

Show interpretations and details¶

You can write interpretations for charts, pivot tables, maps, line lists, event reports, and event charts by clicking on Show interpretations and details. The item will be expanded vertically underneath to show the description, interpretations and replies:

You can like an interpretation, reply to an interpretation, and add your own interpretations. You can edit, share or delete your own interpretations and replies, and if you have moderator access, you can delete others’ interpretations.

It is possible to format interpretation text with bold, italic by using the Markdown style markers * and _ for bold and italic respectively. The text field for writing new interpretations has a toolbar for adding rich text. Keyboard shortcuts are also available: Ctrl/Cmd + B and Ctrl/Cmd + I. A limited set of smilies is supported and can be used by typing one of the following character combinations: :) :-) :( :-( :+1 :-1. URLs are automatically detected and converted into a clickable link.

As interpretações são classificadas em ordem decrescente por data, com a mais recente exibida no topo. As respostas de interpretação são classificadas em ordem crescente por data, com a mais antiga exibida no topo.

Share the dashboard¶

In order to share the dashboard with users and user groups, click on the Share button to the right of the dashboard title to display the Sharing and access dialog.

Existem três níveis de permissões de partilha disponíveis para um painel:

• Sem acesso

  O utilizador ou grupo de utilizadores não pode visualizar ou editar o painel. Se eles tentarem acessar o painel com a url, o aplicativo Painéis exibirá a mensagem "Painel solicitado não encontrado".

• Apenas ver

  O utilizador ou grupo de utilizadores pode visualizar o painel, mas não pode editá-lo.

• Ver e editar

  O utilizador ou grupo de utilizadores pode visualizar e editar o painel. Este nível de partilha permite todos os tipos de mudanças, incluindo alterar o layout, redimensionar e remover itens, renomear e excluir o painel, etc.

Todos os painéis têm o grupo Todos os utilizadores definido como Sem acesso por padrão. O grupo Todos os utilizadores inclui todos os utilizadores conectados.

Add users and user groups¶

Para partilhar um painel com utilizadores e grupos de utilizadores específicos, digite o nome no campo de entrada, escolha o nível de acesso desejado e clique em Dar acesso.

Pode fornecer aos utilizadores a url do painel, permitindo que naveguem diretamente para o painel. Para obter o url do painel, basta abrir o painel no modo de visualização e copiar o url do navegador. Por exemplo, o url para o painel de Cuidados Pré-natais em play.dhis2.org/dev é:

https://play.dhis2.org/dev/dhis-web-dashboard/#/nghVC4wtyzi

Cascade sharing of visualizations on the dashboard¶

Para garantir que todos os gráficos, mapas e tabelas no painel sejam partilhados com os utilizadores e grupos de utilizadores escolhidos, clique no botão Aplicar partilha aos itens do painel.