Wiki source code of Incorrect Flow Configuration
Last modified by Erik Bakker on 2024/09/03 13:45
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{container}} | ||
| 2 | {{container layoutStyle="columns"}} | ||
| 3 | ((( | ||
| 4 | This document will use the actual root cause analysis information to make a generic view that can be used if you run into the same or similar problem. Finally, the document will describe the situation, the problem, the analysis, and the result. | ||
| 5 | |||
| 6 | Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]]. | ||
| 7 | |||
| 8 | == 1. Situation == | ||
| 9 | |||
| 10 | Sometimes, a ticket suggests that something on the flow level might not work as expected and warrants further investigation. In these situations, executing various checks in the Design, Create, and Deploy phases of eMagin is good for zooming in on the problem. This entry will look at a generic approach to this and various situations we have encountered in the past few years. | ||
| 11 | |||
| 12 | == 2. Problem == | ||
| 13 | |||
| 14 | A suspected configuration problem on the flow level needs to be analyzed generically. | ||
| 15 | |||
| 16 | == 3. Analysis == | ||
| 17 | |||
| 18 | === 3.1 Reproduction === | ||
| 19 | |||
| 20 | First, you should check the assumptions of the person coming to you with a ticket. This is for both the Create and the Deploy phase of eMagiz. In Deploy, you check which version of a flow is running and whether this matches the client's expectations. Once you have established the correct flow version, it could happen that what is running is not what a user expected. The first step is to eliminate this mismatch. | ||
| 21 | |||
| 22 | If the flow version is as expected, we can check the [[properties>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-deploy-execute-deployment-plan-gen3.WebHome||target="blank"]] to see whether we see any changes. In this situation, always verify whether the user deployed the flow **after** the property value was changed. | ||
| 23 | |||
| 24 | Thirdly, we zoom into the Manage phase to gather related information in the form of error messages or logging that help us identify at what place in the integration the message has [[exited>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-manage-determining-origin-of-error-message||target="blank"]] the process. Once we have that, we can determine the [[cause>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Active Monitoring.intermediate-active-monitoring-determining-cause-of-error-message||target="blank"]] of the error message better. If there is no indication in the Error messages where the message broke down, it is wise to check the log entries and [[queue statistics>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Messaging.crashcourse-messaging-interpreting-queue-statistics-gen3||target="blank"]] for more information. | ||
| 25 | |||
| 26 | === 3.2 Analysis === | ||
| 27 | |||
| 28 | You can analyze most flow configuration problems in eMagiz with the above steps. The list below indicates various cases where part of the flow was misconfigured. | ||
| 29 | |||
| 30 | For more specific cases, please check out the following: | ||
| 31 | |||
| 32 | * [[Incorrect property configuration>>doc:Main.eMagiz Support.RCA Knowledge Base.rca-knowledgebase-configuration-issues.rca-knowledgebase-incorrect-property-configuration||target="blank"]] | ||
| 33 | * [[Incorrect queue configuration>>doc:Main.eMagiz Support.RCA Knowledge Base.rca-knowledgebase-configuration-issues.rca-knowledgebase-incorrect-queue-configuration.WebHome||target="blank"]] | ||
| 34 | * [[Incorrect groovy configuration>>doc:Main.eMagiz Support.RCA Knowledge Base.rca-knowledgebase-configuration-issues.rca-knowledgebase-incorrect-groovy-configuration.WebHome||target="blank"]] | ||
| 35 | * [[FTP Configuration>>doc:Main.eMagiz Support.RCA Knowledge Base.rca-knowledgebase-configuration-issues.rca-knowledgebase-ftp-configuration.WebHome||target="blank"]] | ||
| 36 | * [[Design runtime changes after Create>>doc:Main.eMagiz Support.RCA Knowledge Base.rca-knowledgebase-runtime-issues.rca-knowledgebase-design-runtime-changes-of-created-runtimes.WebHome||target="blank"]] | ||
| 37 | |||
| 38 | == 4. Result == | ||
| 39 | |||
| 40 | Once the flow configuration problem is identified, you can work towards analyzing and fixing the problem. | ||
| 41 | |||
| 42 | == 5. Suggested Additional Readings == | ||
| 43 | |||
| 44 | * [[Crash Courses (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.WebHome||target="blank"]] | ||
| 45 | ** [[Crash Course Platform (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.WebHome||target="blank"]] | ||
| 46 | *** [[Properties (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-deploy-property-management-new.WebHome||target="blank"]] | ||
| 47 | *** [[Execute Deployment Plan (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-deploy-execute-deployment-plan-gen3.WebHome||target="blank"]] | ||
| 48 | *** [[Determine Origin Error Message (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-manage-determining-origin-of-error-message||target="blank"]] | ||
| 49 | ** [[Crash Course Messaging (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Messaging.WebHome||target="blank"]] | ||
| 50 | *** [[Queue Statistics (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Messaging.crashcourse-messaging-interpreting-queue-statistics-gen3||target="blank"]] | ||
| 51 | * [[Intermediate (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.WebHome||target="blank"]] | ||
| 52 | ** [[Active Monitoring (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Active Monitoring.WebHome||target="blank"]] | ||
| 53 | *** [[Detemine Cause Of Error Message (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.Active Monitoring.intermediate-active-monitoring-determining-cause-of-error-message||target="blank"]] | ||
| 54 | * [[RCA Knowledge Base (Menu)>>doc:Main.eMagiz Support.RCA Knowledge Base.WebHome||target="blank"]] | ||
| 55 | ** [[Configuration Issues (Navigation)>>>doc:Main.eMagiz Support.RCA Knowledge Base.rca-knowledgebase-configuration-issues.WebHome||target="blank"]] | ||
| 56 | *** [[Incorrect property configuration (Explanation)>>doc:Main.eMagiz Support.RCA Knowledge Base.rca-knowledgebase-configuration-issues.rca-knowledgebase-incorrect-property-configuration||target="blank"]] | ||
| 57 | *** [[Incorrect queue configuration (Explanation)>>doc:Main.eMagiz Support.RCA Knowledge Base.rca-knowledgebase-configuration-issues.rca-knowledgebase-incorrect-queue-configuration.WebHome||target="blank"]] | ||
| 58 | *** [[Incorrect groovy configuration (Explanation)>>doc:Main.eMagiz Support.RCA Knowledge Base.rca-knowledgebase-configuration-issues.rca-knowledgebase-incorrect-groovy-configuration.WebHome||target="blank"]] | ||
| 59 | *** [[FTP Configuration (Explanation)>>doc:Main.eMagiz Support.RCA Knowledge Base.rca-knowledgebase-configuration-issues.rca-knowledgebase-ftp-configuration.WebHome||target="blank"]] | ||
| 60 | *** [[Design runtime changes after Create (Explanation)>>doc:Main.eMagiz Support.RCA Knowledge Base.rca-knowledgebase-runtime-issues.rca-knowledgebase-design-runtime-changes-of-created-runtimes.WebHome||target="blank"]] | ||
| 61 | * [[Flow Configuration (Search Result)>>url:https://docs.emagiz.com/bin/view/Main/Search?sort=score&sortOrder=desc&highlight=true&facet=true&r=1&f_space_facet=0%2FMain.&f_type=DOCUMENT&f_locale=en&f_locale=&f_locale=en&text=%22flow+configuration%22||target="blank"]] | ||
| 62 | ))) | ||
| 63 | |||
| 64 | ((( | ||
| 65 | {{toc/}} | ||
| 66 | ))) | ||
| 67 | {{/container}} | ||
| 68 | {{/container}} |