Additional Fields may be configured for certain pages with Sales User for Employee Portal.

Details can be configured for specific pages/sections of Sales User, as described below.

  1. In SAP Business One, go to zedSuite Manager > Manage Additional Fields.
  2. Select Employee Portal from the Portal drop-down (marker 1 below), and the desired Page (marker 2 below).
    Select Employee Portal from the Portal drop-down (1) and the page (2). Add a new field (3) or edit an existing field (4).
    Select Employee Portal from the Portal drop-down (1) and the page (2). Add a new field (3) or edit an existing field (4).

    Available options are:

    Option Description URL
    OrderPad - Order Header Configured fields appear on the document header. Configuration applies to both Order Pad and Quote Pad for Employee Portal ~/order/create?cardcode=\<card-code\>

    Ex: /order/create?cardcode=C20000
    OrderPad - Order Lines Configured fields appear on the line level. Configuration applies to both Order Pad and Quote Pad for Employee Portal ~/order/create?cardcode=\<card-code\>

    Ex: /order/create?cardcode=C20000
    SalesUserBusinessPartner - Business Partner Configured fields appear on Business Partner details screen for Employee Portal. /salesuser/\#\<card-code\>/details

    /salesuser/\#C20000/details
    SalesUserBusinessPartner - Business Partner Contacts Configured fields appear on the Contact Details section of the Business Partner details screen for Employee Portal. /salesuser/\#\<card-code\>/details

    /salesuser/\#C20000/details
    SalesUserBusinessPartner - Business Partner Addresses Configured fields appear on the Address section of the Business Partner details screen for Employee Portal. /salesuser/\#\<card-code\>/details

    /salesuser/\#C20000/details
    SalesUserOpportunity Configured fields appear on Opportunity Details tab of the Business Partner details screen for Employee Portal. ~/salesuser/\#\<card-code\>/opportunities/\<opportunity-number\>

    Ex: /salesuser/\#C20000/opportunities/147
  3. Add a new field using the + icon (marker 3 above), or update an existing field using the golden arrow (marker 4 above). From the Edit field screen, configure the field’s details, as outlined below. For specific use cases and examples, see the Examples section.

    Set basic details (1,2), Default value settings (3-6), Properties (7-12), Active (13).
    Set basic details (1,2), Default value settings (3-6), Properties (7-12), Active (13).
    Field Description
    Label (1) This web label is displayed to the user. For hidden fields, this is an admin-only label.
    Type (2) Available options are:

    Standard - Allows a user to choose a value for this configured field. This value is saved in B1.

    Read-only - A value is displayed to the user, but the user may not edit it. “Default Value” settings must be configured to ensure a value is assigned to this field. This value is saved in B1.

    Display-only - A value is displayed to the user, and it appears as a non-editable note. “Default Value” settings must be configured to ensure a value is displayed. This value is not saved in B1.

    Hidden - This option is not displayed to the user. “Default Value” settings must be configured to ensure a value is assigned to this field. This value is saved in B1.
    Default Value: Use a query to provide a Default Value on web? (3) If enabled, a Query Category (4) and Query (5) must be selected. Default Value is assigned to the field on the web. Depending on other settings, the user may or may not be able to edit this value.
    Default Value: Default Value Query Category (4) This selects the B1 Query Category that contains the customized Default Value query.
    Default Value: Default Value Query (5) This selects the customized B1 Query used to determine the default value.

    This query may optionally use the parameter [%CardCode].

    This query must supply a single row with a single column containing the value desired.
    Default Value: Default Value (6) If a query is not used, a hard-coded default value may be assigned here. If blank when “Use query” is un-checked, no default option will be provided on the web.
    Properties: Field Name (7) Any UDF and a sub-set of core fields may be selected, depending on which page and section is being configured.
    Properties: Use a query to provide Valid Values on web? (8) If enabled, a Query Category (9) and Query (10) must be selected. Valid Value options appear as a drop-down on the web, so the user can only enter valid options.
    Properties: Valid Values Query Category (9) This selects the B1 Query Category that contains the customized Valid Values query.
    Properties: Valid Values Query (10) This selects the customized B1 Query used to determine the list of valid values.

    This query may optionally use the parameter [%CardCode].

    This query must supply a list of value/label pairs. These value/label pairs will be used to display a dropdown of valid options for Standard Additional Field Types. For Read-only Additional Field Types, these value/label pairs will be used to display the associated label for the automatically assigned value.

    The value/label pairs in this query must align with all possible default values. In the event that a default value is not included in this query, the default value will be displayed “as is”.
    Properties: Is Required? (11) When enabled, this forces the user to select/enter details for the configured field. This may be combined with default values where appropriate, or default values may be left blank to force user action.
    Properties: Help Text (12) Optional help text provides the user with additional information, recommended use is to alert the user to built-in query limits (for example: “Warehouses are restricted based on your sales region.”)
    Active (13) If enabled, all users with access to the configured feature will see this option.
  4. Recycle the IIS Application Pool for Employee Portal. This will ensure the latest fields are refreshed immediately for all users. See Troubleshooting - How to recycle Application Pools for a walkthrough.

  5. At this point, users will be able to see the configured fields by accessing the relevant Sales User feature.

