Merge branch 'master' into docs/kafkaTrigger

This commit is contained in:
Tanay Pant 2020-12-11 09:37:39 +01:00
commit 65cd793a5a
4 changed files with 55 additions and 7 deletions

View File

@ -2,6 +2,11 @@
Let's create your first workflow in n8n. We'll create a workflow which will run every morning at 8 AM and will send an SMS to tell you if you should take a sweater with you. You can also find the [workflow](https://n8n.io/workflows/409) on n8n.io.
Here's a video that will take you through the process of creating this workflow.
<iframe width="560" height="315" src="https://www.youtube.com/embed/QhTsOMvqLuo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
## Prerequisites
Youll need the following tools and resources to complete the tutorial:

View File

@ -2,6 +2,10 @@
Let's create your first workflow in n8n. We'll create a workflow that will add a new card to a Trello board whenever a user submits a feedback score that is less than seven. You can also find the [workflow](https://n8n.io/workflows/791) on n8n.io.
Here's a video that will take you through the process of creating this workflow.
<iframe width="560" height="315" src="https://www.youtube.com/embed/NEuto0F41WY" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
## Prerequisites
Youll need the following tools and resources to complete the tutorial:

View File

@ -56,46 +56,69 @@ The start node exists by default when you create a new workflow.
### 2. Gmail node (getAll: message)
This node will return ten messages with the label `n8n` from Gmail. If you want to return all the messages toggle ***Return All*** to `true`.
1. First of all, you'll have to enter credentials for the Gmail node. You can find out how to do that [here](../../../credentials/Google/README.md).
2. Select 'Message' from the ***Resource*** dropdown list.
3. Select 'Get All' from the ***Operation*** dropdown list.
4. Click on ***Add Field*** button and select 'Format' from the dropdown list.
5. Select 'Full' from ***Format*** dropdown menu.
6. Click on ***Add Field*** button and select 'Label IDs' from the dropdown list.
7. Select the label from ***Label IDs*** dropdown list.
4. Click on the ***Add Field*** button and select 'Format' from the dropdown list.
5. Select 'Full' from ***Format*** dropdown menu. This option will return the full email message data with the body content parsed in the payload field.
6. Click on the ***Add Field*** button and select 'Label IDs' from the dropdown list.
7. Select the label from the ***Label IDs*** dropdown list.
8. Click on ***Execute Node*** to run the node.
In the screenshot below, you will notice that the node returns ten email messages with the label `n8n`.
![Using the Gmail node to get all messages with a particular label](./Gmail_node.png)
::: v-pre
### 3. Gmail1 node (remove: messageLabel)
This node will remove the label `n8n` from all the messages that you received in the previous node. If you want to remove a different label, select that label instead.
1. Select the credentials that you entered in the previous Gmail node.
2. Select 'Message Label' from the ***Resource*** dropdown list.
3. Select 'Remove' from the ***Operation*** dropdown list.
4. Click on the gears icon next to the ***Message ID*** field and click on ***Add Expression***.
5. Select the following in the ***Variable Selector*** section: Nodes > Gmail > Output Data > JSON > id. You can also add the following expression: `{{$node["Gmail"].json["id"]}}`.
6. Select the label from ***Label IDs*** dropdown list.
6. Select the label from the ***Label IDs*** dropdown list.
7. Click on ***Execute Node*** to run the node.
:::
In the screenshot below, you will notice that the node removes the `n8n` label from the messages that we received from the previous node.
![Using the Gmail node to remove a label from the messages](./Gmail1_node.png)
::: v-pre
### 4. Gmail2 node (add: messageLabel)
This node will add a new label `nodemation` to the messages that we received from the Gmail node. If you want to add a different label, select that label instead.
1. Select the credentials that you entered in the previous Gmail node.
2. Select 'Message Label' from the ***Resource*** dropdown list.
3. Click on the gears icon next to the ***Message ID*** field and click on ***Add Expression***.
4. Select the following in the ***Variable Selector*** section: Nodes > Gmail > Output Data > JSON > id. You can also add the following expression: `{{$node["Gmail"].json["id"]}}`.
5. Select the label from ***Label IDs*** dropdown list.
5. Select the label from the ***Label IDs*** dropdown list.
6. Click on ***Execute Node*** to run the node.
:::
In the screenshot below, you will notice that the node adds a new label `nodemation` to the messages that we received from the Gmail node.
![Using the Gmail node to add a label to the messages](./Gmail2_node.png)
## FAQs
### 1. How to return all the messages with a particular label?
To return all the messages with a particular label, follow the steps mentioned below.
1. Select 'Message' from the ***Resource*** dropdown list.
2. Select 'Get All' from the ***Operation*** dropdown list.
3. If you want to all return all the messages with a particular, toggle ***Return All*** to `true`.
4. Click on ***Add Field*** and select 'Query'.
5. Enter `label:LABEL_NAME` in the ***Query*** field. Replace `LABEL_NAME` with your label name.
6. Click on ***Execute Node*** to run the node.
Refer to [Search operators you can use with Gmail](https://support.google.com/mail/answer/7190?hl=en) to learn more about filtering your search results.
## Further Reading

View File

@ -1,5 +1,21 @@
# Changelog
## 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
- New nodes
- Ghost
- Nasa
- Snowflake
- Twist
- Enhanced nodes
- Automizy: Added options to add and remove tabs for the Update operation of the Contact resource
- Pipedrive: Added label field to Person, Organization, and Deal resources. Also added Update operation for the Organization resource
- Bug fixes
- Fixed a bug that caused OAuth1 requests to break
- Fixed Docker user mount path
## n8n@0.96.0
For a comprehensive list of changes, check out the [commits](https://github.com/n8n-io/n8n/compare/n8n@0.95.1...n8n@0.96.0) for this version.<br />
**Release date:** 2020-12-03