With an outbound mode Code-Free Flat File Connector, EmpowerID can export data as file dumps. External systems can then process the exported files with any custom logic. This connector can identify and export Person & Account attribute changes in the EmpowerID system. You can additionally configure flags to determine if a record was modified, deleted, or added in EmpowerID. External systems can then import these file dumps with their processing logic. Follow the steps below to configure an account store for outbound flat file connectors,.
Steps to Configure an Outbound Flat File Connector
| Note |
|---|
It would be best to Create Data Model Mapping File for the connector before following this doc. The Data Model mapping file maps the EmpowerID object attributes to the columns of the delimited file. Simply, it specifies what data to export from EmpowerID to which column of the flat file. This document focuses specifically on creating an outbound flat file connector. For a more generic document that describes both inbound and outbound connectors, refer to the document linked here. |
| Info | ||||||
|---|---|---|---|---|---|---|
Creating a Code-Free Flat File Connector account store will create a corresponding SetGroup or Query Based Collection. The naming convention for the set group is adding _SetGroup to the end of the identifier of Account Store. e.g., If you create an account store named HROutboundFileConnector, the corresponding setgroup will be called HROutboundFileConnector_SetGroup. Click on Query Based Collections to learn more about it. The following things will be done in the SetGroup to configure the connector.
|
| Tip |
|---|
Suppose the Outbound Flat File Connector is already created, and there is a requirement to add additional columns or fields to export in the flat files. In that case, you will have to create a new Securityboundaryattribute. Please find more instructions in the section Add Additional Fields to Existing Connector. |
Navigate to Admin → Application and Directories → Account Stores and Systems.
Click on Create Universal Flat File Connector Account Store. You will see the Create page for the Flat File Account store.
Enter basic details for the resource system and Click on Submit.
Sync Direction- Choose the Outbound Synchronization mode of the data
Name- Provide an Identifier for the account store.
Display Name- Please provide a descriptive & friendly name for the account store. The value provided for the display name appears in the UI.
After submitting the basic details, you can enter the configuration setting for the resource system.
Number of Export Files:Specify the number of files the inventory job creates while exporting data from EmpowerID. Consider creating multiple files if you have huge amounts of data to export.
Data Model Mapping File Path: Provide the full path pointing to the Data Model Mapping File. For SaaS implementation, the path is a local path in the Cloud Gateway Server or a network path accessible from the Cloud Gateway server. The Data Model mapping file maps the EmpowerID object attributes to the columns of the delimited file. Simply, it specifies what data to export from EmpowerID to which column of the flat file.
Is Remote (Requires Cloud Gateway): Please select the checkboxIf your EID instance is a SaaS tenant.
Choosing Select if Full File Export is Requiredcheckbox will export all identity data into flat files. Additional fields for settings will appear,
Delimiter For Full Export File: Specify the single-character delimiter for export files—E.g., ""comma for a CSV file.
Processing Action Column Name For Full File: Provide the column's Name in export files that flag the nature of change in the row. This column in the flat file will consist of the value specified subsequently in action for full export.
Action For Full Export: Value to set for the action for the full export file.
Full Export File Time Stamp: This field contains the timestamp naming convention for the full export file. Providing a value will add a timestamp to the end of the filename of exported flat files. When exporting a file named "data.csv" on September 21, 2023, using the "DDMMYYYY" setting, it would be saved as "data_21092023.csv" to indicate the date of export.
Select if Delta File Export is Requiredis for differential export that only dumps records with attribute changes since the last export was successful. Please configure the following settings for the delta files export.
Delimiter For Delta Export File: Specify the delimiter for export files. Use single character value for, e.g., ',' '|.'
Processing Action Column Name For Delta File:Provide the column's Name to include in export files that will record the flag indicating the nature of change in the row. The given column will have values specified on subsequent input fields for add, update, and delete.
Action For Differential Export Add: Provide a single character value to flag a record as added. This value is set in the processing action column If a record is added to EID after the last export.
Action For Differential Export Update:Specify the single character that will identify a row as updated. This value is set in the processing action column of the exported file if the record was modified after the last export.
Action For Differential Export Delete:Specify the single character to set in the processing action column if a record was deleted in EID after the last export.
Delta Export File Time Stamp: This field contains the timestamp naming convention for the delta export file. All files exported will append a timestamp with the provided naming convention. When exporting a file named "data.csv" on September 21, 2023, using the "DDMMYYYY" setting, it would be saved as "data_21092023.csv" to indicate the date of export.
Click on Submit to save the resource system settings.
If you have selected Is Remote in the previous screen of Resource System settings, a list will appear to choose the Cloud Gateway Servers configured for your SaaS tenant. Select the gateway servers and click on submit.
After successfully creating the resource system, you will see a message Request complete!
Upon flat file connector creation, if the direction is selected as "outbound," the system will automatically create a System Job for the export. The prefix of the created Job will be Outbound-full for a full export and Outbound-differential for a delta export based upon the option selected in step #4. If both options for full and delta are selected, two jobs will be created, one for full and another for delta. If you want to create additional jobs manually, please follow the steps in the section below Create Outbound Job to create the Job.
Creating a Code-Free Flat File Connector account store will create a corresponding SetGroup or Query-Based Collection. Please make sure to follow the necessary actions to be done on the set group, as mentioned here in the section Important Information About SetGroups.
You will have to restart IIS & the service pools of EmpowerID so that the account store can obtain the configuration information.
To restart the EmpowerID in a cloud instance, you can do the following.
Navigate to IT Shop-> Workflows
Click on Recycle Service Environment
If you have EmpowerID deployed On-premise, we will have to follow the standard Windows procedure to restart the service and IIS.
Execute the command iisreset from the command prompt to restart your IIS.
Open Services. Click Start, click Run, and then type services.msc.
Right Click on the following services and click on Restart service
EmpowerID Web Role Service
EmpowerID Worker Role Service
| Anchor | ||||
|---|---|---|---|---|
|
Suppose the Outbound Flat File Connector is created already, and there is a requirement to add additional columns or fields to export in the flat files. In that case, you will have to create a new Securityboundaryattribute. Please follow the steps below to configure additional fields to an existing connector,
...
Navigate to Admin → Applications and Directories → Manage Schema
Click on the Security Boundary Attributes tab and Click on ➕ Icon to add a new attribute. Please provide the necessary values and press Save.
Name: Identifier for the Security Boundary Attribute. The Name of the security boundary is the column header in the exported files.
Attribute Type: Data Type of the attribute.
Max Length: The length of the attribute.
SecurityBoundryType: Select the Outbound Flat File Connector you want to create the Security Boundary Attribute.
ObjectAttribute: Select the person object attribute to export.
Create Outbound Job
...
Upon flat file connector creation, if the direction is selected as "outbound," the system will automatically create a System Job for the export. Only follow the steps below if you want to create additional jobs manually.
...