Incorporação de conteúdo externo

O Document360 suporta incorporar conteúdo de terceiros diretamente nos seus artigos — incluindo diagramas, vídeos e formulários interativos — sem sair do portal da base de conhecimento. A incorporação é feita usando código iframe HTML colado na visualização de código no editor Advanced WYSIWYG, ou diretamente no editor Markdown.

Três tipos de embedding são abordados neste artigo:

Quando você usaria esses

• Incorpore um fluxograma Draw.io ou diagrama de arquitetura junto com um procedimento técnico para que os leitores possam ver o contexto completo do sistema sem precisar trocar de ferramenta
• Incorpore um vídeo de treinamento do Microsoft Stream em um artigo de integração para que os usuários internos possam assisti-lo sem sair da base de conhecimento
• Incorpore um Google Form ao final de um artigo para coletar feedback dos leitores, avaliações de satisfação ou pedidos de suporte online
• Use diagramas exportados como imagens quando precisar de um visual leve e sempre visível, que não dependa da disponibilidade de serviços externos

Embedder Draw.io diagrama

Diagrams.net (comumente chamado de Draw.io) é uma ferramenta de código aberto baseada na web para criar fluxogramas, diagramas UML, relacionamentos de entidades, diagramas de rede, maquetes e muito mais.

Incorporar como uma tag de imagem

Use essa abordagem no editor Markdown ou via Code View no editor Advanced WYSIWYG.

1. Em Diagrams.net, clique > Arquivo Incorporar e escolha Imagem.
2. Clique em Incorporar.
3. Clique em Copiar para copiar a tag de imagem gerada.
4. No editor Markdown, cole o código copiado diretamente no artigo. No editor avançado WYSIWYG, clique no ícone de visualização de códigos e cole o código no local desejado.

Você pode ajustar os valores de altura e largura na tag conforme necessário.

Exportar como imagem e enviar

Use essa abordagem para o editor Advanced WYSIWYG ou quando quiser armazenar o diagrama no Document360 Drive.

1. Em Diagrams.net, clique em Arquivo > Exportar como > PNG.
2. Clique em Exportar, nomeie o arquivo e salve no local que preferir.
3. Clique em Baixar.
4. No editor Document360, clique em Inserir imagem e selecione A partir de Upload/URL.
5. Selecione a imagem baixada e clique em Inserir.

Incorpore vídeos do Microsoft Stream

Você pode incorporar tanto o Microsoft SharePoint Stream quanto os vídeos mais recentes do Microsoft Stream nos artigos do Document360. O embedding é suportado tanto nos editores Markdown quanto no Advanced WYSIWYG.

Obtendo o código de embeds do Stream

1. Navegue até a plataforma Stream e selecione o vídeo que deseja incorporar.
2. Clique em Compartilhar no canto superior direito da página do vídeo, depois selecione Incorporar código.
3. No painel de incorporação, configure as seguintes opções, se necessário:
   • Comece a partir — defina um carimbo de tempo específico (por exemplo, 01:23)
   • Tamanho do jogador — escolha uma resolução (por exemplo, 640×360, 1280×720)
4. Clique em Copiar código de incorporação.

Incorporação no editor avançado WYSIWYG

1. Navegue até o artigo desejado.
2. Clique no ícone de visualização de códigos .
3. Cole o código de incorporação no local desejado.
4. Pressione Ctrl + S para salvar.

Embedding usando o comando slash

1. Digite /Video e pressione Enter. O painel Inserir vídeo aparece.
2. Na aba Embed code , cole o código de embed copiado.
3. Clique em Salvar.

Incorpore Formulários do Google

Você pode incorporar o Google Forms diretamente em artigos de base de conhecimento usando um código iframe em HTML. Após a publicação, os leitores podem interagir com o formulário — preenchendo pesquisas, enviando feedback ou inserindo dados — sem sair do artigo.

Obtendo o código de incorporação no Google Forms

1. Vá ao Google Forms e faça login com sua conta Google.
2. Abra um formulário existente ou crie um novo.
3. Clique no botão Enviar no topo do formulário.
4. No painel Enviar formulário , selecione a aba < > (Incorporar).
5. Clique em Copiar para copiar o código de embeds do iframe.

Incorporação no editor avançado WYSIWYG

1. Navegue até o artigo desejado.
2. Clique no ícone de visualização de códigos .
3. Cole o código iframe copiado no local desejado.
4. Pressione Ctrl + S para salvar. O formulário aparecerá no artigo.

Incorporação no editor Markdown

1. Navegue até o artigo desejado no editor Markdown.
2. Cole o link iframe src diretamente no editor no local desejado.

Melhores práticas

• Sempre defina Draw.io diagramas como públicos antes de incorporar — diagramas privados parecerão quebrados para os leitores do site da base de conhecimento
• Use a abordagem de exportação como imagem para diagramas de Draw.io quando quiser controle total sobre o visual sem depender de um link de serviço externo para permanecer ativo
• Verifique as permissões do vídeo do Stream antes de publicar — leitores sem acesso ao vídeo do Stream verão um erro em vez do vídeo
• Teste os Google Forms incorporados após a publicação para confirmar que eles renderizam e enviam corretamente para os leitores
• Mantenha o conteúdo incorporado focado — um diagrama ou formulário por seção. Empilhar múltiplos embeds em um único artigo pode afetar o desempenho do carregamento da página
• Sempre faça uma prévia do artigo após a incorporação para confirmar se o conteúdo está corretamente renderizado antes de publicar