Widgets de imagem

Os widgets de imagem permitem adicionar uma imagem autônoma, como um logotipo, diagrama ou outro visual de marca, a um painel. Ao contrário de uma imagem dentro de um widget de texto, um widget de imagem exibe a imagem por conta própria e a redimensiona para ajustar o widget no modo de rascunho, no modo publicado, nas exportações e nos painéis inseridos.

Adicionando um widget de imagem a um painel e especificando uma imagem.

Adicionar um widget de imagem

  1. Arraste um widget Imagem da barra de ferramentas para a tela.
  2. Adicione uma imagem usando uma das seguintes opções no widget:
    • Arraste e solte um arquivo de imagem do seu dispositivo para o widget, ou clique em navegar para escolher um arquivo. O arquivo é carregado no workspace. Veja as fontes das imagens.
    • Clique em usar uma URL para inserir um caminho de volume do Azure Databricks ou uma URL hospedada publicamente.
    • Clique em selecionar uma imagem do espaço de trabalho para escolher um arquivo de imagem que já está no seu espaço de trabalho.

A imagem aparece no widget e é redimensionada para se ajustar ao widget.

Substituir ou remover uma imagem

Para substituir a imagem em um widget de imagem, selecione o widget e use o botão Upload new image no editor de widgets:

  • Clique Upload new image para enviar um arquivo do seu dispositivo.
  • Clique na seta ao lado de Carregar nova imagem, depois selecione Usar uma URL de imagem ou Selecionar uma imagem de espaço de trabalho.

Para apagar a imagem do widget, clique em Remover imagem.

Fontes de imagem

Widgets de imagem suportam as seguintes fontes de imagem:

  • Arquivo carregado: Quando você solta ou procura um arquivo, Azure Databricks o salva como um arquivo de workspace na mesma pasta do painel, usando o nome original do arquivo. O painel armazena uma referência a esse arquivo. O editor de dashboards não impõe seu próprio limite de tamanho, mas o espaço de trabalho pode rejeitar arquivos muito grandes. Para melhor desempenho no dashboard, use imagens pequenas.
  • Imagem do espaço de trabalho: Um arquivo de imagem que já existe no seu espaço de trabalho. A janela de diálogo Selecionar uma imagem do espaço de trabalho lista os arquivos de imagem que você tem permissão para ler.
  • Caminho de volume ou URL pública: Para os formatos de caminho de volume e URL pública, e as permissões necessárias para imagens hospedadas em volumes, veja Caminhos de imagem e URLs.

Widgets de imagem suportam arquivos PNG, JPEG/JPG, WebP e SVG. Se você selecionar Imagens do modo claro/escuro, pode usar qualquer fonte de imagem para cada modo.

Permissões para imagens de workspace

Arquivos enviados e imagens de workspace têm suas próprias permissões de arquivo de workspace. Os visualizadores de dashboards devem ter permissão de leitura no arquivo da imagem para ver a imagem. Se um visualizador não consegue ler o arquivo, a imagem não carrega para ele. Isso também se aplica a destinatários de assinaturas programadas e a downloads de PDFs.

  • Arquivos enviados: Quando você faz upload de uma imagem, o grupo de usuários (todos os usuários do workspace) recebe a permissão PODE LER no arquivo. Usuários de contas que não são membros do workspace não têm acesso. Para restringir o acesso, altere as permissões do arquivo no navegador de workspace. Consulte as ACLs de arquivo.
  • Imagens do espaço de trabalho: Selecionar uma imagem do espaço de trabalho existente não altera suas permissões. Certifique-se de que os visualizadores de dashboards possam ler o arquivo.

As permissões dos arquivos de imagem não sincronizam com as permissões do painel, então mudar quem pode visualizar o painel não muda quem pode visualizar a imagem.

Exportar, importar e clonar

Quando você exporta, importa ou clona um painel, apenas a referência a um arquivo ou imagem de espaço de trabalho carregada é copiada. O arquivo de imagem permanece em sua localização original no espaço de trabalho. Se você importar o painel para outro espaço de trabalho, incluindo pastas Git ou Pacotes de Automação Declarativa, a imagem não carrega a menos que o arquivo esteja disponível no mesmo caminho e os visualizadores possam lê-lo. Para manter uma imagem portátil entre espaços de trabalho, use uma URL hospedada publicamente.

A remoção de uma imagem de um widget ou a exclusão do painel não exclui o arquivo de imagem do workspace.

Controlar como a imagem é exibida

Por padrão, a imagem é dimensionada para se ajustar ao widget e centralizada. Escolha como a imagem preenche o widget:

  • Ajuste: Escala a imagem para caber dentro do widget, mantendo sua proporção de aspecto. A imagem nunca é cortada e nenhuma barra de rolagem é exibida. Este é o padrão.
  • Preenchimento: Escala a imagem para preencher a largura do widget. Uma barra de rolagem é exibida quando o conteúdo excede os limites do widget.
  • Alinhamento: Use as ferramentas de alinhamento para alinhar sua imagem dentro do widget.

As ferramentas de alinhamento para um widget de imagem.

Adicionar um widget de imagem com o Genie Code

O Genie Code para criação de dashboard pode adicionar widgets de imagem para você. Peça que adicione uma imagem, e ela criará um widget de imagem no canvas. Consulte Usar o Genie Code para criação de dashboard.