Global place to refer messages

General
1

If I have many convo.txt files which have the same messages (bot and user), is there a way to store the text messages at a common global place and refer them?
This is to make sure all the information is at one place so that any change can be made to just one file that effects all convo.txt files.

2

You are talking about Utterances - read about it in the Botium tutorial

3

Thank you @Florian
Can we make BUTTON as part of an utterance in the utterances.txt? It is not working for me if I try this way.

convo.txt
#bot
CARD()
BUTTON(I Agree | I Agree)
BUTTON(Decline | Decline)

#me
UTT_2

utterances.txt
UTT_2
BUTTON(I Agree | I Agree)

I tried extracting just the text “I Agree” into the utterance like below. It did not work.
convo.txt
#bot
CARD()
BUTTON(I Agree | I Agree)
BUTTON(Decline | Decline)

#me
BUTTON(UTT_2 | UTT_2)

utterances.txt
UTT_2
I Agree

Below works without any utterances.
convo.txt
#bot
CARD()
BUTTON(I Agree | I Agree)
BUTTON(Decline | Decline)

#me
BUTTON(I Agree | I Agree)

4

Utterance files are for text synonyms only.
maybe partial convos can help - lookup in Botium Docs

5

Thank you @Florian
In pconvo.txt, can we have more than one partial convo and refer in convo.txt? Currently, below is not working
convo.txt
#bot
Question

INCLUDE AGREE_LOGIN

#bot
question

INCLUDE ASSESS_RISK

pconvo.txt
AGREE_LOGIN

#me
BUTTON(I Agree | I Agree)

ASSESS_RISK

#me
Assess your risk

6

In this case there actually should be three files (one convo, two partial convos). And I suggest to use the #include tag for including partial convos

main.convo.txt

main

#bot
Question

#include AGREE_LOGIN

#bot
question

#include ASSESS_RISK

AGREE_LOGIN.pconvo.txt:

AGREE_LOGIN

#me
BUTTON(I Agree | I Agree)

ASSESS_RISK.pconvo.txt:

ASSESS_RISK

#me
Assess your risk
7

Thank you @Florian
Can all the pconvo.txt text files and the utterances.txt files be placed in a folder and all the convo.txt files in a different folder. Can you please share botium-cli run command that refers to these folders for such if it is possible?

8

botium-cli traverses the directory tree recursivly and looks for all supported file types.

9

@Florian
Lets say, I have the following structire
TEST folder
utterances folder
utt.utterances.txt
pconvos folder
p.pconvo.txt
convos folder
c.convo.txt

My botium cli run at TEST folder is:
botium-cli run --expandutterances --convos convos/c.convo.txt

Above is not working.
I want to run specific convo text files to test various things

10

create a spec folder and place your whole directory in it.
point --convos to the ./spec folder