Troubleshooting guide

This table lists the various run time errors and warnings in IGFC and other relevant information that may help resolve the issue.

Message Details of Run Time error Additional information How to investigate and troubleshoot
101
Description
BOD TenantID is not registered in GFC.
Type
POLLER_ERROR.
Reason Code
Missing GFC setup.
The TenantID for the business document in the COR_INBOX table is not registered in IGFC. TenantID must be the same as Tenant specified during installation.
102
Description
BOD already exists.
Type
POLLER_ERROR.
Reason Code
Invalid BOD.
An earlier business document was already processed by the poller for the same BODID.

A BODID contains the Document, DocumentID, VariationID, AccountingEntity, and Location.

Verify from the IGFC View page for the same document that was processed.
103
Description
BOD mapping does not exist.
Type
POLLER_ERROR.
Reason Code
Invalid BOD.
There were no attributes mapped on the BOD Registration page. Define attributes for the corresponding BOD in the IGFC BOD Registration page.

Go to Documents > BOD > then click Attributes hyperlink for the particular noun. Add and define attribute records.

104
Description
Variation ID does not exist.
Type
POLLER_ERROR.
Reason Code
Invalid BOD.
The business document's attribute for variationID is blank. Attribute {Noun}\DocumentID\ID\@variationID must be defined with a numeric value.
105
Description
Unable to find BOD XSD.
Type
POLLER_ERROR.
Reason Code
Invalid BOD.
The incoming business document is not registered in IGFC. Register the business document in the IGFC BOD Registration page.

Go to Documents > BOD and add and define a new record for the particular business document.

106
Description
Unable to find class file.
Type
POLLER_ERROR.
Reason Code
Invalid BOD.
The Master Data BOD is not yet generated in the BOD Registration page. Generate Master Data BOD in the IGFC BOD Registration page.

Go to Documents > BOD > Select the particular MDM then click Generate Class.

107
Description
Action Code not recognized.
Type
POLLER_ERROR.
Reason Code
Invalid BOD.
The value retrieved for ActionCode attribute from the business document is not valid.

Valid action codes in IGFC are Add, Replace, Delete and Accepted.

Attribute {Verb}/ActionCriteria/ActionExpression/@actionCode must be defined with a valid value.
108
Description
Error reading {Document Name}.xml
Type
POLLER_ERROR.
Reason Code
Invalid BOD.
A required system file of the document does not exist or

is corrupted.

Ensure that the system file of the document found in IGFC Folder(gfc\xsd\Standard\XML) exists and is not corrupted.
109
Description
Error reading {Document Name}.xml
Type
POLLER_ERROR.
Reason Code
Invalid BOD.
The source application's logicalID does not match an existing license key. Ensure license file exists in gfc\resources\ license folder.
199
Description
{Description of Error}
Type
POLLER_ERROR.
Reason Code
Failed Message
An error was encountered during poller processing that does not have a specific error category. All other errors that do not fall under a specific error category will be investigated based on the error description.
204
Description
Cannot run Rule: {Rule Name}. Search Template:{Search Template Name and Parameters} is not active.
Type
RULE_EXEC_ERROR
Reason Code
Missing GFC setup.
For an existing search template, parameters have been added or removed but the relevant master data BOD was not re-activated after the change.

A new search template was added and the relevant master data BOD has not yet been generated.

Generate the relevant master data in BOD page.

Go to Document > BOD to generate the master data BOD.

209
Description
Reference master data is missing for Search template {Search template name and parameters}. Document must be manually reprocessed once all missing master data are sent to GFC.
Type
RULE_EXEC_ERROR
Reason Code
Missing master data.
The search template used in an expression failed to retrieve a value because the master data document being referenced is not yet received by IGFC after 45 minutes from the receipt of the input transaction document. Verify that the referenced master data exists in IGFC View > BOD > Master Data before clicking the Reprocess hyperlink.

Alternatively, check the accuracy of the expression arguments; they must match a master data being searched.

250
Description
Journal not generated for these rules: {Rule Name}.
Type
RULE_EXEC_WARNING
Reason Code
Rule script condition did not create journal.
Rule script conditions for the rule names listed in the message description were not met. Warning Message only and does not necessarily indicate an execution error. If no output is generated from the input business document, check whether there is an existing rule record which matches the accounting entity and document name but has inactive status.
251
Description
Output not generated for rule: {Rule Name}. Document Reference is missing. Document will be automatically reprocessed once all Document References are sent to GFC.
Type
RULE_EXEC_WARNING
Reason Code
Missing reference.
The business document referenced by the originating master data or transaction is not yet received by IGFC. This message does not necessarily indicate an execution error. IGFC will process the master data or transaction once it receives the referenced document.
252
Description
Journal not generated for rule: {Rule Name}. Acknowledge BOD for the original document was not yet received. Updated document will be automatically reprocessed once acknowledgment is sent to GFC.
Type
RULE_EXEC_WARNING
Reason Code
Missing reference.

