Favorites Administration
Administration
Favorites allow company administrators or individual users to save common configurations and frequently selected parts for quick access when creating quotes. Refer to Favorite Products for an overview of favorites and user actions.
Favorites Administrators
Favorites Administrator can be restricted using Administrator Groups.
- If Administrator Groups are enabled, access to all favorites is controlled by Favorite List privileges.
- If Administrator Groups are not enabled, Full Access users with User Administrator privileges will be able access all shared favorite folders.
Add / Edit a Company Folder
Favorite folders can only be shared with user groups. Perform the following steps to create a company folder:
- Navigate to Favorites.
- Click on the Manage Folders icon.
-
Click the Add Folder icon to create a new folder, or click the Edit icon for an existing folder.
- Enter a Folder Label.
-
Enable the Company Folder option.
Only Full Access administrators with Favorite List privileges will see the Company Folder option, so only these administrators can create shared favorite folders.
- Select the appropriate groups for View Access and Add Access.
- View Access only allows users assigned to selected user groups to view the favorite folder.
- Add Access allows user assigned to selected user groups to add favorites to the favorite folder.
- Click the Save icon.
- Click Close.
To view a specific shared folder, select Company Favorites and then select the applicable shared folder from the Folder Selection drop-down.
Notes:
- When a favorite is moved into a shared folder, the folder owner will become the new owner of the favorite. The previous owner will automatically be granted Edit Access for the moved favorite.
-
If Administrator Groups are enabled, access to favorites is controlled by Favorite List privileges.
If Administrator Groups are not enabled, Full Access users with User Administrator privileges will be able access all shared favorite folders.
Managing Favorites
The Update Favorites List page is used to update the product data displayed on the Commerce Favorites list. You can tag items for reconfiguration or change the status icons the system uses to indicate changes to the Commerce Favorites list before performing an update.
These updates ensure that products on the Favorites List display current catalog information. The update engine verifies product attributes, pricing, and availability. The update engine can only calculate pricing information on products with still-supported configurations. When products have new or modified configuration attributes, you can set the engine to skip over them during the update process. This speeds up Favorite List updates, but it also forces users to reconfigure those products before purchase.
- Navigate to the Admin Home page.
- Click Favorites List in the General section.
- Schedule a Favorites List Update:
- Enter the time for starting the update in the Scheduled field.
Example: 11/11/2009 11:11 AM
. - Enter the email address of the person who wishes to receive notification of completion of the update in the Send Email To field.
- Click Schedule Favorites List Update to synchronize all the existing Commerce list entries.
- Sort the Scheduled Tasks list alphabetically by column.
- To sort products: choose the column you want to sort by and click the header.
- To reverse-sort: click the header twice.
-
To delete a Scheduled Task, select the checkbox in the Delete column, and click Delete.
You can delete the scheduled task to cancel the process before a Favorites List update begins. While an update is happening, it is not possible to stop the process.
-
Select the items that should not be updated in the Flag Equipment and Parts for Reconfiguration section.
To do this, navigate to the items that have different supported configurations by clicking a Link and marking all parts for reconfiguration. Or, navigate through the products hierarchy and mark select products.
- Click Update Flags on each page with selected items to save your selection.
- Click Back to return to the previous page without saving changes.
Verifying Favorites List Updates
You can verify Favorites List updates by viewing the email notification generated when an update process finishes. The system sends a confirmation email to the email address specified for the update. Confirmation emails contain the number of products processed, the number of items that no longer exist in the catalog, and the number of items that now need to be reconfigured before purchase.
Sample Email Contents
Number of items processed : 118
Number of items flagged for delete : 2
Number of models flagged for reconfiguration : 10
Number of parts flagged for reconfiguration : 0
Create a "Copy to Favorites" Action Button in Commerce Watch Video
- Navigate to the Admin Home page.
- Click Process Definition in the Commerce and Documents section.
- Select Documents from the applicable process Navigation menu, and then click List.
- Select Actions from the main document Navigation menu, and then click List.
-
For the Main Document/Quote, select Actions in the Navigation column.
The Copy to Favorites action is only available on the main document.
-
Click Add, at the bottom of the Action List page.
-
Enter the title in the Label field.
The entry in the Label field will appear to the end user. Be brief, but descriptive.
The Variable Name field populates automatically. Variable names can only contain alpha-numeric characters and underscores. The entry can be changed before saving, but after saving the value is read-only.
-
Select Copy to Favorites as the Action Type.
-
Click Add to save your changes and return to the previous page.
-
Click Save and Edit Desktop Layout.
The Commerce Layout Editor appears.
-
Click on Actions in the right side panel
-
Drag and drop the Copy to Favorites action into the top action toolbar.
-
Click Save.
-
Deploy the Commerce process.
Create an "Add to Favorites" Action Button in Configuration Watch Video
-
Navigate to the Admin Home page.
-
Click Process Invocation in the Commerce and Documents section.
-
Click on the Model Configuration page.
-
Click Add to add an item.
The Create/Edit Action page opens.
-
Enter the Name and Description. The entry in the Name field will appear to the end user. Be brief, but descriptive.
- For the Action Type, select the Favorites List option.
- Click Add to save your changes and return to the previous page.
-
Select User Access Rights from the Favorites List Navigation menu, and the click List.
The Access Rights Editor page opens.
From within this page you can manage which users have access to the Add to Favorites button. Users will see the Add to Favorites button once they reach the End Node of the Configuration Flow.
-
Add at least one item to the Access Rights field.
- Select a Company Type.
- Select a User Type.
- Click the right toggle button to add the user type to the Access Rights section.
- Click Update to save your changes and return to the previous page.
- On the Action List page, click Back.
- Choose Select box next to the Model Configuration page.
-
Click Deploy.
Users will see the Add to Favorites button once they reach the End Node of the Configuration Flow.
The Configuration "Add to Favorites" button only appears when a user directly opens Configuration. It will not appear when a user launches reconfigure from a transaction.
Adding the Favorites Link to the Header
Watch Video
- Navigate to the Navigation Menus page.
- Click Admin to go to the Admin Home Page.
Click Navigation Menus in the General section.
The Navigation Menus page opens.
-
Click List Links next to the Subheader navigation menu.
The Navigation Items List - Subheader page opens.
-
Click Customize Menus.
The Customize Links for Subheader page opens.
-
Select which level of Access Rights will have visibility to these buttons once they are added.
- To select for which user type you want to add the link, select the link from the Hidden Links list and click Add.
- Click Apply to save your changes and remain on the page.
- Click Back twice to return to the Navigation Menus page.
- Click Deploy.
Troubleshooting
In order to debug some Rules (such as a Recommendation Rule), the debugger requires you to have a "Favorite Item ID". If an invalid ID is entered, the following error occurs:
Creating a Favorite Item ID
-
Navigate to Favorites.
- Locate your desired Model or Part.
- In the Label column click the Model or Part link.
-
Locate the "id = XXX" section of the URL.
-
Copy and paste this number into the Debugger.
The information from that Configuration will be loaded to test for the Rule you are debugging.
- Ensure "Favorites" are enabled on the site where you are performing the debugging when locating your Favorite Item ID.
- Sometimes in the URL, there will be 2 "id = " numbers. Use the first id; it should be 7 digits long.
Notes
Tips and Considerations:
-
You can schedule Favorites List updates to run whenever you like; ideally, they should be run during your system's low usage times.
-
This topic defines the Favorite UI and Favorites administration for sites on Oracle CPQ 22B and later. If your site is on Oracle CPQ 22A or prior, refer to the Favorites List (Oracle CPQ 22A and Prior) topic.
Related Topics
See Also