Overview
This node integrates with OnlyOffice to manage files and folders stored in an OnlyOffice environment. Specifically, the "File" resource with the "List" operation allows users to list all files within a specified folder. This is useful for workflows that need to retrieve and process documents stored in OnlyOffice, such as automating document management, syncing files, or generating reports based on file contents.
For example, you might use this node to:
- Retrieve all files from your personal "My Documents" folder (
@my) to process them further. - List files in a shared "Common Documents" folder (
@common) to monitor changes or trigger notifications.
Properties
| Name | Meaning |
|---|---|
| Folder ID | ID of the folder to list contents from. Use @my for My Documents, @common for Common Documents. |
Output
The output is an array of JSON objects representing the contents of the specified folder. Each item corresponds to either a file or a folder inside the target folder. The structure includes metadata about each file or folder as returned by the OnlyOffice API.
Example output items may include fields like:
id: Unique identifier of the file or folder.title: Name of the file or folder.type: Indicates whether the item is a file or folder.- Other metadata related to the file/folder properties.
No binary data is output by this operation; it strictly returns JSON metadata about files and folders.
Dependencies
- Requires an API key credential for OnlyOffice (configured in n8n credentials).
- The node makes authenticated HTTP requests to the OnlyOffice API endpoint configured via the credential.
- The base URL for the API is taken from the credential configuration.
Troubleshooting
- Invalid Folder ID: If the folder ID does not exist or is incorrect, the API may return an error or empty results. Verify the folder ID value (
@my,@common, or a custom folder ID). - Authentication Errors: Ensure the OnlyOffice API credential is correctly set up with valid access tokens or API keys.
- API Endpoint Issues: Confirm the base URL in the credential matches your OnlyOffice server's API endpoint.
- Empty Results: If no files or folders are returned, verify that the folder actually contains items and that the user has permission to view them.
Common error messages will typically come from the OnlyOffice API and be passed through. Handling these involves checking credentials, folder IDs, and network connectivity.