Manage Groups

Groups control which forms, resources, and records your team can access and what actions they can perform. Users must belong to groups to access forms on mobile devices and perform tasks in the Web Portal. This topic describes how to create and manage groups, assign FormSpaceClosed FormSpaces are where forms are stored and organized in the TrueContext Web Portal. A TrueContext Team may have multiple FormSpaces, depending on their needs. Admins can set FormSpace permissions to control which users have access to the forms in that FormSpace. permissions, and troubleshoot any access issues.

Note:Groups are the only way to give users access to forms. Users can't access forms unless they belong to a group that has permissions in the FormSpace where those forms are stored.

Available on all tiers:

Essentials
Advanced
Enterprise

Contents


How groups and permissions work

Why groups are essential

Groups and the FormSpaces assigned to groups control user access:

  • FormSpaces organize your forms, resources, and data into logical collections based on business needs.
  • Groups organize your users by function or business unit.
  • FormSpace permissions determine what actions each group can perform.

How permissions work

Mobile users can only access forms if their group has permissions in the FormSpace that contains those forms. Similarly, Web Portal users need the correct FormSpace permissions to view data, manage assignments, or perform other tasks.

Info:The topic FormSpace Permissions describes the different types of permissions in detail.


Default groups

All new TrueContext teams are created with two groups:

  • Production Group: For deployed forms used in daily operations. New users are automatically assigned to this group.
  • Test Group: For testing Draft forms before deployment.

You can use these groups as-is, modify them, or create new groups based on your team's needs.


Setup instructions: Create a group

Prerequisites

  • Admin user role (team admin) in TrueContext.

    Info:There are two different levels of group management permissions:
    • Team admins can create, delete, and fully manage groups.
    • Group admins can only add and remove users from existing groups they manage.

    The topic Permissions Quick Reference: Web Portal permissions for user and group management describes group admin permissions in more detail.

  • Understanding of your team structure: Which users need access to which forms and data.

  • FormSpace organization: Forms, resources, data, integrations, and generated outputs organized into FormSpaces that reflect your team's access patterns and workflow needs—such as by region, business unit, service territory, customer type, or equipment specialization.

  • TrueContext Users: Users on your TrueContext team that you want to add automatically or manually to the group.


Create a group and assign users

  1. Go to Users & Groups > Groups > Create Group.

    Shows the cascading menu options to select Create Group.

  2. Enter the group information:

    • Name: Required. Choose a descriptive name that reflects the group's purpose (for example, "Field Technicians," "Supervisors," "Quality Inspectors").

    • Description: Optional. Add details about the group's purpose or which users should belong to it.

  3. Add users to the group:

    • Click in the Selected Users field, and then select a user from the list. Repeat this step to add more users.

    • To remove a user from the group, select the "x" next to the user name.

  4. You can set up the group so that new users created on your team are automatically added to this group. Do you want to do this?

    • If yes, select Add New Users to This Group.

      Note: Users in this group have access to all Active, Draft, and Archived Forms forms and resources in the FormSpaces assigned to this group.

    • If no, go to the next step.

  5. Assign FormSpaces to the group:

    • Click in the Selected FormSpaces field, and then select a FormSpace from the list. Repeat this step to add more FormSpaces.

    • To remove a FormSpace from the group, select the "x" next to the FormSpace name.

    Info:By default, new groups have Can Submit FormSpace permissions. You assign specific FormSpace permissions after you create the group.

  6. Select Create to save the new group.

    Result: The group details page opens and displays the setup that you saved.


Assign FormSpace permissions

After creating the group, you can add or change the FormSpace permissions.

  1. Are you still on the group details page?

    • If yes, go to step 3.

    • If no, go to the group details page: Users & Groups > Groups > List Groups.

      Shows the cascading menu options to select Create Group.

  2. Select the name of the group you just created.

    Tip:You can use the Search option to find the group by name.

    Result: The group details page opens.

  3. Hover over the arrow next to the group name, and then select Edit FormSpace Permissions.

    Group name cascading menu that shows the option to Edit FormSpace Permissions.

  4. For each FormSpace, choose the appropriate permissions.

    The following table lists the different FormSpace permissions and the actions that each permission allows.

    Permission Actions allowed When to use Relevant user roles
    Can Create

    Give this permission to users who are authorized to build and edit Form Definitions and to dispatch forms to field users.

    Tip:Admin users have this permission built-in for all FormSpaces.

    Users
    Can Test

    Open and submit test versions of forms. These are forms based on Draft Form Definitions.

    Set this permission so that specific users can test forms before you make them available for general use.
    • Mobile-only users
    • Users
    • Admin users
    Can View

    Apply this permission to supervisory groups who need to manage their team’s work.

    Tip:Admin users have this permission built-in for all FormSpaces.

    Users
    Can Submit
    • Open and submit an Active form on the Mobile App.

    • In the Mobile App, search for and edit submitted records.

    • Send or transfer (submit) a TrueContext Teamwork-enabled form (Enterprise tier only).

    • Claim a TrueContext Teamwork-enabled form submitted as incomplete (Enterprise tier only).

    Apply this permission to all Field Technicians who require form access to complete their work.

    Tip:All groups have the Can Submit permission preselected by default.

    • Mobile-only users
    • Users
    • Admin users

    View and export your own submitted records.

    • Users

    • Admin users

    Can Approve

    Approval Workflow (Enterprise tier only)

    • Claim a submitted record to review.

    • Approve a submitted record.

    • Request changes to a submitted record.

    • Withdraw approval from a completed record.

    Apply this permission to approver groups who are responsible for reviewing and approving work.
    • Users

    • Admin users

    Can Manage Assignments
    • Send a new or previously dispatched record to a mobile user.

    • Send a new or previously dispatched record to a mobile user, Group, or FormSpace (Enterprise tier only).

    Apply this permission to Users who need to create and manage work.

    Tip:Admin users have this permission built-in for all FormSpaces.

    • Users

    • Admin users

    Info:The topic Permissions Quick Reference includes a detailed list of the actions that users can take in TrueContext and the permissions that they require.

  5. Select Update to save your changes.


