Merge branch 'master' into update/mattermost

This commit is contained in:
Tanay Pant 2020-12-21 11:46:16 +01:00
commit 2307cf2ffd
17 changed files with 207 additions and 27 deletions

View File

@ -86,6 +86,12 @@ module.exports = {
'ga': 'UA-146470481-3',
},
],
[
'sitemap',
{
hostname: 'https://docs.n8n.io'
},
]
],
themeConfig: {
repo: 'n8n-io/n8n',

View File

@ -14,6 +14,7 @@
- [Effortless video collaboration with Whereby, Mattermost, and n8n 📹](https://medium.com/n8n-io/effortless-video-collaboration-with-whereby-mattermost-and-n8n-8fc397feb9cb)
- [Giving kudos to contributors with GitHub, Slack, and n8n 👏](https://medium.com/n8n-io/effortless-video-collaboration-with-whereby-mattermost-and-n8n-8fc397feb9cb)
- [HTTP Request Node — The Swiss Army Knife](https://medium.com/n8n-io/http-request-node-the-swiss-army-knife-b14e22283383)
- [Migrating Community Metrics to Orbit using n8n 📈](https://medium.com/n8n-io/migrating-community-metrics-to-orbit-using-n8n-b293372e8daf)
- [Smart Factory Automation using IoT and Sensor Data with n8n 🏭](https://medium.com/n8n-io/smart-factory-automation-using-iot-and-sensor-data-with-n8n-27675de9943b)
- [Supercharging your conference registration process with n8n 🎫](https://medium.com/n8n-io/supercharging-your-conference-registration-process-with-n8n-2831cdff37f9)
- [Tracking Time Spent in Meetings With Google Calendar, Twilio, and n8n 🗓](https://medium.com/n8n-io/tracking-time-spent-in-meetings-with-google-calendar-twilio-and-n8n-a5d00f77da8c)

View File

@ -0,0 +1,22 @@
---
permalink: /credentials/brandfetch
description: Learn to configure credentials for the Brandfetch node in n8n
---
# Brandfetch
You can use these credentials to authenticate the following nodes with Brandfetch.
- [Brandfetch](../../nodes-library/nodes/Brandfetch/README.md)
## Prerequisites
Create a [Brandfetch](https://brandfetch.io/account) account.
## Using API Key
1. Access your [Brandfetch dashboard](https://brandfetch.io/dashboard).
2. Click on ***API*** on the left sidebar.
3. Select a plan and click on the ***Get API Key*** button.
4. Use the ***App Key*** with your Brandfetch API credentials in n8n.
![Getting Brandfetch credentials](./using-api.gif)

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

View File

@ -11,22 +11,29 @@ The IF node is used to split a workflow conditionally based on comparison operat
You can add comparison conditions using the ***Add Condition*** dropdown. Conditions can be created based on the data type, the available comparison operations vary for each data type.
- Boolean
- Equal
- Not Equal
- Number
- Smaller
- Smaller Equal
- Equal
- Not Equal
- Larger
- Larger Equal
- String
- Contains
- Equal
- Not Contains
- Not Equal
- Regex
:::details Boolean
- Equal
- Not Equal
:::
:::details Number
- Smaller
- Smaller Equal
- Equal
- Not Equal
- Larger
- Larger Equal
- Is Empty
:::
:::details String
- Contains
- Equal
- Not Contains
- Not Equal
- Regex
- Is Empty
:::
You can choose to split a workflow when any of the specified conditions are met, or only when all the specified conditions are met using the options in the ***Combine*** dropdown list.

View File

@ -17,11 +17,11 @@ The Merge node is useful to merge data of multiple streams, once data of both st
- ***Multiples:*** Merges each value of one input with each value of the other input. The output will contain (m*n) items where (m) and (n) are lengths of the inputs.
- ***Pass-through:*** Passes through the data of one input. The output will contain items of the defined input.
- ***Remove Key Matches:*** Keeps the data of input 1 if it does not find a match with the data of input 2.
- ***Wait:*** Waits till the data of both the inputs is available. It will then output a single empty item.
- ***Wait:*** Waits till the data of both the inputs is available. It will then output a single empty item.
- ***Property Input 1:*** The name of the property which decides which items of input 1 to merge. This field is displayed when 'Keep Key Matches', 'Merge By Key', or 'Remove Key Matches' is selected in the ***Mode*** dropdown list.
- ***Property Input 2:*** The name of the property which decides which items of input 2 to merge. This field is displayed when 'Keep Key Matches', 'Merge By Key', or 'Remove Key Matches' is selected in the ***Mode*** dropdown list.
- ***Property Input 2:*** The name of the property which decides which items of input 2 to merge. This field is displayed when 'Keep Key Matches', 'Merge By Key', or 'Remove Key Matches' is selected in the ***Mode*** dropdown list.
- ***Join:*** Use this to specify how many items the output should contain if inputs contain different amount of items. This field is displayed when 'Merge By Index' is selected in the ***Mode*** dropdown list. You can select from the following options.
- ***Inner Join:*** Merges as many items as both the inputs contains. For example, if input 1 contains 3 items and input 2 contains 3 items, the output will contain 3 items.
- ***Inner Join:*** Merges as many items as both the inputs contains. For example, if input 1 contains 3 items and input 2 contains 3 items, the output will contain 3 items.
- ***Left Join:*** Merges as many items as the first input contains. For example, if input 1 contains 3 items and input 2 contains 5 items, the output will contain 3 items.
- ***Outer Join:*** Merges as many items as input contains with most items. For example, if input 1 contains 3 items and input 2 contains 5 items, the output will contain 5 items.
- ***Overwrite:*** Select when to overwrite the values from Input1 with values from Input 2. This field is displayed when 'Merge By Key' is selected from the ***Mode*** dropdown list. You can select from the following options.
@ -118,4 +118,5 @@ return [
## Further Reading
- [Migrating Community Metrics to Orbit using n8n 📈](https://medium.com/n8n-io/migrating-community-metrics-to-orbit-using-n8n-b293372e8daf)
- [Supercharging your conference registration process with n8n 🎫](https://medium.com/n8n-io/supercharging-your-conference-registration-process-with-n8n-2831cdff37f9)

Binary file not shown.

After

Width:  |  Height:  |  Size: 165 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 149 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 134 KiB

View File

@ -0,0 +1,100 @@
---
permalink: /nodes/n8n-nodes-base.Brandfetch
description: Learn how to use the Brandfetch node in n8n
---
# Brandfetch
[Brandfetch](https://www.Brandfetch.com/) is a brand search engine that helps you find logos, colors, fonts, images, and more.
::: tip 🔑 Credentials
You can find authentication information for this node [here](../../../credentials/Brandfetch/README.md).
:::
## Basic Operations
- Return a company's colors
- Return a company's data
- Return a company's fonts
- Return a company's industry
- Return a company's logo & icon
## Example Usage
This workflow allows you to get the logo, icon, and information of a company and store it in Airtable. You can also find the [workflow](https://n8n.io/workflows/835) on n8n.io. This example usage workflow would use the following nodes.
- [Start](../../core-nodes/Start/README.md)
- [Brandfetch]()
- [Set](../../core-nodes/Set/README.md)
- [Airtable](../../nodes/Airtable/README.md)
The final workflow should look like the following image.
![A workflow with the Brandfetch node](./workflow.png)
### 1. Start node
The start node exists by default when you create a new workflow.
### 2. Brandfetch node (logo)
This node will fetch the URL of the logo and icon of n8n. If you want the logo and icon of a different company, enter the domain name of that company instead.
1. First of all, you'll have to enter credentials for the Brandfetch node. You can find out how to do that [here](../../../credentials/Brandfetch/README.md).
2. Enter `n8n.io` in the ***Domain*** field.
3. Click on ***Execute Node*** to run the node.
In the screenshot below, you will notice that the node retrieves the URL of n8n's logo and icon.
![Using the Brandfetch node to retrieve the URL of the logo and icon of a comapny](./Brandfetch_node.png)
### 3. Brandfetch1 node (company)
This node will fetch company data about n8n.
::: v-pre
1. Select the credentials that you entered in the previous Brandfetch node.
2. Select 'Company' from the ***Operation*** dropdown list.
3. Click on the gears icon next to the ***Domain*** field and click on ***Add Expression***.
4. Select the following in the ***Variable Selector*** section: Nodes > Brandfetch > Parameters > domain. You can also add the following expression: `{{$node["Brandfetch"].parameter["domain"]}}`.
5. Click on ***Execute Node*** to run the node.
:::
In the screenshot below, you will notice that the node returns company data about n8n.
![Using the Brandfetch node to retrieve the company data](./Brandfetch1_node.png)
### 4. Set node
We will use the Set node to ensure that only the data that we set in this node gets passed on to the next nodes in the workflow. We will set the value of `Name`, `Icon URL`, and `Logo URL`in this node.
::: v-pre
1. Click on the ***Add Value*** button and select 'String' from the dropdown list.
2. Enter `Name` in the ***Name*** field.
3. Click on the gears icon next to the ***Value*** field and click on ***Add Expression***.
4. Select the following in the ***Variable Selector*** section: Nodes > Brandfetch1 > Output Data > JSON > name. You can also add the following expression: `{{$node["Brandfetch1"].json["name"]}}`.
5. Click on the ***Add Value*** button and select 'String' from the dropdown list.
6. Enter `Icon URL` in the ***Name*** field.
7. Click on the gears icon next to the ***Value*** field and click on ***Add Expression***.
8. Select the following in the ***Variable Selector*** section: Nodes > Brandfetch > Output Data > JSON > icon > image. You can also add the following expression: `{{$node["Brandfetch"].json["icon"]["image"]}}`.
9. Click on the ***Add Value*** button and select 'String' from the dropdown list.
10. Enter `Logo URL` in the ***Name*** field.
11. Click on the gears icon next to the ***Value*** field and click on ***Add Expression***.
12. Select the following in the ***Variable Selector*** section: Nodes > Brandfetch > Output Data > JSON > logo > image. You can also add the following expression: `{{$node["Brandfetch"].json["logo"]["image"]}}`.
13. Toggle ***Keep Only Set*** to `true`. We set this option to true to ensure that only the data that we have set in this node get passed on to the next nodes in the workflow.
14. Click on ***Execute Node*** to run the node.
:::
In the screenshot below, you will notice that the node sets the value of `Name`, `Icon URL`, and `Logo URL`. This value is passed to the next node in the workflow.
![Using the Set node to set data to be inserted by the Airtable node](./Set_node.png)
### 5. Airtable node (Append)
This node will append the data that we set in the previous node to a table. Create a table like [this](https://airtable.com/shrPVVaVZuHofrDVw) in your Airtable base.
1. First of all, you'll have to enter credentials for the Airtable node. You can find out how to do that [here](../../../credentials/Airtable/README.md).
2. Select 'Append' from the ***Operation*** dropdown list.
3. Enter the Base ID in the ***Base ID*** field. For obtaining the Base ID, head over to their [API page](https://airtable.com/api) and select the correct base. Youll find the Base ID there.
4. Enter the name of your table in the ***Table*** field.
5. Click on ***Execute Node*** to run the node.
In the screenshot below, you will notice that the node appends the data that we had set in the previous node.
![Using the Airtable node to insert data into an Airtable table](./Airtable_node.png)

Binary file not shown.

After

Width:  |  Height:  |  Size: 148 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 142 KiB

View File

@ -13,13 +13,18 @@ You can find authentication information for this node [here](../../../credential
## Basic Operations
::: details Spreadsheet
- Create a spreadsheet
:::
::: details Sheet
- Append data to a sheet
- Clear data from a sheet
- Delete columns and rows from a sheet
- Look up a specific column value and return the matching row
- Read data from a sheet
- Update rows in a sheet
:::
## Example Usage
This workflow allows you to append, lookup, update, and read data from Google Sheets. You can also find the [workflow](https://n8n.io/workflows/694) on n8n.io. This example usage workflow uses the following nodes.
@ -60,7 +65,7 @@ In the screenshot below, you will notice that the Set node has created data that
![Using the Set node to set data to be inserted in the Google Sheets node](./Set_node.png)
### 3. Google Sheets node (Append)
#### Creating a Google Sheets spreadsheet
@ -71,9 +76,9 @@ In the screenshot below, you will notice that the Set node has created data that
#### Configure the Google Sheets node
This Google Sheets node will add the data from the Set node in a new row to the Google Sheets that we will specify using the Sheet ID.
This Google Sheets node will add the data from the Set node in a new row to the Google Sheets that we will specify using the Sheet ID.
1. Select 'OAuth2' from the ***Authentication*** dropdown list.
1. Select 'OAuth2' from the ***Authentication*** dropdown list.
2. First of all, you'll have to enter credentials for the Google Sheets node. You can find out how to enter credentials for this node [here](../../../credentials/Google/README.md).
3. Select 'Append' from the ***Operation*** dropdown list.
4. Paste the Sheet ID you copied in the previous step, in the ***Sheet ID*** field.
@ -98,7 +103,7 @@ This node will return the entries from the Google Sheets that have `Berlin` as t
6. Enter `Berlin` in the ***Lookup Value*** field.
7. Click on the ***Add Option*** button and select 'Return All Matches' from the dropdown list.
8. Toggle ***Return All Matches*** to true. This option returns all the entries that contain `Berlin` as the City. Refer to the [FAQs](#how-to-return-all-the-values-with-the-lookup-operation) for more information.
9. Click on the ***Add Option*** button and select 'Value Render Mode' from the dropdown list. This option determines how the values should render in the output. The 'Unformatted Value' option returns the data without formatting it. Refer to the [FAQs](#what-are-the-various-formats-to-read-the-data-from-the-google-sheets) for more information on why we used this option.
9. Click on the ***Add Option*** button and select 'Value Render Mode' from the dropdown list. This option determines how the values should render in the output. The 'Unformatted Value' option returns the data without formatting it. Refer to the [FAQs](#what-are-the-various-formats-to-read-the-data-from-the-google-sheets) for more information on why we used this option.
10. Click on ***Execute Node*** to run the workflow.
In the screenshot below, you will notice that the node returns all the entries that contain Berlin as the City. The output is unformatted. This output is passed on to the next nodes in the workflow.
@ -184,7 +189,7 @@ To change the format, click on ***Add Option*** and select 'Value Render Mode' f
There are two different formats you can use to add/update data in Google Sheets.
- **Raw:** This is the default format. In this format, the values are stored as-is and not parsed. For example, the node stores the text 2020-10-01 as a string in the Google Sheets.
- **User Entered:** In this format, the node parse the values. It follows the rules that are applied when entering text into the cell via the Google Sheet UI. For example, the node stores the text 2020-10-01 as a date in the Google Sheets.
- **User Entered:** In this format, the node parse the values. It follows the rules that are applied when entering text into the cell via the Google Sheet UI. For example, the node stores the text 2020-10-01 as a date in the Google Sheets.
To change the format, click on ***Add Option*** and select 'Value Input Mode' from the dropdown list. Select the appropriate option you want your data to be stored in, from the ***Value Input Mode*** dropdown list.
@ -199,4 +204,5 @@ By default, the Lookup operation returns only the first value that it matches. T
## Further Reading
- [Migrating Community Metrics to Orbit using n8n 📈](https://medium.com/n8n-io/migrating-community-metrics-to-orbit-using-n8n-b293372e8daf)
- [Supercharging your conference registration process with n8n 🎫](https://medium.com/n8n-io/supercharging-your-conference-registration-process-with-n8n-2831cdff37f9)

View File

@ -91,7 +91,7 @@ In the screenshot below, you will notice that the node updates the information o
### 4. Orbit2 node (create: note)
This node will create a note for the member that we created using the Orbit node.
This node will create a note for the member that we created using the Orbit node.
:::v-pre
1. Select the credentials that you entered in the previous node.
2. Select 'Note' from the ***Resource*** dropdown list.
@ -123,3 +123,7 @@ This node will create a post for the member that we created using the Orbit node
In the screenshot below, you will notice that the node creates a post for the member that we created using the Orbit node.
![Using the Orbit node to create a post for a member](./Orbit3_node.png)
## Further Reading
- [Migrating Community Metrics to Orbit using n8n 📈](https://medium.com/n8n-io/migrating-community-metrics-to-orbit-using-n8n-b293372e8daf)

View File

@ -24,6 +24,7 @@ You can find authentication information for this node [here](../../../credential
- Join an existing conversation
- Remove a user from a channel
- Leave a conversation
- List members of a conversation
- Open or resume a direct message or multi-person direct message
- Rename a conversation
- Get a thread of replies posted to a channel
@ -43,12 +44,23 @@ You can find authentication information for this node [here](../../../credential
- Update a message
:::
::: details Reaction
- Add a reaction to a message
- Get the reactions of a message
- Remove a reaction of a message
:::
::: details Star
- Add a star to an item
- Delete a star from an item
- Get all the stars of an authenticated user
:::
::: User
- Get information about a user
- Get online status of a user
:::
::: details User Profile
- Get your user profile
- Update user's profile

View File

@ -1,5 +1,24 @@
# Changelog
## n8n@0.98.0
For a comprehensive list of changes, check out the [commits](https://github.com/n8n-io/n8n/compare/n8n@0.97.0...n8n@0.98.0) for this version.<br />
**Release date:** 2020-12-16
- New nodes
- Brandfetch
- Pushcut
- Pushcut Trigger
- Enhanced nodes
- Google Sheets: Added Spreadsheet resource
- IF: Added Is Empty option
- Slack: Added Reaction and User resource, and Member operation to the Channel resource
- Spreadsheet File: Added the option Include Empty Cell to display empty cells
- Webhook: Added option to send a custom response body. The node can now also return string data
- Bug fixes
- GitLab: Fixed an issue with GitLab OAuth credentials. You can now specify your GitLab server to configure the credentials
- Mautic: Fixed an issue with the OAuth credentials
- If a workflow is using the Error Trigger node, by default, the workflow will use itself as the Error Workflow.
- Fixed a bug that caused the Editor UI to display an incorrect (save) state upon activating or deactivating a workflow
## n8n@0.97.0
For a comprehensive list of changes, check out the [commits](https://github.com/n8n-io/n8n/compare/n8n@0.96.0...n8n@0.97.0) for this version.<br />
**Release date:** 2020-12-10

View File

@ -14,7 +14,9 @@
"build": "vuepress build docs"
},
"author": "",
"dependencies": {},
"dependencies": {
"vuepress-plugin-sitemap": "^2.3.1"
},
"devDependencies": {
"@vuepress/plugin-google-analytics": "^1.5.0",
"directory-tree": "^2.2.4",