Phocas has a new user documentation site. This site will be retired soon.

Create a user

If you have permission to manage users, you can create new user accounts in three ways:

  • Add a new user account from scratch.

  • Clone an existing user account to create a new user account with most of the same settings.

  • Import multiple user accounts (and assign the same settings) at the same time. 

You start all of these actions on the Administration > Users screen.

Add a user

  1. On the Users screen, click New

  2. On the New User screen, enter the user’s details, including their email address and display name. See the User maintenance form for more information.

  3. Determine whether or not you want to send the user an email with their login details. See Manage user passwords.

  4. Select the applicable license(s).

  5. Select the applicable permissions: General (Account Locked and Detailed Logs), Folders and Custom Actions.

  6. Click Save. The new user account is created and extra tabs appear.

  7. Click the Profile tab and either assign a shared profile or create a user-specific profile. See Assign profiles to users.

  8. Click Save > Close.

Clone a user

  1. On the Users screen, select the existing user you want to clone and click Clone

  2. In the Clone User window, enter the user’s username and display name. See the User maintenance form for more information.

  3. Select the LDAP Authenticated? checkbox, if required.

  4. Select the Copy personal favorites checkbox, if you want to copy the original user's personal favorites and assign them to the new user. These are copies only - if the original user deletes a personal favorite, it doesn't affect the new user's copy. 

    • Personal favorites are those favorites that are owned by the original user. Any favorites that were shared with the original owner are not copied.

    • Any shared users on the original owner's personal favorites are not copied. 

    • Subscriptions are not copied.

  5. Enter and confirm a password for the new user.

  6. Select the Force password change? checkbox (only available on non-LDAP sites) if you want to user to be required to create a new password when they first sign in.

  7. Click Save. The new user account is created and opens on the User tab.

  8. Proceed to update the user’s maintenance form.

Import users

  1. On the Users screen, click More > Import

  2. Upload or select users, according to your server configuration, which is either Phocas (default) or LDAP authentication

    • Phocas (default) authentication - The Import tool allows you to upload new users via a CSV text file, for example, based on a Microsoft Excel worksheet. Ensure the data in your file is in the order specified on the Import Users window. You might prefer to download and edit this example file. Then select your file and click Upload.

    • LDAP authentication - The Import tool retrieves a list of all LDAP users who are not already in the Phocas user list. Select the required users and click Next.

  3. Select the applicable license(s).

  4. Assign the users to a group, territory and/or team. Unless you have the Users: All Users setting selected in your profile, the Group and Territory fields will automatically be populated with your own group and territory and show as disabled. If you have either Users: Users In Same Group or Users: Users In Same Territory, but not Users: All Users, both Group and Territory will be disabled. 

  5. Select the applicable permissions: General (Detailed Logs), Folders and Custom Actions.

  6. Determine whether or not you want to send the user an email with their login details. See Manage user passwords.

  7. Click Next.

  8. Select a defined period next to the database or databases you want the new users to be able to access.

  9. Click Save.

  10. Proceed to update the permissions and settings for individual users, as required.