How to use the HP OO plugin

Trigger, poll, and lifecycle-manage HP Operations Orchestration (OpenText OO) executions from Kestra flows.

Authentication

All tasks require host (the base HTTPS endpoint including port, e.g. https://oo.company.com: 8443, required) and apiMode (default CLASSIC). Authentication fields depend on the mode:

CLASSIC: Uses REST v2 with HTTP Basic Auth — set username and password.

CONTAINERIZED: Uses REST v1 with token auth — set tenantId and token (sent as X-Auth-Token).

Optionally set options for HTTP client configuration (timeouts, proxy, SSL). Store secrets in secrets and apply connection properties globally with plugin defaults.

Tasks

executions.Run triggers a flow and optionally polls for completion — set flowUuid (required). Set wait (default true) to poll; when polling, optionally set timeout (default PT1H) and pollInterval (default PT10S). Set failOnError (default true) to fail the task on execution error, and fetchLogs (default false) to include step logs in the output. Pass flow inputs via inputs (a map of key/value pairs) and mark sensitive inputs with sensitiveInputs. Outputs executionId, status, resultStatusType, resultStatusName, startTime, endTime, outputs, and flowVars.

executions.Get fetches execution summaries by ID — set executionIds (required list of one or more IDs). Outputs executions as a list of execution summaries.

executions.List returns a paginated list of executions. All fields are optional: filter by flowPath, status, owner, runName, executionId, flowUuid, startedAfter, or startedBefore (Unix epoch millis), and control pagination with pageNum and pageSize. Outputs executions (CLASSIC mode), uri (stored response — JSON in CLASSIC, CSV in CONTAINERIZED), and count.

executions.Cancel, executions.Pause, and executions.Resume change the state of one or more executions — set executionIds (required list). Set failOnFailure (default true) to fail the task if any status change fails. Resume additionally accepts branchId (branch to resume; omit for the root branch) and inputBinding (inputs for resumed input-required pauses). All three output results as a list of per-execution outcomes.