Como adicionar o componente HTML no relatório do Gestão à Vista

O que é o componente HTML

O componente HTML permite publicar, dentro do relatório do Stratws, conteúdo analítico produzido em outras ferramentas: material criado com apoio de inteligência artificial, relatórios gerados por script ou Power BI e páginas exportadas de outros sistemas.

O componente recebe um documento HTML e o exibe dentro do relatório com a mesma aparência e interatividade que o arquivo já possui fora do Stratws.

Adicionando o componente ao relatório

Para adicionar o componente HTML ao relatório, abra o menu de inserção de componentes do relatório no módulo Gestão à Vista e clique em "HTML".

O menu aparece logo abaixo do campo "Descreva um conteúdo ou Selecione um Componente", com as opções Tabela, Card, Gráfico, Iframe, Notícias, Conteúdo, Imagem e HTML. O HTML é a última opção da lista.

O componente é criado vazio, pronto para receber conteúdo. Ele aparece no relatório com o título "HTML 1", que também passa a ser listado no Sumário, à esquerda. Dentro do componente ficam dois botões: "Importar Artefato" e "Adicionar HTML".

Formas de inserir conteúdo no componente

Depois de criar o componente, há três formas de inserir o conteúdo nele:

• Importar um arquivo .html já pronto, direto do computador;
• Colar ou escrever o código no modo "Edição prévia" — para quem tem o HTML em mãos ou quer digitá-lo diretamente;
• Editar no modo "Visual" — como quem edita um texto, aplicando formatação sem mexer em código.

Alternar entre o modo "Código" e o modo "Visual" não faz perder o que já foi editado.

A edição acontece na janela "Editar Artefato". No topo dela ficam o botão "Importar Artefato" e a escolha de Altura ("Automática" ou "Fixa"). No centro aparece a pré-visualização do conteúdo e, no rodapé, o tamanho atual do conteúdo em relação ao limite (por exemplo, "24 KB de 5 MB"), junto dos botões "Salvar" e "Cancelar".

Quando o HTML contém scripts, a janela mostra o aviso: "Este HTML contém scripts. O modo Visual mostra só a pré-visualização; para editar, use o modo Código."

Para ver e editar o código, use os botões "Prévia" e "Edição", no canto superior direito da janela. Com "Edição" selecionado, o código HTML completo fica disponível para alteração.

Limite de tamanho do conteúdo

O conteúdo HTML tem um limite de 5 MB (megabytes, unidade de tamanho de arquivo).

Se o arquivo importado ultrapassar esse limite, o componente abre automaticamente no modo Código, com um alerta e um contador mostrando o tamanho atual e o limite — por exemplo, "8,2 MB de 5 MB". O botão "Salvar" fica desabilitado até o conteúdo ser reduzido para caber no limite.

O alerta aparece em destaque vermelho no topo da janela, com a mensagem "O conteúdo tem 8,2 MB e passa do limite de 5 MB. Reduza o tamanho para salvar." O contador no rodapé também fica em vermelho e o botão "Salvar" aparece acinzentado.

Salvando e descartando alterações

Para salvar o conteúdo, clique em "Salvar". O relatório é atualizado na hora, sem precisar recarregar a página.

Se o editor for fechado com alterações ainda não salvas, um aviso pergunta o que fazer: salvar as alterações, descartá-las ou continuar editando.

Como o conteúdo aparece no relatório

Depois de salvo, o componente é exibido com o mesmo layout e os mesmos estilos do conteúdo original, ocupando a largura do relatório e sem precisar de rolagem para os lados. Isso vale tanto no computador quanto no celular.

Elementos interativos do conteúdo — como cliques, filtros, abas e dicas que aparecem ao passar o mouse — continuam funcionando normalmente dentro do relatório.

A altura do componente pode ser automática, acompanhando o tamanho do conteúdo, ou fixa, definida em pixels (unidade de medida de tela).

No exemplo abaixo, uma análise financeira criada fora do Stratws aparece dentro do relatório com os mesmos títulos, cartões e cores do arquivo original.

Segurança do conteúdo HTML

O conteúdo do componente HTML roda de forma isolada dentro do relatório: ele não tem acesso aos dados da sessão do usuário nem à página do Stratws.

Mesmo que o conteúdo tente ler informações do navegador ou se conectar à conta do usuário, essa tentativa não alcança o Stratws — e isso vale também se alguém tentar abrir o conteúdo diretamente, fora do relatório.

Por segurança, alguns endereços externos usados pelo conteúdo podem ser bloqueados. Quando isso acontece, o editor avisa quais endereços não vão carregar.

Remover, copiar e criar novas versões do relatório

Remover um componente HTML não afeta os demais componentes do relatório, que continuam na mesma ordem.

Ao criar uma nova versão do relatório, copiar o relatório ou aplicar um template, o componente HTML mantém seu conteúdo. Editar uma versão ou cópia não altera as demais.