Module Assessment | Yext Hitchhikers Platform
Background
The Turtlehead Tacos team is really impressed with the work that you’ve done! Next, the team wants to be able to display job postings for their restaurant locations and corporate headquarters in their Search experience and on their website. As a final project, they want you to help set up their Knowledge Graph to store job postings as entities.
To make this happen, you need to:
- Enable the Job and Location entity types in the Knowledge Graph
- Add some custom fields to the Job entity schema
- Create an entity template for new Job entities
- Upload a spreadsheet of current job postings and save the upload configuration
- Create a folder structure for Job entities
In order to test your knowledge of skills you’ve already practiced, this challenge will provide less detail at each step than previous challenges. You can always reference past modules if you’re stuck!
Your Challenge
Enable the Job and Location entity types in the Knowledge Graph. (You’ll need the Location entity type to create the entity for the Turtlehead Tacos corporate headquarters, since this isn’t one of their Restaurant locations.)
Download the Jobs file . Review the columns in the sheet to determine what custom fields you should create on the Job entity schema. (For example, you should see a “Job Qualifications” column with rich text in markdown format, so you’ll definitely need to add a Rich Text Markdown field.)
Update the fields on the Job entity type and create new custom fields as needed. Fields should include:
In the Core Information section:
- Job Department,
c_jobDepartment
, Option > Single-Option Select (with the following options: Marketing, Finance, Operations, Restaurant Team, Culinary Creations, Legal, HR, Other). Note: do NOT check off “Make it a List”
In the Job Details section:
- Job Qualifications,
c_jobQualifications
, Text > Rich Text V2 - Benefits,
c_benefits
, Text > Text List (do not add any options at the field level — you’ll do this later in your entity template) - Associated FAQs,
c_associatedFAQs
, Entity Relationship (select One Way). Under the Validation options in Field Settings, set the Supported Destination Entity Types to FAQ.
In the Media section:
- Job Photo,
c_jobPhoto
, Photo > Photo
- Job Department,
Create a new Location (not Restaurant) entity for the Turtlehead Tacos corporate headquarters with the following information:
- Entity ID: hq-1
- Name: Turtlehead Tacos Headquarters
- Address:
- Address: 100 Congress Ave
- City: Austin
- State/Region: TX
- Postal Code: 78701
- Main Phone: 800-415-5555 (leave the +1 US country code as-is)
Create an entity template so that any new Job entities are standardized when they’re added to the Knowledge Graph. Name it “New Jobs” and include the following fields:
- Job Photo: Use this URL: https://dynl.mktgcdn.com/p-sandbox/ikDP_y9n1CtAUdWjCg7AgZhcYm4XadTxjWzwKr4A84I/700x450.jpg
- Benefits: Include the following options:
- Medical and Dental insurance plans
- Paid time off
- Personal development and career growth opportunities
- Discounts on food and merchandise
Now that the Job entity schema and entity template are set up, you can upload the Jobs data file you downloaded earlier. But wait: the file doesn’t have columns for Entity Type or Country, which are required fields for all new entities. Resolve this in one of two ways:
- Add the columns to the file and fill in the value “Job” and “US” respectively, and then upload it to Yext, or
- Begin the Entity Upload flow in Yext and add these fields during the Configure File step.
When you upload the Jobs data file, configure your file upload so that any new entities use the “New Jobs” template you just created.
Save the upload configuration as “Job File.”
Create a folder structure to organize all Job entities by the Job Department field. To do this:
- Navigate to Knowledge Graph > Configuration and select Folders.
- Click Create Initial Structure.
- Under Structure Type, set an Entity Type Specific Folder Structure and click Save.
- Click into the Structure section. Under Job, click to add a subfolder level and select the Job Department field.
- Click Reorganize Folders and confirm your choices.