Part 1: Customizing the Default Layout Form

From AgileApps Support Wiki
Revision as of 09:25, 1 December 2022 by Wikieditor (talk | contribs) (Created page with "In this part of the exercise, you update the Default Form that was generated for your application Object, Orders, by adding some additional fields and functions to make the Fo...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

In this part of the exercise, you update the Default Form that was generated for your application Object, Orders, by adding some additional fields and functions to make the Form more realistic.

  1. Look at the default Form created by the system when you created the MyOrders application:
    1. Log in to your AgileApps Cloud tenant as yourself (not as MyManager) and select application MyOrders.
    2. Go to the Configuration page, under the Customization tile, click Objects. Click the Orders Object.
      Note: This page shows the toolset you use to edit the Orders system Object that was generated when you created the MyOrders application - this Object is a system-managed data table in webMethods AgileApps Cloud.
    3. Click Forms and click the Default Layout Form. The Form editor appears:
  2. Look at the Agent’s (internal User’s) perspective of the Default Form:
    1. Select the Orders tab.
    2. Click +Create on the header bar. The default Create new Order Form appears:
    3. Add some values to the Form and click Save.
      Note: There is an extra field, Subject, which is not needed.
      You will remove this field in a later step.
  3. Share an existing Object (that was defined in a different application) with the MyOrders application:
    1. Go to the Configuration page, under the Customization tile, click Resource Sharing.
      The Resource Sharing view shows all the other Objects that you can add to your application. For example, the Accounts Object lets you track information about another organization you are doing business with. This Object was provided with the Service Desk application.
    2. Select Accounts and move it to the Selected box:
    3. Click Save.
  4. To update the Orders Object to relate to the shared Accounts Object:
    1. Go to the Configuration page, under the Customization tile, click Objects. Click Orders.
    2. Click Fields to see a list of all available fields, then click New Field.
    3. Populate the page as shown to add Account as a Lookup field. Moreover, provide fields Account Name, Account Number, City, Description, Phone, Street Address, and Zip Code as Lookup-derived fields to be displayed for an Order:
    4. Click Save.
  5. To update the Order Default Form:
    1. Go to the Configuration page, under the Customization tile, click Objects. Navigate to Orders > Forms > Default Layout.
    2. Remove the “extra” fields: Case Number and Subject by selecting the field and clicking the X icon that appears.
    3. Create a new section for the Accounts Lookup field, by clicking on the Form Controls tab in the Elements palette, then drag and drop Section from the palette to the Default Form, below the Basic Information section. Type Account Information for the Section Title.
    4. Drag and drop fields from the left-hand Fields palette to the Account Information section:
    5. Click Save Changes.
    6. Scroll down to view the Related Information section which shows information about the Line Items that are associated with the current order. This section will be displayed in the View Details section of an order, after an Agent creates an order record.
    7. Click the Edit Related Information icon.
    8. Edit this section as shown to display the following five Line Items fields for an Order in the given sequence:
      1. Click Save.
  6. Next, to see how the updates you made to the Default Layout Form on an Order impact the UI used by an Agent, create a new Order record:
    1. Select the Orders tab and click New Order.
    2. Fill in the order fields as shown:
    3. For the Account field, select the magnifying glass icon to select an Account.
    4. Choose account Fred Supplies (that you created in a previous exercise).
    5. On the Create new Order page, click the Account Information tab to see that the fields have been populated based on the Account field.
    6. Save the new Order.
    7. Use the NEW LINE ITEM button to add three Line Items to the Order, as shown:
    8. Click on a line item and then click View Details, if the details are collapsed:
      Note: It would be useful to have a field that provides the total price for each line item (especially when the quantity is more than one).
  7. To update the Line Items Object to include a Total Price field that multiples the price and quantity for the line item:
    1. Go to the Configuration page, under the Customization, click Objects. Navigate to Line Items > Fields.
    2. Add a new field named Total Price with Display Type Formula, and Return Type Currency. For the Formula, multiply the Quantity field with by the Price field:
    3. Click Save.
      This field is automatically added to the Line Items default Form.
  8. Check the Line Items default layout:
    1. Go to the Configuration page, under the Customization tile, click Objects. Navigate to Line Items > Forms > Default Layout.
    2. Move the Total Price field as shown:
    3. Click Save Changes. 
  9. To verify what the Agent User will see:
    1. Click the LINE ITEMS tab.
    2. Click the record for Part Number A123.
    3. Click View Details. The Form now shows the Total Price field, with the calculated value: