---
title: "Troubleshooting messages"
slug: "troubleshooting-messages"
tags: ["Flow topic"]
status: "new"
updated: 2026-03-20T08:18:03Z
published: 2026-03-20T17:44:53Z
canonical: "docs.staedean.com/troubleshooting-messages"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staedean.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting messages

When a message doesn't run successfully, you can troubleshoot the message. You have several options to troubleshoot a message. You can, for example:

- Validate the message setup.
- Run a message for testing and troubleshooting purposes.
- Analyze the message history.
- Analyze the file history, if the message has an Azure file storage connector with file actions.
- Analyze the tracer, if you have used the tracer on the message run.

Common issues on the message are:

- Field mapping sequence: Make sure the fields are mapped in the same sequence as shown on the related form in D365 F&SCM.
- Mapping conditions and field conditions: Conditions limit the records that are processed. So, if records are skipped unexpectedly, check if conditions are defined.
- Key field setup: Key fields are used to find and update records. If records are not updated unexpectedly, verify if the correct fields are marked as key fields.

> [!NOTE]
> Note
> 
> If you click a ‘Monitor …’ shape in the flow diagram, the related section or article in Operation > Monitoring integrations > [Monitor integration - Details](/data-management/docs/monitor-integration-details) is opened.

## Flow diagram

