Kallidus

Use this Node to query curated Kallidus Learning Progress reporting datasets from Flowgear.

Revision History

0.0.0.1 - Initial release.

Connection

Use this Connection to store the OAuth and tenant settings required for Kallidus reporting requests.

Property Type Description
Tenant Host String Kallidus tenant host only, without protocol, path, or port. For example, use product.kallidus-suite.com or a full custom host such as www.acme.com.
Client ID String OAuth client identifier issued for the Kallidus Data Extraction API.
Client Secret Masked OAuth client secret issued for the Kallidus Data Extraction API.
Scope String Exact OAuth scope string issued during Kallidus onboarding.
Timeout (seconds) Integer Request timeout used for token and reporting calls.
Access Token Masked Cached bearer token used for reporting calls. This value is managed by the runtime after authentication succeeds.
Access Token Expires At UTC String Cached UTC expiry timestamp for the current bearer token. This value is managed by the runtime.

Setup Notes

  • Contact your Kallidus Customer Experience Manager to procure Data Extraction API access and receive your Client ID, Client Secret, and API-specific Scope.
  • Enter only the tenant host in Tenant Host. For standard tenants, use the Kallidus host name such as product.kallidus-suite.com. For custom tenants, use the full custom host such as www.acme.com.
  • The Node uses OAuth 2.0 client credentials and requests tokens from /identity/connect/token. Reporting requests send X-Kallidus-tenant automatically. Token requests do not include that header.
  • The Kallidus Data Extraction API is currently published by Kallidus as a beta API.
  • This Node is Early Access. Live tenant validation is still pending.

Methods

The Node exposes one template-driven query method for the supported Kallidus reporting datasets.

Query

Select a template to query one supported Kallidus Learning Progress dataset. The current Early Access surface supports Users, User Groups, User-Group Relationships, User-Job Profile Relationships, Job Profiles, Courses, Lessons, Days, Course Statuses, Lesson Statuses, Compliance Statuses, Compliance Status Commentaries, Compliance Summaries, and Compliance Details.

Parameter Type Description
Connection Connection Kallidus connection profile.
OperationId String Template-selected identifier for the reporting dataset you want to query.
Options Object Optional typed input object for the selected template. The Early Access templates keep transport details such as raw paging controls hidden from the Workflow designer.
Return Type Description
Response Array One row per record returned by the selected dataset. The Node unwraps the provider value array and does not emit the transport envelope as a row.

Usage Notes

  • Pagination is handled internally. You do not need to manage continuation links or $skip values in the Workflow.
  • Successful empty datasets emit zero rows.
  • Each emitted row includes the normalized fields httpStatusCode, providerType, providerTitle, providerInstance, and operationId in addition to the dataset fields returned by Kallidus.
  • The current Early Access surface is fixed to the 14 curated Learning Progress datasets exposed through the Query templates.
  • Kallidus publishes two DEx API rate limits: token requests and the first 10,000 reporting records run at 100 calls per minute, while reporting pages beyond the first 10,000 records are limited to one call per day per page and reset at midnight UTC.