Examples

The following examples provide walkthroughs of setting up common scenarios. An implementation may require slightly different configuration options, see details above for available options.

Example: Employee changes the warehouse on order lines (Standard field example)

In this scenario, an employee needs to change the warehouse assigned to the order line in some cases. For example, if there’s a surplus of a product in the non-default warehouse, the employee can choose that warehouse instead of the default.

  1. In SAP Business One, configure two queries:
    • A query to select a default warehouse. In this example: B1WebAPI_SU/Custom_DefaultWarehouse. This query may optionally use the parameter [%CardCode].
    • A query to list available warehouses. In this example: B1WebAPI_SU/Custom_WarehouseList. This query may optionally use the parameter [%CardCode]. This query must supply a list of value/label pairs, which will be displayed as a dropdown of valid options.
  2. Select Employee Portal > OrderPad - Order Lines from the drop-down (see markers 1 & 2 below). Add or update the Warehouse field (see markers 3 & 4 below).

    Select the Portal (1) and Page (2); Add a new field for Warehouse (3) or Edit it if it already exists (4).
    Select the Portal (1) and Page (2); Add a new field for Warehouse (3) or Edit it if it already exists (4).
  3. Configure the warehouse details as follows:

    Assign web Label (1), Type (2), Default options (3), general Properties (4). Ensure the field is active (5).
    Assign web Label (1), Type (2), Default options (3), general Properties (4). Ensure the field is active (5).
    • Label (1): Set this to Warehouse.
    • Type (2): Select Standard.
    • Default Value (3): In this example, we are using a custom query to generate the default warehouse. Assign the custom query created in the first step: B1WebAPI_SU/Custom_DefaultWarehouse
    • Properties (4): In this example, we are using the line-level warehouse field, with a customized list of available warehouses. Select the field Warehouse, ensure the Valid Values option is enabled and select the customized query created in the first step: B1WebAPI_SU/Custom_WarehouseList.
    • Active (5): Enable this option to display the field on the web.
  4. Recycle the Application Pool for Employee Portal in IIS. For a walkthrough of this step, see: Troubleshooting - How to recycle Application Pools

  5. To edit the field on the web, log into Employee Portal and add an item to an order.

    Add an item to the order.
    Add an item to the order.
  6. When prompted, select the desired warehouse. The default and available warehouse options are supplied by the custom queries.

    Select the desired warehouse from the available options.
    Select the desired warehouse from the available options.
  7. Submit the order. Note that the selected Warehouse is saved to the line, as selected by the user, shown with marker 1 below.

    Once the order is submitted, the selected warehouse is displayed on the order summary (1).
    Once the order is submitted, the selected warehouse is displayed on the order summary (1).
  8. The selected warehouse setting can also be viewed in SAP Business One. At the document line level, the chosen warehouse is assigned to the line as submitted by the user (see marker 1 below).

    In B1, the Warehouse appears on the order document line (1).
    In B1, the Warehouse appears on the order document line (1).

Example: Query sets the warehouse on order lines (Read Only field example)

