attachElementoDesde: 0.14.0
Un archivo que se adjuntará al PDF de salida.
Esto se puede usar para distribuir dentro del PDF archivos adicionales asociados a él. Los lectores de PDF mostrarán los archivos en una lista de archivos.
Algunos estándares internacionales usan este mecanismo para adjuntar datos legibles por máquinas (por ejemplo, ZUGFeRD/Factur-X para facturas) que reflejan el contenido visual del PDF.
Ejemplo
#pdf.attach(
"experiment.csv",
relationship: "supplement",
mime-type: "text/csv",
description: "Raw Oxygen readings from the Arctic experiment",
)Notas
- Este elemento se ignora al exportar a un formato distinto de PDF.
- Actualmente no se admiten los archivos adjuntos en PDF/A-2, aunque el archivo adjunto cumpla con PDF/A-1 o PDF/A-2.
Parámetros
path
La ruta del archivo que se adjunta.
Siempre se debe especificar, pero solo se lee de ella si no se proporcionan datos en el siguiente argumento.
data
Datos sin procesar del archivo, opcionales.
Si se omite, los datos se leen de la ruta especificada.
relationshipPor defecto: none
La relación del archivo adjunto con el documento.
Se ignora si la exportación no apunta a PDF/A-3.
| Variante | Detalles |
|---|---|
"source" | El documento PDF se creó a partir del archivo fuente. |
"data" | El archivo se usó para derivar una presentación visual en el PDF. |
"alternative" | Una representación alternativa del documento. |
"supplement" | Recursos adicionales para el documento. |
mime-typePor defecto: none
El tipo MIME del archivo adjunto.
descriptionPor defecto: none
Una descripción del archivo adjunto.