Merge branch 'main' into DOC-269-community-nodes

This commit is contained in:
Deborah Barnard 2022-05-26 13:42:37 +01:00
commit 2a9e786314
5 changed files with 36 additions and 24 deletions

View File

@ -1,7 +1,7 @@
To use a predefined credential type:
1. Open your HTTP Request node, or add a new one to your workflow.
2. In **Authentication**, select **Existing Credential Type**.
2. In **Authentication**, select **Predefined Credential Type**.
3. In **Credential Type**, select the API you want to use.
4. In **Credential for `<API name>`**, you can:
1. Select an existing credential for that platform, if available.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 20 KiB

View File

@ -8,8 +8,8 @@ The HTTP Request node is one of the most versatile nodes in n8n. It allows you t
## Node Reference
- **Authentication:** there are two options for authentication:
- Select **Existing Credential Type** to use predefined credential types. This allows you to perform custom operations with some APIs where n8n has a node for the platform. For example, n8n has an Asana node, and supports using your Asana credentials in the HTTP Request node. Refer to [Custom API operations](/integrations/custom-operations/) for more information.
- **Authentication:** there are two options for authentication. n8n recommends using the **Predefined credential type** option when it's available. It offers an easier way to set up and manage credentials, compared to configuring generic credentials.
- Select **Predefined Credential Type**. This allows you to perform custom operations, without additional authentication setup. For example, n8n has an Asana node, and supports using your Asana credentials in the HTTP Request node. Refer to [Custom API operations](/integrations/custom-operations/) for more information.
- Select **Generic Credential Type** to set up authentication using one of the following methods:
- Basic Auth
- Digest Auth
@ -18,8 +18,7 @@ The HTTP Request node is one of the most versatile nodes in n8n. It allows you t
- OAuth2
- None
!!! note "Use existing credential type when possible"
n8n recommends using the **Existing credential type** option when it's available. It offers an easier way to set up and manage credentials, compared to configuring generic credentials.
- **Request Method:** Select the method to be used for the request:
- DELETE

View File

@ -1,8 +1,8 @@
# Node UI Elements
n8n provides a set of predefined UI components (based on a JSON file) that allow users to input all sorts of data types. Currently, the following UI elements are available in n8n.
n8n provides a set of predefined UI components (based on a JSON file) that allows users to input all sorts of data types. The following UI elements are available in n8n.
[[toc]]
## String
@ -21,7 +21,10 @@ Basic configuration
},
```
<img src="./images/string.png" width="350">
![String](/_images/integrations/creating-nodes/code/string.png)
Variation for inputting passwords
@ -40,7 +43,8 @@ Variation for inputting passwords
},
```
<img src="./images/password.png" width="350">
![Password](/_images/integrations/creating-nodes/code/password.png)
Variation with multiple rows
@ -58,7 +62,8 @@ Variation with multiple rows
},
```
<img src="./images/multiple-rows.png" width="350">
![Multiple rows](/_images/integrations/creating-nodes/code/multiple-rows.png)
## Number
@ -83,7 +88,8 @@ Basic configuration
},
```
<img src="./images/number.png" width="350">
![Number](/_images/integrations/creating-nodes/code/number.png)
Variation with decimal points
@ -101,7 +107,8 @@ Variation with decimal points
},
```
<img src="./images/decimal.png" width="350">
![Decimal](/_images/integrations/creating-nodes/code/decimal.png)
## Collection
@ -140,7 +147,8 @@ The `collection` type is used to input a collection of fields. For example, addi
},
```
<img src="./images/collection.png" width="350">
![Collection](/_images/integrations/creating-nodes/code/collection.png)
## Datetime
@ -157,7 +165,8 @@ The `dateTime` type provides a calendar from which you can pick a specific date
},
```
<img src="./images/datetime.png" width="350">
![Datetime](/_images/integrations/creating-nodes/code/datetime.png)
## Boolean
@ -174,7 +183,7 @@ The `boolean` type is used to input a value that is either true or false. It is
},
```
<img src="./images/boolean.png" width="350">
![Boolean](/_images/integrations/creating-nodes/code/boolean.png)
## Color
@ -190,7 +199,8 @@ The `color` type provides a color palette from which a specific color can be sel
},
```
<img src="./images/color.png" width="300">
![Color](/_images/integrations/creating-nodes/code/color.png)
## Options
@ -217,7 +227,7 @@ The `options` type is used to provide options from which a single one has to be
},
```
<img src="./images/options.png" width="350">
![Options](/_images/integrations/creating-nodes/code/options.png)
## Multi Options
@ -244,7 +254,7 @@ The `multiOptions` type is used to provide options from which many can be select
},
```
<img src="./images/multioptions.png" width="350">
![Multioptions](/_images/integrations/creating-nodes/code/multioptions.png)
## Fixed Collection
@ -286,7 +296,9 @@ The `fixedCollection? type is used to present groups of fields that are semantic
},
```
<img src="./images/fixed-collection.png" width="350">
![Fixed collection](/_images/integrations/creating-nodes/code/fixed-collection.png)
## JSON
@ -303,4 +315,5 @@ The `json` type is used to input data formatted as JSON.
},
```
<img src="./images/json.png" width="350">
![JSON](/_images/integrations/creating-nodes/code/json.png)

View File

@ -2,13 +2,13 @@
n8n supplies hundreds of nodes, allowing you to create workflows that link multiple products. However, some nodes don't include all the possible operations supported by a product's API. You can work around this by making a custom API call using the [HTTP Request](/integrations/core-nodes/n8n-nodes-base.httpRequest/) node.
One of the most complex parts of setting up API calls is managing authentication. To simplify this, n8n provides a way to use existential credential types (credentials associated with n8n nodes).
One of the most complex parts of setting up API calls is managing authentication. To simplify this, n8n simplifies authentication for services with an existing node.
## Predefined credential types
A predefined credential type is a credential associated with a particular platform. You can use predefined credential types instead of generic credentials in the HTTP Request node.
A predefined credential type is a credential that already exists in n8n. You can use predefined credential types instead of generic credentials in the HTTP Request node.
For example: you create an Asana credential, for use with the Asana node. Later, you want to perfom an operation that isn't supported by the Asana node, using Asana's API. You can use your existing Asana credential in the HTTP Request node to perform the operation.
For example: you create an Asana credential, for use with the Asana node. Later, you want to perform an operation that isn't supported by the Asana node, using Asana's API. You can use your existing Asana credential in the HTTP Request node to perform the operation, without additional authentication setup.
### Using predefined credential types
@ -17,7 +17,7 @@ For example: you create an Asana credential, for use with the Asana node. Later,
### Credential scopes
Some existing credential types have specfic scopes: endpoints that they work with. n8n warns you about this when you select the credential type.
Some existing credential types have specific scopes: endpoints that they work with. n8n warns you about this when you select the credential type.
For example, follow the steps in [Using predefined credential types](#using-predefined-credential-types), and select **Google Calendar OAuth2 API** as your **Credential Type**. n8n displays a box listing the two endpoints you can use this credential type with: