Troubleshooting Import Agent and Email Archive

Import Agent reports error messages to the Microsoft Windows Event Viewer. The following are the most commonly reported errors. See system administration level errors.

Permission denied

This error can occur when the Laserfiche account associated with a profile does not have sufficient Laserfiche rights to perform the actions in question. For example:

  • If the Laserfiche folder where files will be imported does not exist, the user must have rights to create it.
  • If you have configured Import Agent to insert or replace content when a duplicate document is found, the user must have rights to do so.
  • The user must have rights to create documents in the destination folder.
  • The user must have rights to the specified volume.
  • If you have configured Import Agent to assign metadata (e.g., templates, fields, tags), the account must have rights to do so.

Resolution

Do one of the following:

  • Change the Laserfiche account associated with a profile. Ensure the new Laserfiche account has sufficient rights.
  • Grant additional permissions to the current Laserfiche account. Learn more about granting rights to users.

Username or Password is Incorrect (9010)

You may encounter this error with Import Agent if the account the Import Agent Service is running as has an incorrect username or password, or if the Import Agent Service account does not have access to the correct Windows directories.

Could not update template data

This error can occur when the entire field value defined in the profile cannot be assigned to a field. In most cases this occurs when a value is not valid for a particular field. The file will not be imported and it will be moved to the pre-defined folder.

Resolution

Change the field value defined in the profile and move the files back to the monitored directory.

Out of present range

This error occurs when the value assigned to an integer or long integer field exceeds a valid value for an integer or long integer. The file will not be imported and it will be moved to the pre-defined folder.

Resolution

In the profile, lower the number assigned to the field and move the files back to the monitored directory.

The value of the (profile) count token is invalid

This error occurs when the value of the Session Count token or the Profile Count token exceeds a valid value for an integer or long integer. The file will not be imported and it will be moved to the pre-defined folder. The full error message is: The value of the (profile) count token is invalid.

Resolution

Lower the number assigned to the token and move the files back to the monitored directory.

One or more field values have been shortened to comply with the width of the corresponding field

This error occurs when a field value is larger than the field width. The file will still be imported, but the offending field value will be truncated. This event will be logged in the Microsoft Windows Event Viewer. The full error message is: One or more field values have been shortened to comply with the width of the corresponding field.

Resolution

To prevent this issue from happening, shorten the default field value in the profile or increase the field width in the Laserfiche Administration Console.

Access to the path [path] is denied

This error occurs when the Laserfiche Import Agent service does not have sufficient rights to the monitored directory. The path specified in the error message lists the specific folder.

Exception from HRESULT: 0x80040BC3

This error occurs when trying to import an unsupported file type as an image file or an extremely large image file. The file will not be imported and it will be moved to the pre-defined folder.

Resolution

Manually import the desired file as an electronic file.

Error Executing the Profile

This error occurs when a token is used to populate a field and the token value exceeds the field's width. The error only applies when the field is assigned independent of a template. The file will not be imported and it will be moved to the pre-defined folder. The full error message is: There was an error executing the profile [profile name] while importing the file ["filename"]. (Object reference not set to an instance of an object.)

Resolution 

To prevent this issue from happening, increase the field width in the Laserfiche Administration Console, or populate it using a different value.

Unprocessed Files

In some situations, files will not be imported into Laserfiche or moved from the monitored directory. These situations include:

  • Files are hidden and/or locked.
  • If the profile's post-processing action is set to delete the source files, read-only files will be ignored. If the post-processing action is set to move the source files, read-only files will be imported.
  • The Laserfiche Import Agent service does not recognize the monitored directory as valid.
  • The Windows account associated with the Laserfiche Import Agent service does not have sufficient rights to a Windows folder and/or to sign in to a Laserfiche repository.

Resolution

If Import Agent is failing to import a desired file, perform the following steps as necessary:

  • Verify that the files in the monitored directory are not hidden and/or locked.
  • If the profile's post-processing action is set to delete the source files, either ensure the files are not read-only, or change the post-processing action.
  • Check the values used to define the monitored directory. Ensure the path to all Windows folders on a network drive do not use a mapped drive. If they do, reconfigure the profile to use a UNC path.
  • Check the permissions for the Windows account assigned to the Laserfiche Import Agent service. Learn more.
  • If you have configured a profile to log on to a Laserfiche repository using Windows authentication, ensure the account associated with the Laserfiche Import Agent service can sign into the repository.

Troubleshooting List Files

If a LST, XML, or LSTX file is not imported correctly, consider the following issues:

  • Import Agent has not been properly configured.
  • A referenced file cannot be found. Verify that all related files are present.
  • The list file contains invalid syntax. Open the list file in an editor and search for errors. Use full or relative paths whenever referencing a file on the current machine. Use a UNC to specify a folder on a network drive (e.g., \\ComputerName\ShareName\Path).

Tip: Sample LST and XML list files can be found in the Import Agent install directory. E.g., C:\Program Files\Laserfiche\Import Agent\List File Examples