Back
Module Assessment | Yext Hitchhikers Platform
Background
The Turtlehead Tacos restaurant franchise wants you to help them build experiences for their customers using Yext Listings, Pages, and Search. Before they can power those experiences, you need to set up their structured data in the Knowledge Graph.
The Turtlehead Tacos data model needs these types of entities:
- Restaurants
- Events
- FAQs (which will eventually go on their website pages)
- Menu Items
Turtlehead Tacos is also active in local communities and they want to highlight their efforts on their website. They call these initiatives “Community Stories.” You’ll need to create a custom entity type to store this information.
Next, you’ll need to make sure the right fields are available on each entity type. The team also wants to store their seasonal promotions, which will require a custom field type and a custom field.
This challenge has detailed steps to complete each task. For extra help, see the previous units in this module, or these help articles:
- Enable Entity Types
- Create a Custom Field Type
- Create a Custom Field
- Edit the Field Configuration on an Entity Type
Your Challenge
First, enable the built-in entity types you’ll need. Navigate to Knowledge Graph > Configuration and click the Entity Types tile.
Enable these entity types: Restaurants, Events, and FAQs.
Make Restaurant the primary entity type.
You need to create a custom field type and custom field in order to store all the information about seasonal restaurant promotions that the Turtlehead team wants to display. Start by creating the custom field type. Go to Knowledge Graph > Configuration and click the Field Types tile.
From the Field Types screen, click Add Custom Field Type in the upper right.
Add the following details to the new field type. Make sure you enter these exactly as shown below:
- Type Name: Promotion
- API Name: No input needed — this will auto-populate from the field type name.
- Description: No input needed.
Add subfields to the new field type. Click Add a subfield and add four subfields with the information shown below. When you’re finished, click Save at the bottom of the screen.
- Subfield 1: Type: Single-line text; Label: “Title”
- Subfield 2: Type: Photo; Label: “Photo”
- Subfield 3: Type: Multi-line text; Label: “Description”
- Subfield 4: Type: URL; Label: “URL”
Now, you need to create the Restaurant Promotions custom field to display on your Restaurant entities, using the new custom field type. Go to Knowledge Graph > Configuration and click the Fields tile.
Click Create Custom Field in the upper right. Add the following details to the new field. Make sure you enter these exactly as shown below:
- Type: Choose Promotion from the dropdown menu. Then, select the Make it a List checkbox.
- Field Name: Restaurant Promotions
- ID:
c_restaurantPromotions - Entity Type Availability: Restaurant
- Field Settings: Click to Modify the validation settings. Set the maximum list count to 3.
When you’re finished, click Save field in the lower right.
Make sure the Restaurant Promotions field is visible on the Restaurant entity type. Go back to the field presentation for the Restaurant entity type (Knowledge Graph > Configuration > Entity Types > Restaurant).
Find the Restaurant Promotions field (hint: it will probably be in the Other Fields section at the bottom of the page). Move it to the Core Information section. You can do this by clicking and dragging, or by hovering over the field, clicking the Move To dropdown, and choosing the Core Information section.
Next, create and enable the Community Story entity type. From the Entity Types screen, click the Add Custom Entity Type button in the top right.
Add the following details to the new entity type. Make sure you enter these exactly as shown below:
- Entity Type Name: Community Story
- ID:
ce_communityStory - Plural Entity Type Name: Community Stories
- Description: Add a simple description of your choosing. (Stuck? Use this description: “Local community initiatives by the Turtlehead Tacos team”)
When you’re done, click Create Custom Entity Type at the bottom of the screen. Then, make sure the Community Stories entity type is also enabled.
Add the Description and Videos fields to the Community Story entity type. Click the Add dropdown at the bottom of the Core Information field section and select Add Field.
- Type each field name into the search bar at the top of the Add Fields modal. Select the checkbox next to the field name to add it.
- When you’ve selected both fields, click Add Fields at the bottom of the modal.
Check off Show on Entity Creation on the Videos field.
Click Save at the bottom of the screen.
Congrats, you’ve completed your first challenge! You enabled entity types, added a custom entity type and custom field type, created a custom field, and added fields to entity types. Keep going through the track to start creating entities.
Weekly Challenge Streak: <% util.streakWeekly %>
