Use the SKIP keyword to skip rows during an import.
In certain cases, the file you are importing may contain rows that you wish to skip during an import.
For example, the source data file may contain several rows with a Cost Center named Default and you need to skip these rows during the data import. You can use the SKIP keyword to achieve this.
| Account | Currency | Date | Entity | CC | Amount |
| 1000 | USD | 2023 Dec | 120 | 000 | 100 |
| 1000 | USD | 2023 Dec | 120 | 101 | 200 |
| 1000 | USD | 2023 Dec | 120 | Default | 300 |
| 1000 | USD | 2023 Dec | 120 | Default | 500 |
| 1000 | USD | 2023 Dec | 120 | 000 | 9999 |
Skip specific members
To skip a row for a specific source member:
- Create a new Member Map for the dimension.
- Add the member mappings.
- Enter the source name in the Source Value column to skip rows with specific members.
- Use the <SKIP> keyword in the Mapped Value column.
In this example, any rows with Default as the Cost Center in the import file will be skipped as the data is imported from the staging table to the data model in the system.
| Dimension | Mapping Type | Source Value | Mapped Value |
| CostCenter | Exact | 000 | No CostCenter |
| CostCenter | Exact | 101 | 101 |
| CostCenter | Exact | 102 | 102 |
| CostCenter | Exact | 103 | 103 |
| CostCenter | Exact | Default | SKIP |
- Save the changes.
- Refer to this Member Map in the appropriate Dimension Field Settings when configuring the corresponding Data Import Definition.
Skip blank members
To skip a row with a blank member:
- Create a new Member Map for the dimension that may contain blank members.
- Add the member mappings.
- Use the <BLANK> keyword in the Source Value column to skip blank members.
- Use the SKIP keyword in the Mapped Value column.
In this example, any rows with blank Cost Centers in the import file will be skipped as the data is imported from the staging table to the data model in the system.
| Dimension | Mapping Type | Source Value | Mapped Value |
| CostCenter | Exact | 000 | No CostCenter |
| CostCenter | Exact | 101 | 101 |
| CostCenter | Exact | 102 | 102 |
| CostCenter | Exact | 103 | 103 |
| CostCenter | Exact | <BLANK> | SKIP |
- Save the changes.
- Refer to this Member Map in the appropriate Dimension Field Settings when configuring the corresponding Data Import Definition.
View skipped records in the import logs
You can use the filter option in the View Source Details pane of Data Import Logs to view records that were skipped during the import. This may be helpful when troubleshooting as it provides an easy way to view records that were skipped.
To view skipped records in the import logs:
- Navigate to the Logs module.
- Locate the row that corresponds with your data import in the Data Imports tab.
- Right-click the ellipsis in the Details column and select View Source Details.
- Use the dropdown list to select Show Skipped Records to view any records that were skipped during the data import.
Note: The SKIP keyword isn't limited to manual File Import tasks. The keyword can be used in Member Maps that are used in Data Transfer tasks and Automated File Import tasks. These tasks can also be set to use a Data Import Definition that refers to a Member Map.