Forum Discussion
Exporting Variables into a Google Spreadsheet
Having read this post on how to export variables to be read in a google spreadsheet, I set about trying to get this working in my project, I soon ran into problems, I just could not get it to work as google have changed some of the ways they work their drive documents.
So, after a LOT of google searching and testing various methods, plus reading this article, I came up with the following method which is a combination of the two articles – and it works, hurrah!
1. Create a new google spreadsheet and change the sheet name (lower left hand corner) to DATA. Make sure your column names are the same as the variables you want to export (exactly matching case)
2. Find out your spreadsheet ‘key’ by looking in the address bar, the key is the long series of letters and numbers after /d/ and before /edit:
Eg: https://docs.google.com/spreadsheets/d/1gF0QCNA1TZCNY3qr2zNpWKQ8r43D39o-nqz56c7cQUs/edit#gid=1283040575
Key = 1gF0QCNA1TZCNY3qr2zNpWKQ8r43D39o-nqz56c7cQUs
3. Open the script editor (Tools ==> Script Editor) in your spreadsheet and paste the script from the attached file (I have copied and pasted this script and just kept in all the instructions)
4. There are two places in the script where it says “KEY” – copy and paste your key into these two places, between the “”.
5. Run the setUp script twice (Run menu). The first time it will ask for permission to run (grant it), then the second time you select to run it you won't get any popup indication it has run.
6. Go to Publish > Deploy as web app, enter Project Version name and click 'Save New Version', set security level and enable service (most likely execute as 'me' and access 'anyone, even anonymously).
7. Copy the 'Current web app URL' and paste in a notepad file to keep safe.
8. In Articulate, add a trigger to run javascript and use the following code, replacing “Current web app URL” with your URL you copied in the previous step (in””):
var player = GetPlayer();
$.ajax({
url:
"Current web app URL",
type: "POST",
data: {"Name": player.GetVar("Name")
, "Rating1": player.GetVar("Rating1")
, "Rating2": player.GetVar("Rating2")
, "Rating3": player.GetVar("Rating3")
, "Rating4": player.GetVar("Rating4")
, "postRating1": player.GetVar("postRating1")
, "postRating2": player.GetVar("postRating2")
, "postRating3": player.GetVar("postRating3")
, "Postrating4": player.GetVar("Postrating4")},
success: function(data)
{
console.log(data);
},
error: function(err) {
console.log('Error:', err);
}
});
return false;
9. Publish your articulate project – you need to host it somewhere like SCORM cloud or a LMS. When it has finished publishing click to open the files and edit the story.html and story_html5.html files – add the following line in under the line <!-- version: X.X.XXX.XXX --> or somewhere after <head>:
<script src="//code.jquery.com/jquery-1.11.0.min.js"></script>
10. Go back to articulate and click ‘zip’ – then publish your zip file and hopefully it will work!
This isn’t for the faint hearted but it is so worth it if you can get it working! Good luck!
- SteveFlowersCommunity Member
If you don't want to use the iFrame method, you can use Jquery pretty easily. I don't like to do post publish surgery so I use a bit of Javascript to jack jquery into the head of the document at runtime. Note that you need to load this well ahead of your AJAX calls. Don't try to load this and your AJAX call in the same trigger.
function add_script(scriptURL,oID) {
var scriptEl = document.createElement("script");
var head=document.getElementsByTagName('head')[0];
scriptEl.type = "text/javascript";
scriptEl.src = scriptURL;
scriptEl.id=oID;
head.appendChild(scriptEl);}//only want to add these once!
if(document.getElementById('jquery')==null){
add_script("https://ajax.googleapis.com/ajax/libs/jquery/1.10.1/jquery.min.js","jquery");
}In a separate trigger (give it some time after your JQUERY head load):
var player=GetPlayer();
var vStudent=player.GetVar("studentName");
var vSupervisor=player.GetVar("supervisorName");
var vFacility=player.GetVar("facilityName");var fTarget="https://docs.google.com/a/nara.gov/forms/d/YOURUNIQUEFORMID/formResponse";
function submit_form(){
$.ajax({
url: fTarget,
type: "GET",
data: {"entry.1481580269" :vStudent,"entry.1244291729":vSupervisor,"entry.2088465962":vFacility},success: function(data) {
//won't return since it's cross domain
}});
return false;}
setTimeout(submit_form(), 2000); - kristianchar230Community Member
@Steve, you're a genius. How did you ever figure out the form entry ID thing? That's brilliant.
- AlisonGretchenSCommunity Member
@ Ken. I tried following all the instructions and still struggled.
I came across this website
It has a built in template that can be used for your projects. I haven't had any problems but anything can happen.
Hope this helps.
Thanks Alison for sharing that - and it's worth noting that as of August, Google Drive no longer allowed for hosting of HTML files. With that in mind, you'll want to look at a web server such as Amazon S3 - we've got a great tutorial on this here.
- KenRussomCommunity Member
Thank you Alison, I've been working on this and followed the example exactly, even had a 'tech' guy look at my work and we're still not having any success.
This is hosted on wordpress and the site is Http:// not Https:// . Someone told me that wordpress might strip all scripts.
In the process of setting up another server for testing, I'll let you know.
- KenRussomCommunity Member
Actually I found the problem. I had one variable that was killing the script. Renamed it to shorter less cryptic name. Got things exporting fine.
Thanks for everyone's help. Actually it pretty simple once you past the 'brain freeze'
Thanks Ken for that update and I'm happy to hear you were able to figure it out!
- AbhishekRoyCommunity Member
Thanks for the great tutorial.
a) Will it work for concurrent users ? I have several users taking the course at same time ?Will it create a seperate row in Google Spreadsheet for each user ? or overwrite in the same row ?
b) The most important aspect i want is that the same row in the sheet should be used for a particular user for that specific attempt / session. Not create a new row for the same session whenever the javascript trigger is executed in Storyline. The JS trigger is set on each question slide to keep track where the user has left the course if he/ she exits the course halfway without completing it. Currently it creates a new row for each question.
- SteveFlowersCommunity Member
A) Yes. It will work for concurrent users.
B) The spreadsheet has no way to know if it's the same user. However, you can use formulas to find =Unique() from one sheet to another and get the last value or a calculated value.
For anyone following along, I wanted to let you know that Abhishek asked a similar question here as well.