The Acknowledge BOD for the original document which is the basis for processing the updated document is not yet received by IGFC.

The message does not necessarily indicate an execution error. IGFC will process the transaction once it receives the Acknowledge BOD for the original document.
253
Description
Output not generated for these rules: {Rule Name}. Reference master data is missing for Search template {Search template name and parameters}. Document will be automatically reprocessed once all missing master data are sent to GFC.
Type
RULE_EXEC_WARNING
Reason Code
Missing master data.
The search template used in an expression failed to retrieve a value because the master data document being referenced is not yet received by IGFC. This message does not necessarily indicate an execution error. IGFC will process the transaction once it receives the referenced master data document. The master data document must exist in IGFC within 45 minutes from the time of receipt of the input transaction document. Alternatively, check the accuracy of the expression arguments; they must match the master data being searched.
254
Description
Rules not found. Please check if Rule record or Rule script exists and has Active status.
Type
RULE_EXEC_WARNING
Reason Code
Missing GFC setup.
Applicable rule record does not exist or is not active for the input BOD. This message does not necessarily indicate an execution error. There is no active rule record that matches the document type and sender entity of the input document. Check the status or the setup of the applicable rule record, if any. Go to Business Rule > Rules to check if the desired rule record exists or activate an inactive rule.
255
Description
This is a document reference for these rules: {Rule Name}. The input document or other document references are not yet received.
Type
RULE_EXEC_WARNING
Reason Code
Missing reference.
The document is used as a reference to another input document through the Reference Mapping facility in the Rule setup. The input document applicable for the rule or other related references are not yet received by IGFC to generate an output journal. This message does not necessarily indicate an execution error. IGFC will process the transaction once it receives the required documents.
256
Description
Journal not generated for rule: {Rule Name}. A document with higher variation ID has been processed.
Type
RULE_EXEC_WARNING
Reason Code
Variation ID outdated.
IGFC received a transaction business document with lower variation ID after processing the same document with a higher variation ID. Alternatively, multiple variations of the same document are pending processing in IGFC due to missing references. Once the reference is received, the document with highest variation ID will be processed. As a result, the outdated document will no longer be processed. Identify the updated document with higher variation ID and ensure that it was processed correctly.
299
Description
Journal cannot be generated for Rule: {Rule Name}.Reason: {Error}
Type
RULE_EXEC_ERROR
Reason Code
Failed Message.
An error was encountered during rule execution which does not have a specific error category.

An example would be when AccountingEntityID of the input business document is not defined.

All other errors that do not fall under a specific error category will be investigated based on the error description.

For the particular example given, fix can be made by defining the Accounting Entity in Accounting Entity Registration and Accounting Entity Mapping pages; or change the AccountingEntityID of the input business document to that which has been registered in the Accounting Entity Registration and Accounting Entity Mapping pages.

300
Description
Journal cannot be generated for Rule: {Rule Name}.There are errors in {Expression Value}.
Type
JE_GENERATE_ERROR
Reason Code
Missing master data.
A search-template type expression was defined for an SSJE attribute in the JE template. However, the expression could not retrieve a value because the arguments did not match a master data record. This will be triggered only for mandatory SSJE attributes.
Mandatory SSJE attributes are:
  • JournalEntryLine/GLAccount/GLNominalAccount-
  • JournalEntryLine/SourceAccountingDate/PostDateTime-
  • JournalEntryHeader/BaseJournalEntryHeader/AccountingJournalReference/ID

    ID

The error message will indicate the expression in question, including its arguments. Check the accuracy of the arguments, they must match the master data being searched.

302
Description
Journal cannot be generated for Rule: {Rule Name}. {Output SSJE Attribute} is blank.
Type
JE_GENERATE_ERROR
Reason Code
Missing GFC setup.
The JE template setup does not exist for mandatory SSJE attributes.

Ensure that mandatory SSJE attributes are defined in Rule Setup or Journal Entry Templates.

Go to Business Rule > Rules or Business Rule > Journal Entry Templates to check whether mandatory SSJE attributes have been defined and the value source returns an actual value.

398
Description
Reference BOD has been purged.
Type
JE_GENERATE_ERROR
Reason Code
Missing reference.
The master data or transaction document referenced by the input document is no longer available in IGFC as a result of purging activities. Identify and republish the referenced document from the source application, if applicable.
399
Description
Journal cannot be generated for Rule: {Rule Name}. Reason: {Error}
Type
JE_GENERATE_ERROR
Reason Code
Failed Message.

An error was encountered during output generation which does not have a specific error category.

An example would be when a search-template type expression was defined for an SSJE attribute in the JE template. However, the search template could not retrieve a value because the expression used no longer investigate by checking exists or has been removed.

All other errors that do not fall under a specific error category will be investigated based on the error description.

For the particular example given, investigate by checking the existing JE Templates with type "Expression" and look for values which are not names of an expression. This value is presented as a numeric value which means that the JE template uses a deleted expression.