MobileCoach ISRII Handout

Transcription

1 MobileCoach ISRII Handout Andreas Filler Updated for MobileCoach version Last update:

2 Understanding MobileCoach rules Comment Rule Rule Type/ Comparator Comparison Term Fix setter value Result Value à Result Variable Slide 2 Andreas Filler October 12th, 2017

3 Understanding MobileCoach rules Rule Placeholder Variables Slide 3 Andreas Filler October 12th, 2017

4 Rule Classes Calculation Rule is a calculable term Placeholders are handled as decimal numbers (e.g. 2.5, empty value: 0) Comparison term depends on rule type but is calculated the same way Example: floor($daysparticipated/70) à floor(200/70) à 2 Text Operation Rule is a stitched text Placeholders are handled as text (e.g. 05, empty value: ) Comparison term depends on rule type but is calculated the same way Example: Hello $participantname! à Hello Jessica! Date Operation Rule Term is a date Placeholders are handled as text (e.g. 05, empty value: ) Comparison term depends on rule type Example: and date difference in days à -105 Slide 4 Andreas Filler October 12th, 2017

5 Rule Types #1 Rule Class Rule Type Result Value Comparison Result Calculation calculate value but result is always true calculated decimal value TRUE Calculation calculate value but result is always false calculated decimal value FALSE Calculation calculated value is smaller than calculated decimal value TRUE / FALSE Calculation calculated value is smaller or equal than calculated decimal value TRUE / FALSE Calculation calculated value equals calculated decimal value TRUE / FALSE Calculation calculated value is bigger or equal than calculated decimal value TRUE / FALSE Calculation calculated value is bigger than calculated decimal value TRUE / FALSE Text Operation create text but result is always true stitched text TRUE Text Operation create text but result is always false stitched text FALSE Text Operation calculate amount of select many values number TRUE Text Operation text value equals stitched text TRUE / FALSE Text Operation text value not equals stitched text FALSE / TRUE Text Operation text value matches regular expression stitched text TRUE / FALSE Text Operation text value not matches regular expression stitched text FALSE / TRUE Text Operation text value from select many at position appropriate sub-value TRUE / FALSE Text Operation text value from select many at random position appropriate sub-value TRUE Slide 5 Andreas Filler October 12th, 2017

6 Rule Types #2 Rule Class Rule Type Result Value Comparison Result Date Operation Date Operation date difference value equals (days since given date (rule) calculated and compared to comparison term) calculate date difference in days and true if zero/always true (two dates given, days since given date if comparision term is in the past) none (unmodified given date) date difference in days TRUE=fits / FALSE=fits not TRUE=0 / FALSE<>0 or always TRUE Intervention Operation check value in variable accross interventions and true if duplicate found boolean TRUE=at least one match already found / FALSE=no match found Slide 6 Andreas Filler October 12th, 2017

7 Regular Expressions for Text Operation Rules Examples: a b c d [0-9]+ [a-za-z]* [a-z]{2,4} \d+ Groups and Ranges. Any character except new line (\n) (a b) a or b (...) Group (?:...) Passive (non-c apt uring) group [abc] Range (a or b or c) [^abc] Not (a or b or c) [a-q] Lower case letter from a to q [A-Q] Upper case letter from A to Q [0-7] Digit from 0 to 7 \x Group/ sub pattern number " x" Ranges are inclusive. Character Classes Special Characters \c Control character \n New line \s White space \r Carriage return \S Not white space \t Tab \d Digit \v Vertical tab \D Not digit \f Form feed \w Word \xxx Octal character xxx \W Not word \xhh Hex character hh \x Hexade cimal digit \O Octal digit Quanti fiers * 0 or more {3} Exactly or more {3,} 3 or more? 0 or 1 {3,5} 3, 4 or 5 Add a? to a quantifier to make it ungreedy. Always check your regular expressions! (Web) (Mac) Slide 7 Andreas Filler October 12th, 2017

8 Number Formatters for Text Operation Rules Examples: $costspermonth è $costspermonth{usd %.,0f} è USD 20,000 $costspermonth{usd %.,2f} è USD 20, $day.$month.$year è $day{%02.0f}.$month{%02.0f}.$year è Explanation: % [, = thousand separator] [ _/0 spaces/null] [amount of spacing digits]. [amount decimal digits] f Slide 8 Andreas Filler October 12th, 2017

9 Rule Functions for Calculation Rules Math Function abs(x) absolute value acos(x) arc cosine asin(x) arc sine atan(x) arc tangent average(x,y,z...) average of arguments ceil(x) nearest upper integer cos(x) cosine cosh(x) hyperbolic cosine floor(x) nearest lower integer ln(x) natural logarithm (base e) log(x) base 10 logarithm max(x,y,z...) maximum of arguments min(x,y,z...) minimum of arguments round(x) nearest integer sin(x) sine sinh(x) hyperbolic sine sum(x,y,z...) sum of arguments tan(x) tangent tanh(x) hyperbolic tangent random() pseudo-random number (between 0 and 1) Constants e pi base of natural algorithms ratio of the circumference of a circle to its diameter Math Operator List Function + addition - subtraction - unary minus * multiplication / division ^ exponentiation % modulo first(x,y,z...) second(x,y,z...) third(x,y,z...) position(p,x,y,z...) Number Function digit(x,y) position of 1 st highest value in given list starting with 1 position of 2 nd highest value in given list starting with 1 position of 3 rd highest value in given list starting with 1 value at position p in given list x,y,z starting with 1 from second parameter gives the digit at position x of number y counted from the right side inrange(x,min,max) return 1 if min <= x <= max, otherwise 0 Slide 9 Andreas Filler October 12th, 2017

10 Variable Understanding Participant Variables $participantdialogoptionsmsdata $participantsupervisordialogoptionsmsdata $participantdialogoption data $participantsupervisordialogoption data $participantdialogoptionexternalid $participantsupervisordialogoptionexternalid $participantfeedbackurl $participantmessagereply $participantrawmessagereply $participantunexpectedmessage $participantunexpectedrawmessage $participantintention $participantname $participantlanguage $participantgroup Cellphone number of the participant Cellphone number of the participant s supervisor address of the participant address of the participant s supervisor Unique id of participant in external communication system Unique id of participant s supervisor in external communication system Unique feedback URL of the participant Last message reply sent by participant Last message reply sent by participant (without cleaning) Last message unexpectedly received received from participant Last message unexpectedly received received from participant (without cleaning) Last intention sent by participant Nickname of participant Language of participant, e.g. ch-fr Group of participant $participantparticipationindays Monitoring participation in days of the participant, starting with 0 $participantparticipationinweeks Monitoring participation in weeks of the participant, starting with 0 Slide 10 Andreas Filler October 12th, 2017

11 Understanding System Variables Variable $systemhourofday Hour of day (0-23) $systemdayinweek Day of week, starting with 1=Monday $systemdayofmonth Day of month, starting with 1 $systemmonth Month of year, starting with 1 $systemyear Year in 4 digits $systemlinkedsurvey Survey linked with slide/message $systemlinkedmediaobject Media object contained in slide/message Slide 11 Andreas Filler October 12th, 2017

12 Helpful URLs MobileCoach Deepstream.io integration: MobileCoach JavaDoc: MobileCoach Eclipse Plugin Repository: Setup: Slide 12 Andreas Filler October 12th, 2017

13 Contact Andreas Filler, M.Sc. Center for Digital Health Interventions Health-IS Lab, University St. Gallen & ETH Zurich Slide 13 Andreas Filler October 12th, 2017