Nextcloud Tables icon

Nextcloud Tables

Manage your Nextcloud Tables - tables, rows, and data
Join our community

Actions31

Overview

This node integrates with Nextcloud Tables, enabling users to manage table sharing settings programmatically. Specifically, the "Get All Shares" operation under the "Share" resource retrieves all sharing configurations for a specified table. This is useful in scenarios where you want to audit or review who has access to a particular table and what kind of permissions they have.

Practical examples include:

  • Automatically listing all users and groups that have access to a specific table.
  • Integrating with other workflows to adjust permissions based on external triggers.
  • Generating reports on table sharing for compliance or administrative purposes.

Properties

Name Meaning
Table Select a table from the list or enter its ID. The node will retrieve all shares related to this table.

The "Table" property supports two modes:

  • List: Choose from a searchable list of available tables.
  • ID: Manually enter the unique identifier of the table.

Output

The output is an array of JSON objects, each representing a share associated with the specified table. Each object contains details about the share such as the user or group it is shared with, permission levels, and possibly expiration or other metadata depending on Nextcloud's API response.

No binary data is output by this operation.

Example output structure (simplified):

[
  {
    "shareId": "string",
    "shareWith": "user_or_group_identifier",
    "permissions": "permission_level",
    "shareType": "user/group/link",
    "expirationDate": "optional_date"
  },
  ...
]

Dependencies

  • Requires an active connection to a Nextcloud instance with the Tables app enabled.
  • Needs an API authentication token or API key credential configured in n8n to authorize requests.
  • The node depends on internal handlers and helper methods bundled within the node package to communicate with Nextcloud's API.

Troubleshooting

  • Common Issues:

    • Invalid or missing table ID: Ensure the table exists and the ID is correct.
    • Authentication errors: Verify that the API credentials are valid and have sufficient permissions.
    • Network connectivity problems: Confirm that the Nextcloud server is reachable from the n8n environment.

  • Error Messages:

    • "Unknown resource": Indicates the resource parameter is incorrect; ensure "share" is selected.
    • API errors returned from Nextcloud will be passed through; check the error message for details.
    • If the node fails but "Continue On Fail" is enabled, errors will appear in the output JSON under an error field.

Links and References

Discussion