Skip to content
D
Documentation

Reference category question units

reference
7 min readUpdated

Reference category question units

A reference category question-unit entry connects one Reference list category and one of that category's questions to one or more units. Use this page when a question needs unit data that you maintain separately from the category and question definitions.

Open Configuration, then Reference list, to maintain these entries. The list uses Category and Question as its visible columns.

If you need to…Go to
Check the current entries and available actionsFind and review the list
Check required fields and conditional surfacesUnderstand the fields and rules
Add or change a category question's unitsAdd or edit an entry
Remove an entry or understand why an action is unavailableDelete an entry and handle availability
Review the categories and questions used hereReference categories
Open another Reference list configuration surfaceSerial Status
Return to the configuration entry pointConfiguration dashboard

Before you start

This page maintains reference data: entries that support other configuration records. The list and its maintenance actions depend on your account access, subscription, existing records, and the reference data available to select.

Prerequisites

  • Sign in before opening the configuration area.
  • Use a subscription that includes this feature. If the subscription excludes it, an upgrade surface replaces the list.
  • Have a saved entry before opening it for editing.
  • Confirm that the action you need is available for your account. New, row edit, and row delete appear only when your access permits them.
  • Know the category and question you need to connect. Category options come from the reference-category service, and Category qustion options come from the selected category's questions.

The available category and question values depend on the reference data in your environment. Select the category before choosing the question so that the question choices correspond to it.

Find and review the list

Use this procedure to open the question-unit list and identify its records and controls.

Prerequisites

  • You are signed in.
  • Your subscription includes the Reference list feature.
  • You have access to the Configuration area.

Steps

  1. Open Configuration.

  2. Open Reference list.

  3. Open Categories question unit.

    Identify the Category and Question columns, the Count: 4 record count, and the list actions.
  4. Check the list headers.

    What you need to recognizeWhat appears
    Category columnCategory
    Question columnQuestion
    Current record countCount: 4
    Create actionNew
    Refresh actionRefresh
    List settings actionSettings
  5. Select New to open the new-item popup when it is available.

  6. Select the available action for the task you need.

    If you need to…Select…Result
    Export the listExportExport options open.
    Edit a saved rowThe row's edit actionThe row opens for editing.
    Delete a saved rowThe row's delete iconA confirmation prompt opens.

Result: You can identify the Category and Question columns, the current count, and the actions shown on the page.

Understand the fields and rules

A question-unit row shows its selected category and question in the list. Its unit values are maintained in the new/edit form. The fields and list columns are described below.

SurfaceField or controlRule or visibility
Entry formCategoryRequired. Its options come from the available reference categories.
Entry formCategory qustionRequired. Its options depend on the selected category's questions.
ListCategoryOptional text column.
ListQuestionOptional text column.
Entry formCategory questions unitRequired collection.
Unit rowUnitRequired for each unit row.
Unit listAdd moreAdds another unit row.

The Category and Category qustion selectors appear in the popup for a new or existing entry. Log history appears only while editing an identified item. Other columns and labels depend on your list configuration, so use the headers visible on your screen. Unit values appear in the form rather than in the list.

Add or edit an entry

Use a question-unit entry to associate a selected category and question with one or more units. The new form prepares one unit entry; additional rows let you maintain more units for the same category-question connection. The next section explains how to remove an entry if it is no longer needed.

Prerequisites

  • The question-unit list is open.
  • New is available for a new entry, or a saved row and edit access are available for an edit.
  • You know which category and question to connect.

Steps

  1. Select New, or select the edit action for a saved item to open it in edit mode.

    If you need to…Select…
    Prepare a new itemNew
    Change a saved itemThe row's edit action
  2. In Category, select the category for the entry.

  3. In Category qustion, select the question belonging to the selected category.

  4. In Category questions unit, maintain the unit rows.

  5. In each Unit row, enter the unit value.

  6. Choose the action that matches the state of the entry.

    If you need to…Select…
    Add another unit rowAdd more
    If you are ready to commitOK
    Close without committingCancel

The New Question unit popup shows required Category, Category qustion, and Category questions unit fields. The Unit rows appear for the selected question.

Result: The new or selected question-unit item is submitted through the shared popup, or the popup closes when you select Cancel. A successful new entry uses Data saved Successfully; an update uses Data updated Successfully.

Delete an entry and handle availability

Deleting removes the selected question-unit row after confirmation. The action can be hidden by permissions, replaced by an upgrade surface, refused because related saved data exists, or blocked when at least one item must remain.

IfThen
Your access permits deletionThe delete action is available for a row.
Your access does not permit deletionThe delete action is unavailable.
The subscription excludes the featureAn upgrade surface replaces the list.
Related saved data uses the rowDeletion can be refused.
Deleting would leave no itemsThe minimum-item guard blocks deletion.

Prerequisites

  • The list is available.
  • A row is selected.
  • Delete access is available.

Steps

  1. Select the delete action for the entry you want to remove.

  2. Read the confirmation prompt: Are you sure you want to delete this item?

  3. Choose the action that matches your decision.

    If you want to…Select…
    Close the confirmation without deleting the rowCancel
    Confirm removalDelete
    If the screen shows…Then…
    Related to Saved data, Can't be deletedKeep the row and resolve the relationship in its owning configuration.
    Must have at least one itemKeep at least one row.

Result: After confirmation, the selected row is deleted and the success message is Data Deleted Successfully. If your access or subscription removes the action, the delete action does not appear.

When saving or deleting goes wrong

Use the exact message on screen to identify whether the form needs a required value, an accepted character, or a deletion condition to be addressed. After resolving it, continue with the maintenance procedure above.

MessageCondition or action
RequiredA required unit collection value is empty. Enter the missing Unit value.
This Field Is RequiredA required field is empty. Complete the missing field.
Just '_' '-' And '.' Characters AcceptedThe value does not meet the accepted character pattern. Replace it with an accepted value.
Forbidden characters detected. Please remove them and try again.A filter value contains a forbidden character. Remove it and submit the filter again.
Related to Saved data, Can't be deletedRelated saved data prevents deletion. Keep the row and resolve the relationship in its owning configuration.
Failed to DeleteThe deletion did not complete. Keep the row and check that delete access is available before retrying.
Must have at least one itemThe list cannot be reduced below one item. Keep at least one row.
As a developer, you may have greater privileges to change one or more item.Your account has elevated maintenance privileges. Follow your organisation's access rules when changing an item.

After maintaining the list

Review the question-unit list after a maintenance action to confirm the category-question unit entries.

ActionDeclared result
Create an entryData saved Successfully
Update an entryData updated Successfully
Delete an entryData Deleted Successfully

The current page remains the question-unit maintenance surface after the action. Use the list shown there to review the records available after the action.

For the categories and questions used by this page, open Reference categories. For another shared Reference list surface, open Serial Status. To return to the configuration entry point, open Configuration dashboard.

Was this page helpful?

Need help using the product?