Webinar. The Lighthouse Studio Scripting Series. Part 2 - Perl Sawtooth Software, Inc.

Transcription

1 The Lighthouse Studio Scripting Series Part 2 - Perl

2 2 HTML

3 3 CSS

4 4 JavaScript

5 5 jquery (enhanced JavaScript)

6 6 Perl

7 7 Sawtooth Script Scripting language provided by Sawtooth Software Consists of various functions or commands documented in the help Code that runs on server, not in your browser like JavaScript Simple

8 8 Examples Display previous answers [%Q1%] Build constructed lists ADD(List1, 1, 4) Perform functions, similar to Excel [%Round(Q1/Q2)%]

9 9 Sawtooth Script becomes Perl Sawtooth Script is written in Perl behind the scenes. Sawtooth Script: [%Q1 + 3%] is translated to Perl code: [%VALUE( Q1 ) + 3;%]

10 10 Sawtooth Script becomes Perl All Sawtooth Script functions are available in Perl Make sure to CAPITALIZE Sawtooth Script functions Question names are in quotes [%VALUE( Q1 ) + 3;%]

11 11 Perl Perl is a powerful programming language Custom Perl code can be used for additional flexibility in Sawtooth Script Perl code is executed on the server before it is sent to the browser Custom Perl (Unverified Perl) is straight Perl code that you enter into Lighthouse. You are on your own. We do not check it for errors.

12 12 DEMO

13 13 Perl Basics Variables if statements for loops Functions Etc.

14 14 Where can you use Perl? Perl can be used anywhere Sawtooth Script can be used: Question Text Constructed Lists Skip Logic Quota Logic

15 15 Perl Code Begin Unverified Perl if(value("q1") == 5) AIC("Q3"); End Unverified

16 16 Perl Variables Variables can hold single values such as a number or text Must always begin with a $ sign All variables in Perl must be declared using the word "my" my $days = 12; my $total_seconds = 0; $total_seconds = $days * 24 * 60 * 60; return $total_seconds;

17 17 Perl Strings Variables can store text Text or strings need to have surrounding them To join two strings together use a period my $base_name = Quest ; #Building question names on the fly can be useful. return Result is:. VALUE($base_name. 5 );

18 18 Perl Comments Comments allow you to document your code Comments are ignored by the computer Comments start with # sign my $base_name = Quest ; #Building question names on the fly can be useful. return Result is:. VALUE($base_name. 5 );

19 19 Perl Arrays Arrays are variables that can hold a collection of items = (35, 57, 13, 29, 68); my $total = 0; $total = $scores[0] + $scores[1] + $scores[2]; Arrays start and are accessed with $ArrayName[number] First item is accessed with 0 (0 based)

20 20 Perl Hashes Hashes are variables that can hold a collection of items that consist of key value pairs. Great for quick look up based on a key. my $found = 0; my %zip_codes = (); %zip_codes = ( => Sequim, => Heber, => Boston ); return $zip_code ; # returns Heber #Checking to see if the zip code entered exists if(exists $zip_codesvalue( QZip )) $found = 1;

21 21 Perl Flow Control The "if" statement can be used to conditionally execute code Only one AIC command below is executed if(value("q1") == 1) AIC("Q3"); elsif(value("q1") == 2) AIC("Q2"); elsif(value("q1") == 3) AIC("Q7"); else AIC("Q5");

22 22 Example my $q1 = VALUE("Q1"); if($q1 == 1) AIC("Q3"); if($q1 == 2) AIC("Q2"); if($q1 == 3) AIC("Q5");

23 23 Don t do this! my $q1 = VALUE("Q1"); if($q1 == 1) AIC("Q3"); if($q1 == 2) AIC("Q2"); if($q1 == 3) AIC("Q5");

24 24 Use elsif my $q1 = VALUE("Q1"); if($q1 == 1) AIC("Q3"); elsif($q1 == 2) AIC("Q2"); elsif($q1 == 3) AIC("Q5");

25 25 Perl Conditional Logic && AND > Greater than. OR < Less than. == Numeric compare for equal. eq Text compare for equal.!= Numeric compare for NOT equal. ne Text compare for NOT equal. if (VALUE("Q1") == 3 && (VALUE("Q2") > 4 VALUE("Q2") < 100)) AIC("Q5");

26 26 Perl Looping The for loop allows you to execute code over and over again my $num_quests = 50; my $total = 0; my $i = 0; #Initialize, test, increment for($i = 1; $i <= $num_quests; $i++) $total = $total + VALUE( Q. $i);

27 27 Looping - foreach = (55, 22, 4, 17); my $total_score = 0; my $single_score = 0; foreach $single_score (@scores) $total_score = $total_score + $single_score;

28 28 Perl Functions Functions are useful for packaging up code so that you can run it over and over again sub AddNums my ($num1, $num2) my $sum = $num1 + $num2; return $sum; return AddNums(4, 5);

29 29 GETVALUE() SETVALUE() In Sawtooth Script you can use: SetValue(QuestionName, value) GetValue(QuestionName) QuestionName can be any variable. Recommend using pass-in variables for this. [%SetValue(v1, 5)%] [%GetValue(v1)%]

30 30 Perl Debugging If you get a Script Error check the error_log.cgi file. Available from the Admin Module. Simplify complex problems. Comment out portions of your code by placing a # in front of each line. Use return statements to print out debug values at different spots in the code. Only works for inline script.

31 31 Perl Debugging To debug in List Building, Skip Logic, or Quotas include this function in your Unverified Perl: sub DebugMsg my($msg) open (DEBUGFILE, ">>../admin/debug.txt"); print DEBUGFILE localtime(). ": ". $msg. "\n"; close (DEBUGFILE); //To call it my $x = 13; DebugMsg($x); //admin folder will have debug.txt in it.

32 32 DEMO

33 33 QUESTIONS? Justin Luster Product Manager Megan Peitz Ingenuity Ambassador