Difference between revisions of "Questionnaire links"

From Catglobe Wiki
Jump to: navigation, search
(Return values for CgScript functions)
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
  
+
 __TOC__
 
== Questionnaire links  ==
 
== Questionnaire links  ==
  
Line 25: Line 25:
 
| &amp;c=[accessCode]<br>
 
| &amp;c=[accessCode]<br>
 
| Will open an existing answer sheet beloging to that access code<br>
 
| Will open an existing answer sheet beloging to that access code<br>
 +
|-
 +
| &uac=1<br>
 +
| Will open a page for typing accessCode and then will open existing answer sheet beloging to that access code. See more [[Code_protected_answer_sheets]]<br>
 
|-
 
|-
 
| &amp;b=1<br>
 
| &amp;b=1<br>
Line 30: Line 33:
 
|-
 
|-
 
| &amp;l=[language]<br>
 
| &amp;l=[language]<br>
| Where [language] should be replaced by the iso code of the language that the user should see the questionnaire in.E.g. 'l=dk-DK'.<br>
+
| Where [language] should be replaced by the iso code of the language that the user should see the questionnaire in.E.g. 'l=da-DK'.<br>
 
|-
 
|-
 
| &amp;u=[username]<br>
 
| &amp;u=[username]<br>
Line 41: Line 44:
 
<br>
 
<br>
  
== Detail for qasUser, loginUser, currentUser for each n type link: ==
+
== Return values for CgScript functions ==
 
