Part 1: Customizing the Default Layout Form

From AgileApps Support Wiki

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.

      Objects Orders.png

    3. Click Forms and click the Default Layout Form. The Form editor appears:

      Objects Orders Forms Default Layout.png

  2. Look at the Agent’s (internal User’s) perspective of the Default Form:
    1. Select the Orders tab.

      Orders tab.PNG

    2. Click +Create on the header bar. The default Create new Order Form appears:
      Create new Order Form default.PNG

    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:

      Customization Resource Sharing MyOrders.png

    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:

      Objects Orders Fields New Field Account.png

      Lookup Field Configuration.png

    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.

      Form Default Layout.png

    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:

      Form Default Layout Account Info.png

    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.

      Related Information Line Items Removal.png

    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:

    Updated Related Information.PNG

    1. Select the Orders tab and click New Order.
    2. Fill in the order fields as shown:

      New Order Orders Tab.PNG

    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:

      Line Items.PNG

    8. Click on a line item and then click View Details, if the details are collapsed:

      Line Item A2345.PNG

      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:

      Objects Line Items Fields New Field Total Price.png

    3. Click Save.
      This field is automatically added to the Line Items default Form.
  8. Check the Line Items default layout:

    Form Default Layout Total Price.png

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

      Line Item A123.PNG


Previous

Next