Teams
Inviting other developers as team members on an 8base workspace is easy. As the workspace owner, you can quickly configure user roles and invite users to the workspace from within the console.
Inviting team members
To invite a team member, navigate to Settings > Teams
. Click the invite user button to open the invitation form. Once completed, send the invitation and 8base will email the invitee.
Managing team members
Team members can be updated and removed from a workspace in the Settings > Teams
page. Updating a team member's roles will effect their permissions within the current workspace. Deleting a team member will only disassociate a developer from the current workspace; their 8base developer account will remain intact.
To view pending invitations, switch the top left drop-down option to Invitations. In this view, team invitations can both be revoked or resent. If a mistake was made in the original invitation, please delete and create a new and correct invitation – pending invitations cannot be edited.
Roles and permission for team members
The same roles and permissions system that is used in authorizing 8base applications is used for team member access management. These roles can be configured so that they are specific to an individual or general to a group. Roles are configured the same way in both of these scenarios. However, lets look at both examples.
Developer User Role
In some scenarios, the workspace owner might want to limit the access of an individual developer (Steve) so that they:
- Are not allowed to edit the data model.
- Are only allowed to view their own records.
To accomplish this, they'd add a new role in App Services > Roles
called "Steve - Developer Role". Then in the role's data configuration window, they'd update all tables to only allow "Steve" to read and update User's Records. Next, in the role's app configuration window, they'd ensure that Data: Enable for role: Schema Access is unchecked.
When inviting the developer as a team member, this new role can be attached to the invitation. Otherwise, it can be attributed to their team member profile once they've accepted the invitation.
Developer Group Role
In some scenarios, the workspace owner might want to limit the access of a type of developer (front-end) so that they:
- Are not allowed to deploy back-end logic to the workspace.
- Are not allowed to administer the workspace.
To accomplish this, they'd add a new role in App Services > Roles
called "Frontend Developer Role". In the role's app configuration window, they'd ensure that Settings: Enable for role: Workspace Administration and Logic: Enable for role: Deploy are unchecked.
When inviting a front-end developer team member, this new role can be attached to their invitation. Otherwise, it can be attributed to any team members profile once they've accepted the invitation.
Team Members vs. App Users
There are two types of user-related records in 8base. The first one is called Team Member Record and is created when a Team Member is invited to a workspace. The second one is User Record which is related to the actual client app User who signs-up (registers) for the application you build.
This is an important distinction to be understood. The roles assigned to the Team Member determine which permissions the developer has within the Management Console. The roles assigned to the User determine which permissions the developer has within the application being built.
If the developer wants to test the application as if their account only had the "Guest" role, they can do so by updating their User Record with the desired role. However, only the workspace administrator is able to update and edit roles belonging to Team Members.
Troubleshooting
Common issues when inviting team members.
1: The invitation link you clicked is for another account!
Existing 8base developers may already be logged in when accepting an invitation to join another workspace. If the logged in account's email address is different to that which the invitation was sent to, the invitation will fail. This issue can be resolved by either:
- Have the developer logout, re-accept the invitation, and create a new account.
- Cancel the invitation and resend a new one to the developer's account email address.