Guidedtrack Q&A - Recent questions and answers

Answered: Is it possible to prevent pasting text into question response box?

Wed, 22 Nov 2023 01:19:32 +0000

Hi Ali! There is no built-in way to prevent pasting into a free text question, I'm afraid. The only way to do it would be to use custom JavaScript. For that you would have to embed the program on a website you control (see https://docs.guidedtrack.com/manual/using-the-guidedtrack-website/sharing-your-program-with-users/#embedding-the-run-or-preview-version-of-a-program-on-a-website).

Answered: How do I sort an Airtable json file and display it in a table?

Thu, 26 Oct 2023 16:37:05 +0000

Hi there,

To answer your questions:
Sort the collection: you might want to sort at the time you are pulling the data from Airtable, could be something like:

path: /table1?sort%5B0%5D%5Bfield%5D=Score&sort%5B0%5D%5Bdirection%5D=desc

About table header: you might want to use <th></th> outside of your while loop.
Hint: put the html table into variable before showing it

Check this out, I built a sample that might help you; https://www.guidedtrack.com/programs/25353

References:
https://docs.guidedtrack.com/manual/advanced-options/use-service-to-embed-outside-apps-and-other-tools/

Answered: How do I selectively allow users to go back in some parts of my program?

Mon, 31 Jul 2023 23:16:27 +0000

Yes, that's possible.

You can selectively enable *back in parts of your program by turning the setting on and off.

For example, add

*settings
*back: yes
*menu: no

before sections where you want users to be able to go back. In sections where you no longer want users to do that, add

*settings
	*back: no
	*menu: no

This is useful in several settings. For example, you could allow users to go back while answering screening questions up to the point where their screen-in / screen-out status is determined. You likely wouldn't want a user who screened out to return and answer differently.

Answered: How do I create a chatbot that can hold a conversation?

Wed, 31 May 2023 11:54:51 +0000

As you can see in ChatGPT's API reference, the parameter messages takes a list of messages with the conversation so far. The GuidedTrack program ChatGPT API - public only sends one message inside the list:

>> payload["messages"] = [ { "role" -> "user", "content" -> prompt_for_chatgpt } ]

