Modelos de documento a fundo: imagens e blocos
As duas telas que apoiam o editor de HTML: a biblioteca de imagens e estilos e os blocos que se repetem em vários documentos.
O que se repete em vários documentos fica guardado uma vez só.
A página de um documento é escrita em HTML, a linguagem das páginas da internet. A aparência (cores, fontes, margens) vem do CSS, um arquivo de regras de estilo. Criar o documento e usar o editor estão no manual MAN-CFG-06, "Modelos de documento e de termos (TCLE)".
Este manual cobre as telas de apoio, em Configuração › Comunicação & Documentos: Biblioteca de Assets e Blocos reutilizáveis.
O que você quer reaproveitar?
As duas telas e quem vê
Imagens (.png, .jpg, .jpeg, .webp, .svg) e arquivos de estilo (.css) que os modelos usam.
Pedaços de HTML (cabeçalho, rodapé, tabela, assinatura) que vários documentos incluem.
- Biblioteca de Assets e Blocos reutilizáveis são só para administrador, como o editor de HTML. Para os outros, a tela mostra Acesso restrito.
- Tudo o que se muda aqui vale para os documentos gerados depois. Documento já emitido é um PDF guardado e não muda.
Biblioteca de Assets
"Asset" é o nome técnico de um arquivo de apoio da página: uma imagem ou um CSS. Cada cartão mostra a miniatura, o nome, o tamanho e o selo de quem é o arquivo.
- Formatos
- .png, .jpg, .jpeg, .webp, .svg e .css.
- Tamanho
- Até 2 MB por arquivo. Uma foto tirada no celular costuma passar disso: reduza antes de enviar.
- Cota da clínica
- Até 50 arquivos e 25 MB no total. A linha do topo mostra o uso. Se a clínica precisar de mais, avise a equipe da Fluxo Ideal.
- Selo clínica
- Arquivo que a clínica enviou. Pode ser substituído e excluído.
- Selo global
- Arquivo que a Fluxo Ideal fornece para todas as clínicas. É somente leitura: dá para baixar, não para trocar nem excluir.
- Para subir um arquivo, clique no botão redondo do canto (Subir asset) e escolha o arquivo no computador. Ele aparece na grade na hora.
- Para trocar a imagem de um arquivo que já existe (um carimbo novo, por exemplo), use Substituir no cartão e escolha um arquivo com o mesmo nome. Com nome diferente, a Central recusa.
- Baixar guarda uma cópia no computador. Faça isso antes de substituir, para poder voltar atrás.
- Substituir não guarda a versão anterior: todo documento gerado depois sai com o arquivo novo.
- Excluir um arquivo que nenhum modelo publicado usa apaga na hora, sem pedir confirmação.
- Se algum modelo publicado usa o arquivo, a Central abre Asset em uso com a lista dos modelos. Excluir mesmo assim faz esses documentos saírem sem a imagem ou sem o estilo.
- Dê nomes simples, sem acento nem espaço (
carimbo-clinica.png). A Central troca acento e espaço por "_", e o nome que vale no modelo é o que aparece no cartão. - O logo da clínica não precisa estar aqui: ele vem do cadastro da clínica pela variável
{{ clinica_logo }}(veja o MAN-CFG-06). - Por segurança, a Fluxo Ideal limpa os arquivos .svg ao receber: tira código e links externos. O desenho continua igual.
Usar uma imagem ou um CSS no modelo
No editor de HTML (de um conjunto, de um template de sistema ou de um bloco), o botão Inserir asset coloca a referência no ponto onde está o cursor.
- Ponha o cursor onde a imagem deve entrar e clique em Inserir asset.
- Clique na miniatura do arquivo. Se ele ainda vai ser enviado, digite o nome em Ou informe o nome do arquivo.
- Clique em Inserir. Para uma imagem, entra
<img src="carimbo-clinica.png" alt="">. Para um CSS, entra<link rel="stylesheet" href="estilo.css">. A Central reconhece o tipo pelo arquivo. - Clique em Testar / Pré-visualizar para ver o documento com a imagem, e depois em Publicar.
- Ao gerar o PDF, a Fluxo Ideal procura o arquivo pelo nome: primeiro entre os da clínica, depois entre os globais. A imagem e o CSS vão para dentro do PDF.
- Se não achar o nome, o documento sai assim mesmo, sem a imagem ou sem o estilo, e sem aviso. Por isso, teste sempre antes de publicar.
- A pré-visualização do lado direito do editor mostra o código como está, sem imagens nem dados. A amostra com tudo preenchido é a de Testar / Pré-visualizar.
Blocos reutilizáveis
Um bloco é um pedaço de HTML guardado com nome próprio: o cabeçalho com o logo, o rodapé com o endereço, o quadro de assinatura da médica. Muda-se o bloco uma vez e todos os documentos que o usam mudam juntos.
- Usado em N
- Quantos documentos publicados incluem o bloco. Clique para ver quais.
- Sem uso
- Nenhum documento publicado inclui o bloco. Rascunho não conta.
- Inativo
- O bloco não aparece para ser inserido em modelos novos.
- Clique no botão redondo do canto (Novo bloco) e dê um nome, como "Cabeçalho padrão". Embaixo, a Central mostra o Arquivo do include: o nome em minúsculas, sem acento e sem espaço (
cabecalho_padrao.html). É por esse nome que os documentos chamam o bloco. - Clique em Criar e editar. Abre o mesmo editor de HTML dos conjuntos, com o quadro Variáveis da clínica (seção 5 do MAN-CFG-06).
- Escreva o HTML do bloco. Ele pode usar as variáveis da clínica e os campos do documento, como o nome da médica.
- Clique em Publicar. Bloco sem versão publicada não vale: os documentos usam sempre a versão publicada do bloco.
- Publicar um bloco muda na hora todos os documentos que o incluem, inclusive os de outras médicas. Abra o selo Usado em antes, para saber o alcance.
- Excluir um bloco sem uso apaga na hora, sem confirmação. Bloco em uso abre Bloco em uso com a lista; Excluir mesmo assim faz esses documentos falharem na hora de gerar.
- Errou ao publicar? No editor do bloco, Histórico abre as versões anteriores.
Usar um bloco no modelo
- No editor do conjunto (ou do template de sistema), ponha o cursor onde o bloco deve entrar e clique em Inserir bloco.
- Escolha o bloco na lista. Só aparecem os ativos. Também dá para digitar o nome do arquivo em Ou informe o nome do arquivo.
- Clique em Inserir. Entra uma linha como
{% include "cabecalho_padrao.html" %}: é a instrução que diz "ponha aqui o bloco". - Testar / Pré-visualizar e Publicar. Ao publicar, a Central gera uma amostra antes e não publica se ela falhar, por exemplo por um bloco que não existe.
- O bloco entra com os mesmos dados do documento: a variável que funciona no corpo funciona no bloco.
- Um bloco pode incluir outro bloco.
- Mudou o bloco e quer ver o efeito num documento? Publique o bloco primeiro: a amostra do documento usa a versão publicada dele.
Dúvidas frequentes
Subi a imagem, mas ela não aparece no documento.
Confira se o nome no modelo é igual ao do cartão na biblioteca, letra por letra, e se o modelo foi publicado depois da mudança. A pré-visualização do lado direito do editor não mostra imagens: use Testar / Pré-visualizar.
A Central diz "Limite de assets do estabelecimento atingido".
A clínica chegou a 50 arquivos ou a 25 MB. Exclua os que nenhum modelo usa ou avise a equipe da Fluxo Ideal.
Mudei o rodapé e um documento continua com o antigo.
Publique o bloco: rascunho não vale. Se o rodapé estiver escrito direto no documento, e não por bloco, mude no documento. Localizar no acervo (MAN-CFG-06) mostra onde um texto aparece.
Não vejo a Biblioteca de Assets nem os Blocos.
São só para administrador. A tela mostra Acesso restrito para os outros.
Posso apagar um arquivo "global"?
Não. Ele é da Fluxo Ideal e serve a todas as clínicas. Para usar outro, suba um da clínica com outro nome e troque a referência no modelo.