Merge branch 'master' into docs/google-slides
40
docs/nodes/credentials/ERPNext/README.md
Normal file
@ -0,0 +1,40 @@
|
||||
---
|
||||
permalink: /credentials/erpnext
|
||||
description: Learn to configure credentials for the Emelia node in n8n
|
||||
---
|
||||
|
||||
# ERPNext
|
||||
|
||||
You can use these credentials to authenticate the following nodes with Emelia.
|
||||
- [ERPNext](../../nodes-library/nodes/ERPNext/README.md)
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Create a [ERPNext](https://erpnext.com) account.
|
||||
|
||||
## Using API Key
|
||||
|
||||
1. Open your ERPNext dashboard page.
|
||||
2. Click on ***Settings*** on the top and select 'My Settings'.
|
||||
3. Scroll down to the bottom of the page and click on ***API Access***.
|
||||
4. Click on the ***Generate Keys*** button.
|
||||
5. Copy the displayed API Secret.
|
||||
6. Enter a name for your credentials in the ***Credentials Name*** field in the 'ERPNext API' credentials in n8n.
|
||||
7. Paste the API Secret in the ***API Secret*** field in the 'ERPNext API' credentials in n8n.
|
||||
8. Copy the API Key from ERPNext.
|
||||
**Note:** You might have to refresh the ERPNext window to view the API Key.
|
||||
9. Paste the API Key in the ***API Key*** field in the 'ERPNext API' credentials in n8n.
|
||||
10. Enter the subdomain of your ERPNext account in the ***Subdomain*** field in the 'ERPNext API' credentials in n8n. Refer to the [FAQs](#how-to-find-the-subdomain-of-an-erpnext-account) to learn how to get your subdomain.
|
||||
11. Click on the ***Create*** button to create your credentials in n8n.
|
||||
|
||||
The following video demonstrates the steps mentioned above.
|
||||
|
||||
<div class="video-container">
|
||||
<iframe width="840" height="472.5" src="https://www.youtube.com/embed/Q12DmHS3FL4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
||||
</div>
|
||||
|
||||
## FAQs
|
||||
|
||||
### How to find the subdomain of an ERPNext account?
|
||||
|
||||
In the address bar of your browser, you can find the subdomain. The string between `https://` and `.erpnext.com` is your subdomain. For example, if the URL in the address bar is `https://n8n.erpnext.com`, the subdomain will be `n8n`.
|
||||
@ -71,9 +71,38 @@ The following video demonstrates the steps mentioned above.
|
||||
<iframe width="840" height="472.5" src="https://www.youtube.com/embed/2SFGl3xBdOA" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
||||
</div>
|
||||
|
||||
## Using Outlook.com
|
||||
|
||||
1. Enter the name for your credentials in the ***Credentials Name*** field in the 'IMAP' credentials in n8n.
|
||||
2. Enter your email address in the ***User*** field.
|
||||
3. Enter your account password in the ***Password*** field.
|
||||
4. Enter `outlook.office365.com` in the ***Host*** field.
|
||||
5. Toggle ***SSL/TLS*** to `true`.
|
||||
6. Click on ***Create*** to create your credentials.
|
||||
|
||||
**Note** If you get a connection error, please follow the steps mentioned in the [FAQs](#how-to-solve-the-connection-error-when-connecting-to-outlook-com).
|
||||
|
||||
The following video demonstrates the steps mentioned above.
|
||||
|
||||
<div class="video-container">
|
||||
<iframe width="840" height="472.5" src="https://www.youtube.com/embed/gCWiILtHnPQ" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
||||
</div>
|
||||
|
||||
## FAQs
|
||||
|
||||
### How to solve the connection error when connecting to Outlook.com?
|
||||
|
||||
If you receive a connection error while configuring the credentials for your Outlook account, follow the steps mentioned below:
|
||||
1. Go to [account.live.com/activity](https://account.live.com/activity).
|
||||
2. Sign in using the email address and password of your account.
|
||||
3. Under the ***Recent activity*** section, find the Session Type event that matches the most recent time you received the connection error and click to expand it.
|
||||
4. Select ***This was me*** to let the system know you authorize the IMAP connection.
|
||||
|
||||
|
||||
## Further Reading
|
||||
|
||||
- [Set up IMAP for Gmail account](https://support.google.com/mail/answer/7126229?hl=en)
|
||||
- [Sign in with App Passwords for your Gmail Account](https://support.google.com/accounts/answer/185833?hl=en)
|
||||
- [Set up IMAP for Yahoo mail account](https://help.yahoo.com/kb/sln4075.html)
|
||||
- [Sign in with App Passwords for your Yahoo mail Account](https://help.yahoo.com/kb/generate-manage-third-party-passwords-sln15241.html)
|
||||
- [POP, IMAP, and SMTP settings for Outlook.com](https://support.microsoft.com/en-us/office/pop-imap-and-smtp-settings-for-outlook-com-d088b986-291d-42b8-9564-9c414e2aa040)
|
||||
|
||||
|
After Width: | Height: | Size: 81 KiB |
|
After Width: | Height: | Size: 163 KiB |
@ -0,0 +1,58 @@
|
||||
---
|
||||
permalink: /nodes/n8n-nodes-base.activationTrigger
|
||||
description: Learn how to use the Activation Trigger node in n8n
|
||||
---
|
||||
|
||||
# Activation Trigger
|
||||
|
||||
The Activation Trigger node gets triggered when an event gets fired by n8n or a workflow.
|
||||
|
||||
::: tip 💡 Keep in mind
|
||||
If you want to use the Activation Trigger node for a workflow, add the node to the workflow. You don't have to create a separate workflow.
|
||||
:::
|
||||
|
||||
The Activation Trigger node gets triggered for the workflow that it gets added to. The Activation Trigger node can be used to trigger a workflow to notify the state of the workflow.
|
||||
|
||||
## Node Reference
|
||||
|
||||
- Events
|
||||
- ***Activation:*** Run when the workflow gets activated
|
||||
- ***Start:*** Run when n8n starts or restarts
|
||||
- ***Update:*** Run when the workflow gets saved while it is active
|
||||
|
||||
## Example Usage
|
||||
|
||||
This workflow allows you to receive a message on Mattermost when a workflow is updated. You can also find the [workflow](https://n8n.io/workflows/1033) on n8n.io. This example usage workflow uses the following nodes.
|
||||
- [Activation Trigger]()
|
||||
- [Mattermost](../../nodes/Mattermost/README.md)
|
||||
|
||||
The final workflow should look like the following image.
|
||||
|
||||

|
||||
|
||||
### 1. Activation Trigger node
|
||||
|
||||
Open the workflow where you want to add the activation workflow. Add the Activation Trigger node to the workflow.
|
||||
|
||||
The Activation Trigger node will trigger the workflow when the workflow gets updated.
|
||||
|
||||
1. Select 'Update' from the ***Events*** dropdown list.
|
||||
|
||||
In the screenshot below, you will notice that the node triggers the workflow when the workflow gets updated.
|
||||
|
||||

|
||||
|
||||
### 2. Mattermost node (post: message)
|
||||
|
||||
This node will send a message in the `workflow` channel on Mattermost.
|
||||
::: v-pre
|
||||
1. First of all, you'll have to enter credentials for the Mattermost node. You can find out how to enter credentials for this node [here](../../../credentials/Mattermost/README.md).
|
||||
2. Select a channel from the ***Channel ID*** dropdown list.
|
||||
3. Click on the gears icon next to the ***Message*** field click on ***Add Expression***.
|
||||
::: v-pre
|
||||
4. Enter the following message in the ***Expression*** field: `The workflow {{$workflow.name}}, was updated.`. `$workflow.name` returns the name of the workflow.
|
||||
5. Click on ***Execute Node*** to run the workflow.
|
||||
:::
|
||||
In the screenshot below, you will notice that the node sends a message to Mattermost.
|
||||
|
||||

|
||||
|
After Width: | Height: | Size: 147 KiB |
BIN
docs/nodes/nodes-library/nodes/ERPNext/ERPNext1_node.png
Normal file
|
After Width: | Height: | Size: 157 KiB |
BIN
docs/nodes/nodes-library/nodes/ERPNext/ERPNext2_node.png
Normal file
|
After Width: | Height: | Size: 140 KiB |
BIN
docs/nodes/nodes-library/nodes/ERPNext/ERPNext_node.png
Normal file
|
After Width: | Height: | Size: 160 KiB |
92
docs/nodes/nodes-library/nodes/ERPNext/README.md
Normal file
@ -0,0 +1,92 @@
|
||||
---
|
||||
permalink: /nodes/n8n-nodes-base.erpNext
|
||||
description: Learn how to use the ERPNext node in n8n
|
||||
---
|
||||
|
||||
# ERPNext
|
||||
|
||||
[ERPNext](https://erpnext.com) is an open-source integrated Enterprise Resource Planning software. It is a generic ERP software used by manufacturers, distributors, and services companies.
|
||||
|
||||
::: tip 🔑 Credentials
|
||||
You can find authentication information for this node [here](../../../credentials/ERPNext/README.md).
|
||||
:::
|
||||
|
||||
## Basic Operations
|
||||
|
||||
::: details Document
|
||||
- Create a document
|
||||
- Delete a document
|
||||
- Retrieve a document
|
||||
- Retrieve all documents
|
||||
- Update a document
|
||||
:::
|
||||
|
||||
## Example Usage
|
||||
|
||||
This workflow allows you to create, update, and retrieve a document from ERPNext. You can also find the [workflow](https://n8n.io/workflows/961) on n8n.io. This example usage workflow uses the following nodes.
|
||||
- [Start](../../core-nodes/Start/README.md)
|
||||
- [ERPNext]()
|
||||
|
||||
The final workflow should look like the following image.
|
||||
|
||||

|
||||
|
||||
### 1. Start node
|
||||
|
||||
The Start node exists by default when you create a new workflow.
|
||||
|
||||
### 2. ERPNext node (document: create)
|
||||
|
||||
This node will create a new document in ERPNext.
|
||||
|
||||
1. First of all, you'll have to enter credentials for the ERPNext node. You can find out how to do that [here](../../../credentials/ERPNext/README.md).
|
||||
2. Select 'Item' from the ***DocType*** dropdown list.
|
||||
3. Click on the ***Add Property*** button.
|
||||
4. Select 'Item Name' from the ***Field*** dropdown list.
|
||||
5. Enter `item 1` in the ***Value*** field.
|
||||
6. Click on the ***Add Property*** button.
|
||||
7. Select 'Item Code' from the ***Field*** dropdown list.
|
||||
8. Enter `item-1` in the ***Value*** field.
|
||||
9. Click on the ***Add Property*** button.
|
||||
10. Select 'Item Group' from the ***Field*** dropdown list.
|
||||
11. Enter `Products` in the ***Value*** field.
|
||||
**Note:** Make sure that the item group exists in your ERPNext account.
|
||||
12. Click on ***Execute Node*** to run the node.
|
||||
|
||||
In the screenshot below, you will notice that the node creates a new item with the name `item 1`.
|
||||
|
||||

|
||||
|
||||
### 3. ERPNext1 node (document: addContact)
|
||||
|
||||
This node will add the `Item Tax` property to the item that we created in the previous node.
|
||||
::: v-pre
|
||||
1. Select the credentials that you entered in the previous node.
|
||||
2. Select 'Update' from the ***Operation*** dropdown list.
|
||||
3. Select 'Item' from the ***DocType*** dropdown list.
|
||||
4. Click on the gears icon next to the ***Item Name*** field and click on ***Add Expression***.
|
||||
5. Select the following in the ***Variable Selector*** section: Current Node > Input Data > JSON > name. You can also add the following expression: `{{$json["name"]}}`.
|
||||
6. Click on the ***Add Property*** button.
|
||||
7. Select 'Item Tax' from the ***Field*** dropdown list.
|
||||
8. Enter `5` in the ***Value*** field.
|
||||
10. Click on ***Execute Node*** to run the node.
|
||||
:::
|
||||
In the screenshot below, you will notice that the node adds the Item Tax property to the item that we created in the previous node.
|
||||
|
||||

|
||||
|
||||
### 4. ERPNext2 node (document: get)
|
||||
|
||||
This node will get the information about the item that we created earlier.
|
||||
::: v-pre
|
||||
1. Select the credentials that you entered in the previous node.
|
||||
2. Select 'Get' from the ***Operation*** dropdown list.
|
||||
3. Select 'Item' from the ***DocType*** dropdown list.
|
||||
4. Click on the gears icon next to the ***Item Name*** field and click on ***Add Expression***.
|
||||
5. Select the following in the ***Variable Selector*** section: Current Node > Input Data > JSON > name. You can also add the following expression: `{{$json["name"]}}`.
|
||||
6. Click on ***Execute Node*** to run the node.
|
||||
:::
|
||||
|
||||
In the screenshot below, you will notice that the node returns the information of the item.
|
||||
|
||||

|
||||
BIN
docs/nodes/nodes-library/nodes/ERPNext/workflow.png
Normal file
|
After Width: | Height: | Size: 129 KiB |
@ -203,6 +203,9 @@ To insert the data in Google Sheets, you have to first convert the data in a val
|
||||
|
||||
By default, the Lookup operation returns only the first value that it matches. To return all the values that match, click on ***Add Option*** and select 'Return All Matches'. Toggle ***Return All Matches*** to true.
|
||||
|
||||
### How to specify a sheet?
|
||||
|
||||
By default, the Google Sheets node will operate on the default sheet, `Sheet 1`. If you rename the sheet or want to use a different sheet, you have to specify the name of the sheet. You can do that in the ***Range*** field. For example, if you need to use a sheet named `n8n` for the range `A` to `H`, enter `n8n!A:H` in the ***Range*** field.
|
||||
|
||||
## Further Reading
|
||||
|
||||
|
||||