IvantiInstall

Overview

The Ivanti node for n8n allows you to interact with the Ivanti API, specifically targeting various business objects such as Employees. The Employee → Get Count operation retrieves the number of employee records that match specified criteria. This is useful in scenarios where you need to determine how many employees meet certain conditions (e.g., active status) without retrieving all their details.

Practical examples:

• Counting all active employees in your organization.
• Determining how many employees belong to a specific department.
• Integrating with HR dashboards to display real-time employee counts based on dynamic filters.

Properties

Output

The output will be a JSON object containing the count of employee records matching the provided filter. The structure typically looks like:

{
  "count": <number>
}

• count: The total number of employees matching the filter criteria.

Dependencies

• External Service: Requires access to an Ivanti instance with API enabled.
• API Credentials: Needs valid Ivanti API credentials configured in n8n under the name IvantiApi.
• Environment Variables: The base URL for the Ivanti API must be set in the credentials (baseUrl).

Troubleshooting

Common Issues:

• Invalid Credentials: If the API credentials are incorrect or missing, authentication errors will occur.
• Malformed Filter Expressions: Incorrect OData filter syntax in the "Result Filter" property can cause the API to return errors.
• Network/SSL Issues: If the Ivanti server uses self-signed certificates, ensure SSL validation settings are compatible.

Error Messages and Resolutions:

• 401 Unauthorized: Check your API credentials and permissions.
• 400 Bad Request: Review your filter expression for syntax errors.
• Connection Errors: Verify the base URL and network connectivity to the Ivanti server.

Links and References

• Ivanti OData Query Documentation
• n8n Documentation: Credentials
• OData Filter Syntax Reference