Oracle EBS Employee Profile Update

arazzo: 1.0.1
info:
  title: Oracle EBS Employee Profile Update
  summary: Find an employee by number, read the record, then date-tracked update their details.
  description: >-
    An Oracle HRMS maintenance flow. The workflow searches for an employee by
    employee number, reads the full record by person identifier, and submits a
    date-tracked correction to contact details. Each step inlines its request
    so the profile update can be executed without opening the OpenAPI source.
  version: 1.0.0
  x-realizes-capability-ids:
  - 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.70
      capability_name: HR Operations Management
      spec: oracle-e-business-suite-employee-management-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: employeeManagementApi
  url: ../openapi/oracle-e-business-suite-employee-management-api-openapi.yml
  type: openapi
workflows:
- workflowId: update-employee-profile
  summary: Locate an employee and apply a date-tracked profile correction.
  description: >-
    Searches for an employee by employee number, reads the record by person
    identifier, and submits a date-tracked correction updating email and
    marital status.
  inputs:
    type: object
    required:
    - employeeNumber
    - effectiveDate
    - emailAddress
    - maritalStatus
    properties:
      employeeNumber:
        type: string
        description: Employee number to locate.
      effectiveDate:
        type: string
        description: Effective date for the date-tracked update in YYYY-MM-DD format.
      emailAddress:
        type: string
        description: New email address.
      maritalStatus:
        type: string
        description: New marital status.
  steps:
  - stepId: findEmployee
    description: >-
      Search for the employee by employee number, returning the first match.
    operationId: getEmployees
    parameters:
    - name: employeeNumber
      in: query
      value: $inputs.employeeNumber
    - name: limit
      in: query
      value: 1
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      personId: $response.body#/items/0/personId
  - stepId: readEmployee
    description: >-
      Read the employee record by person identifier to capture the current
      values before applying the correction.
    operationId: getEmployeeById
    parameters:
    - name: personId
      in: path
      value: $steps.findEmployee.outputs.personId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      currentEmail: $response.body#/emailAddress
  - stepId: applyUpdate
    description: >-
      Submit a date-tracked correction updating the employee email and marital
      status as of the effective date.
    operationId: updateEmployee
    parameters:
    - name: personId
      in: path
      value: $steps.findEmployee.outputs.personId
    requestBody:
      contentType: application/json
      payload:
        effectiveDate: $inputs.effectiveDate
        dateTrackUpdateMode: CORRECTION
        emailAddress: $inputs.emailAddress
        maritalStatus: $inputs.maritalStatus
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      updatedEmail: $response.body#/emailAddress
      lastUpdateDate: $response.body#/lastUpdateDate
  outputs:
    personId: $steps.findEmployee.outputs.personId
    previousEmail: $steps.readEmployee.outputs.currentEmail
    updatedEmail: $steps.applyUpdate.outputs.updatedEmail