| Both sides previous revisionPrevious revision | |
| en:create:functions:serialcheck [24.01.2015 13:09] – [Example] alexander.ritter | en:create:functions:serialcheck [21.04.2024 20:21] (current) – admin |
|---|
| ====== serialCheck() ====== | ====== serialCheck() ====== |
| |
| ''int **serialCheck**(string //authorizationCode//)'' | ''int **serialCheck**(string //accessCode//)'' |
| |
| The function ''serialCheck()'' reveals whether an //authorizationCode// is valid, and whether it has already been used. This function can be helpful in calling up an authorization code manually. | The function ''serialCheck()'' reveals whether an //accessCode// is valid, and whether it has already been used. This function can be helpful in calling up an access code manually. |
| |
| **Note:** Only the status of an authorization code can be checked with this function -- the authorization code will not be marked as "used" at the end of the questionnaire. | **Note:** Only the status of an access code can be checked with this function -- the access code will not be marked as "used" at the end of the questionnaire. |
| |
| |
| |
| ^Code^Meaning^ | ^Code^Meaning^ |
| |-1|No authorization code specified| | |-1|No access code specified| |
| |0|Authorization code not recognized in the survey project| | |0|Access code not recognized in the survey project| |
| |1|Authorization code already used (questionnaire is thus completed)| | |1|Access code already used (questionnaire is thus completed)| |
| |2|Questionnaire was already called up with the authorization code, but not completed| | |2|Questionnaire was already called up with the access code, but not completed| |
| |3|Authorization code yet to be used| | |3|Access code yet to be used| |
| |
| |
| ===== Example ===== | ===== Example ===== |
| |
| The following example assumes that an authorization code was asked for on the previous page in the text input field "AB01_01". The PHP code now checks whether the authorization code specified is valid. If not, the PHP code shows a text element as an error message, and redisplays the previous page with ''[[:en:create:functions:repeatpage|repeatPage]]'' | The following example assumes that an access code was asked for on the previous page in the text input field "AB01_01". The PHP code now checks whether the access code specified is valid. If not, the PHP code shows a text element as an error message, and redisplays the previous page with ''[[:en:create:functions:repeatpage|repeatPage]]'' |
| |
| <code php> | <code php> |