You can use the program ChatGPT API with seleted parameters - public (https://www.guidedtrack.com/programs/22860) in order to include your whole conversation history inside the parameter messages. Create an association with the name payload on your main program, structure it as follows and then invoke the program:

>>payload = {"messages"-> [{"role"-> "user","content"-> "tell me a joke"},{"role"-> "assistant", "content"-> "why did the chicken cross the road" }, {"role"-> "user", "content"-> "I don't know, why did the chicken cross the road" }]}
*program: ChatGPT API with seleted parameters - public

For understanding roles: https://help.openai.com/en/articles/7042661-chatgpt-api-transition-guide
Also you may find this thread useful.

Answered: Can I format numerics nicely with commas?

Sat, 27 May 2023 19:15:17 +0000

I managed to build a not-great workaround, but the best approach might be embedded javascript or pre-generating the conditions outside of GT.

Here's the workaround, relying on two programs (one that takes variables a and b as input and returns num and exp, and a second that takes num and exp as input, returning currency).

multiply_num_with_ratio: https://www.guidedtrack.com/programs/22840
convert_to_currency: https://www.guidedtrack.com/programs/22841

>> numbers = [1000, 10000]
>> ratios = [0.1, 0.5] 
>> numbers = {}
>> questions = []
*for: n in numbers
	*for: r in ratios
		>> a = n
		>> b = r
		*program: multiply_num_with_ratio
		*program: convert_to_currency
		>> questions.add(currency)
*for: q in questions:
		Tom gave Jerry *{q}*

Answered: Is user_input_chatgpt the only command I can use to save information to send to ChatGPT?

Wed, 12 Apr 2023 19:29:49 +0000

The ChatGPT API program takes two optional variables, prompt_for_chatgpt and the model to use. The simplest program that would allow your users to ask two consecutive questions would be:

*program: ChatGPT API - public

*clear

*if: success_chatgpt = 1

	*{"RESPONSE FROM CHATGPT:"}*

	{response_from_chatgpt}

*if: success_chatgpt = 0

	*{"ERROR FROM THE CHATGPT API:"}*

	{error_from_chatgpt}
	
*button: Click here to ask a second question! 

*program: ChatGPT API - public

*clear

*if: success_chatgpt = 1

	*{"RESPONSE FROM CHATGPT:"}*

	{response_from_chatgpt}

*if: success_chatgpt = 0

	*{"ERROR FROM THE CHATGPT API:"}*

	{error_from_chatgpt}

If you don't set the prompt, the user gets to enter it. If you want to build the prompt based on the answers of your program's users, you'll save their answer into a different variable, and then build the prompt for ChatGPT, for example:

*question: Enter a short sentence
	*save: sentence
>>prompt_for_chatgpt = "Give me a sentence that rhymes with: {sentence}"

*program: ChatGPT API - public

What is happening here is that the user gets to enter a sentence that is saved into a variable called sentence. Then, the variable prompt_for_chatgpt is generated, incorporating the value of sentence (the curly brackets around a variable make it output its value). When the program ChatGPT API is run, the variable prompt_for_chatgpt is set so you will notice that the question that was displayed before, ins not displayed now.

Regarding the error message you were getting, the problem is that you copied and pasted the code including the *label, which is like a bookmark and has to be unique. You can omit the *label if you don't have a *goto statement.

Answered: I can't build an app that incorporates ChatGPT

Tue, 11 Apr 2023 12:00:19 +0000

Go to the settings of your program, and check that the name of the service is set to ChatGPT API
(if you followed instructions on the blog post to configure the service, there was an error and you were instructed to set it to ChatGPT OpenAI API instead. The blog post has been updated now)

Answered: How can I save a series of associations with a *for loop?

Mon, 10 Apr 2023 12:32:08 +0000

Richard Möhn kindly answered this in the Slack. I'll write the answer here:

"I think this would get you all the way to what you want:"

>> hours_for_activities = {}
*for: activity in activities
	*question: How many hours you spend *per week* on {activity} on average?
		*type: number
		*save: hours_for_activity
		
	>> hours_for_activities[activity] = hours_for_activity

And he followed up with an explanation on how to list the items or sum them:

*for: activity, hours in hours_for_activities
	You spent {hours} h on {activity}.

>> total_hours = 0
*for: activity, hours in hours_for_activities
	>> total_hours = total_hours + hours

Thanks, Richard!

Answered: HTML/CSS classes styling has no effect

Mon, 13 Mar 2023 20:01:35 +0000

Some times you will need to use the rule !important to override GuidedTrack's default styles:

*html
    <style>
	    .my-fancy-header-class {
		    color: purple !important;
		    font-weight: bold !important;
		    font-size: 96px !important;
	    }
    </style>

Thanks for pointing out that the example in the documentation had stopped working since the last update of GuidedTrack's styles. It has already been updated.

Answered: How do I randomize the order of clickable components and set the click to run another program?

Sun, 05 Mar 2023 19:23:22 +0000

You need to have the content to randomize indented right under the *randomize keyword, so all you have to do to get your code to work is to change the first two lines:

*component
	*randomize: 2
		*group
			*component
				*classes: bg-info
				*image: https://i.stack.imgur.com/WFy1e.jpg
					*caption: cats
				*click
					>> preferred_image = "Cat"
					*program:  second_program
				
		*group
			*component
				*classes: bg-info
				*image: https://i.stack.imgur.com/WFy1e.jpg
					*caption: Family or dog?
				*click
					>> preferred_image = "Dog"
					*program: second_program

*wait

The code that you add below the components gets displayed because a component, even if it is clickable, does not act like a page break. In order to create the page break, note that I added a *wait forever.

If you want to have some code after the components that gets executed after second_program is run, you can use a *goto and *label:

		*group
			*component
				*classes: bg-info
				*image: https://i.stack.imgur.com/WFy1e.jpg
					*caption: Family or dog?
				*click
					>> preferred_image = "Dog"
					*program: second_program
					*goto: after_second_program

*wait

*label: after_second_program

Answered: Other's responses displayed within survey

Sun, 05 Feb 2023 13:12:31 +0000

GuidedTrack does not allow you to access the data generated in other runs of your program from one run, but you store the data that you want to share in an external database (for example, Airtable).

There is a tutorial on how to write and read from an Airtable base in the blog: https://blog.guidedtrack.com/?s=airtable#airtable

Answered: How to make a value get stored in a column of the CSV file that I choose dynamically?

Sun, 05 Feb 2023 13:00:13 +0000

You can use >>data::store(columnName, value) to achieve that:

*while: enterAnotherCategory = 1
	*question: What would you like to rate?
		*save: category

	*question: How would you rate the {category} of this service?
		*save: ratingForThisCategory
	>>data::store(category, ratingForThisCategory)

So if a person chooses to rate the "customer support" of the service, there will be a column in the CSV file with the title "customer support".

Answered: Is it possible to batch extract timings for each question?

Wed, 18 Jan 2023 06:43:20 +0000

It's not possible through the UI, I'm afraid. If it's a one-off, we could extract the data from the database and send it to you.

An alternative is to save the time explicitly, although it's going to be relative to some starting point. Like this:

>> startTime = calendar::now

*question: How quickly can you answer?

>> q1Time = calendar::now
>> q1Delay = q1Time - startTime

Then q1Delay would show up in the CSV as ‘2.056 seconds’, for example.

Answered: How to include a chart in an email?

Sun, 07 Aug 2022 16:52:33 +0000

I like to use QuickChart.io - this blog post has an example of how to use it.

Answered: How to ensure at least one checkbox is selected? (within a FOR loop)

Fri, 24 Jun 2022 14:04:41 +0000

The reason *for doesn't allow *goto within its block is that *goto could be used to prematurely break out of the loop. If that were to happen there could be unexpected behavior if that *for loop is ever executed again. The reason for that is that *for needs to automatically keep track of where it is in the loop and what the next element in the collection ought to be.

Most of the time these constraints don't matter and we recommend using *for, because it's easier to use than the alternatives. However, since in your case the constraints *for imposes are getting in the way of accomplishing the task, I'd recommend switching to a *while loop. You'd need to do a little bit more manual work to loop, but you'll be able to use *goto.

To convert your *for loop into a *while, you'll need to declare an indexing variable and increment it at the end of the loop:

>> i = 1
*while: i < vacation_spots.size
	-- the code you currently have in *for, with *goto where you need it
	...
	>> i = i + 1

Answered: Back button hard to see in user testing

Tue, 10 May 2022 12:25:12 +0000

It would be very difficult to make that change the default look for GuidedTrack programs for several reasons:

the navigation bar, where the back button is located, can potentially contain a lot of elements and is therefore very short on space; we simply can't easily cram in a whole word
choosing the work "Back" would present a problem for people building tools in languages other than English – we would have to give them a way to configure a different word, which would also run into the first problem since we wouldn't know how long that word is

You can configure your own app to implement this change, though, if you're embedding your app on your own site, rather than having people use it directly from guidedtrack.com. You just need to include the following CSS rule somewhere on the page or in a separate CSS file:

#back-button span:after {
  content: "BACK";
  font-family: Roboto, sans-serif;
}

