Skip to content
D
Documentation

Custom fields

reference
7 min readUpdated

Custom fields

Custom fields are configurable fields that appear on selected PAMS pages.

If you need to…Go to
Open the configuration area before choosing a maintenance pageConfiguration dashboard
Choose the PAMS page whose fields you maintainOpen Custom fields
Read the fields available on the selected pageUnderstand the preview and field tables
Add or change a fieldAdd and save a field
Check recorded configuration changesReview Last Modifications
Resolve a blocked or unclear field actionWhen field maintenance does not work
Use the configured fields on a sales recordSales job record

Before you start

Custom-field maintenance depends on your subscription, access level, and the information you want to place on the selected page.

The Custom fields maintenance surface is available when the subscription feature is included. When it is not included, PAMS shows the upgrade surface instead of the maintenance controls.

Edit actions appear when your permission check returns editable access. View the page with the access level that permits editing before you plan to add, change, or remove a field.

Have these choices and values ready:

InformationWhere you use it
The page to customizeChoose page you want to customize
The field formatData type
The text users see for the fieldLabel

The page choices are Account, LG, Purchase, and Sales. The available data types are Date, Number, Text, and Yes_No.

Data type and Label are required in the field editor. A required field has a required marker beside it.

Open Custom fields

Choose the PAMS page whose configurable fields you want to maintain.

Prerequisites

  • The subscription feature is included.
  • You have editable access for field maintenance.

Steps

  1. Open the Configuration dashboard in PAMS.

  2. Open Choose page you want to customize.

  3. Select the page you want to maintain.

    If you need to maintain fields for…Select
    Account pagesAccount
    Letter-of-guarantee pagesLG
    Purchase pagesPurchase
    Sales pagesSales
    Select the page whose fields you maintain
  4. Confirm that the selected page's preview appears.

Result: Custom fields is open from the Configuration dashboard, the selected page is shown in Choose page you want to customize, and its preview is available.

Understand the preview and field tables

The preview shows the fields available on the selected PAMS page, grouped into the page areas that PAMS presents for that selection. Use it to locate the area where a custom field belongs before you open the field editor.

For the selected Sales page, the preview showed these fields:

Field 1Field 2Field 3
BranchSales ResponsibleProduct Type
Job TitleTime FrameEnd User
Estimated ValueIn Branch CurrencyFile No.
ClientVendorClient Inquiry Number
Inquiry DateBid Due DateRequested Offer Type
Offer No.Offer TypeOffer Date
Validity PeriodDelivery TimeDelivery Term
Payment MethodPayment PeriodClient Order No.
Vendor Order No.Order DateOrder Activation Date
L/C NumberShahawy Extra

These fields appeared in more than one preview section:

First repeated fieldSecond repeated fieldThird repeated field
ClientVendorBid Due Date
Delivery TimeDelivery TermPayment Method
Payment Period

The preview appears after you select a page.

Locate preview sections and field actions

Work from the field names and sections shown in the preview. The preview content depends on the page you select and the configuration for that page. Which Section is not available as a choice on this screen. When you have located the section, continue with Add and save a field.

Add and save a field

Add a custom field when the selected page needs another labelled value. Edit an existing field when its label needs changing; an existing field's Data type is disabled while it is edited.

Use the appropriate path:

If you need to…Start with…
Add a fieldAdd custom field in the preview section where the field belongs
Change a field's labelSelect the existing field, then Update custom field

Prerequisites

  • Custom fields is open with the target page selected.
  • You know the field's Data type and Label.
  • You have editable access.

Add a new field

  1. Select Add custom field in the preview section where the field belongs.

  2. Open Data type.

  3. Select the data type that matches the value.

    If the field stores…Select
    A calendar dateDate
    A numeric valueNumber
    Free textText
    A yes/no valueYes_No
    Choose the field's data type
  4. Enter the text users should see in Label.

  5. Select Save.

    When the new field is saved, PAMS uses the message Saved.

  6. Check the preview for the new label.

Result: The new field is submitted, and the preview is the place to check whether its label appears.

Change an existing field

  1. Select the existing field in the preview.

  2. Select Update custom field.

  3. Enter the revised text in Label.

  4. Select Save.

    When the existing field is updated, PAMS uses the message Field updated successfully.

  5. Check the preview for the revised label.

Result: The changed label is submitted, and the preview is the place to check the revised field.

Select Save and Close when you want to save a field change and leave the maintenance page in the same action.

After checking the preview, continue with Review Last Modifications or When field maintenance does not work.

Enter a data type and label in the field editor

Review Last Modifications

Last Modifications is the audit-history area for actions recorded against custom-field maintenance. It is available when both companyId and the log-module identifier are present.

Prerequisites

  • Custom fields is open.
  • The company and log-module identifiers are available.

Steps

  1. Select Last Modifications.
  2. Read the audit history in chronological order.

The audit-log text says: The audit log provides you with a chronological sequence of actions performed by the users.

Result: The audit-history area is open with the recorded actions presented as a chronological sequence.

If a field action is blocked or unclear, continue with When field maintenance does not work.

When field maintenance does not work

Use the message on screen to distinguish a value that needs correction from an action that the current subscription or access level does not permit.

What you see or cannot selectWhat it meansWhat to do
This field is requiredA required field in the editor is empty.Enter a value in Data type or Label, then submit the form again.
repeated fieldA field with the same data type and label already exists in the same section.Change Data type or Label, then submit the form again.
Choose page you want to customize is unavailable and the upgrade surface appears.The subscription feature is not included.Contact the person who manages your PAMS subscription.
Edit actions are unavailable.The permission check did not return editable access.Sign in with access that permits field editing, or contact your administrator.
Error occurred while saving fieldThe save action returned a save error.Check the field values and submit the save action again.
Error occurred while updating fieldThe update action returned an update error.Check the revised label and submit the update again.
Error occurred while removing fieldThe remove action returned a removal error.Do not treat the field as removed; resolve the error before continuing.
A close action asks whether to save changes.The page has unsaved changes.Choose a leave-page choice in Continue after maintaining fields.
Which Section is not available.That choice is not available on this screen.Choose the preview section that PAMS presents.

The field editor also provides Ultimate delete this field for an edited field and Delete to remove a saved field after confirmation. A successful removal uses the message Field removed successfully.

Continue after maintaining fields

Leave the maintenance page after you check the field preview or decide whether to keep the change.

Prerequisites

  • A field editor or the Custom fields page is open.
  • You know whether to keep or discard unsaved changes.

Steps

  1. Select Close when you want to leave the field editor.

  2. If PAMS asks Do you want to save your changes?, select the appropriate choice.

    If you need to…Select
    Leave without savingDon't Save
    Save before leavingSave
    Remain in the editorCancel
  3. Select Close when you want to leave the maintenance page after the field editor is closed.

Result: The selected leave-page choice is applied, and you can continue from the Configuration dashboard or the page that uses the configured fields.

After maintaining fields, use Sales job record to see where fields configured for the Sales page are used. Return to the Configuration dashboard when you need to choose another configuration area.

Was this page helpful?

Need help using the product?

Custom fields — PAMS Fresh Generation