Disclaimer
The integration was either created by Saviynt or by Saviynt community users . The integration is available “as is” and falls under standard connectors support for REST, SOAP, JDBC, LDAP, PowerShell, Jar and Saviynt Connector Framework.
Note: Contributor - Manju Kumari
Preface
This guide describes the integration between Saviynt Enterprise Identity Cloud (EIC) and Connecteam.
Audience
This guide is intended for administrators and target system integration teams responsible for integrating and importing users from Connecteam.
Introduction
Connecteam is a workforce management and communication platform designed for businesses with remote or deskless employees. It provides a suite of tools and features to help organizations streamline their operations, improve communication, and manage their workforce more effectively. Some key features and capabilities of Connecteam include:
Employee Communication: Connecteam enables businesses to communicate with their employees through chat, messaging, and announcement features. This helps in keeping employees informed and connected, especially if they work in different locations or shifts.
Task and Project Management: Users can create and assign tasks, projects, and checklists to employees. This feature helps in tracking work progress and ensuring that tasks are completed on time.
Time Tracking: Connecteam offers time tracking and attendance management tools. Employees can clock in and out using the mobile app, and managers can monitor working hours and attendance.
Employee Scheduling: Businesses can create and manage work schedules for their employees, making it easier to assign shifts and track availability.
Training and Onboarding: The platform allows businesses to create and deliver training materials, quizzes, and onboarding processes for new employees.
Forms and Checklists: Users can create custom forms and checklists for various purposes, such as inspections, safety checks, and data collection.
Employee Directory: Connecteam provides a centralized employee directory, making it easy to access contact information and organizational charts.
Performance Tracking: Users can set performance goals, track progress, and conduct employee evaluations within the platform.
Reporting and Analytics: Connecteam offers reporting and analytics tools to help businesses gain insights into their workforce and operations.
Integration: The platform integrates with other business tools and software, such as payroll systems, to streamline processes and data flow.
Connecteam is suitable for a wide range of industries, including retail, construction, healthcare, hospitality, and more. It aims to improve efficiency, communication, and overall management of a mobile or remote workforce.
The REST connector enables you to create an integration with Connecteam for importing users to Saviynt EIC as an HR Identity source. For more information about different connectors in EIC, see Saviynt Enterprise Identity Cloud Connectors.
Note: This guide provides information about using the Connecteam (REST-based) connector for performing operations listed in the Supported Features.
Supported Features
The Connecteam integration supports the following features:
Supported Software Versions
Software | Version |
EIC | Release v4.5 and later |
Understanding the Integration between EIC and Connecteam
You must create an integration between EIC and the collaboration platform hosted by the target application to perform import tasks. The following components are involved in the integration:
Connecteam is the target application that is integrated with the EIC through the REST connector to import the users.
The REST connector enables communication between EIC and the target application. It provides a simplified integration mechanism where in some instances you only need to create a connection with minimal connectivity information for your target application. The REST connector is used for importing users through the REST APIs. For more information about creating a connection, see Creating a Connection.
Job Scheduler is a software component that executes a job based on the configured schedule to perform import operations from EIC. For more information about the jobs used by the connector in the Connecteam integration.
Integration Architecture
EIC uses a REST connection for integrating with Connecteam for importing users. The REST connection uses the REST protocol to communicate with the REST interface of Connecteam.
The following diagram illustrates the connector architecture and communication with the target application.
Figure: Connecteam Integration Architecture
Configuring a Connection
Prerequisites
Tokens can be purchased in the Connecteam platform. This makes it easy for you to ensure you always have enough tokens when needed.
To buy tokens simply press the purchase tokens button and select the relevant bundle. Purchased Tokens never expire and can always be refunded if needed!
For more information check this link.
Creating a Connection
Connection refers to the configuration setup for connecting EIC to target applications. For more information about the procedure to create a connection, see Creating a Connection.
Understanding the Configuration Parameters
While creating a connection, you must specify connection parameters that the connector uses to connect with the target application, define the type of operations to perform, the target application objects against which those operations are performed, and the frequency of performing them. In addition, you can view and edit attribute mappings between EIC and the target application.
Configuration Parameters for User Import
The connector uses the following parameters for creating a connection and for importing users from the target application:
Connection Parameters
Parameter | Description | Example Configuration | Mandatory? |
Connection Name | Specify the name to identify the connection. | - | Yes |
Connection Description | Specify the description for the connection. | - | No |
Connection Type | Select the connection type as REST. | - | Yes |
Default SAV Role | Specify this parameter to assign the SAV role for the connection. The SAV role is a role in EIC that assigns specific access to users. This parameter is valid only for importing users. Sample value: User assigned with the ROLE_ADMIN role, has access to all the sections of EIC. | - | No |
Email Template | Specify this parameter to select an email template for sending notifications. Email templates provide immediate trigger of emails to a user based on actions performed. Email informs user about the action performed and if critical, needs immediate action from the user. | - | No |
ConnectionJSON | Specify this parameter to create a connection.
| Use the following format to connect to the Connecteam application: | Yes |
Import Parameters
Parameter | Description
| Recommended Configuration | Mandatory? |
UserImport JSON | Specify this parameter to import the users. | Refer to the Connection Package |
Yes |
UpdateUserJSON | Specify this parameter to update the users. | Yes |
Using the Connecteam Integration
You can use the Connecteam integration for performing user import after configuring it to meet your requirements.
Guidelines for Using the Integration
To configure import, map all Connecteam attributes to EIC user attributes using UserImport JSON.
Configuring Import Operations
Full User import: When configuring the connection for the first time, first perform the full import to import all existing Users from the target application to EIC. To perform full import, the invoke API gets response from the target application and maps the attributes in the target application with attributes in EIC.
The import jobs are automatically created in EIC after you create a connection for the Connecteam integration.
To import users:
Specify the connection and import parameters.
Note: Ensure that the connection type is selected as REST.Configure the User Import via a Connection (UserImportJob) to import users. For more information about creating jobs, see Data Jobs.
Troubleshooting
To troubleshoot common problems with connectors, answer frequently asked questions, and provide solutions to a few common issues you might encounter while configuring or working with connectors, see Common Troubleshooting Guide for Connectors.
To troubleshoot common problems or obtain answers to frequently asked questions for REST connectors, see the REST Connector Guide.
