Supplemental user data for Profiles

You can supplement user profiles data using a mapping table, the profiles_tdi.properties file, and CSV files.

Mapping user data

You can map additional user data to supplemental tables within the Profiles database and then display that data in a user's profile.

When the LDAP directory provides a code or abbreviation for a particular setting, the supplemental table can provide extra data. For example, an employeeType of P in the LDAP directory might correspond to Permanent. If the employee-type table is populated with data such as p;permanent, this extra data can be displayed in the profile.

The profiles_tdi.properties file stores the settings that determine how the files are formatted.

Note: These properties are supplied in the profiles_tdi.properties file. The file path specified is relative to the TDI solution directory.

This step is mandatory if one or more entities have been selected as the Group By filter in Metrics. Otherwise, when you categorize the Metrics report by this entity, the report will show an unknown value, not the descriptive name of the entity in the chart. Metrics have three default Group By attributes: country, organization and title. The country and organization attributes are in the supported list.

The mapping task for Profiles maps your user data to the following entities:

Fill countries : Add country data to each profile. Use Country code script ./fill_country.sh or fill_country.bat to populate the Country table.

Fill departments : Add department data to each profile. Use Department code script ./fill_department.sh or fill_department.bat.

Fill organization : Add organization data to each profile. Use Organization code script ./fill_organization.sh or fill_organization.bat.

Fill employee types : Add employee-type data to each profile. Use Employee type code script ./fill_emp_type.sh or fill_emp_type.bat

Fill work locations : Add location data to each profile. Use Work location code script ./fill_workloc.sh or fill_workloc.bat.

CSV files

A CSV (comma separated value) file is required as input for each of these tasks.

The following properties pertain to the CVS files used by these tasks:

country_table_csv_separator=;
country_table_csv_file=isocc.csv

department_table_csv_separator=;
department_table_csv_file=deptinfo.csv

emp_type_table_csv_separator=;
emp_type_table_csv_file=emptype.csv

organization_table_csv_separator=;
organization_table_csv_file=orginfo.csv

workloc_table_csv_separator=;
workloc_table_csv_file=workloc.csv

The separator character separates the different tokens in each line. The second property is the name of the file, relative to the solution directory.

The first token is the code. The next attributes are read in order for each additional field. No other fields are required.

The data that can be populated in these tables is usually provided as two values per line: code;description.

For the workloc code, the values can be code;addr1;addr2;city;state;zip. For example: WSF;FIVE TECHNOLOGY PARK DR;;WESTFORD;MA;01886-3141.

Fields that you do not require in your mapping can be omitted from the file; this example uses only one addr field.

The default file name for each codes is shown in the following list:

countryCode : isocc.csv

deptNumber : deptinfo.csv

orgId : orginfo.csv

employeeTypeCode : emptype.csv

workLocationCode : workloc.csv

Sample CSV file

This sample shows some lines from the isocc.csv file, which can be used to fill countries data:

ad;Andorra, Principality of
ae;United Arab Emirates
af;Afghanistan, Islamic State of
ag;Antigua and Barbuda
ai;Anguilla
al;Albania
am;Armenia
an;Netherlands Antilles
ao;Angola
aq;Antarctica
ar;Argentina

You can find more sample CSV files in the wizard_files_directory/TDIPopulation/TDISOL/lin|win/samples directory, where the wizard_files_directory is the location of the various Wizard files that you downloaded or received on disk, and lin|win is the Linux® or Microsoft® Windows® version of the directory.