Hope that helps.

Answered: *Wait Is it possible to show countdown/timer?

Tue, 19 Apr 2022 08:25:00 +0000

I had to so something similar to what you're asking so this may help you.

I needed to display a text for a number of seconds showing the countdown bar and, at the end of the countdown move on to the next page. Since *countdown only works under a question, I used custom CSS to hide the question (so that only the countdown bar is displayed). Countdown automatically moves forward after the specified amount of time, so you can skip using *wait:

*html
	<style>
		.hidden {visibility: hidden !important;}
	</style>
This will be displayed only for 5 seconds!
*question: a
	*countdown: 5.seconds
	*classes: hidden
Page 2

Answered: How to do 2x2 grid for components

Mon, 18 Apr 2022 11:44:05 +0000

You can use the grid system of Bootstrap indenting*classes under your components. Check out this demo code to generate a 2x2 grid:
https://www.guidedtrack.com/programs/19308

You can see that in the code I have also used custom CSS defined using *html to make the components prettier, you can play around with that depending on what your needs are.

Answered: Collect Payment

Mon, 18 Apr 2022 09:17:32 +0000

Yes, by using the *purchase keyword. Please refer to the docs to set it up and try it out: https://docs.guidedtrack.com/manual/advanced-options/in-app-purchases/#in-app-purchases

