A partir do Looker 24.0, as extensões podem ser desenvolvidas para execução em um bloco de painéis. Extensões que podem ser executadas como um bloco ou visualização podem ser adicionadas enquanto o dashboard está no modo de edição ou salvas em um dashboard como uma visualização de uma Análise. As extensões também podem ser configuradas como blocos nos painéis do LookML.
Exemplos de extensões que podem ser usadas como blocos do painel de controle estão disponíveis:
- A extensão de visualização de bloco mostra como criar uma visualização personalizada usando o framework de extensões.
- A extensão do SDK de bloco mostra os métodos de API disponíveis específicos para extensões de bloco.
Como usar o SDK da extensão do Looker com extensões de bloco
As extensões de bloco exigem que o parâmetro mount_points
seja definido no arquivo de manifesto do projeto do LookML para que as extensões sejam carregadas como blocos em um dashboard. Há dois tipos de mount_points
relacionados às extensões de bloco:
mount_points: {
dashboard_vis: yes
dashboard_tile: yes
standalone: yes
}
dashboard_vis
: quando ativada, a extensão aparece nas opções de visualização de uma Análise detalhada, onde pode ser selecionada como uma visualização e salva como um bloco do painel. Quando o painel for executado, ele vai executar a consulta associada ao bloco e disponibilizar os dados para a extensão. Isso é semelhante a como as visualizações personalizadas funcionam. A principal diferença entre uma visualização personalizada e uma extensão em um bloco do painel comdashboard_vis
ativado é que a extensão pode fazer chamadas da API Looker.dashboard_tile
: quando ativada, a extensão aparece no painel Extensões exibido quando um usuário está editando um painel e seleciona a opção Extensões depois de clicar no botão Adicionar. Esse tipo de extensão é responsável por recuperar os próprios dados, em vez de fazer com que a consulta de bloco forneça dados automaticamente à extensão.
Um ponto de montagem adicional, standalone
, faz com que a extensão apareça na seção Applications do menu principal do Looker. É possível que uma extensão tenha vários pontos de montagem definidos. No tempo de execução, a extensão é notificada sobre como é montada e pode ajustar o próprio comportamento de acordo. Por exemplo, standalone
extensões talvez precisem definir a própria altura, enquanto as extensões de bloco não.
APIs extras da extensão de bloco
As extensões de blocos são fornecidas com APIs e dados adicionais no momento da execução. Eles são obtidos do contexto da extensão:
const {
tileSDK,
tileHostData,
visualizationData,
visualizationSDK,
} = useContext(ExtensionContext40)
tileSDK
: fornece funções específicas do bloco para permitir que a extensão interaja com o host do painel do Looker. Por exemplo, para permitir que a extensão exiba e apague mensagens de erro.tileHostData
: fornece dados de bloco para a extensão. Os dados são atualizados automaticamente com base nas interações com o painel de hospedagem. Um exemplo é o indicadorisDashboardEditing
.visualizationSDK
: fornece funções específicas da visualização para permitir que a extensão interaja com o host do painel do Looker. Um exemplo é a funçãoupdateRowLimit
.visualizationData
: fornece dados de visualização para a extensão. Os dados são atualizados automaticamente com base nas interações com o painel de hospedagem. Os dados são semelhantes aos fornecidos para visualizações personalizadas.
Como criar extensões reativas
Os iframes em que as extensões são executadas são redimensionados automaticamente à medida que a janela do host mãe do Looker é redimensionada. Isso é refletido automaticamente na janela de conteúdo do iframe. O componente iframe não tem padding ou margem. Portanto, cabe à extensão fornecer o próprio padding e margem para que pareça consistente com o aplicativo Looker. Para extensões independentes, a altura é controlada pela extensão. Para extensões executadas em blocos do painel ou visualizações do recurso "Explorar", a janela de conteúdo do iframe será definida automaticamente com a altura disponibilizada pelo iframe.
Considerações sobre renderização
É importante observar que as extensões de bloco são renderizadas quando um painel é baixado como PDF ou imagem. O renderizador espera que o bloco o notifique quando a renderização estiver concluída. Se isso não for feito, o renderizador vai parar de responder. Este é um exemplo de como notificar o renderizador de que o bloco foi renderizado.
const { extensionSDK } = useContext(ExtensionContext40)
useEffect(() => {
extensionSDK.rendered()
}, [])
As animações também precisam ser desativadas ao renderizar. Confira abaixo um exemplo em que as configurações de animação são desativadas durante a renderização:
const { lookerHostData} = useContext(ExtensionContext40)
const isRendering = lookerHostData?.isRendering
const config = isRendering
? {
...visConfig,
valueCountUp: false,
waveAnimateTime: 0,
waveRiseTime: 0,
waveAnimate: false,
waveRise: false,
}
: visConfig
if (mountPoint === MountPoint.dashboardVisualization) {
return <VisualizationTile config={config} />
}
Funções e propriedades do SDK do Tile
O SDK do bloco fornece funções que permitem que uma extensão de bloco interaja com o painel de hospedagem.
As funções e propriedades disponíveis são mostradas na tabela a seguir:
Função ou propriedade | Descrição |
---|---|
tileHostData (propriedade) |
Dados do host específicos da extensão de bloco. Consulte a seção Dados do SDK do Tile para mais detalhes. |
addError |
Quando chamado, o dashboard ou a Análise exibe uma mensagem de erro abaixo da visualização. |
clearError |
Quando chamado, o dashboard ou a Análise oculta as mensagens de erro exibidas abaixo da visualização. |
openDrillMenu |
Para extensões de visualização, essa chamada abre um menu de detalhamento. Essa chamada será ignorada se a extensão não for uma visualização de extensão de bloco. |
runDashboard |
Executa o painel atual. Essa chamada é ignorada por uma extensão de visualização de blocos em execução em uma Análise. |
stopDashboard |
Interrompe um painel em execução. Essa chamada é ignorada por uma extensão de visualização de blocos em execução em uma Análise. |
updateFilters |
Atualiza os filtros no painel atual ou em "Explorar". |
openScheduleDialog |
Abre a caixa de diálogo de programação. Esta chamada é ignorada durante a execução em uma Análise. |
toggleCrossFilter |
Ativa os filtros cruzados. Essa chamada é ignorada quando executada em uma Análise. |
Dados do SDK do Tile
As propriedades de dados do SDK de blocos disponíveis são mostradas na tabela a seguir:
Propriedade | Descrição |
---|---|
isExploring |
Quando verdadeiro, indica que o bloco está sendo configurado como uma visualização dentro de uma Análise. |
dashboardId |
O ID do painel do bloco que está sendo renderizado. Se o bloco estiver sendo configurado como uma Análise, essa propriedade não será preenchida. |
elementId |
O ID do elemento do bloco que está sendo renderizado. Se o bloco estiver sendo configurado como uma Análise, essa propriedade não será preenchida. |
queryId |
O ID da consulta do bloco que está sendo renderizado se estiver associado a uma visualização. Se o Bloco estiver sendo configurado como um recurso "Explorar", essa propriedade não será preenchida.queryId é o ID da consulta criada quando a visualização é integrada à Análise do Looker. Ele não contém filtros ou filtros cruzados a serem aplicados ao dashboard. Para refletir os dados mostrados em QueryResponse , é necessário aplicar filtros e filtros cruzados e gerar uma nova consulta. Como resultado, pode haver propriedades mais úteis do que queryId . Consulte filteredQuery para um objeto de consulta com filtros aplicados. |
querySlug |
A consulta slug do bloco que está sendo renderizado se estiver associado a uma visualização. Se o bloco estiver sendo configurado como uma Análise, essa propriedade não será preenchida.O querySlug é um slug da consulta criado quando a visualização é integrada à Análise do Looker. Ele não contém filtros ou filtros cruzados aplicados ao dashboard. Para refletir os dados mostrados em QueryResponse , é necessário aplicar filtros e filtros cruzados e gerar uma nova consulta. Como resultado, pode haver propriedades mais úteis do que querySlug . Consulte filteredQuery para um objeto de consulta com filtros aplicados. |
dashboardFilters |
Os filtros que estão sendo aplicados ao painel. Se o Bloco estiver sendo configurado como um recurso "Explorar", essa propriedade não será preenchida. |
dashboardRunState |
Indica se o painel está em execução. Se o bloco estiver sendo configurado como uma Análise, o estado será UNKNOWN .Por motivos de desempenho do painel, o estado de execução pode nunca ser mostrado como "Em execução". Isso geralmente acontece quando não há outros blocos associados a uma consulta, incluindo aquele a que a extensão está associada. Se a extensão precisar ter certeza de que um painel foi executado, detectar diferenças no lastRunStartTime é a maneira confiável. |
isDashboardEditing |
Quando verdadeiro, o dashboard está sendo editado. Se o bloco estiver sendo configurado como uma Análise, essa propriedade não será preenchida. |
isDashboardCrossFilteringEnabled |
Quando verdadeiro, o cruzamento de filtros é ativado no painel. Se o bloco estiver sendo configurado como uma Análise, essa propriedade não será preenchida. |
filteredQuery |
Um objeto de consulta que corresponde ao ID da consulta associado ao elemento do dashboard subjacente que aplica filtros de painel e alterações de fuso horário feitas no nível do painel. |
lastRunSourceElementId |
O ID do elemento de extensão do bloco que acionou a última execução do painel. O ID será indefinido se a execução do painel tiver sido acionada pelo botão Executar ou pela autorefresh do painel, ou se a execução tiver sido acionada usando o SDK incorporado. Se o bloco estiver sendo configurado como uma Análise, essa propriedade não será preenchida.O lastRunSourceElementId pode ser igual ao ID do elemento da instância de extensão atual. Por exemplo, se a extensão acionar uma execução de painel, ela será notificada quando a execução do painel começar e terminar. |
lastRunStartTime |
Indica o horário de início da última execução do painel. Se o bloco estiver sendo configurado como uma Análise, essa propriedade não será preenchida.Os horários de início e término informados não devem ser usados para capturar métricas de desempenho. |
lastRunEndTime |
Indica o horário de término da última execução do painel. Se o bloco estiver sendo configurado como um recurso "Explorar", essa propriedade não será preenchida. Se o bloco estiver em execução, essa propriedade não será preenchida.Os horários de início e término informados não devem ser usados para capturar métricas de performance. |
lastRunSuccess |
Indica se a última execução do painel foi bem-sucedida ou não. Se o Bloco estiver sendo configurado como um recurso "Explorar", essa propriedade não será preenchida. Se o bloco estiver em execução, essa propriedade não será preenchida. |
Funções e propriedades do SDK de visualização
As funções e propriedades do SDK de visualização disponíveis são mostradas na tabela a seguir:
Função ou propriedade | Descrição |
---|---|
visualizationData (propriedade) |
Visualização (combinação de dados visConfig e queryResponse ). |
visConfig (propriedade) |
Dados de configuração da visualização:
|
queryResponse (propriedade) |
Dados de resposta da consulta |
configureVisualization |
Define a configuração padrão para uma visualização de extensão. A configuração será renderizada no editor de visualização "Explorar". Ele só precisa ser chamado uma vez. |
setVisConfig |
Atualiza a configuração da visualização. |
updateRowLimit |
Atualiza o limite de linhas da consulta. |
Dados do SDK de visualização
O SDK de visualização consiste no seguinte:
- Dados de configuração da visualização
- Dados de resposta de consulta
Dados de configuração da visualização
Propriedade | Descrição |
---|---|
queryFieldMeasures |
Medir informações |
queryFieldDimensions |
Informações de dimensão |
queryFieldTableCalculations |
Informações de cálculo da tabela |
queryFieldPivots |
Informações dinâmicas |
visConfig |
Dados de configuração visual. Ela deve ser mesclada com a configuração padrão e aplicada à visualização renderizada pela extensão. |
export interface VisualizationConfig {
queryFieldMeasures: Measure[]
queryFieldDimensions: Dimension[]
queryFieldTableCalculations: TableCalculation[]
queryFieldPivots: PivotConfig[]
visConfig: RawVisConfig
}
Consultar dados de resposta
Propriedade | Descrição |
---|---|
data |
Matriz de dados de linha |
fieldMeasures |
Informações de medição de campo. |
fieldDimensions |
Informações de dimensão do campo. |
fieldTableCalculations |
Informações sobre os cálculos da tabela de campos. |
fieldPivots |
Informações de rotação de campo. |
fieldMeasureLike |
Uma matriz concatenada de informações de medidas de campo e cálculos de tabela que se comportam como medidas. |
fieldDimensionLike |
Uma matriz concatenada de informações de dimensão de campo e cálculos de tabela que se comportam como dimensões. |