---
pkg: "@nocobase/plugin-action-template-print"
---


pkg: "@nocobase/plugin-action-template-print"
---

# Impressão de Templates



## Introdução

O plugin de Impressão de Templates permite que você crie templates no Word, Excel e PowerPoint (com suporte para os formatos `.docx`, `.xlsx`, `.pptx`). Nele, você pode definir placeholders e estruturas lógicas para gerar dinamicamente arquivos em formatos pré-definidos, como `.docx`, `.xlsx`, `.pptx` e PDF. É amplamente utilizado para produzir diversos documentos comerciais, como orçamentos, faturas, contratos, etc.

### Principais Recursos

- **Suporte a Múltiplos Formatos**: Compatível com templates de Word, Excel e PowerPoint para atender a diversas necessidades de geração de documentos.
- **Preenchimento Dinâmico de Dados**: Preenche e gera automaticamente o conteúdo do documento através de placeholders e estruturas lógicas.
- **Gerenciamento Flexível de Templates**: Permite adicionar, editar, excluir e categorizar templates para facilitar a manutenção e o reuso.
- **Sintaxe Rica para Templates**: Suporta substituição básica, acesso a arrays, loops e declarações condicionais para lidar com lógicas de documentos complexas.
- **Suporte a Formatadores**: Oferece saída condicional, formatação de datas, formatação de números, etc., para melhorar a legibilidade e o profissionalismo do documento.
- **Saída Eficiente**: Suporta a geração direta de arquivos PDF para facilitar o compartilhamento e a impressão.

## Instalação

### Instalar o Plugin

Consulte [Instalando e Atualizando Plugins Comerciais](https://www.nocobase.com/pt/blog/nocobase-commercial-license-activation-guide)

### Instalar o LibreOffice (Opcional)

Para gerar PDFs, é necessário instalar o LibreOffice. [Você pode baixá-lo no site oficial](https://www.libreoffice.org/download/download-libreoffice). Para a versão Docker, você pode criar um script diretamente no diretório `./storage/scripts`.

```bash
mkdir ./storage/scripts
cd ./storage/scripts
vim install-libreoffice.sh
```

O conteúdo de `install-libreoffice.sh` é o seguinte:

```sh
#!/bin/bash

# Define variables
INSTALL_DIR="/opt/libreoffice24.8"
DOWNLOAD_URL="https://downloadarchive.documentfoundation.org/libreoffice/old/24.8.5.2/deb/x86_64/LibreOffice_24.8.5.2_Linux_x86-64_deb.tar.gz"

# Check if LibreOffice is already installed
if [ -d "$INSTALL_DIR" ]; then
    echo "LibreOffice is already installed, skipping installation."
    exit 0
fi

# Update APT sources
tee /etc/apt/sources.list > /dev/null <<EOF
deb http://mirrors.aliyun.com/debian/ bookworm main contrib non-free
deb-src http://mirrors.aliyun.com/debian/ bookworm main contrib non-free
deb http://mirrors.aliyun.com/debian-security/ bookworm-security main contrib non-free
deb-src http://mirrors.aliyun.com/debian-security/ bookworm-security main contrib non-free
deb http://mirrors.aliyun.com/debian/ bookworm-updates main contrib non-free
deb-src http://mirrors.aliyun.com/debian/ bookworm-updates main contrib non-free
deb http://mirrors.aliyun.com/debian/ bookworm-backports main contrib non-free
deb-src http://mirrors.aliyun.com/debian/ bookworm-backports main contrib non-free
EOF

# Update APT and install dependencies
apt-get update

apt-get install -y \
    libfreetype6 \
    fontconfig \
    libgssapi-krb5-2 \
    libxml2 \
    libnss3 \
    libdbus-1-3 \
    libcairo2 \
    libxslt1.1 \
    libglib2.0-0 \
    libcups2 \
    libx11-xcb1 \
    fonts-liberation \
    fonts-noto-cjk \
    wget

rm -rf /var/lib/apt/lists/*

cd /app/nocobase/storage/scripts

# Download and install LibreOffice if not already present
if [ ! -d "./libreoffice" ]; then
    rm -rf libreoffice.tar.gz
    wget --no-check-certificate -O libreoffice.tar.gz $DOWNLOAD_URL
    if [ $? -ne 0 ]; then
        echo "Failed to download LibreOffice."
        exit 1
    fi
    rm -rf libreoffice && mkdir libreoffice
    tar -zxvf libreoffice.tar.gz -C ./libreoffice --strip-components=1
    if [ $? -ne 0 ]; then
        echo "Failed to extract LibreOffice."
        exit 1
    fi
fi

# Install LibreOffice
dpkg -i libreoffice/DEBS/*.deb

ln -s /opt/libreoffice24.8/program/soffice.bin /usr/bin/libreoffice
libreoffice --version

if [ $? -ne 0 ]; then
    echo "Failed to install LibreOffice."
    exit 1
fi

echo "LibreOffice installation completed successfully."
```

Reinicie o container `app`:

```bash
docker compose restart app
# Ver logs
docker compose logs app
```

Verifique se a instalação foi bem-sucedida:

```bash
$ docker compose exec app bash -c "libreoffice --version"

LibreOffice 24.8.4.2 bb3cfa12c7b1bf994ecc5649a80400d06cd71002
```