Adicionar um código de barras à saída do PDF
Um código de barras é um padrão de dados que as máquinas podem ler. Os clientes podem digitalizar códigos de barras com um scanner de código de barras ou a câmera do smartphone. Informações de codificação, como detalhes do produto, números de inventário ou URLs de site, podem ser úteis. A adição de códigos de barras ajuda a capturar os dados facilmente, melhora a experiência do cliente e facilita um melhor gerenciamento e segurança dos dados.
É possível criar um estilo para o código de barras. e use-o para inserir um código de barras em um layout de página. Aplique o estilo a um exemplo de código de barras no layout de página desejado.
Este tutorial ajuda você a adicionar códigos de barras na saída do PDF.
Etapas para gerar um código de barras
Para gerar um código de barras, execute as seguintes etapas:
Atualizar o CSS do modelo para renderizar um valor de código de barras
Modifique o arquivo layout.css
para renderizar um código de barras durante a geração do PDF. Vários tipos de código de barras, como "qrcode" e "pdf417", são compatíveis. Para obter mais detalhes, consulte Tipos de código de barras.
...
.barcode {
-ro-replacedelement: barcode;
-ro-barcode-type: code128;
-ro-barcode-size: 100%;
-ro-barcode-content: content();
object-fit: contain;
margin-top: 2mm;
}
...
Usar o estilo CSS para gerar o código de barras
Você pode gerar o código de barras de maneiras diferentes. Alguns exemplos são os seguintes:
Exemplo 1
Adicione um espaço reservado para código de barras no cabeçalho do modelo e aplique o estilo:
-
Editar Modelos > Layouts de Página
-
Selecione um layout de página. Por exemplo, é possível selecionar o layout de página BackCover, que contém o cabeçalho ou o rodapé.
-
Adicione o trecho a seguir ao local em que deseja inserir o código de barras.
<span class="barcode">Sample barcode</span></p>
.note note NOTE Use o mesmo nome de classe definido em layout.css
. -
Substitua
<Sample barcode>
pelo valor que você deseja que o scanner de código de barras leia.
É possível visualizar o código de barras ao gerar o PDF de saída usando o modelo, que inclui o layout da página. Depois de executar as etapas anteriores, é possível gerar a saída de PDF com um código de barras.
A captura de tela a seguir exibe um exemplo de código de barras em uma saída de PDF.
Exemplo 2
Modifique o arquivo Common.plt
no modelo Básico para adicionar um código de barras após o título do projeto.
Para criar um código de barras para um número ISBN, adicione um número ISBN. Em seguida, use o número ISBN para gerar o código de barras.
...
<div data-region="header">
<p class="chapter-header"><span data-field="project-title" data-format="default">Project Title</span> </p>
<p><span class="barcode">978-1-56619-909-4</span></p>
</div>
}
...
Exemplo 3
Para criar um código de barras usando os metadados do mapa:
Use todos os metadados presentes no elemento <topicmeta>
de um mapa DITA para exibir como código de barras. Certifique-se de usar o XPath correto. Por exemplo, você pode adicionar um <resourceid>
no <topicmeta>
de um mapa DITA.
No exemplo a seguir, a ID do recurso serve como a entrada principal para gerar o código de barras.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "technicalContent/dtd/map.dtd">
<map id="GUID-3c330691-4dac-4020-904a-d2d6246aeeb1-en">
<title>Barcode Sample</title>
<topicmeta>
<resourceid id="7a5bda1c-b1db-4fd8-8763-a731e2e8abba">
</resourceid>
</topicmeta>
<topicref href="GUID-139f6c64-bea3-4f17-8b22-ee131557e249-en.dita" type="topic">
</topicref>
</map>
Você pode usar a ID do recurso em um layout de página da seguinte maneira:
<div data-region="header">
<p class="chapter-header"><span data-field="project-title" data-format="default">Project Title</span> </p>
<p><span class="barcode" data-field="metadata" data-format="default" data-subtype="//resourceid/@id">Resource ID (barcode)</span></p>
</div>
}
Tipos de código de barras barcode-types
Alguns dos códigos de barras usados com frequência são os seguintes: