Reference

operations: manifest queries

Package Trax.Api.GraphQL·Surface GraphQL schema·Source OperationsQueries.cs

Fields of OperationsQueries that read scheduler manifests. Manifest groups are under operations.manifestGroups.

manifests

Returns a paginated list of scheduler manifests, ordered by ID descending (newest first). Supports both offset-based and keyset cursor pagination.

query {
  operations {
    manifests(skip: 0, take: 10) {
      items {
        id
        externalId
        name
        isEnabled
        scheduleType
        cronExpression
        intervalSeconds
        maxRetries
        timeoutSeconds
        lastSuccessfulRun
        manifestGroupId
        dependsOnManifestId
        priority
      }
      totalCount
      isEstimatedCount
      skip
      take
      nextCursor
    }
  }
}

Returns: PagedResult<ManifestSummary>

ManifestSummary fields

| scheduleText | String! | The schedule in plain words: Daily at 02:00 UTC, Every 5 minutes, After nightly-import succeeds, On demand. A cron with no plain reading is shown as itself, in UTC | | nextRuns(count: Int! = 5) | [DateTime!]! | The next times the scheduler will run the manifest, earliest first, in UTC; count is clamped to 0 through 10. See When a manifest runs next |

When a manifest runs next

nextRuns and scheduleText read IOperationsService.GetUpcomingRunsAsync, which asks the manifest manager's own due-ness check, so the times are the ones the manager will act on: exclusion windows are skipped as the manager skips them (under the default FIRE_ONCE_NOW misfire policy, one catch-up run as the window ends), and each run is assumed to succeed when it is due. The first time is now when the manifest is due already. The list is empty for a manual, on-demand, dependent or dormant dependent manifest, where scheduleText says what starts it, and for a manifest that is disabled, in a disabled group, or has a dead letter awaiting intervention. Every manifest a request shows is read in one batch, so a full page costs one query.

query {
  operations {
    manifests(take: 25) {
      items { id scheduleText nextRuns(count: 3) }
    }
  }
}

A manifest's properties (the train input it runs with) are not on this type. Read them from manifestDetail, one manifest at a time.

manifestDetail

Returns one manifest by database ID: every ManifestSummary field, plus the train input the manifest runs with and the rest of its scheduling settings. It backs the manifest detail page.

query {
  operations {
    manifestDetail(id: 42) {
      id
      name
      manifestGroupName
      propertyTypeName
      properties
      misfirePolicy
      misfireThresholdSeconds
      scheduledAt
      nextScheduledRun
      varianceSeconds
    }
  }
}

Returns: ManifestDetail (nullable, returns null if the ID does not exist). It carries every ManifestSummary field (with manifestGroupName non-null) and:

manifestStats

Execution roll-up for a single manifest: run counts by state plus the most recent run and most recent successful run. Backs the summary cards on the dashboard's manifest detail page, through the same IOperationsService.GetManifestExecutionStatsAsync call. A manifest with no runs, or an id with no manifest, gets zeros and nulls. Served index-only by ix_metadata_manifest_state, so it stays fast on a manifest with a long history.

query {
  operations {
    manifestStats(manifestId: 42) {
      manifestId
      total
      completed
      failed
      inProgress
      pending
      cancelled
      lastRun
      lastSuccessfulRun
    }
  }
}

Returns: ManifestExecutionStats! (never null; a manifest with no runs returns all-zero counts and null timestamps).

ManifestExecutionStats fields

manifestExclusions

The schedule exclusion windows configured on a manifest: the days, dates, ranges, or daily time windows during which it is intentionally skipped (not treated as a misfire). Backs the exclusions panel on the manifest detail page. The model is flat and discriminated: type selects which of the other fields apply.

query {
  operations {
    manifestExclusions(manifestId: 42) {
      type
      daysOfWeek
      dates
      startDate
      endDate
      startTime
      endTime
    }
  }
}

Returns: [ManifestExclusion!]! (empty when the manifest has no exclusions or does not exist).

ManifestExclusion fields

See also

• Queries
• operations: manifest mutations
• PagedResult