> For the complete documentation index, see [llms.txt](https://docs.keyfax.biz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keyfax.biz/integrations/host-systems/aareon/launching-keyfax-repairs.md).

# Launching Keyfax Repairs

Launching Keyfax Repairs via Aareon QL.

Once in Aareon QL, use the tree to navigate to the following location.

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FRenDytj7hyFOuqyIbHa0%2Fimage.png?alt=media&amp;token=87709b09-6904-4fa8-a34f-f8071a3b9a0c" alt=""><figcaption></figcaption></figure>

This will present the following screen:

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FUv2HZIh2b0uwzgoQIjFJ%2Fimage.png?alt=media&amp;token=b5e2d3b2-528c-4b4c-86c4-db5808600ac0" alt=""><figcaption></figcaption></figure>

Once you have searched for and selected a tenant, use the New Order button (bottom centre) to enter a repair:

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2Fkw4N7cicJN58h3Q5YWAY%2Fimage.png?alt=media&amp;token=70f23d17-c6e3-450a-ae29-f4731216cfbe" alt=""><figcaption></figcaption></figure>

You will then see a pre-populated window for raising a new repair order with the Keyfax button at the bottom of the screen:

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FauL0E2OgeppXLCCAwgW3%2Fimage.png?alt=media&amp;token=b77677ef-2271-4344-ae92-4f4575daf1d4" alt=""><figcaption></figcaption></figure>

Keyfax will then launch and you can commence the diagnostic for this caller.\
\
Then, once submitted, Keyfax will close, populate various fields (as configured) and return control to Aareon QL.\
\
Note that the two fields below normally accept the **Fault Text breadcrumb** and **Additional Information** (which may be entered on the final page of the diagnostic):

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2Fc0cfxcf19YQrSIvRmzrM%2Fimage.png?alt=media&amp;token=14301025-c421-42c4-b997-fcf97ffb4ae6" alt=""><figcaption></figcaption></figure>

The captions against these fields are configurable within QL - by default, the two fields above are named **Message1** and **Message2**.
