Use Airtable

Introduction

It’s quite easy to start using the Plumsail Documents extension for Airtable:

  1. Set up a document generation process.

  2. Connect the Plumsail extension to your Airtable workspace.

  3. Once everything is set up, select the base records you want to generate documents for and use the Plumsail extension to generate documents automatically.

Airtable extension intro

That’s it! We’ll review each of the steps in more detail further in the article.

Set up a document generation process

Check the article on how to create a new process.

For demonstration purposes, we created an Airtable database Client orders based on the Product catalog template.

Additionally, we established a Documents process to create invoices from an Airtable documents template.

To use the Airtable template start with creating a process from template:

Airtable create process from template

Then search for the Airtable template:

Airtable create process from template

Name the process and proceed to the settings:

Airtable create process from template

Further information on changing the default template can be found later in the article.

Working with Documents extension

Let’s explore how to use the Airtable extension.

How to add a button and choose a process to run

Note

Currently, the extension doesn’t support Plumsail Accounts with two-factor authentication and Plumsail Teams. It is coming with the next releases.

First, connect the Plumsail Documents extension.

  1. Open your Airtable database and click Add an extension button.

Airtable add an extension button
  1. Type Plumsail in the search field and click Add button when the extension is found.

Airtable add an extension

3. Then Sign up for Plumsail Account if you don’t have an account already and click Connect. You’ll need to enter your Plumsail account email and the password to complete the connection.

Airtable add an extension
  1. After connecting to the Plumsail account you’ll see a dialog with details to add a document generation button. Let’s check the settings:

Airtable add an extension
  • Process to start. Dropdown menu with all available processes from the account. Select the process you want to use to generate the document.

  • Button title. The button title is pre-filled with the name of the selected process, but you can change it.

  • Multiple records. When you select multiple records, you can either generate a document for each record or generate one aggregated document with all records.

  • Result document. This is how you receive the result document. You have two options: download the document and/or attach it to the record. Additionally, select a field to attach the document.

  • Field to store attachment. Select a field from the database to store the generated document.

Note

Please check out the article on how to add an attachment field to your Airtable database.

You can add several buttons to the same database and link them to different processes. All Airtable users who have access to the database will see the added buttons.

  1. If you click Add button and close the settings, you’ll see that a button is added to the extension window.

Airtable add an extension

How to copy tokens and add them into the template

Let’s go back to our document generation process now.

We created a process using the default Airtable template. You can add some tokens to the template to correspond with your database fields.

  1. Open your Documents settings.

Documents process settings

And open the template for editing.

Documents process settings
  1. Then go to the Airtable database and click on the gear button to open the extension settings.

Airtable tokens
  1. Open the list of the tokens by clicking on the Show template tokens button.

Airtable tokens
  1. You’ll see all available tokens from the database. Copy the token you want to display in the generated document.

Airtable tokens

Let’s now take a look at how to change the default Airtable template to display some additional information from the database.

Create template

Go back to the documents template and add the tokens you want to display.

For example, we want to add pictures to the Product column cell:

Product column
  1. Go to the extension settings, select the database Client orders and click on the Show template tokens button as described above.

  2. Find the image URL token using the path: Order line items -> Image -> Value -> thumbnails -> small -> url.

Airtable copy image URL token
  1. Paste the copied token to the Product column cell.

Airtable paste image URL token
  1. Add the picture formatter to dynamically insert pictures into the DOCX template.

Airtable add picture formatter

Results

Completing the process settings we choose PDF as the output for the result file.

Airtable process PDF output

Now, we can close the extension settings and generate an invoice.

Airtable select records

The resulting document is downloaded and attached to the record.

Airtable invoice result