To add a map definition:
Navigate to Admin tab and select Mapping Configuration from the navigation pane or click Mapping Configuration button.
Click Add.
If you are creating a new map folder, click New Dir. Enter a folder name.
NOTE: If this is your first map definition, it is recommended that you create a new map definition folder. Creating a map definition under the UNMANAGED ITEMS folder will not allow you to edit or delete your map definition.
Ensure that the folder you want to enter your map definition into is selected. (that is, the folder indicates that it is open).
Enter your Map Name.
Click Next.
NOTE: The Map Type field box is disabled.
Select either Local File or Remote File.
Local File: Allows you to browse for your file on your local file system (on the machine where SDM was launched from).
Remote File: Allows you to choose from existing map source data files on the server where DAS is running. Seven files that may already exist on the server (if Advisor is installed and Vulnerability data was uploaded) are Asset, AssetToRegulation.csv, IpToCountry.csv, taxonomy.csv, CustomerToHierarchy.csv, attackNormalization.csv and exploitDetection.csv. Remote file points to %ESEC_HOME%\data\map_data (Windows) or $ESEC_HOME/data/map_data (UNIX)
Select your map definition file. Click Next.
NOTE: For map files that contain more than 500 lines, you will not see all the lines in the SDM.
In the New Map Definition window, set the following:
Delimiter (pipe, comma, semicolon and so on) of data in rows of the map data source file
Start at row The number of rows to skip from the top of the map data source file.
Column names
Column types The currently supported column types are:
String - A string is a group of characters used as a single object by a computer. A string may consist of a single letter, word or number. The word FINANCE or IP Address 192.168.2.40 might be a string. A string can also consist of a combination of words, spaces, and numbers. The street address of 1313 LION DOG TOWER could be a string.
Number Range - A number range (NumberRange) is a range of numbers. For example, 10 to 200 would be represented as 10-200. To use the range map functionality, a map definition must have exactly one key column and the key column must be of type NumberRange. If there are any other key columns, or the key column is of a different type, the mapping service will not consider the map a range map.
Active columns When a column is marked as active, the data in the column will be distributed to processes using maps. All key columns must be active. Only non-key columns that are active can be select as the Map Column under the Events tab.
Key columns - A key is a unique identifier for the row of data in the map data. If more than one column is selected as a key, the overall key of the map will include all of the columns selected as keys.
Column filtering - A row can be explicitly included or excluded based on matching criteria for a particular column. This can be used to exclude rows from the map source data that are not needed or will interfere with your mapping.
As you configure each setting and filter, the data table will automatically update to allow you to preview your data and ensure your data is being parsed as expected.
Once you finish configuring all parameters and filters for the definition, click Finish.
If you chose Local File in step 7 above, you will be prompted to upload your file to the Remote Files virtual folder located: %ESEC_HOME%\data\map_data. Enter a file name and click OK.