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

> ## 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 documents

When a message does not run successfully, you can troubleshoot the related source document and target document.

When a document is used in a message run, based on the document setup, a query is created that reads the data.

You have several options to troubleshoot a document. You can, for example:

- Validate the document setup.
- Test a document.

Common issues on the document are:

- No files are read from the **Work** folder: Check the read settings on the document header.
- Missing data in export: Verify the setting of these fields on the record setup: '**Join mode**' and '**Combine with parent record**'. For more information, refer to this [blog](https://staedean.com/data/blog/ax-fetch-mode).
- No records are processed: Verify the range as set up for document records.

## Flow diagram

[Embedded content](https://viewer.diagrams.net/?tags=%7B%7D&lightbox=1&highlight=0000ff&edit=_blank&layers=1&nav=1&title=Troubleshooting_documents.drawio&dark=auto#R%3Cmxfile%3E%3Cdiagram%20name%3D%22Page-1%22%20id%3D%220%22%3E1VdNc5swEP01PnoGQ8Z1r3Hd5JBOD%2B7HWUYLKBYsIxZj99d3MQJESDLBrTuNL2jffmh5Tyx4FqzT450RefIFJeiZ78njLPg08%2F3Fjb%2FkS42cGuTjctEAsVHSBvXAVv0CC3oWLZWEYhBIiJpUPgRDzDIIaYAJY7AahkWoh7vmIoYRsA2FHqM%2FlaTEor7n9Y57UHHSbr1qPalooy1QJEJi5UDBZhasDSI1q%2FS4Bl2z1xLT5H1%2Bwdt1ZiCjtyQUJAyNk2ydgk7tPXMa08vGbZUogm0uwtpTscKMJZRqtha8jJTWa9RoznlBFEV%2BGDJekME9OB7v%2FOs8LZN1jWb3g9Cl3X3bt3kAQ3B02rQ3dgeYApkThyQO9zeW6KoXammhtsgHa5%2BGGcKekrgr3PPIC0vl2fxegPm6e6zPmu9psQPdpP4QWklB0J9FdVBUt1gAlXmzj1bZvgnnqhwt5qnI%2BASltRqMYFjw5WBLzd1Cc6dMp2i5izRWLjVW89cFNlhmEqRVYJrIUsAqmiKy34s8Tc7VWM7FUz39oZ6dPUFQNh1NX9X4GxQ1wjKVjWJv15Q4dT5MbFUkUez%2FqYQ7DwJYXvacXl3CS57JZyQcTT%2FI5H81%2B%2FznZt%2BmbfLqky9YTqd5xGlo%2BQM5eomOOcbShDB6E7nUc5WtNdFQgjFmQm969HZ46PuYB8Tcgo9AdLKfEaIkHIo2%2FcBzpzHQi%2BPW0cOAFjyqh0T8Ebv%2Bhew6bb4vgp9OwquyG1zGbtfj%2B6LWjr%2B%2FTyyb%2FSfs2ef8Ewg2vwE%3D%3C%2Fdiagram%3E%3C%2Fmxfile%3E)