Ivanti icon

Ivanti

Interact with Ivanti API
Join our community

Actions42

Overview

The Ivanti node for n8n allows you to interact with the Ivanti API, specifically targeting custom business objects. The Get Many operation retrieves multiple records from a specified custom business object, supporting advanced filtering, sorting, and field selection via OData query parameters. This is useful for scenarios where you need to extract lists of records, perform reporting, or integrate Ivanti data into other workflows.

Practical examples:

  • Fetching all open tickets from a custom business object for monitoring.
  • Exporting selected fields from a business object for analytics.
  • Paginating through large datasets in Ivanti for batch processing.

Properties

Name Meaning
Business Object Name The name or ID of the custom business object to query. Required.
Limit Max number of results to return (1–100). Controls pagination size.
Send Sort Parameters Whether to include sorting options in the request. If enabled, exposes the "Sort" property.
Sort Sorting options (shown if "Send Sort Parameters" is true):
• Sort Key Name or ID: Choose between "Creation Time" or "Last Modification Time".
• Sort Order: Ascending or Descending.
Query Parameters Additional OData query parameters:
• Result Filter: Expression to filter results (e.g., Status eq 'Open').
• Select Fields: Comma-separated list of fields to include.
• Skip Records: Number of records to skip (for pagination).

Output

The output is an array of JSON objects, each representing a record from the specified custom business object. The structure of each object depends on the fields selected and the schema of the business object. Typical fields may include identifiers, timestamps, and any custom fields defined in your Ivanti instance.

Example output:

[
  {
    "RecId": "12345",
    "CreatedDateTime": "2024-06-01T12:34:56Z",
    "LastModDateTime": "2024-06-05T09:21:00Z",
    "...": "..."
  },
  ...
]

Note: The actual fields depend on your "Select Fields" input and the business object schema.

Dependencies

  • External Service: Requires access to the Ivanti API endpoint.
  • Credentials: Must configure the IvantiApi credential in n8n, including the base URL (baseUrl) and authentication details.
  • n8n Configuration: No special environment variables required beyond standard credential setup.

Troubleshooting

Common issues:

  • Invalid Business Object Name: If the provided name/ID does not exist, the API will return an error. Double-check the spelling and existence of the business object.
  • Authentication Errors: Ensure that the IvantiApi credentials are correctly configured and have sufficient permissions.
  • OData Query Errors: Malformed filter or select expressions can cause errors. Refer to OData query documentation for correct syntax.
  • Limit Exceeded: Setting "Limit" above 100 will result in an error due to the enforced maximum.

Error messages and resolutions:

  • "Resource not found": Check the business object name.
  • "Unauthorized": Verify credentials and permissions.
  • "Invalid query parameter": Review filter/select/sort expressions for typos or invalid field names.

Links and References

Discussion