Questionnaire links
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.
| 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 | Case1: Direct | Qas user | Qas user | Empty | Qas user |
| Case2: Direct Anon Qas | Empty | anonymous (userRId: 4) | Empty | anonymous (userRId: 4) | ||
| Case3: n=1 | Empty | anonymous (userRId: 4) | Empty | anonymous (userRId: 4) | ||
| Case4: n=2 | User C | User C | Empty | User C | ||
| Case5: n=3 | Don't work when NO logged in before, will show login page | |||||
| User B | Case6: Direct | Qas user | Qas user | User B | Qas user | |
| Case7: Direct Anon Qas | Empty | anonymous (userRId: 4) | User B | anonymous (userRId: 4) | ||
| Case8: n=1 | Empty | anonymous (userRId: 4) | User B | anonymous (userRId: 4) | ||
| Case9: n=2 | User C | User C | User B | User C | ||
| Case10: n=3 | User B | User B | User B | User B | ||
| User A | No | Case11: Direct | Qas user | Qas user | Empty | User A |
| Case12: Direct Anon Qas | Empty | anonymous (userRId: 4) | Empty | User A | ||
| Case13: n=1 | Empty | anonymous (userRId: 4) | Empty | User A | ||
| Case14: n=2 | User C | User C | Empty | User A | ||
| Case15: n=3 | Don't work when NO logged in before, will show login page | |||||
| User B | Case16: Direct | Qas user | Qas user | User B | User A | |
| Case17: Direct Anon Qas | Empty | anonymous (userRId: 4) | User B | User A | ||
| Case18: n=1 | Empty | anonymous (userRId: 4) | User B | User A | ||
| Case19: n=2 | User C | User C | User B | User A | ||
| Case20: n=3 | User B | User B | User B | User A | ||
