Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The user maintenance form allows you to change a user's permissions, functionality and other settings. 

Select Administration > Users to see a list of Phocas users or search for a user. Select a user from the 'Name' column to open the user maintenance formYou may not see all of the tabs described below, depending on your profile.

Table of Contents
maxLevel3
 

Info
iconfalse
titleRelated articles
Tip
titleSave your changes

Make sure you Save changes you make on any screen within the User maintenance form. Using Close or moving to a different screen does not automatically save the changes.

User tab

The User screen is divided into two sections: User information in the top section and basic permissions underneath. It is essentially the same screen that you populate when you create a new user. The other tabs appear once the user has been created.

User information

  • Username (mandatory): The name the user will use to log in to the application. This usually matches a user's Windows network login.
  • Display Name (mandatory): The name displayed on the user menu.

  • Email: The user's email address. A

    You access a user’s account, known as a maintenance form, when you add a user and update a user. The form contains several details fields, permissions and other settings, organized into tabs. Depending on your profile, you might not see all of the tabs.

    Note

    If you make any changes to any tabs on this screen (user maintenance form), ensure you click Save to save and apply those changes. If you click Close or move to a different tab, your changes are not saved.

    Table of Contents
    minLevel1
    maxLevel2
    outlinefalse
    typeflat
    separatorpipe
    printablefalse




    User tab

    The User tab displays when you are adding a new user account (other tabs display afterward) and it is the default tab that displays when you open an existing user account. This tab has the following settings:

    • Username (mandatory) - The name the user will use to sign in to Phocas. This usually matches the user's network sign-in name.

    • LDAP Authenticated? - Only available on LDAP configured implementations, this setting indicates which authentication method is been used. If the checkbox is selected, the user is authenticated against the LDAP server. If the checkbox is not selected, the user is authenticated against Phocas. If the user is being added from a source other than Active Directory, an additional Password setting is available.

    • SAML Authenticated? - Only available if the Single sign-on (SSO) feature is enabled for your Phocas site and is selected by default.

    • Windows or SQL user name: Only required for older desktop versions of Phocas.

    • Email* - The user's email address. The user needs a valid email address to be able to receive subscriptions. New

    users on
    • users on the current version of Phocas will be asked to enter an email address the first time they sign in, unless one has already been entered here.

  • Phone numbers: Information fields.
  • Group, Territory: Groupings used to make bulk updates easier and allow for filtering by group or territory from the View a list of all users screen. These fields may be disabled for some admin users, depending on your permissions.  You need to have 'Users: All Users' selected in your profile.

  • Language: If language is left blank, the default system language will be used. Selecting a different language does not change
    • Display Name (mandatory)* - The name that displays on the User menu.

    • Phone, Cell and Home* - The user’s telephone numbers.

    • Language* - The user’s language. Selecting a different language from the list will translate the text when the user next signs in; however, it does not translate the names of measuresproperties or dimensions, as these are defined by the data in each database

    .
  • Show splash screen: Controls whether a splash screen will be displayed when the user signs in.
  • Default home screen: Either
    • . If this setting is left blank, the default system language will be used.

    • Timezone* - The user’s timezone.

    • Home: The user’s default homepage. You can either leave this blank to present the user with a

    home screen
    • homepage listing the databases, dashboards and favorites to which they have access, or select a dashboard (to which they have access) as their default home screen.

    You can only choose a dashboard to which they have access.
  • Timezone: Select a default timezone for the user. They can change this via their personal settings screen.
  • Permissions 

    • Show splash screen* - Controls whether a splash screen displays when the user signs in.

    • Group, Territory and Team - Only available if you have the Administration > Users: All Users permission, these items make bulk updates easier and enable filtering in some areas of Phocas.

    • Password - Determines if the user receives sign-in details by email.

      • Auto-generate password: If selected, automatically creates a password that conforms to your site's password policy (as long as your site uses the default Phocas authentication), which is always used in conjunction with the Email details to user setting below. See Manage passwords.

      • Force password change: If selected, when the user first signs in, the system forces them to enter a new password.

      • Email details to user: Only available if the SMTP details are configured and the user has an email address. If selected, sends the URL, username and password to the user in an email.

    • License - The user’s Phocas license type (Full or Viewer) and access to the CRM and Rebates modules.

    • Permissions - High-level, site-wide settings applicable to the user.

      • General > Account Locked: Controls whether the user’s account is locked.

      • General > Detailed Logs: Controls whether every query by the user is recorded

    (they can be viewed in the 950641 tab). Enabling this option can slow the system so it should be used with caution
      • . If selected, every query is recorded, along with the export activity. The logs are viewable in the user account’s Usage tab (see below). Caution should be used when enabling this option, as it can result in large quantities of data being collected, slowing the system down.

      • Folders: 

    Ticking any of the folders displayed in this list allows the user to access the favorites and dashboards in the ticked folder. Profile settings control whether a user can create or delete items.
  • Integrations: Ticking any of the integration tasks displayed in this list allows the user to access these actions from the grid. 
  • Unlocking a user account 

    If a user exceeds the limit on the number of login attempts they will be automatically locked out of their account. Untick 'Account locked' to unlock their account. For information on setting a limit on failed logins see Set your site's password policy 

    User tab

       Image Removed

    Profile tab

    The Profile screen (shown in image below) controls which functional elements of Phocas are available to the user. From this screen you can select one of the following profile types:  

  • A pre-defined system profile. These are common profiles created in the Profiles administration form and assigned to multiple users. They are usually:
    • Viewer
    • Basic
    • Advanced
    • Administrator
  • A <blank> profile. The user has no enabled functionality. This means that they are able to run
      • The folders that contain favorites and dashboards the user can access. You can manage these folders in the Administration > Folders page.

      • Custom Actions: The actions the user can access from the Analytics grid. 

    *Users can change these settings later via their account settings.

    Image Added

    Profile tab

    The Profile tab contains the user permissions. This is where you control what the user can do in Phocas, from a functionality perspective. 

    Profile type

    Start by selecting a profile option from the dropdown list:

    • One of the pre-defined system profiles: Viewer, Basic, Advanced and Administrator -

      • These are common profiles, sometimes referred to as shared profiles that can be assigned to multiple user accounts. You can customize these profiles to meet your organization’s needs.

      • Each profile has a different combination of user permissions, allowing you to quickly assign multiple permissions to the user at once.

      • If the user has a Viewer license (set on the User tab), the settings on the Profile tab are unavailable.  

    • The blank profile - Selecting this option means the user has no functionality in Phocas. They can view favorites that are in the folders listed on the User

    page
    • tab and drill down on the resulting data, but they cannot create new favorites or change modes within the existing ones.

    A '
    • The User Specific

    ' profile. Each of the elements
    • profile - Selecting this option allows you to create a profile specifically tailored for the user, as each of the permissions can be enabled or disabled

    for a specific user

    If a user has a viewer licence, the Profile tab on their individual user maintenance form has the profile type grayed out.  

    Profile tab (top section only)

    Image Removed

    Administrators with permission can edit a system profile or create a new profile by selecting Administration > Profiles from Phocas menu. See Assign profiles to users.

    Administration profile settings

    See Customize administrator permissions

    Databases tab

    The databases screen (shown in the image below) displays available databases and allows an administrator to manage user access to these databases. 

    • To grant a user access to a database, select a defined period from the dropdown menu next to the database. Clearing a defined period denies access.
    • To further restrict what data the user can see within a specific database, click the lock icon Image Removed next to the database. 
    • Use the up and down buttons at the top left of the screen to set the order in which the databases appear in the user's home screen. 

    Image Removed

    Favorites tab

    This tab displays any personal favorites created by the user as well as any favorites shared with them. 

    •  Selecting an item enables the 'Delete' button on the left-hand side.
    • Deleting a personal favorite permanently removes it from the system. Deleting shared favorites just removes if from the user's view, it remains for other shared users and the original author.  

    You can filter favorites by whether they are owned by the user ( i.e., ones they have created), whether the user has subscribed to them (including frequency and delivery type) or by database. In the image below, the 'Is subscribed' filter is active and has turned orange. 

    Image Removed

    Dashboards tab

    This tab displays any personal dashboards created by the user. Selecting an item enables the 'Delete' button on the left-hand side. There are no other configuration options.

    Image Removed

    Usage tab

    The usage chart displays the user's usage in a column chart. Every time a user performs a query on the query screen the count for that database and that day is increased. This includes whenever a new dimension, measure, property, etc. is selected. Dashboard and chart queries are not counted. 

    By default, the chart shows usage across all databases during the past 28 days. You can filter by database or a 3, 6 or 12 month period.

    Hidden

    User permissions

    The permissions are organized into the following sections:

    • Dashboards - These permissions govern access to the Phocas dashboards and the actions users can take within those dashboards.

    • Favorites - These permissions govern access to the Phocas favorites and the actions users can take within those favorites.

    • Collaboration - These permissions allow users to share dashboards and favorites 

    • Query - These permissions determine what users can do in the Analytics grid, such as perform queries, switch modes, select and set periods, change properties, export data, and so on.

    • File Upload - These permissions allow users to upload files.

    • Databases - The main Databases permission allows users to view the list of Phocas databases to which they have access, via the Phocas menu and homepage. The Default Period allows users to set the default period for those databases.

    • Administration - These settings govern access to the Administration module and the actions users can take there. They are not for regular users, so should be rarely assigned.

    • CRM - Dependent on the CRM license, these permissions govern access to the CRM module and the actions users can take there.

    • Rebates - Dependent on the Rebates license, these permissions govern access to the Rebates module and the actions users can take there.

    • Financial Statements - These settings apply to the Financial Statements module. They allow users to customize financial statements and access restricted account transactions.

    • Budgeting & Forecasting - These settings apply to the Budgets and Forecasts module. They allow users to manage budget and forecast workbooks.

    Image Added


    Databases tab

    The Databases tab displays a list of the Phocas databases. This is where you control the data the user can access in Phocas. Even if a user has permission to do something in Phocas, such as view a favorite or dashboard, if that user does not have access to the underlying data, no data will display. See Manage user database access and restrictions.

    Image Added

    Favorites tab

    The Favorites tab displays a list of the favorites to which the user has access, which includes any personal favorites created by the user and the favorites shared with them. You can delete any of these favorites. See Manage favorites.

    Image Added


    Dashboards tab

    The Dashboards tab displays a list of the personal dashboards created by the user, if any. You can delete any of these dashboards. See Manage dashboards.

    Image Added

    Usage tab

    The Usage tab displays activity information for the user. See Monitor user activity.


    Query Log tabs

    The Query Logs tab displays details for each query the user makes. See Monitor user activity.


    Other (hidden) tabs

    The user maintenance form contains some additional tabs not typically available to administrators

    . These include 'Settings' and 'Audit'

    , which

    are used

    are used by Phocas implementation and support consultants.

    Query log tab

    If Detailed logging is enabled, this tab displays details for each query the user makes. This detailed logging records the date/time, the database, mode, dimension, period, any selections made and whether the result was shown as a chart or grid. Not all admin users will see this tab.

    • The Purge button against the user permanently deletes all recorded events. 
    • The Refresh button re-queries the log and reloads the page.

    Image Removed

    Resetting a password from the user maintenance form

     On sites that use Phocas authentication administrators can reset a user's password from the user maintenance form, selecting Reset password to the top right.

    Image Removed

    Note about saving changes

    You need to Save to permanently store any changes made on a screen in the user maintenance form. If you click Close or move to a different tab without first saving you will lose your changes.

     

    These include Settings and Audit.