Applies to: IT Planning & IT Financial Management Foundation
You may encounter some of the following errors when uploading data into ITP or ITFMF. Please refer to the following tables to identify the error you are experiencing.
"The upload process will modify one or more of the uploaded rows during import into the application"Row Modifications errors occur when non-required values in your imported data are inconsistent with the application's templates or Reference Data. ITP and ITFMF will automatically modify data when these errors occur to ensure an otherwise successful import. In most situations, invalid data is modified or removed from the import, while remaining data is imported.
Symptom
What's going on
Solution
The listed columns are not imported to ITP, but other valid columns are imported normally.
Uploaded files must follow ITP's template and column placement. Columns that are not part of ITP's templates are not recognized and will not be uploaded.
The error message should list all instances of omitted columns.
Ensure you are importing data using the associated ITP template.
The listed values are not uploaded into ITP, which may leave gaps in your dataset.
ITP has identified data that is incorrectly formatted. As explained in the previous entry, ITP uses templates for data imports. Each template column requires a specific type of data (i.e. text, numerical, etc.). Failure to match the correct value type for a column is the most common cause of this error.
The error message should list all instances of improperly formatted data.
Investigate your data and confirm that all column data is correctly formatted for its respective column.
The data listed in the error is not imported to ITP because it cannot be correlated to existing Reference Data.
Imported data must correlate with your Reference Data, which acts as a key to link Departments, Accounts, and IDs. The non-required data you are importing cannot be found in your Reference Data.
The error message should list all instances of data that cannot be correlated to Reference Data.
Verify that all values in your imported file correlates to your published Reference Data. If not, update your Reference Data.
Select Update Reference Data only for the budgets you wish to apply changes to.
In Reference Data, you can create custom lists and dimensions.Once established, these custom elements act in the same way as all other Reference Data.
This error is functionally the same as the previous error, "Could not resolve one or more references to another table:", but specific to custom lists and dimensions.
First encountered column of duplicates will be used: <Column1>. Duplicate column will be omitted: <Column2>
<Column1> is imported while <Column2> is not imported to ITP.
ITP has detected multiple column names matching the name of a template column.
In the example image, there are two columns identified called "Cost Center Code" and "Cost Center." Both columns include the required column name "Cost Center."
ITP will default to the first column that matches in order from left to right when reading the .CSV file. Any additional column matches will not be imported.
If you wish to use one name over the other, switch the order the columns so your preferred name will be read first (in order from left to right).
"Rows will be omitted due to the following missing or unrecognizable keys"
Row Omissions errors occur when required values in your imported data are inconsistent with ITP and ITFMF templates or Reference Data. These errors are significant and may cause your data import to fail entirely. It is important to resolve these errors when they appear.
Departments and Projects can be associated with specific Cost Centers. If so, only those Cost Centers are considered valid.
Your imported data is associating Cost Centers with Departments that are not explicitly permitted in your current settings.
For Departments
For Projects without Investment Planning
For Projects with Investment Planning:
NOTE: For Projects, you can enable the Allow Any Cost Center option to disable the mapping restriction. This option is available in Project Reference Data or Project Listing, depending on whether you have Investment Planning.
Imported data must correlate with your Reference Data, which acts as a key to link Departments, Accounts, and IDs. The required data you are importing cannot be found in your Reference Data.
Delegated costs occur when a project has ended and its upkeep costs have moved to a different Department. Delegated costs will still appear in their original Department as greyed out, read-only rows.
Delegated costs data must be updated where the cost has been delegated.
Identify where the cost has been delegated. You must update these costs in their delegated location, not their source location.
For more information, see Delegate project costs.
Other types of errors that can occur in ITP and ITFMF
because one or more reference tables are using values that are no longer present in the version you want to publish
Publishing ErrorReference Data that previously existed in ITP or ITFMF is now missing. Because elements of your report depend on that Reference Data, a major error is produced and the publish operation fails.
CT to ITP Integration Error
This issue may be caused by:
Navigate to IT Planning, click the Settings Menu, then click Cost Transparency Integration. Verify the following:
Navigate to Cost Transparency and verify the following:
IT Planning is pulling data from the current month in Cost Transparency. The month must be open in CT; otherwise the integration cannot find any data.
NOTE: For additional information, please see:
Troubleshoot: unable to import or export Excel files
Looking for more? Check the IT Planning and Financial Management KB. Still can't find an answer? Post your question to the Apptio Community.
This topic is open for your feedback. At the bottom of this screen click Add a comment.
Great Info!
This is really helpful. Once in a while coming back to this and find a minor error I have made.