Actions74
- ai Actions
- array Actions
- audiovideo Actions
- carbone Actions
- charts Actions
- code Actions
- data Actions
- datetime Actions
- events Actions
- files Actions
- geo Actions
- hellospaces Actions
- images Actions
- Get Metadata of an Image
- Scale an Image
- Overlay an Image on another Image
- Scale an Image to Fit Given Dimensions
- Resize an Image
- Mask an Image with Another Image
- Mask an Image with a Circle Mask
- Crops an image by the given x, y, width and height paramters.
- Convert Texts to an Image
- Convert HTML String or URL to an Image
- Generates a QRCode with given text and color.
- Get EXIF from Image
- Remove EXIF from Image
- Modify Image EXIF
- playground Actions
- spreadsheet Actions
- stripe Actions
- youtube Actions
spreadsheet → Vlookup Spreadsheet Function for Arrays
AI-generatedOverview
This node provides a "Vlookup Spreadsheet Function for Arrays" operation, similar to the VLOOKUP function in spreadsheet applications. It allows you to search for a value in the first column of an array (representing tabular data) and return the value from another specified column in the same row. This is useful for data enrichment, lookups, or joining datasets within your n8n workflows.
Common scenarios:
- Enriching records by looking up reference data (e.g., finding a product name by its ID).
- Merging two datasets based on a common key.
- Automating data validation or transformation tasks that require cross-referencing values.
Example:
Given an array of user records, you can use this node to find a user's email address by searching for their username.
Properties
| Name | Meaning |
|---|---|
| Data | Array of lines with mixed values. The main dataset to perform the lookup on. |
| Lookup value | The value to be found in the first column of the data. |
| Column | The column index (starting from 0) whose value should be returned when a match is found. |
| Ignore case sensitivity | Sets whether the lookup should ignore case differences (true = case-insensitive). |
Output
- json: The output will contain the result of the VLOOKUP operation. Typically, this will be the value found in the specified column for the matching row. If no match is found, the output may indicate an error or return
null. - If an error occurs (e.g., no match found, invalid input), the output will include an
errorfield describing the issue.
Example output:
{
"result": "Matched Value"
}
or, in case of error:
{
"error": "No match found for the given lookup value."
}
Dependencies
- External Service: Requires access to the 1001fx API.
- API Key: You must configure the
1001fxApicredential in n8n. - Environment: No additional environment variables are required beyond standard n8n configuration.
Troubleshooting
Common issues:
- Invalid Data Format: Ensure the "Data" property is a valid array of arrays or objects as expected by the API.
- Column Index Out of Range: If the "Column" value exceeds the number of columns in your data, an error will occur.
- No Match Found: If the "Lookup value" does not exist in the first column, the output will indicate an error.
- Case Sensitivity: If "Ignore case sensitivity" is set incorrectly, matches may not be found as expected.
Error messages:
"No match found for the given lookup value."— Check your data and lookup value."Invalid input data format."— Ensure your "Data" property is correctly structured."API key missing or invalid."— Make sure your 1001fxApi credentials are set up in n8n.