In this scenario, warehouse assignment is based on custom logic, and the assigned warehouse needs to be displayed to an employee during order placement. For example, a query is configured to determine the “closest” warehouse to the customer that has surplus stock.

  1. In SAP Business One, configure two queries:
    • A query to select the warehouse. In this example: B1WebAPI_SU/Custom_DefaultWarehouse. This query may optionally use the parameter [%CardCode].
    • A query to list available warehouses. In this example: B1WebAPI_SU/Custom_WarehouseList. This query may optionally use the parameter [%CardCode]. This query must supply a list of value/label pairs, and must include all possible warehouses that can be assigned by the Default query.
  2. Select Employee Portal > OrderPad - Order Lines from the drop-down (see markers 1 & 2 below). Add or update the Warehouse field (see markers 3 & 4 below).

    Select the Portal (1) and Page (2); Add a new field for Warehouse (3) or Edit it if it already exists (4).
    Select the Portal (1) and Page (2); Add a new field for Warehouse (3) or Edit it if it already exists (4).
  3. Configure the warehouse details as follows:

    Assign web Label (1), Type (2), Default options (3), general Properties (4). Ensure the field is active (5).
    Assign web Label (1), Type (2), Default options (3), general Properties (4). Ensure the field is active (5).
    • Label (1): Set this to Warehouse.
    • Type (2): Select Read-Only.
    • Default Value (3): In this example, we are using a custom query to generate the default warehouse. Assign the custom query created in the first step: B1WebAPI_SU/Custom_DefaultWarehouse
    • Properties (4): In this example, we are using the line-level warehouse field, with a list of warehouse codes/names for display on the web. Select the field Warehouse, ensure the Valid Values option is enabled, then select the customized query that was created in the first step: B1WebAPI_SU/Custom_WarehouseList.
    • Active: Enable this option to display the field on the web.
  4. Recycle the Application Pool for Employee Portal in IIS. For a walkthrough of this step, see: Troubleshooting - How to recycle Application Pools

  5. To see the field on the web, log into Employee Portal and add an item to the order.

    Add an item to the order.
    Add an item to the order.
  6. At this point, the assigned warehouse will be displayed on the line, as supplied by the custom queries.

    View the assigned warehouse and edit quantity.
    View the assigned warehouse and edit quantity.
  7. Submit the order. Note that the selected Warehouse is saved to the line, as selected by the user, shown with marker 1 below.

    Once the order is submitted, the selected warehouse is displayed on the order summary (1).
    Once the order is submitted, the selected warehouse is displayed on the order summary (1).
  8. The selected warehouse setting can also be viewed in SAP Business One. At the document line level, the chosen warehouse is assigned to the line as submitted by the user (see marker 1 below).

    In B1, the Warehouse appears on the order document line (1).
    In B1, the Warehouse appears on the order document line (1).

Example: Query displays BP account status (Display Only field example)

In this scenario, an account status is displayed at the top of the Business Partner Details or Opportunity Details screen. This message provides a sales person with an “at a glance” status message (for our example: “Account is overdue by less than 30 days”).

  1. In SAP Business One, configure a query to select a message based on the customer [%CardCode]. In this example: B1WebAPI_SU/Custom_AccountStatus.

  2. Select Employee Portal > SalesUserBusinessPartner - Business Partner or Employee Portal > SalesUserOpportunity from the drop-down (see markers 1 & 2 below). Add or update the Account Status field (see markers 3 & 4 below).

    Select the Portal (1) and Page (2); Add a new field for Account Status (3) or Edit it if it already exists (4).
    Select the Portal (1) and Page (2); Add a new field for Account Status (3) or Edit it if it already exists (4).
  3. Configure Account Status details as follows:

    Assign web Label (1), Type (2), Default options (3). Ensure the field is active (4).
    Assign web Label (1), Type (2), Default options (3). Ensure the field is active (4).
    • Label (1): Set this to Warehouse.
    • Type (2): Select Read-Only.
    • Default Value (3): In this example, we are using a custom query to determine the account status to display. Assign the custom query created in the first step: B1WebAPI_SU/Custom_AccountStatus
    • Active (4): Enable this option to display the message on the web.
  4. Move the field into the desired position. Shown below, the Account Status field has been moved to the top.

    Select the field's row (1); Use the Arrows to move the field (2).
    Select the field's row (1); Use the Arrows to move the field (2).
  5. View the customer details (or opportunity details, as configured) on the web.

    Customer Details, with Account Status as generated by a custom query.
    Customer Details, with Account Status as generated by a custom query. Status Message (1).
    Opportunity Details, with Account Status as generated by a custom query.
    Opportunity Details, with Account Status as generated by a custom query. Status Message (2).

Example: Query sets a UDF when an order is placed on the web (Hidden field example)

In this scenario, it’s necessary to identify where an order was placed (on the web, within B1, or through some other process, such as orders taken by phone). To facilitate this, a custom UDF on the Order Header can be created, which can then be updated from Employee Portal using a Hidden field. This type of hidden field can be configured as outlined below.

  1. In this example, we will use a hard-coded default value so no query is required. However, a query may optionally be configured if one is needed. This is outlined in previous examples.

  2. Select Employee Portal > OrderPad - Order Header from the drop-down (see markers 1 & 2 below). Add or update the Warehouse field (see markers 3 & 4 below).

    Select the Portal (1) and Page (2); Add a new field for Order Source (3) or Edit it if it already exists (4).
    Select the Portal (1) and Page (2); Add a new field for Order Source (3) or Edit it if it already exists (4).
  3. Configure the Order Source details as follows:

    Assign web Label (1), Type (2), Default Value (3), Field Name (4). Ensure the field is active (5).
    Assign web Label (1), Type (2), Default Value (3), Field Name (4). Ensure the field is active (5).
    • Label (1): Set this to Order Source. Note that because this is not displayed on the web, it is only visible to admins in SAP Business One.
    • Type (2): Select Hidden.
    • Default Value (3): In this example, we are using a Default Value. Set the Default Value to EP which identifies Employee Portal as the source.
    • Properties (4): In this example, we are using a document header UDF called “Order_Source”. No other details are required.
    • Active: Enable this option to display the field on the web.
  4. Recycle the Application Pool for Employee Portal in IIS. For a walkthrough of this step, see: Troubleshooting - How to recycle Application Pools

  5. To see the field in B1, first place an order on the web: log into Employee Portal and add an item to the order.

    Add an item to the order.
    Add an item to the order.
    Submit the order.
    Submit the order.
  6. The UDF assignment can be viewed in SAP Business One. On the document, the UDF is set as determined by the custom query. (see marker 1 below).

    In B1, the Order Source UDF is set, as set on the web (1).
    In B1, the Order Source UDF is set, as set on the web (1).

