2009-08-03
QPL Reference Manual

Warning! This page is in the process of being rewritten for QPL Version 6. It may still have references to QPL Version 5.

All administrators may create and maintain user accounts for both respondents and administrators after a project has been deployed. (Note: Accounts also may be created or modified in bulk by writing SQL scripts. See Preloading User Accounts and Data for more information.)

Creating or editing an account is a three step process:

  1. Use the Find User Accounts page to look up one or more accounts,
  2. Pick the account you wish to modify from the accounts found on the User List page, and
  3. Edit the account information on the Edit User page.

Find User Accounts Page

The Find User Accounts page lets you find user accounts a variety of ways. If you know the user's name, you can enter it (or just the first few letters) into the name field and then click the "Find" button at the bottom of the page to create a list of all the accounts with that name. Similarly, you may use any of the other search fields, separately or together, to find individual or groups of users. Blank fields will not be used for searching.

You may also use the search capabilities of the Find User page to perform a number of housekeeping activities, such as getting a list of user who have a number of failed login attempts or a list of users in a particular group.

The user accounts that you are allowed to see and edit is limited by your administrative status. Administrators can see only Normal, Super user, and Closed accounts. Data Administrators can see these and Administrator accounts. The System Administrator can see all accounts except other System Administrator accounts.

The Find User Accounts page displays your last search each time you go to this page. You can use the "Reset" button at the bottom of the page to restore the default settings (which search for the first 100 Normal user accounts).

Click on the field labels below to get more information about how each field may be searched.

User Name

Search string matches the beginning of user names. For example, "d," will match all user names that begin with the letter d.

Password, Full name, Telephone, Email, and Group

Search string will match anywhere in a one of these fields. For example, "cord," will match recorder, recording, record, etc. Enter the word "none," in any of these fields to search for an empty field.

Invalid or Missing Addresses

This check box will separately search for invalid addresses. These would include addresses that use illegal characters (such as a space) or are missing the "@" character.

Users' addresses that fail this test will not be sent email messages in this system.

Status

Check the types of user accounts to include in the search. You are only allowed to select accounts that have a lower status than your account. For example, an Administrator may only select respondent accounts and not other administrator accounts.

Failed Login Attempts

Search for user accounts that have as many or more failed login attempts than the number entered in this field. For example, "3," will select user accounts that have three or more failed logins.

Expiration Date

Search for user accounts that expiration dates that are on or after this date. The date must be entered in yyyy-mm-dd format. For example, "2002-12-01," will select user accounts which have expiration dates on or after December 12, 2002.

id of Last Message Sent

Search for user accounts that were last sent this message. Enter the id number of the message.

Number of Messages Added to Queue

Search for user accounts that were sent at least this number of email messages or more. Enter 0 (zero) to search for accounts that were sent no email messages.

Comments

Search for up to ten words that have been entered in the user account Comment field. The words will be matched in any order. For example, searching for "quick fox," will match "The quick brown foxes jumped over the lazy dog." You may also use the underscore character (_) as a wildcard for a single character.

Maximum Accounts in List

Enter the maximum number of user accounts that should be listed. Minimum value is 1 (one).

Find

Starting searching for the user accounts using the criteria you entered on the page. Accounts must match all the criteria you entered. If one or more accounts matched your criteria, the matching accounts will be listed on the User List page.

Reset

Replace any criteria you entered with the default values. The default values will search for the first 100 Normal user accounts.

If your search is not working as expected, it is probably because you did not remove some criteria from a previous search. If you are entering a different search, you should first press the Reset button to make sure you have cleared your previous search criteria.

Cancel

Press the Cancel button to close this page and go back to the main administrative page.

Print

Press the Print button to print this page.