Wondering if this is possible.

Fri, 15 Apr 2022 03:20:56 +0000

Answered: Can I change navigation buttons language?

Fri, 25 Feb 2022 10:59:25 +0000

Hi Benjamín,

Our internationalization features aren't very good at the moment. I'm afraid there's no option to change the default button text on slider questions.

There is a workaround for the specific case you mentioned – you could use an explicit *page keyword and make sure you end that page with a *button. You're free to use whatever text in whatever language for the button, and it'll look like a slider question:

*page
	*question: How are you feeling?
		*type: slider
	
	*button: Move on to the next page

In your case, you'd use Spanish for the question text and button.

Answered: Is there a direct URL for the CSVs containing Guided Track survey data?

Fri, 25 Feb 2022 10:50:19 +0000

Downloading the CSV necessarily means authentication, because GuidedTrack has to ensure that it's sending the data to someone who is authorized to read it. Not requiring authentication would effectively make all of your CSV data public, which wouldn't be responsible.

That said, I think it's possible to do what you want. There are probably many ways, but the one I found was to use httr, which is a wrapper for curl and has options for authentication.

The following ought to work to get your data into R, just replace GT_ACCOUNT_EMAIL and GT_ACCOUNT_PASSWORD with your account details:

library(httr)

GET("https://www.guidedtrack.com/programs/17783/csv", authenticate("GT_ACCOUNT_EMAIL", "GT_ACCOUNT_PASSWORD"))

The above probably needs more massaging to get a vector or something useful out of the data, but it should solve the immediate problem you're facing.

Another tricky bit is that the CSV is streamed to the client, since it might be a huge file. I hope httpr handles that correctly, but if it doesn't you might see your data truncated after 500 or so rows.

Edit: For people looking for info on how to write scripts that download the data for a GuidedTrack program, the solution is pretty much the same as above. Of course, you wouldn't be using R to write your scripts, but any language would have equivalent facilities.

Here's an example of using curl to write a bash script to achieve the same result:

curl -u "EMAIL:PASSWORD" https://www.guidedtrack.com/programs/PROGRAM_ID/csv

To adapt the above command for your use case, in the above replace EMAIL with the email associated with your GuidedTrack account, PASSWORD with your GuidedTrack password, and PROGRAM_ID with the ID of the program you want to download the data from. You can find the ID by opening the program and looking at the address bar of your browser – if the URL is something like https://www.guidedtrack.com/programs/123/ or https://www.guidedtrack.com/programs/123/edit, then the program ID is 123.

Answered: How to customise a PDF based on GT user answers?

Wed, 16 Feb 2022 12:08:23 +0000

Following up on this, here is a blog post on how to generate a pdf using APITemplate.io from a GuidedTrack program: http://blog.guidedtrack.com/?p=560

Answered: Embed if statements under question answers

Fri, 28 Jan 2022 14:18:23 +0000

As Belén said, this should work. Are you sure the sex variable is defined when the *ifs run?

Answered: How to create a matrix of questions?

Tue, 07 Dec 2021 12:15:58 +0000

GuidedTrack currently doesn't support matrix questions in the exact form you're asking for. We've had this request before and looked into adding matrix questions, but each time this has come up we've decided against it. There are two main reasons for this:

Matrix questions are hard to use

When we talk to survey participants, they're generally pretty emphatic that they find the layout hard to work with. They tend to take longer to fill out these questions and we suspect they make more mistakes while doing so. One of the principles we try to abide by in GuidedTrack is to prevent people from building the wrong thing when we can, and there seems to be some evidence that replacing matrix questions with vertical multiple choice questions is better for participants and for the quality of the data you get our of your studies.

Matrix questions don't work well on small screens

Horizontal space is very limited on mobile phones and matrix questions require a lot of it – you need to fit the question text and all the answers on the same row. Making this work on phones is a difficult task, and, compounded with the usability problems mentioned above, is further reason to choose an alternative way of collecting data.