Supported Fields

Each page selected in the Additional Fields configuration screen has a specific subset of core B1 fields that may be configured, in addition to any UDF (User-Defined Field) assigned to that object type. Core fields that come installed with Employee Portal are defined below.

OrderPad - Order Header

To configure an Additional Field for Order document Headers on Order Pad (including both Orders and Quotes), select OrderPad - Order Header from the Page drop-down. This configuration option is available in version 93.0 and higher.

Field Description
Any UDF UDF’s (User-Defined Fields) that have been applied to document headers may be configured.

OrderPad - Order Lines

To configure an Additional Field for Order document Lines on Order Pad (including both Orders and Quotes), select OrderPad - Order Lines from the Page drop-down. This configuration option is available in version 93.0 and higher.

Field Description
Any UDF UDF’s (User-Defined Fields) that have been applied to document lines may be configured.
WhsCode Warehouse Code

No valid values are defined.

Business Partner - Business Partner Master Data

To configure an Additional Field for Business Partner Master Data, select SalesUserBusinessPartner - Business Partner from the Page drop-down.

Field Description
Any UDF UDF’s (User-Defined Fields) that have been applied to Business Partner Master Data may be configured.
AddID No valid values are defined.
BP Project Valid Values are defined in the query B1WebAPI_SU/_OMAN_BP_PROJECTS
Cellular No valid values are defined.
E_Mail No valid values are defined.
EmailAddress No valid values are defined.
Fax No valid values are defined.
GroupCode Valid Values are defined in the query B1WebAPI_SU/_OMAN_BP_GROUPCODE
Industry Valid Values are defined in the query B1WebAPI_SU/_OMAN_OPPORTUNITY_INDUSTRIES
IndustryC No valid values are defined.
LangCode No valid values are defined.
ListNum Price List Number.

Valid Values are defined in the query B1WebAPI_SU/_OMAN_BP_PRICELISTS
Language Valid Values are defined in the query B1WebAPI_SU/_OMAN_LANGUAGES
Phone1 No valid values are defined.
Phone2 No valid values are defined.
ProjectCod No valid values are defined.
Territory Valid Values are defined in the query B1WebAPI_SU/_OMAN_OPPORTUNITY_TERRITORIES

Business Partner - Business Partner Contacts

To configure an Additional Field for Business Partner Contacts, select SalesUserBusinessPartner - Business Partner Contacts from the Page drop-down.

Field Description
Any UDF UDF’s (User-Defined Fields) that have been applied to Business Partner Contacts may be configured.
Address No valid values are defined.
Fax No valid values are defined.
LastName No valid values are defined.
MiddleName No valid values are defined.
Notes2 Remarks 2.

No valid values are defined.
Pager No valid values are defined.
Tel2 Phone 2.

No valid values are defined.
Title No valid values are defined.

Business Partner - Business Partner Addresses

To configure an Additional Field for Business Partner Addresses, select SalesUserBusinessPartner - Business Partner Addresses from the Page drop-down.

Field Description
Any UDF UDF’s (User-Defined Fields) that have been applied to Business Partner Addresses may be configured.
Block No valid values are defined.
Building No valid values are defined.
Country No valid values are defined.
GblLocNum Global Location Number.

No valid values are defined.
StreetNo Street Number.

No valid values are defined.

Opportunities

To configure an Additional Field for Sales Opportunities, select SalesUserOpportunity - Sales Opportunity from the Page drop-down.

Field Description
Any UDF UDF’s (User-Defined Fields) that have been applied to Opportunities may be configured.
Industry Valid Values are defined in the query B1WebAPI_SU/_OMAN_OPPORTUNITY_INDUSTRIES
IntRate No valid values are defined.
PrcnProf Profit (%).

No valid values are defined.
PrjCode Project Code.

Valid Values are defined in the query B1WebAPI_SU/_OMAN_OPPORTUNITY_PROJECTS
Source Information Source.

Valid Values are defined in the query B1WebAPI_SU/_OMAN_OPPORTUNITY_SOURCES
SumProfS Profit Total.

No valid values are defined.
Territory Valid Values are defined in the query B1WebAPI_SU/_OMAN_OPPORTUNITY_TERRITORIES