Opencell

Overview

The File Explorer - List Files operation in this n8n node allows you to retrieve a list of files from a specified directory on an Opencell server. This is useful for automating file management tasks, such as monitoring directories, processing files, or integrating with other systems that require access to files stored within Opencell.

Common scenarios:

• Listing all files in a directory for further processing (e.g., downloading, moving, or deleting).
• Monitoring a directory for new files and triggering workflows based on their presence.
• Integrating Opencell's file storage with external systems by fetching file lists programmatically.

Practical example:
You could use this operation to periodically check a directory for new invoice PDFs and then process or email them automatically.

---

Properties

Name	Type	Meaning
Authentication	options	Selects the authentication method to connect to Opencell (Basic Authentication or OAuth2)
Directory	string	The path of the directory whose files you want to list. Required.
Body Content Type	hidden	Internal property; not user-configurable.

---

Output

• The output will be a JSON object containing the list of files found in the specified directory.
• The structure typically includes file names and may include additional metadata depending on the Opencell API response.

Example output:

{
  "files": [
    {
      "name": "document1.pdf",
      "size": 12345,
      "lastModified": "2024-06-01T12:34:56Z"
    },
    {
      "name": "image.png",
      "size": 67890,
      "lastModified": "2024-06-02T08:15:00Z"
    }
  ]
}

Note: Actual fields depend on the Opencell API response.

---

Dependencies

• Opencell API: Requires access to an Opencell instance with the REST API enabled.
• Authentication: You must provide valid credentials for either Basic Authentication or OAuth2, configured in n8n credentials.
• n8n Configuration: Ensure the Opencell API base URL and credentials are set up in your n8n instance.

---

Troubleshooting

Common issues:

• Invalid Directory Path: If the specified directory does not exist, the node may return an error or an empty list.
• Authentication Errors: Incorrect credentials or insufficient permissions will result in authentication failures.
• Network Issues: Connectivity problems between n8n and the Opencell server can cause timeouts or connection errors.

Error messages and resolutions:

• "Username/password error. Error code : XXX": Check your credentials and ensure they are correct.
• "Host error. Error code : XXX": Verify the Opencell server is reachable from your n8n instance.
• "Invalid credentials (unknown error)": Double-check both the authentication method and credentials configuration.

---

Links and References

• Opencell Documentation
• n8n Credentials Setup
• n8n File Operations Guide