[Embedded content](https://viewer.diagrams.net/?tags=%7B%7D&lightbox=1&highlight=0000ff&edit=_blank&layers=1&nav=1&title=Troubleshooting_messages.drawio&dark=auto#R%3Cmxfile%3E%3Cdiagram%20name%3D%22Page-1%22%20id%3D%220%22%3E7VxZc6M4EP41fiQFGGPymDiZ2a3KHLWpnal5lEEGJoAoIeJ4fv1KIA7J4JjDjL2elCuGRt1Af32ppWQ2X4VvHzGIvU%2FIgcFMV5232fxhpuuaoZv0i1F2OeXW1HKCi32HD6oIz%2F4vyIkqp6a%2BAxNhIEEoIH4sEm0URdAmAg1gjLbisA0KxLvGwIV7hGcbBPvU775DPE41VbW68Bf0Xa%2B4tVVcCUExmhMSDzhoWyPNH2fzFUaI5Efh2woGTHuFYnK%2BDy1XyyfDMCLHMCQEYLLPxOUkZFe8M2Wj6qUn91vPJ%2FA5Bja7sqUIU5pHwoCeafRw4wfBCgUIZ3zzzWaj2zalJwSjF1i7omY%2F5ZVCk0xGfvdXEKT87s%2FVY75CTOBb7TH5i32EKIQE7%2BgQr6Z7gyt6WwFlchIXoi%2F4%2BU7kANxK3FJwpUd6wFXZrFYXELgFuwY49jW7%2F%2Fo1bVL7iNm48M1lvnSzCdDW9qgybhxo%2B4mPIjooAGsYfEWJT7LzhwBu6N3umaZ8arVP0uXQdxx283sQ%2BC4j4FxdJcMdp5cD9zCFZobpHk4rFDMAQpgkmQ99mOkmCJmFROskrjgGY2hIGJoihloPEP9NIP6y%2FskChq5mKm18p0xs4Ecv%2BVUqxAEEKCGI6NWQ4UwpyE7ol005FYGvsA8Ckpf6i3PzOWwoGKWRAx1uGd3ccK3COTT7uWE3sKx9sDTJ4wxVQkvvjhY9rQF2EMBv1M4pRrAOoppAksZdwHzlUhSeVfxXn%2ByUmpgypKZr5qWTwusAaG26RFn9hPDqErwlzzB424Ksfm1B9gEx3aKUlT0wYcYOIqaWMEYsScoB1wzYbR3%2FlR667LByAhA59HcEqdW1sDH7rzgbhAFWQPkBzEyCKrd8JuZIjQmgWfAkacHoEWjaosqd41SvThgk3xF%2B8SOXV5QQd4kuwHEUJkshSNnmcpS6lHri0P8kjp10fprE8U8aCTljQ189t%2B8c5jjFMUroTKQD0DiNipKAAowVLk0RZdXhnl8t3HIiWZgnTSTzYxJJjPyIZLdf3NOPeqMvZvqq%2BJot6JhVRs%2FPRdqycayWEWV%2BPnbZJFeTaHrzWFEu%2FeynunUcRjdlIhUs493MlnnKPbBf3MzixEkf%2FTmU7OSsGEPsUyghE4A9FK7T5GtFukcpoe5FzbGY0KsVkZ5Bmsfou%2B3CNWJP78IIYhC0J%2B2jU%2B1EecnsUSG1Ba1PKPJJFqiqwOX5CSXtusSpMBdTxipBhFTqTpqQzrrUXY4Tod7HltcdA4DNqo1DqE6ad84KVbnMGAnVtrxjXN0ExnfKGUyaZPWzl%2F3G1Frw7%2Bsa3Y7YNbqLQLD7VXurLpOBnFepc9YrQuNqK0LZM2%2FH6Ry1eebimj3TzvuemWt26CmsIZ3WwEJKz65CtizBuhLUe1C6DmDiIZTNus6so6BpPaagrekdYlfoUnbI6oy1vde8%2BBMxCsDUE3Uj2RzkiGgx2Tqa3uTfj8VDnnwVTRtlHc3mCoTO3orsvpJRiu0yJpfrhXXdUynP%2FBRh4iEX0Uz7WFHvRbOvxjwhFHPiT0jIjq9Jg5QgKd53Nnn6pC4kQtppAQTDABD%2FVVTEIO3q%2FbQrrm5ekoIb1mZOqWADPX37%2BzZ17oj2xbPJ8nPyESlc6XwZCawL5an7ui8AklT8lKeMulqKUsCmvFnHpLUWwDDxf%2FG7MrWJDa2HpqjxGR0dNBpVyFkU9cawhCBhtKuYi%2F7Knq4mwhD4FVMUgDabBJI9hMrnO84r5tfmFfJq9OQuIe7XOewS87NwiR9Fp364T%2BiW6BRFgOjgFZp5UMI4bmH0c4vSuC7LJ0bKFBnrHcZgVxvA7asVT8MSa6milPrQMl4%2FPJ4e5E%2FQG%2FpFzyqspsPLQr%2B%2BtWCKQswclHKaq4SzVrC8sDl5yjE6pBzzLFLOeFWYJiYcq3O%2BkROWBNI4%2BWZ5jT4xVcRp9Il5B59YnoVPjFiGabpk1d0nJ7pxUMI4bmH1L8Mu1CeG5olRarCFvJH%2BnRpMGj%2B8Brvtj3vzlOmsca9vyZmiANN6NhrFrUOXpOGGvRun1fCwZuPlang6G%2B7ZuKpbwmVpuL6BYuoEIQd8a9ktQUjjhycIrWeDpm6mf%2BDvWx9YVkf4rbHh79mkETchXSD8i4HwD5oy8dbAUVOmAqH%2FTR%2FB1MylYNTdW9e6yD8X%2BceZMWnDumsX6BnyJrHJ3WLRxS3Oo702VitBvVHnklV37yS8I2Ekv%2BjZYSut67KcYqR0MUq1oKkdl3RkhhHqhZ6NJHFr5CUZAN%2Bh9btiotUlJlpnERNHLBWGhkSxtXqSBQetZ4vtcj1C3ho6uU8su%2FjE7Vn4xIhLDurwnR%2F6FDs%2FCjj6FAoX6BXD88Q4NULxx2VH1wgSQ9cagf11cvmPh%2FLh1f9vmj%2F%2BBw%3D%3D%3C%2Fdiagram%3E%3C%2Fmxfile%3E)

## Related

- [Monitor message history](/monitor-message-history.md)
- [Monitor file history](/monitor-file-history.md)