|
<< Click to Display Table of Contents >> Navigation: Enterprise > Widgets > Enterprise EDP Widgets > EDP EDD Status > Troubleshooting Stuck EDDs |
EDDs can become stuck for several reasons. For more information on the cause, review TaskHistory.Reason in ST_TASK.TASK_INFO.
Following are some errors and troubleshooting suggestions:
Error |
Issue |
Resolution |
|---|---|---|
No error is thrown. |
A long wait time or disruption in the workflow can cause the connection to break and an EDD to become stuck. |
Delete the stuck date or re-upload the EDD. |
(Enterprise): •EDD Process Agent alert - Configuration Error Error occurred while loading data: [EDD NAME].zip System.IO.DirectoryNotFoundException: Could not find a part of the path 'D:\local\Temp\....'
•The EDD file [EDD Name].zip has been rejected because of errors found in the data. Please review the attached error report and make the necessary corrections before resubmitting the EDD.
(Professional): “An error has occurred in EarthSoft.EDP, Version=7.0.0.0, Culture=neutral, PublicKeyToken=7b3b91006de2d53d:
Could not find a part of the path '[FILE PATH]\[EDD NAME].xls'. at EarthSoft.EDP.IO.ZipFile.LoadFile(String filename, EddFormatDefinition efd) |
The EDD is nested in a subfolder within the zip folder, or the files/worksheets may be named incorrectly. |
Ensure the following for the zip folder being loaded into EDP: •It only contains data files and does not contain any subfolders •All *.txt files or Excel worksheets (depending on the file type of the EDD) are named accurately to match the corresponding sections of the EDD (e.g., if "LabSample_v1" is expected, an error will be thrown if tab or filename is "LabSample") |
(Enterprise): EDD Process Agent alert - Configuration Error
Error occurred while loading data: [EDD NAME].zip System.NullReferenceException: Object reference not set to an instance of an object. at EarthSoft.EDP.IO.ZipFile.LoadFile(Stream fileStream, EddFormatDefinition efd)...
(Professional): An error has occurred in EarthSoft.Common, Version=7.0.0.0, Culture=neutral, PublicKeyToken=7b3b91006de2d53d:
Object reference not set to an instance of an object. at EarthSoft.EDP.Forms.EddProcessor.ReadFormatFileEnd(String filename, String type) |
The format is nested in a subfolder within the zip folder. |
Ensure the format is not nested within the zip folder. |
(Enterprise): EDD Process Agent alert - Configuration Error
Unable to initialize EddFormatDefinition: [EDD NAME].zip System.Exception: Unable to read format file ([FILE PATH]\[FORMAT NAME].dll): Type 'http://tempuri.org/EQEDD:yes_no_values' is not declared. |
See the "Cause/Details" section of Error Opening Format (Unable to Read Format File, tempuri.org). |
(Enterprise): See the "Best Practices for the Temp Folder" section of EarthSoft.Common.Utilities.File.zipTempFolder.
(Professional): See "Resolution/Workaround" steps in Error Opening Format (Unable to Read Format File, tempuri.org). |
(Enterprise): EDD Process Agent alert - Configuration Error
Unable to initialize EddFormatDefinition: [EDD NAME].zip System.Exception: Unable to read format file ([FILE PATH]\[FORMAT NAME].xse): Object reference not set to an instance of an object. |
EDP is unable to read the format files, or some of the required format files are missing. |
In some cases, this issue can be resolved by loading the format onto the server rather than storing the format in DT_FILE. In others, the site's workflow needs to be restarted to ensure that all necessary format files are loaded to the temporary format folder on the server and can be accessed by EDP. |
(Enterprise): EDD Process Agent alert - Configuration Error
Error occurred while loading data: [EDD NAME].zip System.Xml.XmlException: Unexpected xml tag. at EarthSoft.EDP.IO.ZipFile.LoadFile(Stream fileStream, EddFormatDefinition efd) |
If using a third-party application to create or edit EDDs (such as Visual Basic or Excel), the method in which the EDD is saved may cause this error. |
Re-save the EDD as one of the alternate valid file types and attempt to re-load the data. |
(Enterprise via EDGE EDD): Error occurred while creating package: [FILE NAME] System.Exception: Transaction connection was lost, unable to continue committing rows. at EarthSoft.EDP.EddPackage.Commit(UpdateModes mode) at EarthSoft.Workflow.Clients.Default.DefaultFileProcess.PackageCommit(EddPackage pkg, EddConfig eddConfig) at EarthSoft.Workflow.Clients.Default.DefaultFileProcess.PerformAction(ReservedTaskInfo taskInfo, TaskReservationMonitor taskReservationMonitor) |
The user who pushed an EDGE EDD (which makes use of the EDGE format's automatic file organization feature) was not assigned an Admin role in Enterprise. |
To solve this issue, either: •assign the user an Admin role •have a user who is already assigned an Admin role download the EDD (e.g., via the EDP EDD Upload widget) and re-commit the data |
(Enterprise): EDD Process Agent alert - Configuration Error Unable to initialize EddFormatDefinition: {EDDName}.zip System.ArgumentException: Illegal characters in path. at System.IO.LongPathHelper.Normalize(String path, UInt32 maxPathLength, Boolean checkInvalidCharacters, Boolean expandShortPaths) at System.IO.Path.NormalizePath(String path, Boolean fullCheck, Int32 maxPathLength, Boolean expandShortPaths) at System.IO.Path.GetFullPathInternal(String path) at System.IO.FileInfo.Init(String fileName, Boolean checkHost) at EarthSoft.Workflow.Management.File.FileManagementConfigSettings.GetFormatConfigurations(Connection connection, List`1 configItems) at EarthSoft.Workflow.Management.File.FileManagementConfigSettings.getFileManagementConfig(Connection connection) at EarthSoft.Workflow.Clients.Default.DefaultFileProcess.PerformAction(ReservedTaskInfo taskInfo, TaskReservationMonitor taskReservationMonitor) |
An illegal character may exist in the ST_CONFIG.STRING_VALUE for the record where OBJECT_VALUE=’xsdFileName’. |
Rename the file path for the format to confirm there is not an illegal character. Check for spaces or hard-returns. |
(Enterprise): EDD Process Agent alert - Configuration Error Error occurred while creating package: {EDDName}.zip System.Exception: Unknown commit type 'merge' at EarthSoft.Workflow.Clients.Default.DefaultFileProcess.PackageCommit(EddPackage pkg, EddConfig eddConfig) at EarthSoft.Workflow.Clients.Default.DefaultFileProcess.PerformAction(ReservedTaskInfo taskInfo, TaskReservationMonitor taskReservationMonitor) |
The capitalization may not be correct in ST_CONFIG.STRING_VALUE for the commit type. |
ST_CONFIG.STRING_VALUE for the commit type record is case sensitive. For example, 'Merge' must be used for Insert and Merge, not 'merge' or 'MERGE'. |
(Enterprise): EDD Process Agent alert - Configuration Error Unable to initialize EddFormatDefinition: [EDD NAME].zip System.Exception: Unable to read format file (EDD NAME.dll): Exception has been thrown by the target of an invocation. System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. System.Exception: The file DotSpatial.Projections.dll may not be found, and therefor, the coordinate conversion will not work. |
EDP is unable to find the DotSpatial.Projections.dll file in the Enterprise bin folder location. |
Copy over the DotSpatial.Projections.dll file, obtained from a matching Professional installation build, into the Enterprise bin folder. |
Copyright © 2026 EarthSoft, Inc. • Modified: 27 Apr 2026