Skip to content
D
Documentation

Reference list

reference
11 min readUpdated

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 listFind and open a reference
Understand the record before entering valuesUnderstand the reference record
Enter or change reference detailsReference information
Save a new or changed referenceCreate or update a reference
Review a saved referenceReview a saved reference
Maintain categories and questions used by referencesReference categories
Maintain units for reference questionsReference category question units
Review registered serial statusesReference serial status
Continue with the owning sales-job recordSales 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

  1. Choose the route that matches your work.

    If you need to…Open
    Work directly from the listOpen the Reference list page
    Work from the saved sales jobThe saved sales job that owns the list
  2. If you opened the sales job, open the Reference List tab.

  3. Read the headers that are visible in the list. The list shows these columns:

    ColumnUse it to recognize
    Serial No.The reference serial number
    CategoryThe reference category
    Job No.The related job number
    ModelThe model shown in the list
    Year of manufacturingThe manufacturing year
    Delivery dateThe product delivery date
    Warranty end dateThe warranty end date
    ManufacturerThe 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.
  4. Select the row for the saved reference you need to review or change.

  5. To start a reference from the product entry point, select Product.

  6. 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:

SurfaceWhen it is availableWhat it is for
Main reference informationReference details exist, the page is not excluded, and the feature is includedEnter or review the reference fields
Check-upThe record has an IDReview or add serial-status information
Last ModificationsThe record has an ID and the latest-modifications feature is availableReview changes made to the record
PrintThe record is saved and unchanged, and printing is allowedPrepare the reference for printing
UploadThe import popup is open and importing is enabledUpload 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.

AreaFieldsRule
IdentitySerial Number, ManufacturerBoth are required.
Dates and warrantyYear of manufacturing, Product delivery date, Warranty period, Warranty end dateThese fields are configurable. Warranty period has a minimum value of 0.
PartiesVendor, Client, End UserAll three are required.
Order and market detailsClient Order No., Vendor Order No., Market Segment, CountryThese fields are configurable.
ClassificationCategory, Model nameCategory is required. Model name is configurable.
ApplicationApplicationConfigurable.
Question branchQuestion answer and, when the question has units, Question unitThe 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.

AreaFields or columnsAction
Check-upChecked on, Status, CommentAdd or edit a status when the saved-record conditions allow it.
Last ModificationsStatus, Checked on, Checked by, CommentSelect 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

  1. Enter the reference identifier in Serial Number.

  2. Select the manufacturer in Manufacturer.

  3. Enter the applicable dates and warranty information in Year of manufacturing, Product delivery date, Warranty period, and Warranty end date.

  4. Select the related parties in Vendor, Client, and End User.

  5. Enter order and market information in Client Order No., Vendor Order No., Market Segment, and Country when those fields are available.

  6. Select the classification in Category.

  7. Enter the model and application information in Model name and Application when those fields are available.

  8. Select the save action that matches what you want to do.

    If you need to…Select
    Save and keep working in the formSave
    Save and leave the formSave and Close
    Upload reference data from an open import popupUpload
  9. 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

  1. 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

  1. On a saved, unchanged record, select Print when it is available.

  2. Select Check-up to review Checked on, Status, and Comment.

  3. Select Last Modifications when the latest-modifications feature is available.

  4. In the history area, select Registration for the log entry you need to inspect when it is available.

  5. Return to the Reference list.

  6. Select Export to open the list export options.

    If the list settings are open, the list can also show Filter Row and Group Panel.

Identify Export, the export options, and the visible Reference list columns.

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.

BranchWhat changes
Configurable fieldsYear 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 unitSelect the available unit for Warranty period when the unit choice is shown.
Question branchA question answer can appear in the details. Question unit appears when the question has units.
SubscriptionIf the feature is excluded, the main reference surface is not available.
Saved-record actionsCheck-up requires a saved record. Last Modifications also requires the latest-modifications feature. Print requires a saved, unchanged record and printing permission.
Print optionsIn 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 seeWhat to do
Serial you have entered already exist and belong to same manufacturerCheck Serial Number and Manufacturer. Correct the duplicate or select the appropriate existing reference.
There is error in serial you have enteredCorrect the value in Serial Number, then save again.
An error occurred while processing your requestCheck the values in the form and retry the save. If it continues, use the approved help path.
Your request was completed successfullyTreat 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:

SubjectWhere to continue
Please enter the storage area and position for each productThe owning product flow; this shared commit message is outside the Reference list flow.
Shared list-export character handlingThe general list-export guidance
Account, category, warranty-unit, question-unit, and check-up status choicesSelect from the choices displayed on the open form
Question and print optionsUse the controls shown in the open branch
Record deletionThe 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 recordsSales job record
Change the categories and questions available to referencesReference categories
Change units for a reference questionReference category question units
Maintain registered serial statusesReference serial status
Resolve a general errorGeneral error messages
Get help when the available instructions do not solve the problemGetting help

Was this page helpful?

Need help using the product?

Reference list — PAMS Fresh Generation