We have run across a few situations in Dynamics AX 2012 where the workflow batch job fails with the error "Failed to find workflow" message. When the customer received this error it prevented the remaining workflow messages in the queue from being processed. In order to process all of the items that were queued up we needed to complete the following steps:
1. Identify the record(s) that are causing the batch to fail.
Select a.RECID from SYSWORKFLOWMESSAGETABLE a Where a.ROOTCORRELATIONID notin(Select b.ROOTCORRELATIONID fromSYSWORKFLOWTABLE b)and a.MESSAGELIFECYCLESTATE = 1
2. Dequeue the SYSWORKFLOWMESSAGETABLE records that do not have a corresponding SYSWORKFLOWMESSAGETABLE record.
Update SYSWORKFLOWMESSAGETABLE Set MESSAGELIFECYCLESTATE = 2 where RECID =<RECID returned from statement above>
The procedures above will dequeue the message causing the error and allow the batch to complete.
Note: As always, ensure you do a proper backup of your existing SYSWORKFLOWMESSAGETABLE prior to attempting this fix.
SysWorkflowMessageTable Table [AX 2012]
The SysWorkflowMessageTable table contains the workflow messages between Microsoft Dynamics AX and Microsoft Workflow Runtime. A message is connected to a workflow instance. The sender stores the message in the table and the receiver does the work requested by the message and removes the message. Messages are stored until the related workflow instance completes or is cancelled.
Methods
| Method | Description | |
|---|---|---|
 | aosValidateDelete | Validates on the server that the specified record can be deleted from a table. (Inherited from xRecord.) |
