{
  "test_id": "ORCL.HCM.COREHR.PERSON.ADDRESS",
  "scenario_name": "Manage Address",
  "application": "Oracle Fusion Cloud",
  "product": "HCM",
  "module": "Core HR",
  "process": "Person Management",
  "business_flow": "Employee Lifecycle",
  "scenario_type": "Positive / Functional",
  "priority": "High",
  "automation_status": "SyntraFlow Ready",
  "library": "Syntra Standard",
  "canonical_url": "https://www.syntraflow.cloud/oracle-erp-testing-tool/test-library/hcm/core-hr/person-management/manage-address/",
  "objective": {
    "intro": "This test validates that Oracle Fusion HCM correctly creates, updates and effective-dates a worker's address, applying the address type, country and state validation rules configured for that worker's legislation.",
    "confirms": [
      "a new address is added to the worker record with the correct address type and effective date",
      "an existing address can be updated and the prior version is retained in address history",
      "country and state/province reference data drive the fields required and the formatting expected",
      "the primary address indicator is correctly applied where the customer allows more than one active address",
      "future-dated address changes take effect on the correct date without disturbing the current address",
      "the rest of the worker's person record is unaffected by the address change"
    ],
    "scope_note": "This scenario validates address maintenance for an existing worker record. Adding a worker for the first time, updating other person information and managing national identifiers are covered by separate test scenarios."
  },
  "preconditions": [
    "The worker record exists in Oracle Fusion HCM and is in an active status.",
    "The address type used for the test is configured for the worker's legislation.",
    "Country and state/province reference data is available and configured.",
    "The test user has the appropriate Person Management role and access to maintain worker addresses.",
    "Employee self-service address maintenance is enabled where that variation is being tested."
  ],
  "test_data": [
    {
      "field": "Person Number",
      "example": "${PERSON_NUMBER}"
    },
    {
      "field": "Address Type",
      "example": "${ADDRESS_TYPE}"
    },
    {
      "field": "Country",
      "example": "${COUNTRY}"
    },
    {
      "field": "Effective Date",
      "example": "${EFFECTIVE_DATE}"
    },
    {
      "field": "Address Line 1",
      "example": "${ADDRESS_LINE_1}"
    },
    {
      "field": "Address Line 2",
      "example": "${ADDRESS_LINE_2}"
    },
    {
      "field": "City",
      "example": "${CITY}"
    },
    {
      "field": "State / Province",
      "example": "${STATE_PROVINCE}"
    },
    {
      "field": "Postal Code",
      "example": "${POSTAL_CODE}"
    },
    {
      "field": "Primary Indicator",
      "example": "${PRIMARY_INDICATOR}"
    }
  ],
  "business_steps": [
    {
      "step_number": 1,
      "step_name": "Sign In to Oracle Fusion",
      "action": "Sign in to Oracle Fusion Cloud with a user account that has Person Management address maintenance access.",
      "test_data": "",
      "expected_result": "The Oracle Fusion Cloud home page loads successfully for the authenticated user.",
      "validation_type": "action"
    },
    {
      "step_number": 2,
      "step_name": "Navigate to Person Management",
      "action": "Navigate to the Person Management work area used to maintain worker personal information.",
      "test_data": "",
      "expected_result": "The Person Management work area opens successfully.",
      "validation_type": "action"
    },
    {
      "step_number": 3,
      "step_name": "Locate the Worker Record",
      "action": "Search for and open the target worker's record using the worker's person number.",
      "test_data": "${PERSON_NUMBER}",
      "expected_result": "The correct worker record opens and is confirmed active.",
      "validation_type": "action"
    },
    {
      "step_number": 4,
      "step_name": "Select Add or Update Address",
      "action": "Start the Add Address action for a new address, or select an existing address and choose Update.",
      "test_data": "${ADDRESS_TYPE}",
      "expected_result": "The address entry page opens, ready for input.",
      "validation_type": "action"
    },
    {
      "step_number": 5,
      "step_name": "Enter Address Details and Country",
      "action": "Enter the address lines, city, state/province and postal code for the selected country.",
      "test_data": "${COUNTRY} / ${ADDRESS_LINE_1} / ${ADDRESS_LINE_2} / ${CITY} / ${STATE_PROVINCE} / ${POSTAL_CODE}",
      "expected_result": "The address details are accepted according to the country's formatting rules, without validation errors.",
      "validation_type": "action"
    },
    {
      "step_number": 6,
      "step_name": "Set Effective Date and Primary Flag",
      "action": "Set the date the address change takes effect and, where more than one address is allowed, set the primary address indicator.",
      "test_data": "${EFFECTIVE_DATE} / ${PRIMARY_INDICATOR}",
      "expected_result": "The effective date and primary indicator are accepted and applied to the address record.",
      "validation_type": "action"
    },
    {
      "step_number": 7,
      "step_name": "Review Address Details",
      "action": "Review the entered address, country, effective date and primary indicator before submitting.",
      "test_data": "",
      "expected_result": "All entered address details display correctly for review.",
      "validation_type": "action"
    },
    {
      "step_number": 8,
      "step_name": "Submit and Verify Address Saved",
      "action": "Submit the address change and retrieve the resulting address record and history.",
      "test_data": "",
      "expected_result": "The address is saved with the correct country, effective date and primary indicator, and the prior address version, if any, is retained in address history.",
      "validation_type": "business_assertion",
      "note": "This is the main business assertion for the scenario — the test does not stop merely because the save action succeeded; the resulting address record must be retrievable with the correct effective-dated history."
    }
  ],
  "expected_results": [
    "A worker address is created or updated successfully using valid country, state/province and postal data.",
    "The address is correctly associated with the worker's person record.",
    "The country recorded on the address matches the value entered.",
    "The effective date applied to the address change is correct.",
    "The prior address version is retained in address history when an existing address is updated.",
    "The primary address indicator reflects the value entered, where more than one active address is allowed."
  ],
  "validation_checkpoints": [
    "Address saved correctly.",
    "Correct country recorded.",
    "Effective date correct.",
    "Prior address retained in history.",
    "Primary indicator correct.",
    "Person record otherwise unchanged."
  ]
}