diff --git a/docs/nodes/credentials/Baserow/README.md b/docs/nodes/credentials/Baserow/README.md new file mode 100644 index 000000000..fa7df6671 --- /dev/null +++ b/docs/nodes/credentials/Baserow/README.md @@ -0,0 +1,23 @@ +--- +permalink: /credentials/baserow +description: Learn to configure credentials for the Baserow node in n8n +--- + +# Baserow + +You can use these credentials to authenticate the following node: +- [Baserow](../../nodes-library/nodes/Baserow/README.md) + +## Prerequisites + +Create a [Baserow](https://baserow.io/) account on any hosted Baserow instance +or a self hosted instance. + +## Using API Key + +1. Open your Baserow dashboard. +2. Click on the user menu on the top left and select **Settings** from the dropdown list. +3. Select the **API Tokens** section and click on the **Create token +** button. +4. Enter a name and give rights to your desired group. +5. Click on the **...** menu next to the token name and copy the token. +6. Use this token for your Baserow credential in n8n. diff --git a/docs/nodes/nodes-library/nodes/Baserow/README.md b/docs/nodes/nodes-library/nodes/Baserow/README.md new file mode 100644 index 000000000..a9b14af2d --- /dev/null +++ b/docs/nodes/nodes-library/nodes/Baserow/README.md @@ -0,0 +1,93 @@ +--- +permalink: /nodes/n8n-nodes-base.baserow +description: Learn how to use the Baserow node in n8n +--- + +# Baserow + +[Baserow](https://baserow.io/) is an open source no-code database and Airtable alternative. + +::: tip 🔑 Credentials +You can find authentication information for this node [here](../../../credentials/Baserow/README.md). +::: + +## Basic operations + + + +## Example + +This workflow allows you to create, find, and delete rows in Baserow default Customer table. This example workflow uses the following nodes. + +- [Start](../../core-nodes/Start/README.md) +- [Set](../../core-nodes/Set/README.md) +- [Baserow]() + +The final workflow should look like the following image: + +![A workflow with the Baserow node](./workflow.png) + +For this workflow you need an account to any Baserow instance with the demo table `Customers`. + +### 1. Start node + +The start node exists by default when you create a new workflow. + +### 2. Set node + +We will use the Set node to set the values for the `name` and `id` fields of a new record. + +1. Click on the ***Add Value*** button and select 'String' from the dropdown list. +2. Enter `Name` in the ***Name*** field. +3. Enter a name in the ***Value*** field. +4. Click on the ***Add Value*** button and select 'String' from the dropdown list. +5. Enter `Last name` in the ***Name*** field. +6. Enter a last name in the ***Value*** field. +7. Click on the ***Add Value*** button and select 'Boolean' from the dropdown list. +8. Enter `Active` in the ***Name*** field. +9. Check the value. +10. Click on ***Execute Node*** to run the node. + +### 3. Baserow node (Create) + +This node will create a row in the `Customers` table with the content from the previous node. + +1. Enter your credentials for the Baserow node. You can find out how to create credentials [here](../../../credentials/Baserow/README.md). +2. Enter your Baserow instance URL (default value is for official version). +3. Select 'Create' from the ***Operation*** dropdown list. +4. Enter the Table ID in the ***Table ID*** field. For obtaining the Table ID, see the Database API page available from the database menu. +5. Click on ***Execute Node*** to run the node. + +### 4. Baserow list + +This node will list all the rows with the name `Bill`. If you want to list records with a different name, use that name instead. + +::: v-pre +1. Select the credentials that you entered in the previous node. +2. Click on the gears icon next to the ***Host*** field and click on ***Add Expression***. +3. Select the following in the ***Variable Selector*** section: ***Nodes > Baserow > Parameters > Host***. You can also add the following expression: `{{$node["Baserow"].parameter["host"]}}`. +4. Select the 'List' option from the ***Operation*** dropdown list. +5. Click on the gears icon next to the ***Table ID*** field and click on ***Add Expression***. +6. Select the following in the ***Variable Selector*** section: ***Nodes > Baserow > Parameters > Table***. You can also add the following expression: `{{$node["Baserow"].parameter["table"]}}`. +1. Click on ***Add Option*** and select 'Search' from the dropdown list. +7. Enter `Bill` in the ***Search*** field. +8. Click on ***Execute Node*** to run the node. +::: + +You will notice that the node only returns the record with a column containing `Bill`. + +### 4. Baserow delete + +This node will delete all the rows listed from the previous node. + +::: v-pre +1. Select the credentials that you entered in the previous node. +2. Click on the gears icon next to the ***Host*** field and click on ***Add Expression***. +3. Select the following in the ***Variable Selector*** section: ***Nodes > Baserow > Parameters > Host***. You can also add the following expression: `{{$node["Baserow"].parameter["host"]}}`. +4. Select the 'Delete' option from the ***Operation*** dropdown list. +5. Click on the gears icon next to the ***Table ID*** field and click on ***Add Expression***. +6. Select the following in the ***Variable Selector*** section: ***Nodes > Baserow > Parameters > Table***. You can also add the following expression: `{{$node["Baserow"].parameter["table"]}}`. +5. Click on the gears icon next to the ***Row ID*** field and click on ***Add Expression***. +6. Select the following in the ***Variable Selector*** section: ***Current Node > Input Data > JSON > id***. You can also add the following expression: `{{$json["id"]}}`. +7. Click on ***Execute Node*** to run the node. +::: diff --git a/docs/nodes/nodes-library/nodes/Baserow/workflow.png b/docs/nodes/nodes-library/nodes/Baserow/workflow.png new file mode 100644 index 000000000..7f1b9506e Binary files /dev/null and b/docs/nodes/nodes-library/nodes/Baserow/workflow.png differ