My suggestion is to try converting the matrix questionnaire into a series of multiple choice questions that share the same scale. This is very easy to do in GuidedTrack:

>> scale = ["Option A", "Option B", "Option C"]

*page
	*question: Question 1
		*answers: scale

	*question: Question 2
		*answers: scale

	*question: Question 3
		*answers: scale

So far, each time we've suggested this approach it has turned out to be a good replacement for matrix questions. I hope it works for you as well.

Further resources

There are more advanced things GuidedTrack allows you to do with answer scales. Check out the *answers documentation page to learn more: https://docs.guidedtrack.com/manual/asking-questions/questionnaire-answer-scales-using-answers/
We wrote a guide to effective study design with GuidedTrack, which should help you squeeze out the most out of GT's powerful features: https://docs.guidedtrack.com/research-guide/

Answered: Get a unique ID for user?

Thu, 25 Nov 2021 10:36:46 +0000

You could create a table in Airtable with just one record where you store the last order ID you generated. In your program, you would then withdraw that number and increment by one to use it in that run, updating Airtable as well.

It is a clunky solution but it will work. In the future you should not need to use an external provider to share the value of a variable across different program runs but that functionality is not yet implemented.

Another option is to generate a random number that is really big (with 10 digits, for example): technically there could be two ids that are the same but the likelihood of that happening is really small.

Answered: Possible to create a Dashboard?

Tue, 16 Nov 2021 14:31:33 +0000

Good question! This is definitely possible. I've put together a quick demo for you to inspect. I chose basketball because it's my favorite sport and because you only need 5 players, so it was less work to put together.

The main program is here and the code is publicly available:
https://www.guidedtrack.com/programs/19411/edit

It asks you to enter a player for each position, then displays the five players you've entered. Clicking on a player allows you to edit their details.

The code is pretty straight-forward. The only tricky part is the use of *component inside a *for loop, which also makes it necessary to use *with in order to handle clicking each component properly. You can read more about this in the documentation.

If you want to try the dashboard out, the link it here: https://www.guidedtrack.com/programs/49riqjl/run.

I expect you'll have follow-up questions, so please ask away.

Answered: Is it possible to record audio from a participant?

Mon, 11 Oct 2021 07:54:28 +0000

It is possible, but hard. What you would need:

Know the JavaScript for recording audio.
Embed the GuidedTrack program on a website you control, so that you can make the audio recording JavaScript available to the GuidedTrack program.
Use *trigger and *events and *goto and *wait in a hacky way to cause the JavaScript to record the audio and the GuidedTrack program to wait for the recording to be done.
Upload the recording to a storage service, such as Dropbox, by using the HTTP API of that service. (Since you can't store the audio on GuidedTrack.)

We're going to add features to make this simpler in the future. But for now you have to go the hard way.

If you contact us (see my private message), we can help you with the details. It would be too much to write the complete how-to here.

Answered: Persisting text/image below each page (footer)

Fri, 08 Oct 2021 09:57:03 +0000

You can use a component with classes to do that:

*html
	<style>.myProgramFooter {position:fixed; bottom:-30px; right:0; border:0px !important;}</style>

*component 
	*classes: myProgramFooter
	*image: https://i.imgur.com/hrOOAsA.jpg

You can play around with the css to adjust it to your needs. Use position:fixed so that it is always displayed at the bottom of the screen and position:absolute so that it is below the content of the program. You will need to add the code in every page, but you can create a subprogram with the code above and that way you only need to write on each page:

*program: my footer program

(or whatever you name the program)

Answered: Conditional statement if question is blank

Thu, 26 Aug 2021 14:30:49 +0000

Assuming that the question that saves the answers to placesToEat is of *type: checkbox or has *multiple indented under it, placesToEat will be a list/collection (the documentation is here in the manual).

What you would do is to check the size of that list - if your user skipped the question, the size of the list is 0:

*if: placesToEat.size = 0
	Oh it's empty in here. Let's help you find a restaurant.
	*button: Next

Answered: Getting UTC Time

Mon, 23 Aug 2021 19:27:31 +0000

You can use *service to retrieve it from a site like http://worldclockapi.com/api/json/utc/now.

Here is how you would do it. In your program, use this code:

*service: utc
	*path: /
	*method: GET
	*success
		>>out_UTCtime = it["currentDateTime"]
	*error
		>>out_UTCtime = ""

and then you need to go to your program settings to configure the service:
1) On Settings>Services, click on "New service"
2) Fill the "Name" field with utc, and the "URL" field withhttp://worldclockapi.com/api/json/utc/now, leaving all the other fields blank
3) Click Save and the program is ready to run!