| aosValidateInsert | Validates on the server that the specified record can be inserted. (Inherited from xRecord.) |
| aosValidateRead | Validates on the server that the specified record can be read. (Inherited from xRecord.) |
| aosValidateUpdate | Validates on the server that the specified record can be updated. (Inherited from xRecord.) |
| buf2con | Packs the table buffers of an xRecord instance into an X++ container. (Inherited from xRecord.) |
| cancelTimeOut | Cancels a previous method call to the setTimeOut method. (Inherited from Object.) |
| canSubmitToWorkflow | Indicates whether submission to workflow is possible. (Inherited from xRecord.) |
| caption | Gets and sets the caption property of a table. (Inherited from xRecord.) |
| checkInvalidFieldAccess | Gets and sets invalid field access. (Inherited from xRecord.) |
| checkRecord | Gets and sets the property that indicates whether to check mandatory fields. (Inherited from xRecord.) |
| checkRestrictedDeleteActions | Gets and sets the property that indicates whether a record can be deleted. (Inherited from xRecord.) |
| clear | Removes all rows from the table buffer. (Inherited from xRecord.) |
| company | Gets and sets the property that indicates a legal entity for the record. (Inherited from xRecord.) |
| con2buf | Unpacks a container into the table buffers. (Inherited from xRecord.) |
| concurrencyModel | Gets and sets the default concurrency model to use to update records. (Inherited from xRecord.) |
| context | Gets and sets the context property. (Inherited from xRecord.) |
| data | Retrieves a row from the table. (Inherited from xRecord.) |
| dataSource | Retrieves the data source of the table. (Inherited from xRecord.) |
| defaultField | Populates default values in a field in the table. (Inherited from xRecord.) |
| defaultRow | Populates default values in fields in the table in the non-interactive case. (Inherited from xRecord.) |
| delete | Deletes the current record from the table. (Inherited from xRecord.) |
| disableCache | Gets and sets the property that indicates whether caching is disabled. (Inherited from xRecord.) |
| dispose | Releases resources that are used by the xRecord object. (Inherited from xRecord.) |
| doClear | Removes all rows from the table buffer and bypasses any additional logic in the clear method of the table. (Inherited from xRecord.) |
| doDelete | Deletes the current record from the table and bypasses any additional logic in the delete method of the table. (Inherited from xRecord.) |
| doInsert | Inserts the record into the table and bypasses any additional logic in the insert method of the table. (Inherited from xRecord.) |
| doUpdate | Updates the current record and bypasses any additional logic in the update method of the table. (Inherited from xRecord.) |
| doValidateDelete | Performs the action to validate that a record can be deleted. (Inherited from xRecord.) |
| equal | Determines whether the specified object is equal to the current one. (Inherited from xRecord.) |
| fieldAccessRight | Returns the field access right. (Inherited from xRecord.) |
| fieldBufferAccessRight | Returns the field access right for the current record. (Inherited from xRecord.) |
| fieldState | Sets or returns the state of a field in the table buffer. (Inherited from xRecord.) |
| getAllowRedefault | Returns the list of fields that are allowed to re-default. (Inherited from xRecord.) |
| getDefaultingDependencies | Returns the container that holds defaulting dependencies. (Inherited from xRecord.) |
| getExtension | Returns the table extension. (Inherited from xRecord.) |
| getFieldValue | Gets the value of the specified field from a table buffer. (Inherited from xRecord.) |
| getInstanceRelationType | Returns the table name that corresponds to the InstanceRelationType ID. (Inherited from xRecord.) |
| getPhysicalTableName | Return the physical table name, which, in the case of the SQL Temp DB table, is the table instance name. (Inherited from xRecord.) |
| getPresenceFieldData | Retrieves the PresenceInfo value from the specified field. (Inherited from xRecord.) |
| getSQLStatement | Gets the SQL statement that is used to return records from the database. (Inherited from xRecord.) |
| getTableInInstanceHierarchy | (Inherited from xRecord.) |
| getTableType | Indicates the type of the table. (Inherited from xRecord.) |
| getTimeOutTimerHandle | Returns the timer handle for the object. (Inherited from Object.) |
| handle | Retrieves the handle of the class of the object. (Inherited from Object.) |
| hasRelatedTable | Indicates whether a foreign key constraint buffer is linked with the table. (Inherited from xRecord.) |
| helpField | Retrieves a string that contains the Help text for the specified field. (Inherited from xRecord.) |
| initValue | Initializes a field to the default value. (Inherited from xRecord.) |
| inputStatus | Sets or returns the current input status of the table buffer. (Inherited from xRecord.) |
| insert | Inserts the record into the table. (Inherited from xRecord.) |
| interactiveContext | Sets or returns the current interactive context of the table buffer. (Inherited from xRecord.) |
| isFieldDataRetrieved | Checks whether the data of the given field has been retrieved. (Inherited from xRecord.) |
| isFieldSet | Checks whether a field has a Set or Defaulted state. (Inherited from xRecord.) |
| isFormDataSource | Indicates whether the data source is a form. (Inherited from xRecord.) |
| isNewRecord | Returns true if the record is a new record that hasn't been persisted yet. (Inherited from xRecord.) |
| isPartOfUOWSaveChanges | (Inherited from xRecord.) |
| isTempDb | Indicates whether the type of the table is SQL TempDB. (Inherited from xRecord.) |
| isTmp | Indicates whether this is a temporary table. (Inherited from xRecord.) |
| joinChild | Finds the join child of the current record. (Inherited from xRecord.) |
| joinParent | Finds the join parent of the current record. (Inherited from xRecord.) |
| linkPhysicalTableInstance | Checks whether there is a link for the physical table instance for the record. (Inherited from xRecord.) |
| merge | Merges the current table with the specified table. (Inherited from xRecord.) |
| modifiedField | Modifies the specified field to the original. (Inherited from xRecord.) |
| modifiedFieldValue | Modifies the specified field to the original value. (Inherited from xRecord.) |
| new | Initializes a new instance of the Object class. (Inherited from Object.) |
| notify | Releases the hold on an object that has called the wait method on this object. (Inherited from Object.) |
| notifyAll | Releases a lock on the object that was issued by the wait method on this object. (Inherited from Object.) |
| objectOnServer | Determines whether the object is on a server. (Inherited from Object.) |
| orig | Retrieves the original values of the current record. (Inherited from xRecord.) |
| overwriteSystemfields | Gets and sets the property that indicates whether system fields can be overwritten. (Inherited from xRecord.) |
| owner | Returns the instance that owns the object. (Inherited from Object.) |
| postCacheLoad | Is executed after data is hit from the cache for the select operation on the table. (Inherited from xRecord.) |
| postLoad | Is executed after a record is read. (Inherited from xRecord.) |
| preRemoting | Is executed before a cross-tier call is about to be executed for the table that would pack its state to the other tier. (Inherited from xRecord.) |
| queryTimedOut | Indicates whether the query exceeded the time limit for execution. (Inherited from xRecord.) |
| queryTimeout | Gets and sets the property that indicates the time limit for the execution of a query. (Inherited from xRecord.) |
| readCommittedLock | (Inherited from xRecord.) |
| readPast | Gets and sets the property that indicates whether to skip rows that are locked by other processes when a record is read. (Inherited from xRecord.) |
| recordLevelSecurity | Gets and sets the property that indicates whether to apply security on a record level. (Inherited from xRecord.) |
| relatedTable | Sets or returns the related buffer of a link of a table buffer. (Inherited from xRecord.) |
| renamePrimaryKey | Renames the foreign keys in other tables according to the change of the corresponding primary key value in this table. (Inherited from xRecord.) |
| reread | Rereads the record from the table. (Inherited from xRecord.) |
| RowCount | Retrieves the number of rows in the table. (Inherited from xRecord.) |
| selectForUpdate | Gets and sets the property that indicates whether to select records for update when they are read. (Inherited from xRecord.) |
| selectLocked | Indicates whether to select locked records. (Inherited from xRecord.) |
| selectRefRecord | Selects the record by referenced field ID. (Inherited from xRecord.) |
| selectWithRepeatableRead | Gets and sets the property that indicates whether repeatable read is enabled. (Inherited from xRecord.) |
| setConnection | Sets the user connection for this table. (Inherited from xRecord.) |
| setCrossPartition | Sets or resets cross-partitioning for the table. (Inherited from xRecord.) |
| setFieldValue | Sets the field value in the record buffer. (Inherited from xRecord.) |
| setSQLTracing | Enables or disables SQL tracing mode. (Inherited from xRecord.) |
| setTimeOut | Sets up the scheduled execution of a specified method. (Inherited from Object.) |
| setTmp | Sets the table so that it is not persisted to the database. (Inherited from xRecord.) |
| setTmpData | Sets the contents of the temporary table to the specified data. (Inherited from xRecord.) |
| setXDSContext | Sets new XDS context. (Inherited from xRecord.) |
| skipAosValidation | Gets and sets the property that indicates whether to skip validation of Microsoft Dynamics AX Application Object Server (AOS). (Inherited from xRecord.) |
| skipDatabaseLog | Gets and sets the property that indicates whether to skip database log requests. (Inherited from xRecord.) |
| skipDataMethods | Gets and sets the property that indicates whether to discard overloaded methods. (Inherited from xRecord.) |
| skipDeleteActions | Gets and sets the property that indicates whether to skip delete actions on the table. (Inherited from xRecord.) |
| skipDeleteMethod | Gets and sets the property that indicates whether to discard overloaded methods. (Inherited from xRecord.) |
| skipEvents | Provides an option to turn off calling the Application.event* methods for the lifetime of an xRecordobject. (Inherited from xRecord.) |
| skipPostLoad | Gets and sets the property that indicates whether to skip executing the xRecord.postLoad method on the table. (Inherited from xRecord.) |
| skipTTSCheck | Gets and sets the property that indicates whether to skip the check to determine whether the record is selected for update. (Inherited from xRecord.) |
| suppressWarnings | Gets and sets the property that indicates whether to suppress warnings for this pointer. (Inherited from xRecord.) |
| tableAccessRight | Returns the table access right. (Inherited from xRecord.) |
| tableBufferAccessRight | Returns the table access right for the current record. (Inherited from xRecord.) |
| takeOwnershipOfTempDBTable | (Inherited from xRecord.) |
| toolTipField | Retrieves the HelpText value for the specified field. (Inherited from xRecord.) |
| toolTipRecord | Retrieves the ToolTip value for the current record. (Inherited from xRecord.) |
| toString | Returns a string that represents the current object. (Inherited from Object.) |
| ttsabort | Aborts a transaction that was started by a call to the ttsbegin method. (Inherited from xRecord.) |
| ttsbegin | Starts a transaction that can be either committed by the ttscommit method or aborted by the ttsabort method. (Inherited from xRecord.) |
| ttscommit | Commits a transaction that was started by a call to the ttsbegin method. (Inherited from xRecord.) |
| update | Updates the current record. (Inherited from xRecord.) |
| usageCount | Retrieves the current number of references (the value of the reference counter) that the object has. (Inherited from xRecord.) |
| useExistingTempDBTable | (Inherited from xRecord.) |
| validateDelete | Determines whether the current record is valid and ready to be deleted from the database. (Inherited from xRecord.) |
| validateField | Determines whether the specified field is valid. (Inherited from xRecord.) |
| validateFieldValue | (Inherited from xRecord.) |
| validateWrite | Determines whether the current record is valid and ready to be written. (Inherited from xRecord.) |
| validTimeStateUpdateMode | Sets a valid time state update mode on the cursor. (Inherited from xRecord.) |
| wait | Pauses a process. (Inherited from Object.) |
| wasCached | Specifies the location from which the data was retrieved. (Inherited from xRecord.) |
| write | Updates a record if it exists; otherwise, inserts a record. (Inherited from xRecord.) |
| xml | Retrieves an XML string that represents the current object. (Inherited from xRecord.) |
| | ::exist | Indicates whether the specified record in the SysWorkflowMessageTable table exists. |
| | ::findByActivity | Finds the specified record in the WorkflowMessageTable table. |
| | ::findByCorrelation | Finds the specified record in the WorkflowMessageTable table. |
| | ::findByMessageId | |
| | ::findQueued | Finds the specified record in the WorkflowMessageTable table. |
| | ::initFromWorkflowMessage | Microsoft internal use only. |
Fields
| Field | Type | Configuration key | Description |
|---|---|---|---|
| ActionName | Extended Data Type:WorkflowOutcomeName Type: String | None | Name of application object. |
| ActivityContextType | Enumeration:WorkflowActivityContextType | None | The workflow activity context type |
| ActivityInstanceId | Extended Data Type:WorkflowActivityInstanceId Type: Guid | None | Activity ID identifies a workflow activity. For example. a workflow task. |
| AssignedUser | Extended Data Type:WorkflowAssignedUser Type: String | None | The user assigned a return or request change work item. |
| AxaptaUser | Extended Data Type:WorkflowUser Type: String | None | Workflow User contains Microsoft Dynamics AX user name. |
| BatchAffinity | Extended Data Type:WorkflowMessageBatchAffinity Type: Guid | None | The batch affinity identifies the group of workflow messages being process instance of a workflow batch task. |
| Bookmark | Extended Data Type:WorkflowBookmarkId Type: Guid | None | Workflow runtime internal bookmark identifier |
| ConfigurationId | Extended Data Type:WorkflowConfigurationId Type: Guid | None | Workflow ID identifies a workflow and its versions. |
| dEL_ModifiedTime | Extended Data Type:DEL_ModifiedTime Type: Integer | None | (This field applies only to the following version(s): Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2 (SYS)) |
| MessageId | Extended Data Type:WorkflowMessageId Type: Guid | None | Identifies a workflow message |
| MessageLifeCycleState | Enumeration:WorkflowMessageLifeCycleState | None | Message Life Cycle State identifies the life cycle state of workflow message. |
| MessageType | Enumeration:WorkflowMessageType | None | Message Type identifies the type of a workflow message (e.g. Activation, WorflowStarted etc.). |
| modifiedDateTime | Extended Data Type:ModifiedDateTime Type: UtcDateTime | None | |
| ParentCorrelationId | Extended Data Type:WorkflowParentCorrelationId Type: Guid | None | The parent workflow correlation identity. |
| Partition | Extended Data Type: Partition Type: Int64 | None | (This field applies only to the following version(s): Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2 (SYS)) |
| RecId | Extended Data Type: RecId Type: Int64 | None | |
| recVersion | Extended Data Type:RecVersion Type: Integer | None | |
| RootCorrelationId | Extended Data Type:WorkflowRootCorrelationId Type: Guid | None | The root workflow correlation identity. |
| SubWorkflowId | Extended Data Type:WorkflowSubWorkflowId Type: Guid | None | Identification of the subworkflow |
| WorkflowContextCompanyId | Extended Data Type:CompanyId Type: String | None | Company ID is the initials of the company accounts. |
| WorkflowContextRecId | Extended Data Type:WorkflowContextRecId Type: Int64 | None | Identifies the data record associated with the workflow. |
| WorkflowContextTableId | Extended Data Type:WorkflowContextTableId Type: Integer | None | Identifies the data table containing the data record associated with the workflow. |
| WorkflowCorrelationId | Extended Data Type:WorkflowCorrelationId Type: Guid | None | Correlation ID identifies a workflow instance. |
| WorkItemInstanceId | Extended Data Type:WorkflowWorkItemInstanceId Type: Guid | None | WorkItem ID identifies a work item. |
Relations
| Relation | Table | Lines |
|---|---|---|
| DataArea | DataArea | |
| MessageId | SysWorkflowMessageTable | |
| Partition | Partitions | |
| UserInfo | UserInfo | |
| UserInfo1 | UserInfo | |
| WorkflowVersionTable | WorkflowVersionTable | |
| WorkflowWorkItemTable | WorkflowWorkItemTable |
Nice and good article.
ReplyDeleteMicrosoft Dynamics AX Online Training