--- updatedAt: 2026-10-06T12:55:13.000Z agentTools: projectIndex: https://docs.fulcrumapp.com/llms.txt --- # Append PDF attachments to a report Render PDF files attached to a Fulcrum record as additional pages at the end of a generated report. Uses the Fulcrum Attachments API and PDF.js to decode each PDF and render its pages as canvas elements, which Puppeteer captures as part of the final PDF output. # Append PDF attachments to a report ## Overview Some workflows require that uploaded PDF files (inspection certs, third-party reports, permits, etc.) be merged into the generated Fulcrum PDF report for that record. This example shows how to: 1. Fetch all attachment metadata for the current record using the Fulcrum [Attachments API](https://developer.fulcrumapp.com/reference/attachments). 2. Download each `.pdf` attachment and encode it as a Base64 string using `GETBLOB` and `BUFFER2BASE64`. 3. Decode each PDF in the browser using **PDF.js** and render every page to a `` element. 4. Append each canvas to the document body — Puppeteer includes them in the final PDF. > **Important:** Because this process is async, you must also use the [Puppeteer stall technique](./puppeteer-stall-for-async-rendering.md) to prevent the renderer from capturing the page before all PDF pages are drawn. ## Dependencies Add this ` ``` ## Code Add the Puppeteer idle-blocker before `main()`, then include the PDF attachment section inside your `main()` function: ```html
<%- /* RENDER(...) or other EJS output */ %>
``` ## How it works | Step | Where it runs | What it does | | ----------------------------------- | ------------- | --------------------------------------------------------------------------------------------------------------------- | | `API('/attachments?...')` | Server (EJS) | Fetches attachment metadata for the record (used instead of `QUERY()` because the Query API has no attachments table) | | `GETBLOB(url)` | Server (EJS) | Downloads the raw binary content of each PDF | | `BUFFER2BASE64(blob)` | Server (EJS) | Encodes the binary as a Base64 string embedded in the HTML | | `base64ToUint8Array()` | Browser (JS) | Decodes the Base64 string back to binary | | `pdfjsLib.getDocument()` | Browser (JS) | Parses the binary PDF | | `page.render()` | Browser (JS) | Draws each page to a `` element | | `document.body.appendChild(canvas)` | Browser (JS) | Appends each page to the document for Puppeteer to capture | | `window.__idleBlocker.abort()` | Browser (JS) | Signals Puppeteer that rendering is complete | ## Notes * `API()` and `GETBLOB()` are EJS-only server-side functions — they cannot be called from client-side `