Workday Explore Supervisory Organization

arazzo: 1.0.1
info:
  title: Workday Explore Supervisory Organization
  summary: Search supervisory organizations, load the first match's detail, and list its workers.
  description: >-
    An organization discovery flow. It searches supervisory organizations by
    name and branches on whether a match was found: when at least one matches it
    loads the organization detail and then lists the workers in the directory,
    and when nothing matches it ends. Every step spells out its request inline
    so the flow can be read and executed without opening the underlying OpenAPI
    description.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-300
  - BC-300.70
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-300
      capability_name: Human Capital Management
      spec: workday-organizations-api-openapi.yml
      confidence: 0.7
    - capability_id: BC-300.70
      capability_name: HR Operations Management
      spec: workday-workers-api-openapi.yml
      confidence: 0.85
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: organizationsApi
  url: ../openapi/workday-organizations-api-openapi.yml
  type: openapi
- name: workersApi
  url: ../openapi/workday-workers-api-openapi.yml
  type: openapi
workflows:
- workflowId: explore-supervisory-org
  summary: Search supervisory orgs, load the first match, then list workers.
  description: >-
    Searches supervisory organizations by name, then branches: if an
    organization matched it loads its detail and lists the worker directory,
    otherwise it ends.
  inputs:
    type: object
    required:
    - authorization
    - search
    properties:
      authorization:
        type: string
        description: OAuth2 bearer token, e.g. "Bearer eyJ...".
      search:
        type: string
        description: The name to search supervisory organizations by.
  steps:
  - stepId: searchOrgs
    description: Search supervisory organizations by name.
    operationId: getSupervisoryOrganizations
    parameters:
    - name: Authorization
      in: header
      value: $inputs.authorization
    - name: search
      in: query
      value: $inputs.search
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      matchedOrgId: $response.body#/data/0/id
    onSuccess:
    - name: orgFound
      type: goto
      stepId: getOrgDetail
      criteria:
      - context: $response.body
        condition: $.data.length > 0
        type: jsonpath
    - name: noOrg
      type: end
      criteria:
      - context: $response.body
        condition: $.data.length == 0
        type: jsonpath
  - stepId: getOrgDetail
    description: Load the detail record for the first matched organization.
    operationId: getSupervisoryOrganizationById
    parameters:
    - name: Authorization
      in: header
      value: $inputs.authorization
    - name: ID
      in: path
      value: $steps.searchOrgs.outputs.matchedOrgId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      orgDescriptor: $response.body#/descriptor
  - stepId: listWorkers
    description: List the worker directory, used to enumerate members of the organization.
    operationId: getWorkers
    parameters:
    - name: Authorization
      in: header
      value: $inputs.authorization
    - name: limit
      in: query
      value: 100
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      workers: $response.body#/data
      total: $response.body#/total
  outputs:
    matchedOrgId: $steps.searchOrgs.outputs.matchedOrgId
    orgDescriptor: $steps.getOrgDetail.outputs.orgDescriptor
    workers: $steps.listWorkers.outputs.workers