This document has multiple references to How do I build Taxonomy document
| Table of Contents | ||
|---|---|---|
|
Taxonomy Node
The Taxonomy node lets you use the taxonomy tree in Experience Manager with the flows in Experience Designer. There are three actions to choose from:
Get
Create
Upsert
Get action
Get action is used to retrieve Taxonomy data from the database. Taxonomy Node inputs leverage the mustache {{tag}} template language, which is applied to the node input either reference from msg.payload or msg
...
Taxonomy Id
The ID of the taxonomy tree should be given here. You can give an ID manually or can populate it dynamically populate the field using a mustache tag.
For example: {{msg.payload.voiceMenuId}}
...
Category Phrase
You can manually fill this field or make use of a mustache tag. The node searches the first-level categories in the taxonomy tree for a match. If found, it selects that taxonomy branch.
...
Session Management for Category - If a Category is found, the Taxonomy node stores the Category in the session and uses it in the next query if a category is not passed to it.
SubCategory Phrase
You can manually fill this field or make use of a mustache tag. The node Searches within the taxonomy branch mentioned in the “Category Phrase” field.
...
For example, the auto-generated slot name for this taxonomy subtopics is First_Aid_Subtopics. The alternate slot name created to use within the intent is subCategory, which is used in all the utterances. The same slot name (ie. subCategory) is passed in the mustache tag in the SubCategory Phrase field of the Taxonomy node.
...
WhatAskStart
The text provided in the “WhatAskStart” can be accessed with the properties “whatYouCanAskParentChild” and “whatYouCanAsk”.
...
| Code Block |
|---|
for other article{{plural}} on {{Category}}, you can say <break time="400ms"/> |
...
WhatAskLoop
This field is used for speech synthesis of the branch titles that are suggested in the “WhatAskStart” field.
...
Either of these parameters can be used in the say node as shown in the below screenshot to suggest the subtopics to the user.
...
Multi Category
This message will be sent to the output pin if multiple categories are found.
...
| Code Block |
|---|
There are {{length}}, main topics found, for <break time='300ms'/> {{Category}}, you can say <break time='500ms'/> |
Multi Sub Category
This message will be sent to the output pin if multiple subcategories are found.
...
| Code Block |
|---|
There are {{length}}, sub topics found, for <break time='300ms'/> {{subCategory}}, you can say <break time='500ms'/> |
Replace Words
A comma-delimited list of words to replace.
...
Note: The language processors sometimes generate misspelled words, or words not in your context, such as byte versus bite, joking versus choking
Create Action
Using the Create action, you can create taxonomy categories or subcategories using the Taxonomy node.
...
| Info |
|---|
If a valid parentId is not given then, by default, it updates the Root node. |
Upsert Action
Using Upsert action, you can update any existing taxonomy categories or subcategories. If no entries are found, the system will insert the queried values into the database.
...
| Info |
|---|
If a valid parentId is not given then, by default, it updates the Root node. |
Output Payload
SayText
| Code Block |
|---|
msg.payload.orbita.taxonomy.SayText |
...
| Code Block |
|---|
msg.payload.orbita.taxonomy.whatYouCanAskParentChild |
Example flows in Experience Designer
In this section, there are two example flows to get you started with using the Taxonomy node in the Experience Designer. Also, find the attachment to get the JSON code of the two flows.
Example Flow 1
The following image shows the sample flow in the Experience Designer. The JSON code of the flow is attached to this document.
...
Slot Values and intents
If you enabled Auto Generate Slots when creating the taxonomy tree, then the topics and subtopics slots are created in the database automatically. The auto-generated slots are named Taxonomy_tree_name_Topic and Taxonomy_tree_name_Subtopic.
In this example, the taxonomy name is Test Info. The slots named Test_Info_Topic and Test_Info_Subtopic are auto-generated which can be used in the intents.
...
Example flow 2
Upon request, the following flow is used to list all the topics from the taxonomy tree. The JSON code of the flow is attached to this document.
...
| Attachments | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Related Articles
| Filter by label (Content by label) | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|