Skip to main content

Eletive

· 7 min read
Pradeep Kadambar
Pradeep Kadambar
Creator

Eletive is a People Success Platform that gathers real-time employee engagement surveys, performance management, OKR goal-setting, 360-feedback, and 1:1s in one intuitive and user-friendly tool. Eletive automates and streamlines tedious admin tasks, so HR, managers, and team members can focus on the business goals.

Versions: 7.5.2

Connector Settings​

Steps

  1. Login to RSA Identity G&L console as System Administrator.
  2. Navigate to AFX > Connectors.
  3. Click on Create Connector and select the RESTful Web Service connector template.
  4. Enter the details as shown below under General tab.

    Alt text
  5. Click on the Settings tab and enter the required connection details.

    Alt text
  6. Click on Add More Parameters.
  7. Enter the details for APIKey as shown below and click OK.

    Alt text
  8. Provide the API key in the API Key field and click OK.

    Alt text
    .

Supported Verbs​

Create an Account​

Steps

  1. Edit the connector and navigate to Capabilities tab.
  2. Click on Create an Account and configure as shown below.

Command Input Parameters

Parameter Name*Display NameMappingDescription
Account✔️Account ID${AccountTemplate.Name}A unique identifier used to reference users
LastName✔️Last Name${AccountTemplate.LastName}Family name of the user
FirstName✔️First Name${AccountTemplate.FirstName}Given name of the user
Email✔️Email Address${AccountTemplate.Email}Primary email address of user
ManagerIDManager ID${AccountTemplate.ManagerID}A unique identifier used to reference user's supervisor
ManagerEmailManager Email Address${AccountTemplate.ManagerEmail}Primary email address of user's supervisor
EmpTypeEmployee Type${AccountTemplate.EmpType}Used to identify the relationship between the organization and the user.
CountryCountry${AccountTemplate.Country}The user's country (ISO 3166 — Country Codes)

🔒 = Encrypted ✔️ = Required

Command Output Parameters
Parameter NameTypeDisplay NameMappingDescription
ExternalIDStringExternal IDAccount.Name A unique identifier used to reference users within Eletive
Command Code
Generate SessionToken
MethodPOST
Pathv1/scim2/Users
Request Headers
Content-Typeapplication/json
Accept*/*
AuthorizationBearer ${Settings.APIKey}
Request Body
{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:ietf:params:scim:schemas:extension:eletive:2.0:User"
  ],
  "externalId": "${Account}",
  "userName": "${Email}",
  "name": {
    "familyName": "${LastName}",
    "givenName": "${FirstName}"
  },
  "emails": [
    {
      "type": "work",
      "value": "${Email}",
      "primary": true
    }
  ],
  "locale": "en",
  "preferredLanguage": "en",
  "userType": "Users",
  "active": true,
  "urn:ietf:params:scim:schemas:extension:eletive:2.0:User": {
    "participateInSurvey": true,
    "Manager": {
      "email": "${ManagerEmail}",
      "externalId": "${ManagerID}"
    },
    "Country": "${Country}",
    "Email": "${Email}",
    "userType": "${EmpType}"
  }
}
Status Code
Expression TypeStatus Code
Pattern
^[23]\d{2}$0
^([45])\d{2}$$1
Brief Response
Expression TypeStatus Code
Pattern
^(.{0,3})Response code: $1
Detailed Response
Expression TypeStatus Code
Pattern
^(.{0,3})Response code: $1
ExternalID
Expression TypeJson Path
Expressionid
  1. Click OK.
  2. Run the Test Connector Capabilities to verify the verb.

Enable an Account​

Steps

  1. Edit the connector and navigate to Capabilities tab.
  2. Click on Enable an Account and configure as shown below.

Command Input Parameters

Parameter Name*Display NameMappingDescription
Account✔️Account ID${Account.External_Id}A unique identifier used to reference users

🔒 = Encrypted ✔️ = Required

Command Code
Generate SessionToken
MethodPATCH
Pathv1/scim2/Users/${Account}
Request Headers
Content-Typeapplication/json
Accept*/*
AuthorizationBearer ${Settings.APIKey}
Request Body
{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:PatchOp"
  ],
  "Operations": [
    {
      "op": "add",
      "path": "active",
      "value": true
    }
  ]
}
Status Code
Expression TypeStatus Code
Pattern
^[23]\d{2}$0
^([45])\d{2}$$1
Brief Response
Expression TypeStatus Code
Pattern
^(.{0,3})Response code: $1
Detailed Response
Expression TypeStatus Code
Pattern
^(.{0,3})Response code: $1
  1. Click OK.
  2. Run the Test Connector Capabilities to verify the verb.

Disable an Account​

Steps

  1. Edit the connector and navigate to Capabilities tab.
  2. Click on Disable an Account and configure as shown below.

Command Input Parameters

Parameter Name*Display NameMappingDescription
Account✔️Account ID${Account.External_Id}A unique identifier used to reference users

🔒 = Encrypted ✔️ = Required

Command Code
Generate SessionToken
MethodPATCH
Pathv1/scim2/Users/${Account}
Request Headers
Content-Typeapplication/json
Accept*/*
AuthorizationBearer ${Settings.APIKey}
Request Body
{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:PatchOp"
  ],
  "Operations": [
    {
      "op": "add",
      "path": "active",
      "value": false
    }
  ]
}
Status Code
Expression TypeStatus Code
Pattern
^[23]\d{2}$0
^([45])\d{2}$$1
Brief Response
Expression TypeStatus Code
Pattern
^(.{0,3})Response code: $1
Detailed Response
Expression TypeStatus Code
Pattern
^(.{0,3})Response code: $1
  1. Click OK.
  2. Run the Test Connector Capabilities to verify the verb.

References​

CON003