Troubleshooting Access History Task Failures

If the Access History feature is not enabled, the task completes but the Task Result has a status of Warning and a banner states, "The Access History feature must be enabled in order to support history events."

If the Extract YAML Config is missing the transform configuration name, the status indicates Fail and a banner states, "No transformation configuration name was found in the Export YAMLConfig."

If the Extract YAMLConfig has a bad value for the transform configuration name, or references one that does not exist, the status indicates Fail and a banner states, "Unable to find YAMLConfig AccessHistoryImageConfig2."

If the Extract YAMLConfig is missing a value for extracted objects, the status indicates Warning and a banner states, "The selected Export YAMLConfig is missing entry for exportedObjects."

If the Transform YAMLConfig has a bad value in the extracted objects list, the status indicates Warning and a banner states, "The Transform YAMLConfig is missing imageConfigDescriptor for exportedObject [object]." Note that other extracted objects with valid values will still be processed.

If the Transform YAMLConfig is missing an entry for one of the extracted objects, the status indicates Warning and a banner states, "The Transform YAMLConfig is missing ImageConfigDescriptor for importedObject Certification."

If the reading or processing of InterceptedDelete objects fails for any reason, the status indicates Warning and a banner states, “The row in the spt_intercepted_delete table remains in the database and will be retried during the next run. There is no limit to the number of attempts made for processing an InterceptedDelete row.”

If the Data Extract Processor for the xxxx partition encounters any failures while extracting or publishing objects, the status indicates Warning and a banner states, “The list of failed objects is written to the task's NamedTimestamp object.”

If the number of newly failed objects exceeds the defined thresholds (maxFailuresAbsolute or maxFailuresPercent), the status indicates Warning and a banner states, “The task will fail with an error, and the NamedTimestamp will not be updated (neither the date nor the list of failures).”

If the number of newly failed objects is below the threshold, the task will complete successfully. The status indicates Warning and a banner states, “The NamedTimestamp will be updated with both the date and the list of failed objects.”

Note: During the Extract Partition Creation execution, the list of failed objects (if any) are read from the NamedTimestamp object and are scheduled to be processed by the Data Extract Processors requests, along with any newly changed objects found in IIQ database. However, the number of re-attempts of a failed object is limited by the task argument maxObjectAttempts. When an object is attempted to be processed more than maxObjectAttempts time, it is discarded from the failure list in NamedTimestamp.