Do you ever want to keep track of Pull Requests (PRs) made in your repo in a spreadsheet format? In this tutorial, I'll show you how to set up a workflow to achieve this using Buildable.
With this workflow, whenever a new PR is created in your Github repo, Buildable listens to that event and instantly takes action to add it as a new record in your Airtable database.
Prerequisites
Before we jump in, let’s take a look at some prerequisites you'll need for this tutorial:
- A Buildable account (Create your free account here)
- A Github Repo
- An Airtable base
Now, let's get started!
Create a connection
Start by adding a Github Repo connection in your Buildable IDE. Navigate to Connections and then click "New".
From there, select "Github Repos" as your connection source.
Complete the account connection prompt by filling the details:
Always give your connection an appropriate name e.g "Portfolio-Connection"
Not sure how to get your Github Personal Access Token? See docs
Test your connection and once successful, connect.
Subscribe to events
Next, select the Github repo events you want Buildable to subscribe to. Subscribing to these events allow Buildable to detect when these events occur and carry out the required action.
For this tutorial, we’d want to subscribe to the Pull Request event.
Build a workflow
Now that we’ve connected our event source, we need to build out this workflow.
Go to Workflows and select ”New.”
You'll be prompted to give your workflow a suitable name and description.
Next, attach the pull request event for Buildable to listen to. This is what will trigger our workflow.
To do this, select your Github repo, the connection and then the event. In this case, github-repos > portfolio-connection > pull_request.
Add action
The action is what happens when Buildable detects a pull request in our repo. We want that action to send a record to our Airtable database.
From our IDE, click the "Add action" button.
From the list, select Airtable > Create Records
Connect Airtable
If this is the first time you're connecting Airtable to Buildable, then you'll need to fill in the required credentials to connect Airtable to Buildable.
Not sure how to find the API key and Base ID? See below
How to get your Airtable API key
How to get your Airtable Base ID
You'll notice the "Create Records" node is called createdRecords
. Since this is a pull request record, let’s rename this correctly as pullRequestRecord
.
Create Airtable base
Now, we need to create the Airtable table where we'll be inserting pull request records. Let's call this table "Pull Requests.".
Next, create the fields you need to record in the table. For the purpose of this tutorial, we'll be creating these 6 fields:
- Title
- Description
- Author
- Number
- Created
- URL
Asides the Number field, make sure the remaining fields are “Single line text” or “Long text” fields.
Modify Input Node
Back in Buildable, you'll notice this template came with pre-filled data. We would need to modify this data for our scenario.
We have our API KEY, BASE ID, and endpoint already pre-filled, so we'd leave them as they are.
But, you need to change the tableName
to the name of your table in Airtable. Remember, the table is called Pull Request
Finally, map the value of these fields from the Pull Request event to match exactly what we have in Airtable.
$body
represents the entire payload coming into your node.
- Title ->
$body.pull_request.title
- Description ->
$body.pull_request.body
- Author ->
$body.sender.login
- Number ->
$body.pull_request.number
- Date created ->
$body.pull_request.created_at
- URL ->
$body.pull_request.url
For ease, copy and paste this code into your IDE.
const nodeInput = ({ $body, $headers, $env, $data }) => {
return {
BUILDABLE_AIRTABLE_API_KEY: $env.BUILDABLE_AIRTABLE_API_KEY, // Required
BUILDABLE_AIRTABLE_BASE_ID: $env.BUILDABLE_AIRTABLE_BASE_ID, // Required
endpoint: "https://api.airtable.com/v0", // Required
tableName: "Pull Requests", // Required
// Required - Array of objects to insert
records: [
{
fields: {
Title: $body.pull_request.title,
Description: $body.pull_request.body,
Author: $body.sender.login,
Number: $body.pull_request.number,
Created: $body.pull_request.created_at,
URL: $body.pull_request.url,
},
},
],
};
};
Save and run your connection!
Explore this workflow
Congrats! You've just completed this workflow. Go ahead and trigger a Pull request in your Github repo. You would see this data populated in Airtable 🎉
If you wish to extend the logic of your workflows, add in custom JavaScript functions from Buildable's action library.
Have questions? Drop them in the comments below. Join the Buildable Discord community, or follow on Twitter to learn more about updates.
Top comments (0)