Defining Context Eligibility Rules

The instructions in this topics explain how to apply context eligibility rules.

Configure anonymous and known-user browsing for the anonymous and known-user browsing use case

Perform the following steps to create the context dimension.

1. Click App Launcher.
2. Search for Vlocity Product Console and click the link.
3. Click Dashboard, then click Rules, then click Context Dimension.
4. Click New.
5. Enter the required information for anonymous users or logged-in users. You do not set different context dimensions for anonymous and logged-in users. One contextdimension works for both, for example:

6. Click Save.
7. Click the Context Mapping facet to identify Context Scope.
8. Click New Context Mapping.
9. Enter the following required information.

For anonymous users (example):

For logged-in users (example):

10. Click Save.

Perform the following steps to create the context rule.

1. Click App Launcher.
2. Search for Vlocity Product Console and click the link.
3. Click + icon next to the Rules item in the menu.
4. Enter the following required information. For anonymous users (example):

For logged-in users (example):

5. Click Save.
6. Click Rule Condition.
7. Click Add Condition.
8. Enter the following required information. For anonymous users (example):

For logged-in users (example):

9. Click Save.

Perform the following steps to create rule set.

1. Click App Launcher.
2. Search for Vlocity Product Console and click the link.
3. Click + icon next to the Rules Set item in the menu.
4. Enter the following required information. For anonymous users (example):

For logged-in users (example):

You can create a single rule set by combining rules for Fiber and MemberStatus by applying expression mode or and executing it using a URI to pass two different context parameters separated by a comma. For an anonymous user, an example is: /services/apexrest/vlocity_cmt/v3/catalogs/MOBILE/offers?context={"DC_RULE_MEMBER_STATUS":"Gold","DC_RULE_FIBER_AVAILABLE":"True"}. You can pass two or more dimension parameters as part of the API request. You can also create a rule set that calls two different rules that point to two different context dimensions, in this case, Fiber and Member Status. When you call the URI, you could pass only one dimension name, Fiber, and not Member Status, andthat will satisfy the rule. If you have two or more context dimensions defined with an OR condition but you pass just one of them in the request body, then the defined default value is used for the other context dimension. If you write a URI for Member Status and Fiber Available = True, but there is no value for Member Status, then do not include the parameter value so Digital Commerce does not try to process the null value. Instead, Digital Commerce uses the specified default value for the context dimension value. If you have defined the default value for DC_RULE_FIBER_AVAILABLE as True, then the request URI skips passing the DC_RULE_FIBER parameter.

5. Click Save.
6. Click the Children Rules facet.
7. Click New Child Rule.
8. Add the rule and the sequence.
9. Click Save.
10. Add more child rules as necessary according to the previous steps.

Perform the following steps to apply the rule set to the product.

1. Click App Launcher.
2. Search for Vlocity Product Console and click the link.
3. Click the Search icon next to the Product item in the menu.
4. Search for Fiber Broadband 100 and open it.
5. Click Context Rules.
6. Click Add Rule Set and search for the DC_RULE_FIBER_AVAILABLE rule.
7. Repeat the above steps for the DC_RULE_MEMBER_STATUS rule.
8. Click Save.

Before testing the API, you must first run the Populate API Cache job or run theRegenerate Cached API Records job if you are making changes to an existing productcatalog. Perform the following steps to test the API.

1. Navigate to Postman.
2. Check to Agree to terms of service.
3. Click login with Salesforce.
4. Select Utilities→REST Explorer in the top menu.
5. Leave GET as HTTP selected method.
6. Enter the following URL for anonymous users (example).

/services/apexrest/vlocity_cmt/v3/calatogs/FIBER/offers?context={"DC_RULE_FIBER":"true"} Here accountStatus and AccountSLA have an OR condition with each other, so wecan pass either one of these parameters or both. /services/apexrest/vlocity_cmt/v3/calatogs/FIBER/offers?context={"AccountStatus":"Active"} /services/apexrest/vlocity_cmt/v3/calatogs/FIBER/offers?context={"AccountSLA":"Gold"} /services/apexrest/vlocity_cmt/v3/calatogs/FIBER/offers?context={"AccountStatus":"Active","AccountSLA":"Gold"}

The default value is chosen if you create a rule set with two rules pointing to two different dimension names and only one dimension parameter is passed when invoking the API.

For logged-in users (example): /services/apexrest/vlocity_cmt/v3/calatogs/FIBER/offers?context={“AccountID”:“xxxxx”}&isloggedin=true /services/apexrest/vlocity_cmt/v3/calatogs/FIBER/offers?context={“AccountID”:“xxxxx”,"AssetStatus":"Active"}&isloggedin=true You are specifying the context map in the URL.

7. Click Execute.

If fiber technology is available, the API returns a list of products including the Fiber Broadband 100 product and a special reduction in price that is only available for known users who are Gold members.