Configuring custom attributes for Coupa v.1.0
Configuring custom attributes for Coupa v.1.0
This feature allows you to configure custom attributes in Starling Connector during connector subscription. You can provide the list of custom attributes in a defined format with the name, type and allowed values of the attributes. The custom mappings in the One Identity Manager provide the values for these custom attributes.
NOTE:
- Only String and Boolean data types are supported currently by Coupa connector.
- While configuring Coupa v.1.0 connector, if you do not want to configure any custom attributes, then enter the value None in the Custom Properties field.
To configure custom attributes:
-
Enter the custom properties in the mentioned format in Starling.
-
In the One Identity Manager, map the created custom attributes that were specified in Starling.
-
Perform a synchronization and verify if the custom attributes are available in the One Identity Manager.
NOTE:
-
The Starling UI has default mapped attributes.
-
Apart from the default mapped attributes, the Starling UI used for registering a Coupa connector has an input field where you can provide the custom attributes that have to be mapped in the connector's User resource type.
The format of the custom attributes in the User resource type must be as follows:
{field_name}|{data_type}
Example: custom_attribute_name1|string;custom_attribute_name2|string;
custom_attribute_name1 = name of the custom attribute
data_type = string (or) boolean
-
All custom attributes are mapped in the enterprise user extensions.
-
All custom user attributes have mutability: readWrite, returned: default, caseExact: false, required: false, 'multiValued: false, uniqueness: none.
-
Only the data types Stringand Boolean are supported currently by Coupa connector.
Configuring custom attributes in connectors
Configuring custom attributes in connectors
This section describes the steps to configure custom attributes using Starling Connect for connectors.
To configure a custom attribute:
- Navigate to the configured connector in the Active Connectors section.
- Click the connector tile.
The General Configuration and Schema Configuration are displayed.
- Click EDIT.
The Schema Configuration displays the Custom Attributes section, where you can configure the custom attributes.
NOTE: If you have already configured any custom attributes, they are displayed in the Custom Attributes section.
- Select the object under which you want to create the custom attribute.
- In the Custom Attributes section, enter the appropriate values in the following fields:
- Data Type
- Target System Attribute name
- Description
NOTE:
Choose the required option from the available list of data types in the Data Type field
- Binary
- Boolean
- DateTime
- Decimal
- Integer
- String
- Click SAVE.
NOTE:
- To configure another custom attribute, click ADD ATTRIBUTE.
- To remove a custom attribute, select the custom attribute and click Remove.
- To modify and existing custom attribute, click the custom attribute and enter new configuration details.
- Enter the configuration details in the General Configuration section and click Test Connection.
- Click SAVE.
The newly created custom attribute is displayed in Custom Attributes section and is available in One Identity Manager.
NOTE:
- In SuccessFactors HR connector, if a custom attribute is a part of navigation, then you must enter it in the following format in Starling Connect: <navigation>$$<custom_attribute>. For example, you must enter userNav/dateOfBirth as userNav$$dateOfBirth in Starling Connect.
- The SuccessFactors HR connector supports single level of navigation only.
Disabling attributes
The Disable attribute feature can be used when you want to skip an attribute that exists in the target system.
NOTE: Mandatory attributes cannot be disabled.
This section describes the steps to disable an attribute using Starling Connect.
To disable an attribute:
- Navigate to the configured connector in the Active Connectors section.
- Click the connector tile.
The General Configuration and Schema Configuration are displayed.
- Click EDIT.
The Schema Configuration highlights the attributes that can be disabled.
NOTE: You cannot disable mandatory attributes. Mandatory attributes are suffixed with a *.
- Toggle the attribute that you want to disable.
NOTE: If you disable a parent attribute, all its child attributes are disabled.
- Enter the configuration details in the General Configuration section and click Test Connection.
- Click SAVE.
The disabled attribute is removed from the SCHEMA responses and requests of the following operations:
Operation |
From |
GET Schema |
Response |
Get <object> by Id |
Response |
Create <object> |
Response
Request (which is sent from the connector to the cloud application) |
Update <object> |
Response
Request (which is sent from the connector to the cloud application) |
NOTE: In the above table, <object> represents a connector endpoint.
Configuring a connector that uses the consent feature
Configuring a connector that uses the consent feature
This section describes the procedure to configure a connector that uses the consent feature.
To configure a connector that uses the consent feature
- Enter the configuration details in the General Configuration.
NOTE:
- Each connector requires a different set of configuration details. For more information about the configuration details for each connector, navigate to the section Supervisor configuration parameters for the connector that you want to configure, in this document.
- Every connector license that you have, allows you to configure two different connections, one in the Production environment and the other in the Development environment. Hence, you can configure the connector to create a Starling Connect connector connection in your Development environment for testing, and then, configure it in your Production environment.
- Click Give Consent.
NOTE:
- To provide consent, use an account with administrative privileges.
- For more information about the necessary permissions required to configure each connector, navigate to the section Connector configuration for the connector that you want to configure, in this document.
- Click Test Connection.
- Click Save.