Verify the group setup

After creating and configuring the group:

  1. Check that users can see the expected forms on their mobile devices.
  2. Test that Web Portal users can perform their required tasks.
  3. Review the group's FormSpace permissions to ensure they align with user roles.

Manage existing groups

Prerequisites

  • You must have the Admin user role (team admin) in TrueContext.
  • To add or remove users, if you're not a team admin, you must be a Group Admin.

How to make changes to existing groups

To… Go to group details > group name…

Change group details, including:

  • Group name or description
  • Group membership (add or remove users)
  • Option to automatically Add New Users to This Group
  • Add or remove assigned FormSpaces
Update
Set up group administrators Edit User Permissions
Change FormSpace permissions Edit FormSpace Permissions
Delete a group Delete

Change group details

Use the group Update option to:

  • Change the group name and description.
  • Add or remove users.
  • Select or clear the option to automatically Add New Users to This Group.
  • Add or remove assigned FormSpaces.
  1. Go to the group list: Users & Groups > Groups > List Groups.

    Shows the cascading menu options to select Create Group.

    Result: The Groups page displays all groups in your team.

  2. From the Groups page, select the name of the group you want to update.

  3. From the group dropdown menu, select Update.

    Group menu that shows the Update option, used to change the group name, add or remove users, and add or remove FormSpace access

  4. Make the required changes, and then select Update to save your changes.

Note: Removing users from a group immediately removes their access to the FormSpaces assigned to that group.


Set up group administrators

Admin users (team admins) and users identified as Group Admins can:

  • Add or remove users from a group.
  • Identify users as Form Submission Listeners. Email data destinations can be set up to automatically send data to Form Submission Listeners (such as supervisors or managers).
  1. Go to the group list: Users & Groups > Groups > List Groups.

    Shows the cascading menu options to select Create Group.

    Result: The Groups page displays all groups in your team.

  2. From the Groups page, select the name of the group you want to manage.

  3. From the group dropdown menu, select Edit User Permissions.

    Group menu that shows the Edit User Permissions option, used to set up Group Admins and Form Submission Listeners.

  4. Select the users you want to be Group Admins and the users you want to be Form Submission Listeners. Users can be either or both.

  5. Select Update to save your changes.

Change FormSpace permissions

  1. Go to the group list: Users & Groups > Groups > List Groups.

    Shows the cascading menu options to select Create Group.

    Result: The Groups page displays all groups in your team.

  2. From the Groups page, select the name of the group you want to manage.

  3. From the group dropdown menu, select Edit FormSpace Permissions.

    Group menu that shows the "Edit FormSpace Permissions" option, to change what group members can do in a FormSpace.

    Result: The FormSpace Information page opens and displays a list of FormSpaces assigned to the group.

  4. For each FormSpace listed, select the permissions that you want the group to have.

  5. Select Update to save your changes.


Delete a group

Note:Deleting a group is permanent and can't be undone. Users in the deleted group will lose access to assigned FormSpaces unless they belong to other groups with appropriate FormSpace permissions.

Before you delete a group, you might want to:

  1. Go to the group list: Users & Groups > Groups > List Groups.

    Shows the cascading menu options to select Create Group.

    Result: The Groups page displays all groups in your team.

  2. From the Groups page, select the name of the group you want to delete.

  3. From the group dropdown menu, select Delete.

    Group menu that shows the "Delete" option to permanently delete the group.

    Result: The system prompts you to confirm the deletion.

  4. Select Ok to delete the group.

    Result: The Groups page displays a list of remaining groups.


Troubleshoot group access issues

Users can't access forms on mobile devices

Problem: Users report they can't see forms on their mobile devices.

Solution:

  1. Verify the user belongs to a group that has permissions in the FormSpace containing the forms.
  2. Check that the forms are Active, not DraftClosed A draft form is a partially filled-out form saved on a device, or a preliminary version of a form that's been saved but not deployed in the Form Builder..
  3. Confirm the user has reconciled their mobile device recently.
  4. Review the group's FormSpace permissions to ensure they include Can Submit at minimum.

Web Portal users can't perform required tasks

Problem: Users can't view data, manage assignments, or perform other Web Portal functions.

Solution:

  1. Check the user's role (Admin, User, or Mobile-Only).
  2. Verify the user belongs to groups with appropriate FormSpace permissions.
  3. Review the specific permissions required for the task:

    • Can Approve: Required to approve submitted records.
    • Can Manage Assignments: Required to dispatch forms.
    • Can Test: Required to test Draft forms.

New users aren't getting expected access

Problem: New users don't have access to the forms they need.

Solution:

  1. Check if the user was added to the correct groups during account creation.
  2. Verify that groups have Add New Users to This Group enabled if automatic assignment is expected.
  3. Manually add the user to the appropriate groups if needed.
  4. Confirm the groups have the correct FormSpace permissions.