Answered: Customize summary - or how to display tags

Thu, 19 Aug 2021 11:11:03 +0000

If you want to customize your summaries, you may find it useful to save the answer to each question into a variable, and then display the variable with whatever text you choose:

*question: What is your favorite color?
	*save: favColor
	
Your favorite color is {favColor}

Answered: Allow user to add answer if selection is not sufficient

Thu, 19 Aug 2021 11:08:18 +0000

Hi! Try this code:

*question: What are your favorite colors?
	*type: checkbox
	Red
	Blue
	Orange
	Other
	*save: favColors
	
*if: "Other" in favColors

	*label: askOtherColor
	*question: What other colors?
		*tip: Enter one color per line
		*multiple
		*save: addFavColors
		
	--add addFavColors to the list of favorite colors
	>>favColors.combine(addFavColors)
	
	--remove "Other" from list of favorite colors
	>>favColors.erase("Other")
	
This is your list of favorite colors: {favColors}

Answered: .erase and .add is removing/adding elements in more than one collection

Wed, 28 Jul 2021 08:37:34 +0000

Hi!
Do this instead:

>>resultsFull = [] 
>>resultsFull.combine(resultsOriginal)

You can find the full explanation for it in the manual:
https://docs.google.com/document/d/1RKblBEwG7BrMMeTXFITSNDJQsszHotqaE_q-E9q0QHA/view#heading=h.ds7raeq957xu

Answered: Change what happens depending on multiple answers to checkbox question

Mon, 26 Jul 2021 23:38:59 +0000

Anon gave a sleek answer, which I liked.
I just wanted to comment on an alternative, which is to assign a variable after each alternative. For instance:

*question: What is your favourite colour?
	Yellow, like a shining sun.
		>>answer="correct"
	Blue, as the bluest skies!
	Green

*if: not answer = "correct"
	You're wrong! Yellow is the colour!

---Or, if you'd like to add an explanation for each answer.

*question: What is your favourite colour?
	Yellow, like a shining sun.
		>>answer="yellow"
	Blue, as the bluest skies!
		>>answer="blue"
	Green, green, green, green...
		>>answer="green"
	I want it all painted black.
		>>answer="black"

*if: answer="yellow"
	You're right! Yellow rocks!
	
*if: answer="black"
	No! Black is not a colour. It's the absence of colours.
	
--- and so on...

Please, notice this wouldn't work with a question of the Checklist type. Anon's answer is more suitable for that.
Hope that helps!

Answered: event goto leads to "Uncaught TypeError: Cannot read property 'history_entry' of undefined"

Tue, 20 Jul 2021 12:16:10 +0000

It's late, but this should be fixed now. Sorry for taking a long time!

Answered: Why is a variable being miscalculated?

Fri, 11 Jun 2021 10:12:30 +0000

The problem is that you are allowing the users to go back in your program. If they answer "yes" to the first two questions and then go back to the first one to change the answer to "no", the variable "languagesSpoken" is still 2. Then they answer yes to speaking Spanish and German, so the final value of the variable is 4.

You can try this code instead:

*settings
	*back: yes
*question: Do you speak French?
	Yes
		>>speaksFrench = 1
	No
		>>speaksFrench = 0
	
*question: Do you speak Spanish?
	Yes
		>>speaksSpanish = 1
	No
		>>speaksSpanish = 0
	
*question: Do you speak German?
	Yes
		>>speaksGerman = 1
	No
		>>speaksGerman = 0

>>languagesSpoken = speaksFrench + speaksSpanish + speaksGerman

Answered: Is it possible to create a clickable image?

Fri, 28 May 2021 06:16:26 +0000

