Examples

Airtable Service

Airtable Cloud Service

Airtable is a cloud based storage and collaboration service that features a neat UI to serve users with an interactive way to modify their databases. Airtable Service will work for a specific format of the database, as shown below.

Setting up Airtable

Please go to the website below and create an account. https://airtable.com/ (Links to an external site.)

Airtable lets you create a 'base', which holds all of your 'tables'. 'Tables' are like spreadsheets that you can update from anywhere, and they can hold all sorts of values, like numbers, strings, and dates!

Inside a table, there are 'fields'. Each 'field' has a datatype assigned to it, so numbers can only go in number fields and so on...

Creating an Account

When you create an account at Airtable, you are granted a certain amount of "space" and the ability to create tables through their webbased visual interface. You are also given an access token unique to you that you can use to create external access (read and write) from python scripts to your Airtable data.

To get started: go to Airtable and create an account.

https://airtable.com/signup

Creating a Base

Then create your first "base" (short for "database") which by default will have a blank table.

Suggestion:

  • choose "Start from Scratch"
  • name it something relevant, like "EN1Robotics"

baseCreation

Setting Up Your Table

After creating the base, you should see your empty table. table1

A) Name your table anything. This name will later be used to access your database with Airtable Service. In this picture, it has been named, "finalProject".

table2

B) Rename the "Notes" column to be "Value". Fields under "Name" are keys to your information, where the information you wish to find will be located under the "Value" column. This is very important as Airtable Service looks for "Name" and "Value" to create Key/Value pairs of information.

table3

C) Where you can change your column name to "Value", change the field type of the column to be "Single line text".

table4

D) Delete columns that are not "Name" and "Value", such as "Attachments" and "Status".

table5

E) You should end with a workspace that looks like the following, with only "Name" and "Value" columns. (Note: the background color may differ)

table6

Using your Table

In your table, each "Tag", one single piece of Key&Value information, is represented by a row of "Name" and "Value" fields. The "Name" is the Tag's identifer, and the "Value" is the information associated with the Tag. In Airtable, all "Value" entries will be in strings, but Airtable Service will implicitly convert your "Value" fields to data types that you give them.

Getting your API Key

Airtable uses token-based authentication. You need to, from your Airtable account, set up an API Key that will be used by your code for gaining access to your data.

apikey1

From your account page (https://airtable.com/account (Links to an external site.)) you should generate a key:

apikey2

This API Key is your "password" for accessing your data. It looks like this:

apikey3

Note: The key in the image is no longer in use.

Getting your Base ID

The base ID is needed in order for external applications to access the content in the base you created.

A) Go to https://airtable.com/api B) Select the base you created

baseid1

C) Save your Base ID somewhere you can remember! baseid1

Where do these go?

Now that you have your (1) API Key, (2) Base ID, and (3) Table Name (what you named your table, e.g. "finalproject"), you will need to supply this to the Airtable Service to interact with your table with Javascript. See other documentation for detail. Have fun!