{| class="wikitable"
 
{| class="wikitable"
 
|+
 
|+
Line 49: Line 52:
 
![[User_getQasUser]]
 
![[User_getQasUser]]
 
![[User_getLoggedInUser]]
 
![[User_getLoggedInUser]]
 +
![[User getCallingLoggedInUser]]
 
![[getCurrentUserResourceId]]
 
![[getCurrentUserResourceId]]
 
|-
 
|-
| rowspan="8" |No
+
| rowspan="10" |No
| rowspan="4" |No
+
| rowspan="5" |No
 
|Direct
 
|Direct
|Qas user or Empty
+
|Qas user
|Qas user or anonymous
+
|Qas user
|Qas user or anonymous
+
|Empty
 +
|Qas user
 +
|-
 +
|Direct Anon Qas
 +
|Empty
 +
|anonymous (userRId: 4)
 +
|Empty
 +
|anonymous (userRId: 4)
 
|-
 
|-
 
|n=1
 
|n=1
 
|Empty
 
|Empty
 
|anonymous  (userRId: 4)
 
|anonymous  (userRId: 4)
 +
|Empty
 
|anonymous  (userRId: 4)
 
|anonymous  (userRId: 4)
 
|-
 
|-
Line 66: Line 78:
 
|User C
 
|User C
 
|User C
 
|User C
 +
|Empty
 
|User C
 
|User C
 
|-
 
|-
 
|n=3
 
|n=3
| colspan="3" |'''''Error:''''' Don't work when NO logged in before
+
| colspan="4" |Don't work when NO logged in before, will show login page
 
|-
 
|-
| rowspan="4" |User B
+
| rowspan="5" |User B
 
|Direct
 
|Direct
|Qas user or Empty
+
|Qas user
|Qas user or anonymous
+
|Qas user
|Qas user or anonymous
+
|User B
 +
|Qas user
 +
|-
 +
|Direct Anon Qas
 +
|Empty
 +
|anonymous  (userRId: 4)
 +
|User B
 +
|anonymous (userRId: 4)
 
|-
 
|-
 
|n=1
 
|n=1
 
|Empty
 
|Empty
 
|anonymous  (userRId: 4)
 
|anonymous  (userRId: 4)
 +
|User B
 
|anonymous  (userRId: 4)
 
|anonymous  (userRId: 4)
 
|-
 
|-
Line 85: Line 106:
 
|User C
 
|User C
 
|User C
 
|User C
 +
|User B
 
|User C
 
|User C
 
|-
 
|-
 
|n=3
 
|n=3
 +
|User B
 
|User B
 
|User B
 
|User B
 
|User B
 
|User B
 
|User B
 
|-
 
|-
| rowspan="8" |User A
+
| rowspan="10" |User A
| rowspan="4" |No
+
| rowspan="5" |No
 
|Direct
 
|Direct
|Qas user or Empty
+
|Qas user
|Qas user or anonymous
+
|Qas user
 +
|Empty
 +
|User A
 +
|-
 +
|Direct Anon Qas
 +
|Empty
 +
|anonymous (userRId: 4)
 +
|Empty
 
|User A
 
|User A
 
|-
 
|-
Line 102: Line 132:
 
|Empty
 
|Empty
 
|anonymous  (userRId: 4)
 
|anonymous  (userRId: 4)
 +
|Empty
 
|User A
 
|User A
 
|-
 
|-
Line 107: Line 138:
 
|User C
 
|User C
 
|User C
 
|User C
 +
|Empty
 
|User A
 
|User A
 
|-
 
|-
 
|n=3
 
|n=3
| colspan="3" |'''''Error:''''' Don't work when NO logged in before
+
| colspan="4" |Don't work when NO logged in before, will show login page
 
|-
 
|-
| rowspan="4" |User B
+
| rowspan="5" |User B
 
|Direct
 
|Direct
|Qas user or Empty
+
|Qas user
|Qas user or anonymous
+
|Qas user
 +
|User B
 +
|User A
 +
|-
 +
|Direct Anon Qas
 +
|Empty
 +
|anonymous (userRId: 4)
 +
|User B
 
|User A
 
|User A
 
|-
 
|-
Line 121: Line 160:
 
|Empty
 
|Empty
 
|anonymous  (userRId: 4)
 
|anonymous  (userRId: 4)
 +
|User B
 
|User A
 
|User A
 
|-
 
|-
Line 126: Line 166:
 
|User C
 
|User C
 
|User C
 
|User C
 +
|User B
 
|User A
 
|User A
 
|-
 
|-
 
|n=3
 
|n=3
 +
|User B
 
|User B
 
|User B
 
|User B
 
|User B

Latest revision as of 07:11, 15 December 2023



Questionnaire links

Links to questionnaires can be created in a number of ways to support various actions upon users viewing their answer sheets. One type of link is recurring links where clicking the link will automatically generate a new answer sheet for that user. The basic part of the link can be found on the information dialog on the questionnaire list. By default the tag '&n=1' will have been added.

Recurring link

r=[qasGUID]
Open directly an existing answer sheet
r=[qnaireGUID]
Use combine questionanire guid with below tags for open existing answer sheet or generate new answer sheet
&n=1
Will generate a new answer sheet each time the link is clicked. But it will check whether the user has a cookie telling Catglobe that this user should return to the initial answer sheet he created using the link and thus try to avoid that any one user uses the link more than once.
&n=2
Similar to n=1 except that it will actually also generate a new user to attach to the answer sheet created. There may be various reasons why you would want to create user accounts when users use the link. You may for example have CGScript in your questionnaire that send information to update the user object with demographic data.
&n=3
Will generate a new answer sheet for logged in user each time the link clicked (need to be logged in before)
&c=[accessCode]
Will open an existing answer sheet beloging to that access code
&uac=1
Will open a page for typing accessCode and then will open existing answer sheet beloging to that access code. See more Code_protected_answer_sheets
&b=1
When this tag is added we will ignore that the logged in user has a session cookie which informs us that he has already started on a different answer sheet. We will instead just generate a new answer sheet to answer each time the user clicks the link!
&l=[language]
Where [language] should be replaced by the iso code of the language that the user should see the questionnaire in.E.g. 'l=da-DK'.
&u=[username]
If you did not choose &n=1 or &n=2 then you can instead specify user's user name and passwords as tags to let the system find an existing answer sheet for the questionnaire belonging to that user. Replace the [username] tag with the applicable user name. It must be used in combination with the correct password tag shown below. Can also be used for an n=3 link to login during the creation.
&p=[password]
Replace the [password] tag with correct password for the user used in the [username] tag.


Return values for CgScript functions

Qnaire Impersonation already logged in link type User_getQasUser User_getLoggedInUser User getCallingLoggedInUser getCurrentUserResourceId
No No Direct Qas user Qas user Empty Qas user
Direct Anon Qas Empty anonymous (userRId: 4) Empty anonymous (userRId: 4)
n=1 Empty anonymous (userRId: 4) Empty anonymous (userRId: 4)
n=2 User C User C Empty User C
n=3 Don't work when NO logged in before, will show login page
User B Direct Qas user Qas user User B Qas user
Direct Anon Qas Empty anonymous (userRId: 4) User B anonymous (userRId: 4)
n=1 Empty anonymous (userRId: 4) User B anonymous (userRId: 4)
n=2 User C User C User B User C
n=3 User B User B User B User B
User A No Direct Qas user Qas user Empty User A
Direct Anon Qas Empty anonymous (userRId: 4) Empty User A
n=1 Empty anonymous (userRId: 4) Empty User A
n=2 User C User C Empty User A
n=3 Don't work when NO logged in before, will show login page
User B Direct Qas user Qas user User B User A
Direct Anon Qas Empty anonymous (userRId: 4) User B User A
n=1 Empty anonymous (userRId: 4) User B User A
n=2 User C User C User B User A
n=3 User B User B User B User A