{
  "test_id": "ORCL.HCM.COREHR.STRUCTURE.LOCATION",
  "scenario_name": "Location",
  "application": "Oracle Fusion Cloud",
  "product": "HCM",
  "module": "Core HR",
  "process": "Workforce Structures",
  "business_flow": "Workforce Configuration",
  "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/workforce-structures/locations/",
  "objective": {
    "intro": "This test validates that a workforce location can be created and maintained in Oracle Fusion HCM with a correct code, name, country, address and effective date, and that the resulting location is available for use by departments, positions and worker assignments once active.",
    "confirms": [
      "the location is created with a unique location code and name",
      "country and address data are captured and formatted correctly for the selected country",
      "the effective date and status applied to the location are correct",
      "an existing location can be updated without breaking existing references from departments or assignments",
      "an inactivated location correctly restricts new usage while preserving existing historical references",
      "Oracle correctly enforces validation when data errors, configuration errors or security restrictions are introduced (DATA_ERROR, CONFIGURATION_ERROR, SECURITY_ERROR, EXPECTED_VALIDATION)"
    ],
    "scope_note": "This scenario covers creation and maintenance of a single workforce location in Oracle Fusion HCM Core HR TEST/UAT environments. It does not cover the department, grade or job structures that reference a location, which are covered by the separate Departments, Grades and related Workforce Structures scenarios in the same cluster."
  },
  "preconditions": [
    "A location structure is configured in the target Oracle Fusion HCM environment.",
    "The test user has appropriate Workforce Structures access to create and maintain locations.",
    "Country and state/province reference data required for the address is configured and active.",
    "Where the location will be referenced by a department or assignment test, the target department or assignment scenario is available.",
    "The location code used for the test is not already in use in the target environment."
  ],
  "test_data": [
    {
      "field": "Location Code",
      "example": "${LOCATION_CODE}"
    },
    {
      "field": "Location Name",
      "example": "${LOCATION_NAME}"
    },
    {
      "field": "Country",
      "example": "${COUNTRY}"
    },
    {
      "field": "Address Line 1",
      "example": "${ADDRESS_LINE_1}"
    },
    {
      "field": "City",
      "example": "${CITY}"
    },
    {
      "field": "State / Province",
      "example": "${STATE_PROVINCE}"
    },
    {
      "field": "Postal Code",
      "example": "${POSTAL_CODE}"
    },
    {
      "field": "Effective Date",
      "example": "${EFFECTIVE_DATE}"
    },
    {
      "field": "Status",
      "example": "${STATUS}"
    }
  ],
  "business_steps": [
    {
      "step_number": 1,
      "step_name": "Sign In and Navigate to Workforce Structures",
      "action": "Sign in to Oracle Fusion Cloud with a user account that has Workforce Structures access and navigate to the Workforce Structures work area.",
      "test_data": "",
      "expected_result": "The Workforce Structures work area opens successfully.",
      "validation_type": "action"
    },
    {
      "step_number": 2,
      "step_name": "Initiate Create or Update Location",
      "action": "Open the Locations page and either start creating a new location or select an existing location and choose Update.",
      "test_data": "${LOCATION_CODE}",
      "expected_result": "The location entry page opens, ready for input.",
      "validation_type": "action"
    },
    {
      "step_number": 3,
      "step_name": "Enter Location Code and Name",
      "action": "Enter the location code and location name for the new or updated location.",
      "test_data": "${LOCATION_CODE} / ${LOCATION_NAME}",
      "expected_result": "The location code and name are accepted, and the code is confirmed unique.",
      "validation_type": "action"
    },
    {
      "step_number": 4,
      "step_name": "Enter Country and Address",
      "action": "Select the country and enter the address lines, city, state/province and postal code for the location.",
      "test_data": "${COUNTRY} / ${ADDRESS_LINE_1} / ${CITY} / ${STATE_PROVINCE} / ${POSTAL_CODE}",
      "expected_result": "The address details are accepted according to the selected country's formatting rules, without unexpected validation errors.",
      "validation_type": "action"
    },
    {
      "step_number": 5,
      "step_name": "Set Effective Date and Status",
      "action": "Set the date the location becomes effective and set the location status.",
      "test_data": "${EFFECTIVE_DATE} / ${STATUS}",
      "expected_result": "The effective date and status are accepted and applied to the location record.",
      "validation_type": "action"
    },
    {
      "step_number": 6,
      "step_name": "Review Location Details",
      "action": "Review the entered location code, name, country, address, effective date and status before submitting.",
      "test_data": "",
      "expected_result": "All entered location details display correctly for review.",
      "validation_type": "action",
      "note": "Reviewing the location before saving lets the tester catch an incorrect field entry before the location is created."
    },
    {
      "step_number": 7,
      "step_name": "Submit and Verify Location Available for Assignment",
      "action": "Submit the location and confirm it can be selected from the location list of values in a department or worker assignment.",
      "test_data": "",
      "expected_result": "The location is saved with the correct code, name, country, address, effective date and status, and is available for selection wherever active locations are used.",
      "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 location must be retrievable and selectable in downstream Workforce Structures usage."
    }
  ],
  "expected_results": [
    "The location is created or updated with a unique location code and name.",
    "Country and address data are recorded correctly per the applicable country address format.",
    "The effective date applied to the location is correct.",
    "The location status (active or inactive) is applied correctly.",
    "The location is available for selection in department, position and worker assignment setup where active.",
    "Inactivating a location restricts new usage while historical references remain intact."
  ],
  "validation_checkpoints": [
    "Location created correctly.",
    "Address correct.",
    "Country correct.",
    "Effective dates correct.",
    "Status correct.",
    "Available for worker assignment where active."
  ]
}