Versions Compared

Key

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

Table of Contents

A tenant admin uses the Manage Users page to add new users, delete users, edit the properties of existing users and download/upload a csv file containing user data. Click the Manage Users link to display the  user the frevvo user list. To the right of each user name are icons described below.

...

  1. Complete the new user form. 
  2. User names can contain characters, numbers, dot (.), hyphen (-) and the underscore (_). User names can only be started with a character, number or underscore (_) as the first first character. Max length is 50 characters.

  3. Change Password on Next Login is checked by default.  recommends  frevvo recommends keeping this checked for best security practices. Users will be prompted to enter a new password that meets strength requirements on their first login.
  4. Assign roles to the user. NOTE: Assign the special role frevvo.Designer to any user who needs permission to create forms and workflows.
  5. You can assign multiple roles to any user by clicking the "+" icon
  6. Assign a reports to for any user who needs to route a form they fill in to their manager. For example a PTO request.
  7. Submit the form

...

CSV Upload of Users and Roles

customers frevvo customers that have a large number of users with assigned roles, may need to import these (userids/roles) into frevvo. provides frevvo provides the ability to perform a bulk import of user data.

...

Info
  • To include a ',' (comma) in a field, escape it with a leading '\' character. To include a '|' (bar) in a role name, escape it with a leading '\' char.
  • To delete a user, enter DELETE into the transaction column of the file for that user. The user id and tenant fields are required for successful deletion. The message "Attempting to delete non-existing userId. It will be ignored." displays if the user id does not exist.
  • To delete all roles for a user, leave the roles column blank. See Updating Users and Roles using a CSV file UpdatingUsersandRolesusingaCSVfile for more information.


  • Although csv files can be opened in other programs, they are best viewed through some kind of spreadsheet program. Here is the file when it is opened with Excel:

...

Downloading the user csv file will provide you with the format needed to import users and their associated roles into frevvo. Once you have your csv file ready, follow these steps to upload it:

...

The image shows the result of a validation that resulted in errors. User data cannot be uploaded until the errors are corrected. The table showing the validation data is scrollable vertically when loading a large csv file.
Image RemovedImage Added

Info

notifyIfNewUser determines when a password reset notification is sent to a user.

  • 'true' will notify new users and any current user that does not have a password. The password reset link will expire in 24 hours.
  • 'false' will not send a notification, even if the user is new or does not have a password. This allows tenant admins to set up and manage users in a test tenant, and notify them for access later.

...

You will see this message with the number of roles and users that were created: "Users Loaded successfully. 3 Added, 1 Updated, 0 Deleted, 4 Roles Added." Uploading an empty users file displays the message "Users file is empty".

...

Tip
  • If you leave the roles column blank in the csv file you are using for updates, the existing roles for that user will be deleted. Be sure to add the roles relevant to the users you are updating so the existing roles are not cleared.
  • The warning messages "Update of user failed"  or "Users Loaded successfully with some issues. See detailed results for details." is no longer displayed if users in the csv file you are uploading do not have any roles assigned to them. 
  • Customers who have automated csv uploads via the API (set up on versions earlier than v9.0) should be aware that passwords are no longer supported in csv upload and will be ignored.

CSV Upload Considerations

...

  • Click at the top of the user list to add a new user.
  • Click at the top of the user list to add a new tenant admin user.
  • Click to display that user's home page.
  • Click to edit that user's management functions.
  • Click to upload a signature image file that will be applied to all forms/workflows this user signs in place of his or her first and last name. Refer to Signature Images SignatureImages and  Electronic Signatures for more information.

  • Click  to log into  as into frevvo as that user.
  • Click to edit a user's profile including password, e-mail address, max upload attachment size, disable the user.
  • Click  to remove a user from the server.
Info

If you use LDAP or a delegating or custom security manager to define your  users your frevvo users and their roles or groups, you do not see the New User icon on the Manage Users page.

...

The tenant admin can add/manage signature images for frevvo users that is applied to all forms/workflows this user signs in place of his or her first and last name.

...

  • The default maximum size for attachments in the frevvo Cloud is 25 MB or 26214400 bytes. On Premise customers can use the frevvo.attachment.maxsize property to configure the maximum size for attachments.
  • The Reports To field is a ComboBox. Begin typing the userid of the person this user reports to and a list of matching users displays. Select the Role and Enabled DisableUsersfield values from the Dropdown choices.
  • To save changes, click Submit. To cancel changes, click "Return to Manage Users" at the top of the page.

...

 There are three places to set the maximum size of attachments in in frevvo.

  1. The server frevvo server can be configured with a configuration property to specify the maximum size for attachments. The upper limit for attachments in the frevvo Cloud is 25 MB. Uploading attachments greater than this value shows this error message:



  2. The tenant admin can set the maximum file size per user by editing their profile. Add the value in bytes to the Max Attachment Size field on the Edit User screen.  



    The value in this field overrides the max size value configured on the server level, as long as it does not exceed that value. For example, if the Server was set for 20 MB and the user profile was configured for 15 MB, the user sees this error message when trying to upload a 30 MB attachment:



  3. Designers can specify the max file size per the Max Size property of individual Upload Controls. The image shows a 5 MB Max Size property specified for an Upload Control.



    If a user uploads a file larger than 5 MB to this control, they will see this error

...

Users can also click "Forgot Password" on the login screen to reset their own password. Passwords for tenant admins and the superuser (admin@d) for On Premise installations can also be changed using this procedure. Remember, the user must have an email address configured in for frevvo for this method to work.

Logged in users can change their password using the Manage Personal Information link under My Account on the top right of the screen. Tenant and server admins can change their passwords by clicking on the  icon from the Edit Admin Users screen.

Note

Password reset notifications sent via csv User upload and/or the Forgot Password process will expire after 24 hours. If the 24-hour window is exceeded, users can use the Forgot Password process to reset their password.

...

You can delete users from the Manage Users page by clicking the Remove User icon beside their name, or you can delete users using the CSV Upload method by entering DELETE into the transaction column for the user(s). However,  recommends  frevvo recommends using caution with this process. Here are some best practices to keep in mind.

...

Avoid deleting users with the frevvo.Designer role. If a designer user has resources such as forms, workflows, scripts, spacesportals, etc. those will also be deleted, including submissions, when the user is deleted. If you must delete a designer user, you can download their resources and upload them to another designer user. In this case, you will not be able to move submissions. You will also need to update any published share links to those resources.

...

Designers will also see a link to Manage Production Forms here so the designer can easily manage their account from this screen.

If you are using  spacesusing frevvo portals, you can add a link to this screen to the space portal menu.