Functionalities
Identity Integration
Product Feature |
Supported |
Authenticate User |
No |
Validate User |
Yes |
Enable/Disable User |
No |
Reset Password |
Yes |
Expire Password Immediately |
No |
Expire Password by Date |
No |
Provisioning Integration
Data Format |
Export |
Create |
Modify |
Delete |
Trigger |
User |
Yes |
Yes |
Yes |
Yes |
No |
Group |
Yes |
Yes |
Yes |
Yes |
No |
UserList |
Yes |
Yes |
Yes |
Yes |
No |
Prerequisites
Ensure that these prerequisites are satisfied:
- Rave Alert is available, configured, and running.
- An administrator account that can be used to establish a connection and has authority to manage objects on the Rave Alert system.
Create the Rave Alert connected system in the Admin UI
- Log in to Identity Administration and click the Systems tab.
- On the Connected System View page, click the Add button and select Rave Alert from the Type drop-down list. The Connected System Details page displays the default values:
Only configurations which are specific to Rave Alert is documented below. For an overview of the configuration which are common to all connectors, please refer to our link to “connected systems guide”.
Connection Information |
|
User ID |
The User ID to connect to Rave Alert. |
Password |
The password of the User ID given. |
Connection Timeout |
Number of seconds to wait for completion of an API call to Rave Alert before timing out. |
3. Enter the desired information and click Add.
Creating the Rave Alert connected system in Studio
- Log in to the Workflow and Connectivity Studio and click Connectivity -> Add Systems on the menu bar. The Add Connected Systems window displays.
- Select Rave Alert from the Type drop-down list. The default values display.
3. Enter the required information. Only configurations which are specific to Rave Alert will be documented below. For an overview of the configuration which are common to all connectors, please refer to our link to “connected systems guide”.
Connection Information |
|
User ID |
The User ID to connect to Rave Alert. |
Password |
The password of the User ID given. |
Connection Timeout |
Number of seconds to wait for completion of an API call to Rave Alert before timing out. |
4. Click Apply to add the system.
Using the Connected System for Identity
Perform these procedures to configure the connector:
- Connector Details for Identity
- Identity Password Management
Connector Details for Identity
This table lists values to enter when associating the Identity user with an existing user in the Rave Alert connected system:
Field |
System Attribute |
Example Value |
Account ID |
||
Login ID |
Identity Password Management
See User Management for details on password management.
Using the Connected System for Provisioning
Perform these procedures to configure the connector:
- Configuring for Export
- Configuring for Import
- Connector Details for Provisioning
Note: If the number of records to be processed exceeds one thousand, we recommend configuring the workflow to use bulk mode, which lowers the memory consumption of the system by streaming data to files. Because data is streamed for every task, performance of the workflow execution will be decreased due to increased read-write operations. See the Workflow and Connectivity Studio document for details on how to configure bulk mode.
Configuring for Export
Perform these procedures to configure the connector for data export:
- Configuring the Export Connector
- Configuring the Export Link
From the Workflow and Connectivity Studio, select the Rave Alert UserExport workflow listed under the projects folder. If a workflow does not already exist, create an export workflow. See Workflow and Connectivity Studio for details on creating export workflows.
Configure the Export Connector
- In the Design pane, double-click the export object (the first object after the Start object). The Configure Data Source window displays:
- From the Configure Plug-In tab, set the properties as required:
Associated Connected System |
Select the connected System from the list. The export will be done from this connected system |
Data Formats |
Select the type of data format to use: User (Default), Group or UserList |
DeltaExportMode |
Select the type of attribute to export if a change takes place (this works in conjunction with ExportMode when DeltaExport is selected):
|
DynamicConnectedSystem |
Select the global variable to use as the dynamic connected system name. This works in conjunction with DynamicConnectedSystemOption when GlobalVariable is selected. |
DynamicConnectedSystemOption |
Select how to control Dynamic System Support (DSS):
|
ExecuteGIGAssociatedTaskAsynchronously |
If this property is True, GIG associated tasks will execute asynchronously. |
ExportMode |
Select the type of data to export:
|
Filter |
Specify search criteria to determine the objects to be exported from the Rave Alert Connected System. Either a filter condition or UserByEmail value is mandatory for Rave User export. The default filter given is "userListName Present". Use the Set Filter button that becomes active to create a filter. See the Set Filter section for additional information. |
GroupById |
Option to fetch a group by providing Id. This property is available only for Group data format. |
MaxResults |
Select the maximum number of results that can be returned. |
UserByEmail |
Option to fetch a user by providing Email. This property is available only for User data format. |
UserListById |
Option to fetch a UserList by providing Id. This property is available only for UserList data format. |
Set Filter
Setting the filter is a means to narrow the search scope and return specific results:
Element |
Description |
Attribute |
Select the attribute of the filter. This represents the attribute name for searching the Rave Alert system. |
Comparison |
Select the operator value for this filter. |
AND Condition List |
Creates an AND statement comparing selected conditions. If there is more than one condition in this list box, all conditions must be true. |
Filter Syntax |
Displays the filter syntax used to retrieve entries from the Rave Alert and to build the export list. |
- Using logical AND, generate the complex filter to narrow the search result.
- Click OK when complete to return to the Configure Data Source window.
- (Optional) Select the Attributes Only the standard attributes display:
Modify schema attributes using these buttons:
Add |
Add additional attributes to the list. The Add New attribute dialog displays. Note: Only attributes that are present in the business Object schema can be added. If they are not in the business Object schema they will be disregarded. |
Export |
Export the schema list to an XML file. |
Import |
Imports the schema list from an XML file. |
Reset Schema |
Resets the schema definition to the default schema prepackaged with the IDM Suite. |
4. (Optional) Select the Appearance tab to change how the Connected System object displays in the Design pane.
5. Click OK and save any changes and return to the Workflow and Connectivity Studio.
Configure the Export Link
- In the Design pane, double-click the export link between the export object (the first workflow object after the Start object) and the Data Mapper object. The Configure Link window displays.
Source Attributes |
Select the attribute to export |
Selected Attributes |
Displays default attributes and those attributes that have been selected from the Source Attributes. Note: The check boxes are used only for delta export operations. These checked attributes will always be exported whether they were changed or not. Usually, the attributes that are selected as mandatory attributes help in identifying or verifying an entry when completing mapping functions. |
Advanced Settings |
Displays the Configure Attributes window for configuring advanced settings for attributes. Under the Encrypted column, check the box of any attribute that needs to be encrypted. |
2. From the Attribute Selection tab, select attributes to export.
3. Click Ok to save any changes and return to Workflow and Connectivity Studio
4. Deploy the workflow by selecting Deploy New Deployment. See the Workflow and Connectivity Studio documentation for details of deployment options.
5. Manage and run the deployed workflow from the AdminUI. See the “Identity Suite Administration” documentation for details.
Configuring for Import
Perform these procedures to configure the connector for data import:
- Configure the import Connector
- Configure the Import Link
From the Workflow and Connectivity Studio, select the Rave Alert UserAdd, UserModify, or UserDelete workflow listed under the projects folder. If a workflow does not already exist, create an import workflow. See the “Workflow and Connectivity Studio” documentation for details on creating import workflows.
Configuring the Import Connector
- In the design pane, double-click the import object (the last workflow object). The Configure Data Source window displays:
- From the Configure Plug-In tab, set these properties as required:
Associated Connected System |
Select the connected system from the list. The import operation will be done to this connected system. |
Data Formats |
Select the type of data format to use: User (Default), Group or UserList |
DynamicConnectedSystem |
Select the global variable to use as the dynamic connected system name. This works in conjunction with the DynamicConnectedSystemOption when GlobalVariable is selected. |
DynamicConnectedSystemOption |
Select how to control Dynamic System Support (DSS):
|
Id |
Specify the attribute that contains the value used to uniquely identity the user account ID on the connected system. (ACCOUNT_ID column of the FISC_USER_ACCOUNT table). Rave Alert supports email as account Id. Note: This option is only available for the User data format. |
loginId |
Enter the attribute that contains the value used to uniquely identity the user account login ID on the connected system. (ACCOUNT_USERNAME column of the FISC_USER_ACCOUNT table). Rave Alert supports email as Login Id. Note: This option is only available for the User data format. |
3. (Optional) Select the Attributes tab if attributes schema is to be modified.
4. (Optional) Select the Appearance tab to change how the Connected System object displays in the Design pane.
5. Click OK to save any changes and return to the Workflow and Connectivity Studio window.
Configuring the Import Link
- In the design pane, double-click the import link between the import link between the Data Mapper object and the import object (the last workflow object). The Configure Link window displays:
Source Attributes |
Select the attributes to import. |
Check for attribute-level auditing |
If auditing is enabled and these attributes below are checked, Provisioning will log all events for auditing purposes. |
Select Attributes |
Displays default attributes and those attributes that have been selected from the source Attributes. Note: The default attributes are those that are commonly used to create a new user. |
Advanced Settings |
Displays the Configure Attributes window for configuring advanced settings for attributes. Under the Encrypted column, check the box of any attribute that needs to be encrypted. |
Key Attribute |
Select the attribute to be used as the key attribute for status processing and audit. |
2. From the Attribute Selection tab, select attributes to import.
3. (Optional) Select the Appearance tab to change how the link displays in the Design
4. Click OK to save any changes and return to the Workflow and Connectivity Studio
5. Deploy the workflow by selecting Deploy New Deployment. See the “Workflow and Connectivity Studio” documentation for details of deployment options.
6. Manage and run the deployed workflow from the Admin UI Server tab. See the “Identity Suite Administration” documentation for details.
Configuration Details for Provisioning
Connector Supported Data Formats
The items in the MV (multi-valued), Export and Import columns have these meanings:
- Y = Yes (attribute is supported for this operation)
- N = No (attribute is not supported for this operation)
User Data Format
Name |
Type |
MV |
Export |
Import |
firstName |
String |
N |
Y |
Y |
lastName |
String |
N |
Y |
Y |
String |
N |
Y |
Y |
|
role |
String |
N |
Y |
Y |
sisId |
String |
N |
Y |
Y |
gender |
String |
N |
Y |
Y |
ssoId |
String |
N |
Y |
Y |
languagePreference |
String |
N |
Y |
Y |
alternateEmail1 |
String |
N |
Y |
Y |
alternateEmail2 |
String |
N |
Y |
Y |
mobileNumber1 |
String |
N |
Y |
Y |
mobileCarrier1 |
String |
N |
Y |
Y |
mobile1Confirmed |
Boolean |
N |
Y |
Y |
mobileNumber2 |
String |
N |
Y |
Y |
mobileCarrier2 |
String |
N |
Y |
Y |
mobileNumber3 |
String |
N |
Y |
Y |
mobileCarrier3 |
String |
N |
Y |
Y |
voiceOnlyPhoneNumber1 |
String |
N |
Y |
Y |
voiceOnlyPhoneNumber2 |
String |
N |
Y |
Y |
voiceOnlyPhoneNumber3 |
String |
N |
Y |
Y |
useMobile1ForVoice |
Boolean |
N |
Y |
Y |
useMobile2ForVoice |
Boolean |
N |
Y |
Y |
useMobile3VorVoice |
Boolean |
N |
Y |
Y |
userListId |
String |
Y |
Y |
Y |
password |
String |
N |
N |
Y |
Group Data Format
Name |
Type |
MV |
Export |
Import |
id |
String |
N |
Y |
Y |
name |
String |
N |
Y |
Y |
description |
String |
N |
Y |
Y |
keyword |
String |
N |
Y |
Y |
alertPhone |
Boolean |
N |
Y |
Y |
alertEmail |
Boolean |
N |
Y |
Y |
officialCircle |
Boolean |
N |
Y |
Y |
isPublic |
Boolean |
N |
Y |
Y |
anyoneCanPost |
Boolean |
N |
Y |
Y |
numSubscriptions |
String |
N |
Y |
N |
UserList Data Format
Name |
Type |
MV |
Export |
Import |
id |
String |
N |
Y |
Y |
name |
String |
N |
Y |
Y |
memberId |
String |
Y |
Y |
Y |
Lookup Data
To lookup data from Rave Alert, use the Data Mapper rule Lookup Data.
- Log in to the Workflow and Connectivity Studio and double-click the Data Mapper object on the Design pane. The Configure Data Mapper window displays.
- Select the Lookup Data rule under the Mapping Rule column, and then click the Source Value. The Configure Lookup window displays.
- Select the Rave Alert system from the Select System drop-down list:
4. In the Enter Lookup Prefix field, enter the prefix to be added to the Lookup fields.
5. Select the Lookup Type (User, UserList and Group) from the drop-down list.
6. Select the lookup method By Email (For User Lookup Type), By Id (For UserList or Group Lookup Type)or By Filter.
7. Selecting By Filter, the next field will change to Filter. Click the Build button to bring up the filter dialog. The Filter usage was explained earlier in section Set Filter.
8. Selecting the By Email or By Id changes the next filed to Email or Id. Click Pick button along it to select the Email/Id value as attribute/variable/literal.
9. The next Pick button is used to define the attributes to be exported from the lookup.
10. Select the Exit as Mapper Task Failed on Lookup Failure check box to exit the task with failed status on lookup failure. It will not process the succeeding entries and will ignore the already processed entries and will not return any data. This is selected by default.
11. Click OK.