Ploomes CRMInstall

Summary

Retrieves a collection of Tag records from Ploomes CRM with full OData query support and optional caching.

Inputs

• Cache Strategy — How to use in-memory cache for GET requests. Options: Disabled (no cache), Cache First (use cache if available), Fallback Only (always request, use cache on failure).
• Cache TTL (Seconds) — Time-to-live for cached responses in seconds. Only applies when Cache Strategy is Cache First or Fallback Only.
• $top (Limit) — Maximum number of records to return. Default is 1.
• $skip (Offset) — Number of records to skip for pagination. Default is 0.
• $select (Fields) — Comma-separated list of fields to return. Default is 'Id'.
• $orderby (Sort) — Field to sort by with optional direction (asc/desc). Default is 'Id'.
• Use Filter Builder — Toggle between visual filter builder (true) and raw OData $filter string (false).
• $filter (Raw) — Raw OData $filter expression when Use Filter Builder is false.
• Filter Conditions — Visual filter conditions (field, operator, value, type, logical operator) when Use Filter Builder is true.
• Custom Property Filters — Filter by custom field values (OtherProperties). Each filter includes Field ID, Value Property, Operator, Value, and whether the value is numeric.
• Navigation Property Filters — Filter by navigation properties (e.g., Lists, Tags). Supports 'Collection (any)' for one-to-many and 'Direct Navigation' for single-valued properties.
• Use Expand Builder — Toggle between visual expand builder (true) and raw OData $expand string (false).
• $expand (Raw) — Raw OData $expand expression when Use Expand Builder is false.
• Expand Relations — Visual expansion of related entities. Each expansion can specify nested $select, $filter, and $expand.
• Expand Nested Filters — Build nested $filter conditions for expanded properties (alternative to writing raw filter in expansions).

Output shape

Array of Tag objects (JSON). Each object contains the fields selected via $select (default: Id) and any expanded relations. When caching is used, items are annotated with _fromCache (and _fallback if served from cache after a request failure).

The node outputs three main arrays: success data, error data, and timeout data. On successful retrieval, the success array contains the Tag records.

Examples

Example 1: Get the first 10 Tag records, selecting Id and Name, sorted by Name ascending.

Set $top to 10, $skip to 0, $select to 'Id,Name', $orderby to 'Name asc'.

Example 2: Retrieve Tag records where the custom field with ID 5 (StringValue) equals 'VIP', using the visual filter builder.

Enable Use Filter Builder, add a Custom Property Filter with Field ID 5, Value Property 'StringValue', Operator 'eq', Value 'VIP'.

Links

• n8n community nodes installation guide