If image maps get sanitized, that’s unfortunate. Essentially it would be a new feature to support this and I think we don’t have capacity for that now.

Depending on what you want to do, however, *component might fit the bill. See the documentation for *component (it takes a while to jump to the right place).

There is another workaround, which is hosting the image map on an external page and make the user go GuidedTrack program → external page → GuidedTrack program#some-label.

Host an HTML page with just your image map somewhere, eg. on GitHub Pages. Say it's called https://pascal.github.io/map.html
In your GuidedTrack program when you want the user to see the image, use
*goto: https://pascal.github.io/map.html
The image maps contains links back to the program.
https://www.guidedtrack.com/programs/abc234d/run#some-label

Answered: how to write questions from right(in Persian) in new version of guidedtrack?

Wed, 19 May 2021 01:03:45 +0000

Update 2021-05-28: The issue should be fixed now.

This is the workaround that I originally posted:

-- You've already got this part.
*settings
	*classes: text-right

-- This makes it work for questions, too.
*html
	<style>.text-right div.prompt { text-align: right; }</style>

Answered: Is it possible to retrieve time in milliseconds?

Wed, 05 May 2021 10:41:06 +0000

Hi! Yes, I think it's possible to see the time that someone responded to a given question, down to the millisecond. While in the "Data" tab, if you click on "questions" and then click on an individual question, you can see, down to the millisecond, the time that each question was answered.

Answered: Can one capture voice recording from participants?

Thu, 08 Apr 2021 18:37:32 +0000

Hi! We don't currently have this feature-- GuidedTrack can include your own audio files in surveys, but there isn't the ability to create recordings within a program. We don't have file creation/upload functionality in general. Unfortunately the best workaround I can think of is collecting links to files hosted elsewhere.
I do think this would be useful, and I will bring the suggestion to the team!

Answered: Color a single word in a question - HTML tag is buggy

Wed, 24 Mar 2021 08:03:06 +0000

You can wrap up the whole paragraph:

*html
	<p>Tatyana knew that Grandma always enjoyed serving an abundance of food to her guests. Now Tatyana watched as Grandma gathered Tatyana's small mother into a wide, scrawny embrace and then propelled <span style="color:red;">her</span> to the table, lifting her shawl from her shoulders, seating her in the place of honor, and saying simply: "There's plenty."</p>

Answered: Receiving a variable through a custom event

Tue, 23 Mar 2021 08:34:13 +0000

Hi,

If you are embedding the GuidedTrack program with an iframe, you would not be using custom events. Instead, what you can do is to reload the program running in the iframe passing whatever information you need via url parameters.

This is a program that captures the name and last name of a person and greets them: https://www.guidedtrack.com/programs/16334/edit

Now, let's say that in your site there is another place where the person can enter their name and you want to pass it to your GuidedTrack program when they click a button. This is what the html code could look like:

<button onclick="myFunction()">Send name to GuidedTrack</button>
<iframe id='iframeid' src="http://www.guidedtrack.com/programs/ur9vkak/run" width="100%" height="600px"></iframe>

And this is the myFunction() code, which reloads the same program but assigning a value to the program variables userName and userLastName:

    <script>
function myFunction() {
    document.getElementById('iframeid').src = "http://www.guidedtrack.com/programs/ur9vkak/run?userName=Peter&userLastName=Jackson" ;
}
</script>

In the code of the GuidedTrack program, you can see that at the very beginning there is a *startup event:

*events
*startup
	*if: userName
		*goto: greeting
			*reset

When you initially load the program but have not yet clicked the button, userName has not been defined so this block of code does nothing and the program goes on to asking the questions. Anytime that you click the external button, the program will reload and it will take the userName and userLastName that have been passed as url parameters (with values "Peter" and "Jackson"). When you do that, the code under *startup gets executed immediately so in this case, the program flow will go to the final greeting page.

Answered: What's the easiest way to get a pdf of the survey?

Mon, 15 Mar 2021 22:38:15 +0000

Hi Ali! Based on the link you shared, it sounds like you want to create a pdf of a survey, without any pre-filled answers (e.g., so that it could be printed and filled out as a paper-based survey) - is that right? If so, then I think there might be ways to do this with the *service keyword plus paid APIs, but I'll wait to see if anyone else reading this has ideas on that front.

