FXL Item Cart Setup
Introduction
FXL Item Cart enables FieldFX Back Office users to find and select items using the FX Item Picker, store the results of the selection, then select items from a different search in the FX Item Picker and store them to the FXL Item Cart.
The FXL Item Cart is generic and intended to be customizable.
Items in the FXL Item Cart can insert directly to the Target Object, be sent to an APEX class or REST Endpoint for processing, or be sent as XML through the Lightning Event Messaging.
To use the FieldFX Lightning package starting with version 1.225, you must use the FieldFX Managed Package version 1.529 or higher. To find the version numbers you have installed, see Check Version Number for FieldFX Managed Package and FieldFX Lightning Managed Package. |
Prerequisites
To set up the FXL Item Cart, you need to:
Have these user licenses | Have these permissions | Complete these tasks and review these topics before continuing |
---|---|---|
|
|
Set Up FXL Item Cart
-
Switch to the Lightning Experience.
-
Access the page that you want to use the FX Item Picker.
-
Select , then click Edit Page.
-
Type FXL Item Cart in the Search components.. box.
-
Drag the FXL Item Cart from the Custom - Managed list to the place on the page where you want the cart to appear.
Consider adding the FXL Item Cart to a place where the FX Item Picker can appear on the page at the same time.
-
Make sure the FXL Item Cart is the selected component on the page.
-
Define the settings for the component using the options on the right side of the screen.
Field Description Insert Action:
Select the type of action to complete when the User selects Save in the FXL Item Cart.
-
Insert: Adds the list of items in the cart to the specified Target Object
-
Use Endpoint: Use the REST API to add the list of items in the cart through the specified Rest Endpoint
-
Use Apex Class: Use the specified Apex Class Name to add the list of items in the cart
-
Fire Event: Send the list of items as XML in a Lightning Messaging Event
UID of Item Cart:
A string that uniquely identifies this particular FXL Item Cart
Use this UID on the page’s FX Item Picker's UID of Item Cart field to link the FX Item Picker to the FXL Item Cart.
Columns (optional):
Comma-delimited list of field API names to display in the FXL Item Cart grid
The fields selected must come from the object used by the Item Picker that updates the Item Cart.
If left blank, the FXL Item Cart displays the Amount, Name, and Description fields.
-
Target Object: API name of the object where the items in the FXL Item Cart should create records
For example, if the FX Item Picker is selecting Ticket Items, enter
FX5__Ticket_Item__c
as the FXL Item Cart’s Target Object, since the items on a Ticket are stored in that object. -
Target Object Parent Lookup Field: API name of the field on the Target Object that refers to the parent object
For example, the
FX5__Ticket__c
field on theFX5__Ticket_Item__c
object links a ticket item to a particular ticket record. -
Target Object Item Field: API name of the field on the Target Object that stores the item number
For example, the
FX5__Ticket_Item__c
object records item numbers in theFX5__Price_Book_Item__c
field. -
Apex Class Name (optional): If Use Apex Class is selected as the Insert Action type, enter the name of the Apex Class to use to process the items in the Item Cart
Otherwise, leave the field blank.
-
Rest Endpoint (optional): If Use Endpoint is selected as the Insert Action type, enter the name of the Rest Endpoint to use to process the items in the Item Cart
Otherwise, leave the field blank.
-
-
Click Save
-
Add the UID of Item Cart string to the FX Item Picker’s UID of Item Cart field for the FX Item Picker used to add items to this cart
Recommended Reading
-
FX Item Picker - Learn how the FX Item Picker works.