Chat now with support
Chat with Support

Starling Connect Hosted - Active Roles Administration Guide

AtlassianJC

AtlassianJC is a connector that links Atlassian software with Jira software. It gives teams the ability to manage projects and track development efforts in the cloud.

NOTE: AtlassianJC supports the Jira software and Confluence.

Supervisor Configuration Parameters

To configure the connector, following parameters are required:

  • Connector Name

  • Username

  • API Key

  • SCIM URL (Cloud application's instance URL used as targetURI in payload)

Supported Objects and Operations

Users
Table 46: Supported operations for Users

Operation

VERB

Create

POST

Delete

DELETE

Get All Users

GET

Get (Id)

GET

Get All Users with pagination GET
Groups
Table 47: Supported operations for Groups

Operation

VERB

Create

POST

Update

PUT

Delete

DELETE

Get All Groups

GET

Get (Id)

GET

Mandatory Fields

Users
  • DisplayName
  • Email Id
Groups
  • DisplayName

Connector Limitations

  • Cloud application does not support the Created date and Modified date.
  • Timezone, Active, and Locale are readonly fields.

  • Cloud application does not support the PUT operation for User objects.

  • While trying to create a duplicate user, the cloud application returns an error with the status code 201. But the existing user is retrieved as the result.

  • The Stride application is no longer part of Atlassian.

  • Cloud application does not supports the Get All groups with pagination operation.

  • The cloud application attributes for the cloud API URL is case-sensitive.

Pipedrive

Pipedrive is a cloud-based sales management tool offered on a web platform and as a mobile app.

Supervisor Configuration Parameters

To configure the connector, following parameters are required:

  • Connector name

  • API key

  • SCIM URL (Cloud application's instance URL used as targetURL in payload)

Supported Objects and Operations

Users
Table 48: Supported operations for Users

Operation

VERB

Create

POST

Update

PUT

Delete

DELETE

Get user by Id

GET

Get all users

GET

Mandatory Fields

Users
  • Emails.value
  • DisplayName

Connector Limitations

  • The Groups object type is not supported.

  • Pagination is not supported.
  • Deleted user object can be retrieved using Get user by ID.
  • Creation of a duplicate user does not return an error. Instead, the existing object is returned.
  • Deactivated or Deleted users can be deactivated or deleted multiple number of times.

  • Deactivated or Deleted users can be activated again.

  • The Update operation supports only the change of active flag field.

SuccessFactorsHR

SuccessFactorsHR is an integrated human-resources platform. It offers users tools for onboarding, social business, and collaboration along with tools for learning management, performance management, recruiting, applicant tracking, succession planning, talent management, and HR analytics. It is also cloud-based.

Supervisor Configuration Parameters

To configure the connector, following parameters are required:

  • Connector Name
  • Username
  • Password
  • SuccessFactorsHR instance URL (https://apps.support.sap.com/sap/support/knowledge/public/en/2215682)

  • Minimal Attributes

    NOTE: The default value is false. When the value is set to true, only the minimal set of attributes for all the objects including Employee, Department, Location, CostCenter will be queried from the SuccessFactorsHR system.

 

Table 49: Minimal set of attributes for the objects

SuccessFactorsHR

Attributes

Location externalCode, name, description, timezone, geozoneFlx, status
Employee EmpJob attributes: userId, department, costCenter, businessUnit, location, division, startDate, endDate, managerId, jobTitle, contractType, company
User attributes: userId, username, defaultFullName, hireDate, lastModified, status, department, location, firstName, lastName, mi, suffix, email, addressLine1, state, city, zipCode, country, businessPhone, cellPhone
Department name, description, externalCode, status, parent

CostCenter

name, description, externalCode, status

 

Supported Objects and Operations

Users

Not Applicable

Groups

Not Applicable

 

Table 50: Department Mapping
SCIM Parameter SuccessFactorsHR Parameter
DepartmentName id
Description description

ImportSource

sourceSystem

Remarks status
ShortName name

vrtCostCentersMapping

costCenter

vrtDepartmentHead

headOfUnit

vrtLocationsMapping

location

 

Table 51: Location Mapping
SCIM Parameter SuccessFactorsHR Parameter
Building externalCode
Description description
Ident_locality id

ImportSource

sourceSystem

LongName name
Room status

RoomRemarks

locationGroup

Connector Limitations

  • Create and Delete operations are not supported for any object.

  • Currently, the Update functionality is functional only for the following attributes of the Employee object:

    • cellPhone
    • businessPhone
    • email

Nutshell

Nutshell is a customer relationship management (CRM) service. It can be integrated with other SaaS services for small businesses, including Google Apps.

Supervisor Configuration Parameters

To configure the connector, following parameters are required:

  • Connector name

  • Username for the cloud account

  • Password - API Key

  • Target URL of the cloud account

Supported Objects and Operations

Users
Table 52: Supported operations for Users

Operation

VERB

Create

POST

Update

PUT

Delete

DELETE

Deprovision

PUT

Undo Deprovision

PUT

Groups
Table 53: Supported operations for Groups

Operation

VERB

Create POST
Update

PUT

Delete DELETE

Mandatory Fields

Users
  • emails.value

Groups
  • displayName

Connector Limitations

  • Error messages and status codes are not customized. The following status codes are returned:

    • 200
    • 201
    • 204
    • 400
    • 401
    • 404
  • Members cannot be added or retrieved from teams (groups) via the team endpoints. This can be achieved using the user endpoints and, updating the individual users. However, considering the large number of users in live production environments, membership management is not supported by the connector, as performance issues may arise.
  • The delete operation is soft delete. Hence, it is possible to delete, or retrieve the deleted user or group multiple number of times. However, a deleted group will not be retrieved as part of the list groups response.
  • Multiple email addresses can be associated to a user. Hence, the first email Id from the Nutshell user response is considered as the email id for the SCIM user.
  • The NutShell API does not provide information on retrieval of all resources through paginated requests. Hence, the connector provides a nextCursor value, when the total resource count is divisible by requested count.

Related Documents