@trg-admin/n8n-nodes-office-tools

An n8n community node for the Office Tools REST API — empowering automated document generation, AI-powered document creation, template rendering, revisions & tracked changes, full-text search, and asynchronous PDF export jobs.

📑 Table of Contents

• Features
• Installation
• Credentials & Setup
• Resources & Operations
  • Document
  • Template
  • Job
• Workflow Examples
• Development & Building
• Publishing
• License

✨ Features

• Document Processing & Conversion:
  • Convert HTML into clean DOCX documents.
  • Upload existing binary documents (DOCX, etc.) with metadata.
  • Download documents directly into n8n binary streams.
  • Replace document body content from raw HTML while preserving structure.
• AI-Powered Document Generation:
  • Generate structured Word documents from JSON data payloads and plain-English prompts.
• Template Rendering:
  • Dynamic template dropdown loader (loadOptions).
  • Extract template variable schemas and sample payloads.
  • Live render preview across formats (PDF, DOCX, XLSX, PPTX, ODT, ODS, ODP).
  • Synchronous and asynchronous document rendering with custom actor & metadata tagging.
• Tracked Changes & Revisions:
  • Inspect revision histories and tracked changes.
  • Programmatically accept or reject revisions.
• Text & Structure Manipulation:
  • Extract text with character offset and length limits.
  • Full-text search inside document bodies.
  • Batch apply text edit actions (insert, replace, delete).
• Async Job & Artifact Handling:
  • Queue PDF export jobs and poll job status.
  • Download finished artifacts (PDF) directly into workflow binaries.

📦 Installation

In n8n Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your n8n instance.
2. Select Install a community node.
3. Enter @trg-admin/n8n-nodes-office-tools.
4. Accept the risk warning and click Install.

Manual / Docker Installation

Install the package inside your custom n8n Docker image or local node module directory:

npm install @trg-admin/n8n-nodes-office-tools

🔐 Credentials & Setup

1. In n8n, navigate to Credentials > New Credential.
2. Search for and select Office Tools API (officeToolsApi).
3. Fill in the required fields:
   • API Base URL: The base URL of your Office Tools server (e.g. http://localhost:18081 or https://office-tools.internal.yourdomain.com).
   • API Token: Bearer authentication token used to authorize requests.
   • Ignore SSL Issues: Toggle on if using self-signed certificates or internal staging environments.
4. Save and test the connection.

🚀 Resources & Operations

1. Document

Manage documents, convert formats, inspect text, and apply tracked changes.

Example: Apply Actions JSON

[
  {
    "type": "replace",
    "search": "{{CUSTOMER_NAME}}",
    "value": "Acme Corp",
    "position": "after"
  },
  {
    "type": "insert",
    "search": "Signature:",
    "value": " Signed electronically on 2026-09-15",
    "position": "after"
  }
]

2. Template

Work with predefined templates, extract variables, preview outputs, and render final documents.

3. Job

Track and retrieve asynchronous export/rendering jobs.

💡 Workflow Examples

Example 1: Generate a Document from HTML & Export to PDF

1. Webhook / Trigger: Receive customer contract details.
2. Office Tools (Document > Create From HTML): Convert formatted HTML template with customer variables into a DOCX document.
3. Office Tools (Document > Export to PDF): Trigger PDF generation job.
4. Office Tools (Job > Download Artifact): Fetch generated PDF artifact.
5. Email / Slack Node: Send final PDF to customer.

Example 2: Populate a Template & Send Preview

1. Office Tools (Template > Preview): Select template from dynamic dropdown and supply data JSON payload (outputFormat: pdf).
2. Google Drive / WorkDrive / S3 Node: Upload binary output directly.

🛠️ Development & Building

# Navigate to package directory
cd office-tools

# Typecheck TypeScript definitions
npm run typecheck

# Build and package assets
npm run build

📦 Publishing

To publish this package to the npm registry:

cd office-tools && npm publish --access public

📄 License

MIT