Supported objects and operations
Facebook Workplace is a collaborative business platform run by Facebook to help users communicate through groups, chat, and social networking in a corporate environment.
Supervisor configuration parameters
To configure the connector, following parameters are required:
-
Connector Name
- API Key
-
Target URL
- Graph API URL
Users
Table 15: Supported operations and objects for Users
Create |
POST |
Update (Id) |
PUT |
Delete (Id) |
DELETE |
Get (Id) |
GET |
Get |
GET |
Pagination |
GET |
Groups
Table 16: Supported operations and objects for Groups
Create |
POST |
Update (Id) |
PUT |
Delete (Id) |
DELETE |
Get (Id) |
GET |
Get |
GET |
Pagination |
GET |
Mandatory fields
Users
Groups
User and Group mapping
The user and group mappings are listed in the tables below.
Table 17: User mapping
Id |
Id |
UserName |
userName |
Name.Formatted |
name.formatted |
Name.GivenName |
name.givenName |
Name.FamilyName |
name.familyName |
Name.MiddleName |
name.middleName |
Name.HonorificPrefix |
name.honorificPrefix |
Name.HonorificSuffix |
name.honorificSuffix |
DisplayName |
displayName |
NickName |
nickName |
UserType |
userType |
Title |
title |
PreferredLanguage |
preferredLanguage |
Locale |
locale |
Timezone |
timezone |
Active |
active |
Emails |
emails |
Addresses |
addresses |
PhoneNumbers |
phoneNumbers |
Groups.value |
Group.id |
Groups.display |
Group.name |
Extension.Organization |
organization |
Extension.Division |
division |
Extension.Department |
department |
Extension.Manager.Value |
manager.managerId |
Extension.EmployeeNumber |
employeeNumber |
Extension.CostCenter |
costCenter |
Meta.Created |
Meta.created |
Table 18: Group mapping
Id |
Id |
DisplayName |
Name |
Members.value |
UserOrGroupId |
Meta.Created |
CreatedDate |
Meta.LastModified |
LastModifiedDate |
Extension.description |
description |
Extension.email |
email |
Extension.manager.value |
owner.id |
Extension.privacy |
privacy |
Connector limitations
- Only the trial subscriptions created using a business email ID with valid domain account will have the access to API integration. The subsequent subscriptions will not have the access.
- Create Groups, Update Groups and Delete Groups are not supported at the free subscription provided by target system.
- You can use a Group object only if at least one member associated with it.
- The Group will get deleted automatically when the last member is removed from the membership association.
- Connector supports Add Group Manager and Modify Group Manager, however the group details returned by connector will not have Group Manager information unless the group is created using the user interface of Facebook Workplace. This is due to the limitations of API provided by the target system.
Mandatory fields
Facebook Workplace is a collaborative business platform run by Facebook to help users communicate through groups, chat, and social networking in a corporate environment.
Supervisor configuration parameters
To configure the connector, following parameters are required:
-
Connector Name
- API Key
-
Target URL
- Graph API URL
Supported objects and operations
Users
Table 15: Supported operations and objects for Users
Create |
POST |
Update (Id) |
PUT |
Delete (Id) |
DELETE |
Get (Id) |
GET |
Get |
GET |
Pagination |
GET |
Groups
Table 16: Supported operations and objects for Groups
Create |
POST |
Update (Id) |
PUT |
Delete (Id) |
DELETE |
Get (Id) |
GET |
Get |
GET |
Pagination |
GET |
Users
Groups
User and Group mapping
The user and group mappings are listed in the tables below.
Table 17: User mapping
Id |
Id |
UserName |
userName |
Name.Formatted |
name.formatted |
Name.GivenName |
name.givenName |
Name.FamilyName |
name.familyName |
Name.MiddleName |
name.middleName |
Name.HonorificPrefix |
name.honorificPrefix |
Name.HonorificSuffix |
name.honorificSuffix |
DisplayName |
displayName |
NickName |
nickName |
UserType |
userType |
Title |
title |
PreferredLanguage |
preferredLanguage |
Locale |
locale |
Timezone |
timezone |
Active |
active |
Emails |
emails |
Addresses |
addresses |
PhoneNumbers |
phoneNumbers |
Groups.value |
Group.id |
Groups.display |
Group.name |
Extension.Organization |
organization |
Extension.Division |
division |
Extension.Department |
department |
Extension.Manager.Value |
manager.managerId |
Extension.EmployeeNumber |
employeeNumber |
Extension.CostCenter |
costCenter |
Meta.Created |
Meta.created |
Table 18: Group mapping
Id |
Id |
DisplayName |
Name |
Members.value |
UserOrGroupId |
Meta.Created |
CreatedDate |
Meta.LastModified |
LastModifiedDate |
Extension.description |
description |
Extension.email |
email |
Extension.manager.value |
owner.id |
Extension.privacy |
privacy |
Connector limitations
- Only the trial subscriptions created using a business email ID with valid domain account will have the access to API integration. The subsequent subscriptions will not have the access.
- Create Groups, Update Groups and Delete Groups are not supported at the free subscription provided by target system.
- You can use a Group object only if at least one member associated with it.
- The Group will get deleted automatically when the last member is removed from the membership association.
- Connector supports Add Group Manager and Modify Group Manager, however the group details returned by connector will not have Group Manager information unless the group is created using the user interface of Facebook Workplace. This is due to the limitations of API provided by the target system.
Connector limitations
Facebook Workplace is a collaborative business platform run by Facebook to help users communicate through groups, chat, and social networking in a corporate environment.
Supervisor configuration parameters
To configure the connector, following parameters are required:
-
Connector Name
- API Key
-
Target URL
- Graph API URL
Supported objects and operations
Users
Table 15: Supported operations and objects for Users
Create |
POST |
Update (Id) |
PUT |
Delete (Id) |
DELETE |
Get (Id) |
GET |
Get |
GET |
Pagination |
GET |
Groups
Table 16: Supported operations and objects for Groups
Create |
POST |
Update (Id) |
PUT |
Delete (Id) |
DELETE |
Get (Id) |
GET |
Get |
GET |
Pagination |
GET |
Mandatory fields
Users
Groups
User and Group mapping
The user and group mappings are listed in the tables below.
Table 17: User mapping
Id |
Id |
UserName |
userName |
Name.Formatted |
name.formatted |
Name.GivenName |
name.givenName |
Name.FamilyName |
name.familyName |
Name.MiddleName |
name.middleName |
Name.HonorificPrefix |
name.honorificPrefix |
Name.HonorificSuffix |
name.honorificSuffix |
DisplayName |
displayName |
NickName |
nickName |
UserType |
userType |
Title |
title |
PreferredLanguage |
preferredLanguage |
Locale |
locale |
Timezone |
timezone |
Active |
active |
Emails |
emails |
Addresses |
addresses |
PhoneNumbers |
phoneNumbers |
Groups.value |
Group.id |
Groups.display |
Group.name |
Extension.Organization |
organization |
Extension.Division |
division |
Extension.Department |
department |
Extension.Manager.Value |
manager.managerId |
Extension.EmployeeNumber |
employeeNumber |
Extension.CostCenter |
costCenter |
Meta.Created |
Meta.created |
Table 18: Group mapping
Id |
Id |
DisplayName |
Name |
Members.value |
UserOrGroupId |
Meta.Created |
CreatedDate |
Meta.LastModified |
LastModifiedDate |
Extension.description |
description |
Extension.email |
email |
Extension.manager.value |
owner.id |
Extension.privacy |
privacy |
- Only the trial subscriptions created using a business email ID with valid domain account will have the access to API integration. The subsequent subscriptions will not have the access.
- Create Groups, Update Groups and Delete Groups are not supported at the free subscription provided by target system.
- You can use a Group object only if at least one member associated with it.
- The Group will get deleted automatically when the last member is removed from the membership association.
- Connector supports Add Group Manager and Modify Group Manager, however the group details returned by connector will not have Group Manager information unless the group is created using the user interface of Facebook Workplace. This is due to the limitations of API provided by the target system.
SAP Cloud Platform
SAP Cloud Platform is an open Platform as a Service (PaaS) that offers users in-memory capabilities, core platform services, and business services for cloud applications.
Supervisor configuration parameters
To configure the connector, following parameters are required:
Supported objects and operations
Users
Table 19: Supported operations for Users
Create |
POST |
Update (Id) |
PUT |
Delete (Id) |
DELETE |
Get (Id) |
GET |
Get |
GET |
Pagination |
GET |
Groups
Table 20: Supported operations for Groups
Create |
POST |
Update (Id) |
PUT |
Delete (Id) |
DELETE |
Get (Id) |
GET |
Get |
GET |
Mandatory fields
Users
Groups
User and Group mapping
The user and group mappings are listed in the tables below.
Table 21: User mapping
Id |
id |
UserName |
userName |
Name.GivenName |
givenName |
Name.FamilyName |
familyName |
Name.HonorificPrefix |
name.honorificPrefix |
DisplayName |
displayName |
Emails.Value |
email.value |
Addresses.StreetAddress |
addresses.streetAddress |
Addresses.Locality |
addresses.locality |
Addresses.Region |
addresses.region |
Addresses.PostalCode |
addresses.postalCode |
Addresses.Country |
addresses.country |
Addresses.Type |
addresses.type |
PhoneNumbers.value |
phoneNumbers.value |
UserType |
userType |
Locale |
locale |
Timezone |
timeZone |
Active |
active |
Groups.value |
group.$ref |
Groups.display |
group.display |
Extension.Organization |
extension.organization |
Extension.Division |
extension.division |
Extension.Department |
extension.department |
Extension.Manager.Value |
extension.manager.value |
Extension.Manager.DisplayName |
extension.manager.displayName |
Extension.ContactPreferenceTelephone |
contactPreferenceTelephone |
Extension.IndustryCrm |
industryCrm |
Extension.PasswordStatus |
passwordStatus |
Extension.MailVerified |
mailVerified |
Extension.CompanyRelationship |
companyRelationship |
Extension.ContactPreferenceEmail |
contactPreferenceEmail |
Extension.SourceSystem |
sourceSystem |
Extension.CostCenter |
extension.costCenter |
Extension.EmployeeNumber |
extension.employeeNumber |
Extension.CorporateGroups |
corporateGroups.value |
Extension.customAttributes.name |
attributes.name |
Extension.customAttributes.value |
attributes.value |
Meta.Created |
meta.created |
Meta.LastModified |
meta.lastModified |
Table 22: Group mapping
id |
name |
DisplayName |
displayName |
Members.value |
members.value |
Members.display |
members.display |
Extension.GroupName |
extension.name |
Extension.Description |
extension.description |
Connector limitations
-
A performance impact is expected, with a list response of Groups because each record is retrieved and counted, since SCP Groups APIs do not provide totalResults.
-
ServiceProviderAuthority contains only Id field with the same value as the tenant id of the SCP instance, as there are no APIs that can fetch the tenant details in SCP.
-
Get All Groups and Get particular group with ID operations do not retrieve Created and Last Modified fields for Groups object types.