Reference list overview
A reference is a saved record of an installed product, identified by information such as its serial number, parties, dates, category, and application. The Reference list is where you locate and export these records. A saved reference record is where you enter, change, print, check, and review one reference.
| If you need to… | Go to |
|---|---|
| Find a saved reference or start from the list | Find and open a reference |
| Understand the record before entering values | Understand the reference record |
| Enter or change reference details | Reference information |
| Save a new or changed reference | Create or update a reference |
| Review a saved reference | Review a saved reference |
| Maintain categories and questions used by references | Reference categories |
| Maintain units for reference questions | Reference category question units |
| Review registered serial statuses | Reference serial status |
| Continue with the owning sales-job record | Sales job record |
Before you start
The Reference list can appear as a tab in a saved sales job, and its record form can also be opened from the Reference list page. Before you begin, have the saved record or product context you need, the reference information to enter, and access to the feature.
Prerequisites
- Use a saved sales job when you are reaching the Reference list from the job workspace.
- Make sure the Reference list feature is included in the subscription.
- Have the product, serial number, manufacturer, vendor, client, end user, dates, category, and application information available for the reference you are entering or reviewing.
- Check the fields that your company configuration makes required before you start. The six fields required by the displayed form are Serial Number, Manufacturer, Vendor, Client, End User, and Category. Other fields can be required by configuration.
The available record areas depend on whether the record is saved and which features are available. Check-up is available for a saved record. Last Modifications is available for a saved record when the latest-modifications feature is included.
Find and open a reference
Use the Reference list to locate saved references, inspect the columns currently shown for your list, open a record, or start a new record from Product.
Prerequisites
- You are signed in.
- You have a saved sales job if the Reference list is reached from the job workspace.
- To start a new reference, Product is available.
Steps
-
Choose the route that matches your work.
If you need to… Open Work directly from the list Open the Reference list page Work from the saved sales job The saved sales job that owns the list -
If you opened the sales job, open the Reference List tab.
-
Read the headers that are visible in the list. The list shows these columns:
Column Use it to recognize Serial No. The reference serial number Category The reference category Job No. The related job number Model The model shown in the list Year of manufacturing The manufacturing year Delivery date The product delivery date Warranty end date The warranty end date Manufacturer The manufacturer The columns in your list come from its selected layout, so work from the headers visible on your screen. The list also has Refresh, Table Layout, and Settings.
Identify the Reference List page, its visible columns, and the list toolbar. -
Select the row for the saved reference you need to review or change.
-
To start a reference from the product entry point, select Product.
-
Confirm that the new-reference fields are displayed.
Result: You have either opened a saved reference record or reached the new-reference form. Continue with Understand the reference record to identify the available areas before entering values.
Understand the reference record
The reference record groups the main reference information, saved-record review areas, and record actions in an accordion and separate validation groups.
The main information group contains the reference details. The record also has a collapsible accordion, and separate validation groups for the main data, serial status, and the additional reference branch. The available surfaces change with the record state and feature access:
| Surface | When it is available | What it is for |
|---|---|---|
| Main reference information | Reference details exist, the page is not excluded, and the feature is included | Enter or review the reference fields |
| Check-up | The record has an ID | Review or add serial-status information |
| Last Modifications | The record has an ID and the latest-modifications feature is available | Review changes made to the record |
| The record is saved and unchanged, and printing is allowed | Prepare the reference for printing | |
| Upload | The import popup is open and importing is enabled | Upload imported data |
Use Print, Check-up, and Last Modifications when they appear on the saved record. Then continue with Reference information to enter or review values.
Reference information
Reference information identifies the product and the parties connected with it, records its dates and warranty, classifies it, and describes its application. Required markers on the form identify the fields that must be completed for the displayed configuration.
| Area | Fields | Rule |
|---|---|---|
| Identity | Serial Number, Manufacturer | Both are required. |
| Dates and warranty | Year of manufacturing, Product delivery date, Warranty period, Warranty end date | These fields are configurable. Warranty period has a minimum value of 0. |
| Parties | Vendor, Client, End User | All three are required. |
| Order and market details | Client Order No., Vendor Order No., Market Segment, Country | These fields are configurable. |
| Classification | Category, Model name | Category is required. Model name is configurable. |
| Application | Application | Configurable. |
| Question branch | Question answer and, when the question has units, Question unit | The question branch is shown when it applies. |
For Manufacturer, Vendor, Client, End User, and Category, select a value from the available list. Use the available warranty-period unit when it is shown. Complete the question answer and question unit when that branch is shown.
Review areas
The review areas let you check a saved reference and its record history. Check-up contains the serial-status information for a check, while Last Modifications contains the history of changes.
| Area | Fields or columns | Action |
|---|---|---|
| Check-up | Checked on, Status, Comment | Add or edit a status when the saved-record conditions allow it. |
| Last Modifications | Status, Checked on, Checked by, Comment | Select Registration for a history entry when that action is available. |
Checked on is required and cannot be later than today. Status and Comment are required in the check-up entry. Select a status from the registered serial-status choices shown on the form.
Create or update a reference
Enter a new reference or correct the details of a saved one. Complete the required identity and party fields first, then add the configurable information that your company uses.
Prerequisites
- You are on the new-reference form or have opened a saved reference for editing.
- You have the reference information required by your company.
- Serial Number, Manufacturer, Vendor, Client, End User, and Category are available and ready to complete.
Steps
-
Enter the reference identifier in Serial Number.
-
Select the manufacturer in Manufacturer.
-
Enter the applicable dates and warranty information in Year of manufacturing, Product delivery date, Warranty period, and Warranty end date.
-
Select the related parties in Vendor, Client, and End User.
-
Enter order and market information in Client Order No., Vendor Order No., Market Segment, and Country when those fields are available.
-
Select the classification in Category.
-
Enter the model and application information in Model name and Application when those fields are available.
-
Select the save action that matches what you want to do.
If you need to… Select Save and keep working in the form Save Save and leave the form Save and Close Upload reference data from an open import popup Upload -
If the confirmation popup appears, select Yes to continue or No to cancel.
Check the required markers and the Save and Save and Close controls before committing the reference.
Result: The form submits through the selected save path when its validation succeeds. A successful
save uses the message Your request was completed successfully. Continue with Review a saved
reference when the record is saved.
Leave without saving
Leave the form without saving when you do not want to keep your changes.
Prerequisites
- You have unsaved changes on the reference form.
Steps
- Select Don't Save in the exit popup.
Result: You leave the form without saving the unsaved changes.
Review a saved reference
Review a saved reference when you need to print its details, inspect its check-up, read its change history, or return to the list and export list data.
Prerequisites
- You have opened a saved reference record, or you have returned to the Reference list.
- The saved record has an ID for Check-up and Last Modifications.
- Printing is allowed and the record is unchanged when you need Print.
Steps
-
On a saved, unchanged record, select Print when it is available.
-
Select Check-up to review Checked on, Status, and Comment.
-
Select Last Modifications when the latest-modifications feature is available.
-
In the history area, select Registration for the log entry you need to inspect when it is available.
-
Return to the Reference list.
-
Select Export to open the list export options.
If the list settings are open, the list can also show Filter Row and Group Panel.
Result: The saved record is open in the review area you selected, or the Reference list shows its export options. Continue with Handle optional fields and access branches when the available controls differ from these steps.
Handle optional fields and access branches
Reference records contain a mixture of fixed required fields, company-configurable fields, and branches that depend on saved-record data, subscription features, or the information available in the record. Treat a control as applicable when it is visible and enabled on your screen.
| Branch | What changes |
|---|---|
| Configurable fields | Year of manufacturing, Product delivery date, Warranty period, Warranty end date, Client Order No., Vendor Order No., Market Segment, Country, Model name, and Application can be required by company configuration. |
| Warranty unit | Select the available unit for Warranty period when the unit choice is shown. |
| Question branch | A question answer can appear in the details. Question unit appears when the question has units. |
| Subscription | If the feature is excluded, the main reference surface is not available. |
| Saved-record actions | Check-up requires a saved record. Last Modifications also requires the latest-modifications feature. Print requires a saved, unchanged record and printing permission. |
| Print options | In the print popup, use the two choices and watermark field shown for your print request. |
Do not use the presence of a field in one reference form to assume that the same field is required in every company configuration. Likewise, do not treat Question unit, print options, or saved-record tabs as universal controls. When a value is missing or invalid, continue with When validation or saving goes wrong.
When validation or saving goes wrong
Use the exact message on screen to decide what to correct. Complete the missing or invalid reference value, then use Save or Save and Close again. The messages below are the messages assigned to the reference form or its list action.
| What you see | What to do |
|---|---|
Serial you have entered already exist and belong to same manufacturer | Check Serial Number and Manufacturer. Correct the duplicate or select the appropriate existing reference. |
There is error in serial you have entered | Correct the value in Serial Number, then save again. |
An error occurred while processing your request | Check the values in the form and retry the save. If it continues, use the approved help path. |
Your request was completed successfully | Treat the save request as completed, then review the record or return to the list as your task requires. |
Forbidden characters detected. Please remove them and try again. | Remove the forbidden characters from the list value involved in the export or list action, then retry. This message is shared list-export handling rather than a reference-specific field rule. |
The save form validates before committing. If a save control is disabled, correct the required fields that are visible and check that the record is in the appropriate state before trying again. If the message or behavior belongs to shared handling, continue with Out of scope.
Out of scope
For shared behavior that the Reference list does not assign to a specific flow, continue here:
| Subject | Where to continue |
|---|---|
Please enter the storage area and position for each product | The owning product flow; this shared commit message is outside the Reference list flow. |
| Shared list-export character handling | The general list-export guidance |
| Account, category, warranty-unit, question-unit, and check-up status choices | Select from the choices displayed on the open form |
| Question and print options | Use the controls shown in the open branch |
| Record deletion | The page or workflow that owns deletion |
After identifying the owning surface, continue with What to do next.
What to do next
After reviewing a reference, continue from the surface that owns the next piece of work.
| If you need to… | Continue with |
|---|---|
| Work with the complete sales opportunity and its related records | Sales job record |
| Change the categories and questions available to references | Reference categories |
| Change units for a reference question | Reference category question units |
| Maintain registered serial statuses | Reference serial status |
| Resolve a general error | General error messages |
| Get help when the available instructions do not solve the problem | Getting help |
Was this page helpful?