Common Code
How to use Common Code in Shared Reference Data: access, working steps, fields, related records and troubleshooting.
Purpose and access
Maintain approved reference lists and directory relationships. For locations, select country, region and city from the directory. For classifications, preserve the parent-child hierarchy and code identifiers.
This page is a record page in System Admin → Shared Reference Data. Use the link above to open the configured destination; permissions are checked by the destination service.
Before you start
Prepare the required information: Code List, Title, Common Code.
Confirm the company, party, dates, units and source references that apply. Select existing links carefully and check for an existing record before creating a duplicate.
Working steps
- Open Common Code from System Admin → Shared Reference Data, or use ERP Search.
- Filter the list and open the relevant record. To add a record, use Add/New when your role provides that action.
- Complete the editable fields described below. Required fields and validation conditions must be satisfied; read-only values are set by the system or their source records.
- Add the required child rows. Review each row’s identifiers, linked records and values, using the child-table field reference below.
- Save the record and address validation messages. Reload and verify the saved values and relationships.
- Use any additional workflow actions only when the record and your role provide them. Saving this record does not automatically complete a related transaction or external action.
Field reference
These fields come from the installed ERP definition. Hidden fields and password inputs are omitted. Additional conditions, custom scripts and workflow rules can make a field required or read-only in a particular context.
| Field | Type / behavior | How to use it |
|---|---|---|
Code Listcode_list | Link Required | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: Code List |
Canonical URIcanonical_uri | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Titletitle | Data Required | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Common Codecommon_code | Data Required | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Descriptiondescription | Small Text Optional | Provide concise contextual information relevant to the record. Avoid unrelated personal or confidential data. |
Additional Dataadditional_data | Code Optional · Read-only | Administrator/integration field. Use a validated configuration or supported script and test its impact before deployment. |
Applies Toapplies_to | Table Optional | Add the relevant child rows and review required columns, quantities and references before saving. Linked record: Dynamic Link |
Child tables
Applies To — child-row fields
| Field | Type / behavior | How to use it |
|---|---|---|
Link Document Typelink_doctype | Link Required | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: DocType |
Link Namelink_name | Dynamic Link Required | Select the record identified by the associated document-type field. Verify both the type and the linked record. |
Link Titlelink_title | Read Only Optional · Read-only | System-provided value; correct its source record or calculation rather than overwriting the displayed result. |
Troubleshooting
- Not permitted: verify the account, role and source-document permission. Do not share an administrator login.
- Missing record or address: inspect the relevant Link or Dynamic Link fields; a matching title alone does not establish a relationship.
- Cannot save or change status: review required fields, read-only values, document status and the configured approval transition.
- Unexpected report or portal result: review company/date filters, source-document submission and the approved party or Employee link.