On the other hand, if (instead of printing a blank survey) you wanted to summarize someone's answers (e.g., to share with someone who's already completed their survey), I could share some ideas for how you could go about that?

Answered: Numerical Validation

Mon, 15 Mar 2021 06:19:02 +0000

*label: age
*question: how old are you?
	*type: number
	*save: age 
	
*if: age < 20 
	Please try again. 
	*goto: age 
	
*if: age > 70
	You're way too old to be doing this. 
	*goto: end

You are {age} years old 
*button: cool
*label: end

Unsure if this is what you mean but here's just like a way around it probably. :)

Answered: Remove from collection

Mon, 22 Feb 2021 08:07:48 +0000

You can use the new functions .erase and .remove.

.erase removes something at a given index, for example:

>>friends = ["Liz", "Ana", "Sam"]
>>friends.remove(2)

The code above will remove the second element from the collection (the one with value "Ana")

.remove will remove all of the elements that match a give value:

>>tripsThisYear = ["Paris", "London", "Rome", "London", "Madrid"]
>>tripsThisYear.erase("London")

If you run the code above you will see that the function removes the two elements with value "London"

show a tip for an question only after a specified time has passed

Sun, 24 Jan 2021 18:47:49 +0000

So I want to have a question but want to display text under the question, but display it only
after 5 minutes have passed. It's for a digital escape room game, where my students are supposed to think about the answer before receiving a hint.
The way it is now, anything under the question will not be displayed until an answer is submitted.
I don't quite get how you can use maintain to do what I'd like to do.
I could use wait after the question, but not before the question, because then the question won't be displayed.
Any ideas?

Here's my code (I don't get why when I paste the code from my program, the indentations don't show):

*label: question1

>>answer = "wrong"
*while: answer = "wrong"

*question: What's the answer to everything?
	*type: number
	42
		>>answer = "correct"
		*goto: question2
	*other
		That's not yet correct.
		*goto: question1

*wait: 5.minutes
Here's a tip. It's an answer from Mr. Adams.

Built in way to highlight correct answer for quiz questions (applying css to classes dynamically)

Fri, 22 Jan 2021 00:20:57 +0000

I'd like to have a way for participants to get immediate feedback within the same page about whether or not they've gotten a question right by highlighting their answer as either green or red depending on if they got the answer right.

For example:

*question: Select Option 1
	1
	2
	*save: option

If they select option 2 their selected answer should turn red. If they selection option 1, their selected answer should turn green. My current approach is to transform the question into components and, if they get an answer right, to re-render the components on the next page with a green or a red class. This is somewhat clumsy and requires a bunch of if-statements a lot of text and another page load.

Is there a better way of doing this?

Loop through a set of questions until participant opts to exit study

Wed, 20 Jan 2021 21:46:26 +0000

Let's say I have a list of 15 questions which I want to show to a participant one at a time. However, before each question I want to ask the participant if they'd like to answer another question from that set or if they'd like to exit the study. If the participant indicates they'd like to answer a question, one question should be randomly taken from the list and shown to the participant. This loop should continue until the participant has exhausted the questions available or until the participant says indicates he'd like to leave the study.

So, for example, a participant would be asked the following

*question: Would you like to answer one more question?
	Yes, show me one question
	No, I'd like to end the study
	*save: question_decision

If Yes --> Pull a question from a list of questions and add one to counter. If No --> Exit Study.

I imagine this has to be done with a collection and goto and label statements which loop until the value of question_decision is "No." However, I couldn't figure out how to randomly pull a question and its associated answer choices for the purpose of this task. Any thoughts?

summary by answers

Sun, 17 Jan 2021 19:06:43 +0000

I am making my survey and I have a question about generating a report for the user.

I want to be able to feedback to the user when they finish the survey, highlighting all the questions where they gave a particular answer for a number of multiple-choice questions. I.e., where a user answers "strongly agree" to any of these questions, I want these questions to be highlighted for them at the end.

I am able to tag questions(as per the 'summarizing entered data' section of your handbook, however, I want to be able to tag specific answers (multiple choice) instead of the questions.