Nextcloud Tables icon

Nextcloud Tables

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

Actions31

Overview

This node enables managing shares for Nextcloud Tables, specifically allowing you to create new shares on tables. It is useful when you want to grant access permissions to specific users or groups for a particular table in your Nextcloud instance. For example, you can share a table with a colleague (user) or an entire team (group), specifying what actions they are allowed to perform such as reading data, creating rows, updating rows, deleting rows, or managing the table structure and shares.

Typical use cases include collaborative data management where different users or teams need controlled access to shared tables without giving full administrative rights.

Properties

Name Meaning
Table Select a table from your Nextcloud instance by listing available tables or entering its ID.
Share Type Choose whether to share with a single user or a group. Options: User, Group.
User When sharing with a user, select the specific user from the list of all available Nextcloud users. (Shown only if Share Type = User)
Group When sharing with a group, select the specific group from the list of all available Nextcloud groups. (Shown only if Share Type = Group)
Permissions Define the permissions granted for this share. Options include:
- Read: Permission to read table data (default true)
- Create: Permission to add new rows
- Update: Permission to edit existing rows
- Delete: Permission to delete rows
- Manage: Full access including modifying structure and managing shares
Additional Options Optional extra settings such as Display Name for the share

Output

The node outputs JSON data representing the result of the share creation operation. This typically includes details about the created share such as the share ID, the target user or group, the assigned permissions, and any metadata related to the share.

If the node supports binary data output, it would be used to represent files or attachments related to the share, but based on the provided code and properties, the output is purely JSON describing the share.

Dependencies

  • Requires an active connection to a Nextcloud instance with the Nextcloud Tables app installed.
  • Needs an API key or authentication token configured in n8n credentials to authorize requests to the Nextcloud API.
  • The node relies on internal helper methods to fetch lists of tables, users, and groups dynamically for selection fields.

Troubleshooting

  • Common issues:
    • Invalid or missing table ID: Ensure the selected table exists and the ID is correct.
    • Insufficient permissions: The API credential must have rights to create shares on the specified table.
    • User or group not found: Verify that the user or group exists in the Nextcloud instance.
  • Error messages:
    • "Unknown resource": Occurs if the resource parameter is incorrect; ensure "share" is selected.
    • API errors related to authorization or invalid parameters will be returned from Nextcloud and surfaced by the node.
  • To resolve errors, verify credentials, input parameters, and that the Nextcloud server is reachable.

Links and References

Discussion