# MRI

<figure><img src="/files/jM9Pg4eH0IsqQO5Ab1Di" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**NOTE** MRI, Orchard Systems, Castleton Technology and Real Asset Management have come together as one
{% endhint %}

MRI / Orchard Housing supply two housing management systems:

* **Orchard Housing GUI** (previously *Archouse*)
* **Orchard Housing WEB** (previously *Archouse Plus*)

This page describes the Orchard Housing WEB product (hereinafter **OH)**. This integration operates via a go-between program. When ready to run a Repair Diagnostic, OH will launch the executable `KF_arcHouse.EXE`.

{% hint style="info" %}
**NOTE** The program `KF_arcHouse.exe` is a component of the [Keyfax Client](/product-suite/client.md) and is supported by Omfax Systems Ltd. Should any error messages carrying `KF_arcHouse.exe` in the title appear, these should be referred to Omfax Systems Support.
{% endhint %}

Within OH, it is possible to configure the command-line arguments that are passed to `KF_arcHouse.exe` (*for further information on how to define these arguments please contact Orchard Information Systems or see the* [*Keyfax System Administration Guide*](http://help.keyfax.biz/Keyfax%20General%20Help%20and%20Technical%20Data%20HC%206/docs/Orchard%20Housing%20_Keyfax_System%20Administration%20Guide_v1%200.pdf)).&#x20;

### Command-Line Arguments

The following arguments can be supplied:

<table><thead><tr><th width="222">Item</th><th width="132.33333333333331" align="center">Argument</th><th>Description</th></tr></thead><tbody><tr><td><code>USER CODE</code></td><td align="center">/UC:</td><td>Unique user ID which must be defined in Keyfax (MANDATORY ARGUMENT)</td></tr><tr><td><code>TENANT DETAILS</code></td><td align="center">/TD:</td><td>Name and address comprising Comma separated variables</td></tr><tr><td><code>TENANT ID</code></td><td align="center">/TI:</td><td>Tenant ID (<em>Note: only supported in Keyfax Client version 3.2.0.37 or greater)</em></td></tr><tr><td><code>TENANCY TYPE</code></td><td align="center">/TT:</td><td>This defines which Repair Diagnostic script set to use</td></tr><tr><td><code>ASSET ID</code></td><td align="center">/AI:</td><td>Optional Asset identifier</td></tr><tr><td><code>COMPANY</code></td><td align="center">/CO:</td><td>Determines which instance of Keyfax to use. If omitted, the default company is used</td></tr><tr><td><code>FILENAME</code></td><td align="center">/FN:</td><td>Location of Export XML filename.</td></tr><tr><td><code>XSLT TRANSFORMATION FILE</code></td><td align="center">/XS:</td><td>Location of file used for XSLT tranformation of export XML. <em>Note that this is not normally a requirement as this is a historical legacy since Keyfax and the earlier KEYFAXI32.DLL version 3.2.0.32 transformation is performed server-side.</em></td></tr><tr><td><code>DEBUG SWITCH</code></td><td align="center">/DB:</td><td>Defines the debug level. Please avoid setting any value for this parameter unless Support have been advised. Values are '1' (debug to <strong>screen</strong>) or '2' (debug to <strong>file</strong> DEBUG.LOG).</td></tr></tbody></table>

An example call might be:

```
/UC:MJames /TD:"Harry Smith, 1 The Street, Sometown" /TT:1 /AI:12345AR /CO:CO_001 /FN:"C:\Program Files\Keyfax\Export.xml" /XS:"C:\Program Files\Keyfax\Export.xsl"
```

{% hint style="info" %}
**NOTE** Any arguments containing white space must be enclosed in quotes.
{% endhint %}

To access the page, click here. The configuration page within OH is as follows (click [here](http://help.keyfax.biz/Keyfax%20General%20Help%20and%20Technical%20Data%20HC%206/page.aspx?pageid=accessing_configuration_details) for a description of how to get to this page):

<figure><img src="/files/aSN21Fxzh2DbpN99YTWw" alt=""><figcaption></figcaption></figure>

These settings will normally be established and maintained by Orchard Housing, however, there are two items worthy of note here:

1. **Delete XML File checkbox**; in order to housekeep after each repair is raised, switch this option ON, otherwise you could end up with thousands of files!
2. **/FN: Parameter**; this is the filename path to which Orchard appends the user id and datetime to make it unique when the workflow workitem is created.

### **Processing**

In essence, the program will launch a Keyfax Repair Diagnostic whcih will delete any existing export XML file. Once complete will it generate a new Export.XML file (using the optional XSLT transformation), then terminate. On detecting the export XML file, OH regains focus and the works order etc is created.

### **Installation**

The `KF_arcHouse.exe` program is delivered as part of the Keyfax Client Installation (v3.2.0.22 or greater) or Keyfax Administrator Tools version 3.2.0.32 or greater (the latter also deploys the Keyfax Client components). The installation configuration file (KF32install.INI) must contain the following declaration:

```
HostApplication=arcHouse_Plus
```

{% hint style="info" %}
**NOTE** This setting is used for both Archouse Plus and Orchard Housing).
{% endhint %}

### **Transformation**

* FaultText 1,50 is moved to **FaultDescription1**
* FaultText 51,50 is moved to **FaultDescription2**
* FaultText 101,150 is moved to **FaultExtendedText**
* Only output 1st Fault will accumulate Repair and Advice nodes from all Faults
* Job descriptions for all faults concatenated in FaultDescription1, 2 and FaultExtendedText&#x20;

he initial implementation performs the following transformation:

{% hint style="info" %}
**NOTE** Ensure that the target folder used for creating the Export XML is exclusive to each user and has Write permissions.
{% endhint %}

### **Orchard Housing Screenshots**

Note that this describes earlier versions of Orchard Housing. For versions since and including 2010A07\_18, click [here](http://help.keyfax.biz/Keyfax%20General%20Help%20and%20Technical%20Data%20HC%206/page.aspx?pageid=orchard_v2010a07_18).\
\
Figure 1 - Login Page<br>

<figure><img src="/files/IyXVN7dekLbTlGeK4hiV" alt=""><figcaption></figcaption></figure>

Figure 2 - Select '**New Contact**'

<figure><img src="/files/WI8sTZtEtUoJuxVtxnnW" alt=""><figcaption></figcaption></figure>

Figure 3 - Select Case type of '**Omfax Repair**' then enter address to lookup

<figure><img src="/files/TqhQRBkF3yCBKKa0fhAe" alt=""><figcaption></figcaption></figure>

Figure 4 - Select '**No**' then choose Integration Type of '**KEYFAX**'

<figure><img src="/files/0bOE5b3n27KFXJLObrcA" alt=""><figcaption></figcaption></figure>

Figure 5 - Click '**New Repair**'

<figure><img src="/files/4HUL9Y9iRHpphGHHuOhe" alt=""><figcaption></figcaption></figure>

Figure 6 - On return details are populated as below

<figure><img src="/files/BYB4anY9HrnRpOBXNXj7" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keyfax.biz/integrations/host-systems/orchard-housing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.