Chat now with support
Chat with Support

Starling Connect Hosted - Active Roles Administration Guide

Zendesk

Zendesk is a unified customer service platform. It features a common user interface, single login, and a platform for sharing customer data.

Supervisor Configuration Parameters

To configure the connector, following parameters are required:

  • Connector name

  • User Name

  • Password

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

Supported Objects and Operations

Users
Table 66: Supported operations for Users

Operation

VERB

Create User

POST

Update User

PUT

Delete User

DELETE

Deprovision

PUT

Undo Deprovision

PUT

Groups
Table 67: Supported operations for Users

Operation

VERB

Create Group

POST

Update Group

PUT

Delete Group

DELETE

Deprovision

PUT

Undo Deprovision

PUT

Update Membership

PUT

Mandatory Fields

Users
  • DisplayName
  • Email
Groups

DisplayName

Connector Limitations

  • A user with Agent role only can be added to group membership.

  • Get resource by pagination will always return the resources in multiples of hundred. For example, if the count is specified as 126, 200 records are returned.

  • If any value for startIndex is passed when using get resources by pagination parameter, the result from the connector is always the nearest 100 records from the requested number.

  • Users can be deleted multiple times as the cloud application supports soft delete.

G Suite

G Suite is a cloud computing, productivity, and collaboration tool. It includes the Google web applications Gmail, Drive, Hangouts, Calendar, and Docs. It also includes an interactive whiteboard. The enterprise version offers custom-domain email addresses, additional storage, and 24/7 phone and email support.

You must create a service account to access the G Suite services. For information on creating a service account, see Creating a service account in G Suite.

Supervisor Configuration Parameters

To configure the connector, following parameters are required:

  • Connector name

  • UserName

  • Private_Key (Whole JSON content of private key file created for service account)

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

Supported Objects and Operations

Users
Table 68: Supported operations for Users

Operation

VERB

Create User

POST

Update User

PUT

Delete User

DELETE

Deprovision

PUT

Undo Deprovision

PUT

Groups
Table 69: Supported operations for Groups

Operation

VERB

Create Group

POST

Update Group

PUT

Delete Group

DELETE

Deprovision

PUT

Undo Deprovision

PUT

Update Membership

PUT

Mandatory Fields

Users
  • FirstName

  • LastName

  • Password

Groups

Email

Connector Limitations

  • Connector supports cursor based pagination even with any change at count in subsequent requests.

  • Created date is displayed for Users. Created date and Modified date are not displayed for Groups.

  • Group information of user is not displayed in user details.

  • The Email ID of Users and Groups to be created should be provided along with the domain name of target instance.

 

Concur

Concur offers two on-demand Software as a Service (SaaS) products to help manage travel. Concur Travel & Expense gives you web and mobile solutions for travel and expense management, and TripIt is a mobile travel organizer for individuals.

Supervisor Configuration Parameters

To configure the connector, following parameters are required:

  • Connector name

  • Client Id

  • Client Secret

  • Username

  • Password
  • Geolocation

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

Supported Objects and Operations

Users
Table 70: Supported operations for Users

Operation

VERB

Create User

POST

Update User

POST

Delete User

DELETE

Get User

GET

Get All Users

GET

Get All Users with Pagination

GET

Groups

NA

Mandatory Fields

Users
  • userName

  • name.givenName

  • name.familyName

  • enterpriseUserExtension.empId

  • emails.value

  • password

  • scimUser.locale

  • enterpriseUserExtension.ctryCode

  • enterpriseUserExtension.crnKey

  • enterpriseUserExtension.ledgerKey

  • enterpriseUserExtension.custom21

Groups

NA

Connector Limitations

  • Only user end-points are supported in Concur connector.

  • Inactive user's information is not displayed when Get All Users operation is performed.

  • The search result status for inactive user is NotFound .

  • While Get Users by Pagination with StartIndex and count specified, next nearest multiple of 100 records to the count value are fetched.

  • Invalid Geolocation url returns BadRequest status.

  • Created and LastModified dates are not supported.

  • API does not return the details of groups to which a user is associated.

  • POST user with the details similar to that of existing user's id, email and EmpId will update existing user's information. In such case, status code 201 is returned.

  • Inactive user cannot be created or edited.

  • GivenName and FamilyName are not updated in PUT user operation.

  • Custom21 value accepts only the Expense list code. For example, a valid Custom21 value are IN - 890, IN - 562, AU - 510, NL - 842, NO - 432, and so on.

  • Currently, an authentication related issue is observed while Get User by Id for a user "cteadmin@quest.com". This issue causes integration failure. To fix this, two keys are introduced in AppSettings of function host named ShouldExcludeUsers and ExcludeUserIds.

  • ShouldExcludeUsers key accepts either true or false as value, and ExcludeUserIds takes comma separated user's ids.

  • If value for ShouldExcludeUsers is true, the user ids mentioned in ExcludeUserIds will not appear in GetAll Users response.

 

Tableau

Tableau offers data visualization software to let users upload files to a server or the cloud. You can create custom dashboards to analyze business intelligence and data.

Supervisor Configuration Parameters

To configure the connector, following parameters are required:

  • Connector name

  • Username

  • Password
  • Site name (Example: https://online.tableau.com/#/site/MarketingTeam/users)

  • Target URL (Cloud application's instance URL used as target URI in payload - Example: https://{instance-name}.online.tableau.com/api/{api-version})

Supported Objects and Operations

Users
Table 71: Supported operations for Users

Operation

VERB

Create User

POST

Update User

PUT

Delete User

DELETE

Deprovision

PUT

Undo Deprovision

PUT

Groups
Table 72: Supported operations for Groups

Operation

VERB

Create Group

POST

Update Group

PUT

Deprovision

PUT

Undo Deprovision

PUT

Update Membership

PUT

Mandatory Fields

Users

Email

Groups

displayName

Connector Limitations

  • User update is supported for User role only.

  • Created and last modified dates are not available.

  • Group deletion is not supported.

  • Adding or removing a member from a renamed group is possible only after a full synchronization .

 

Related Documents