Track Jobs and Results Praxis

Track in Offisy Connect on the practice computer which lab requests were sent to a device and which results came back.

Where do I find jobs and results?

Open Offisy Connect on the practice computer. The Aufträge (Jobs) page shows every lab request sent to a device. The Ergebnisse (Results) page shows every result file a device has delivered.

The Übersicht (Overview) page also shows the engine state (Läuft (Running), Startet … (Starting …), or Gestoppt (Stopped)) and refreshes automatically every three seconds.

Fig. 1The Overview page shows the engine state and metrics for each account.

Requirements

• The Offisy Connect add-on is included in your license.
• Offisy Connect is installed and connected to at least one Offisy account.
• For lab requests, a device is set as the Ziel für Laboranfragen (target for lab requests).

Filters

If multiple accounts are connected to the installation, both pages show an Account field at the top with the option Alle Accounts (All accounts). Selecting a single account shows only its jobs or results.

On both pages, you can also narrow the list down with the Zeitraum (time period) filter.

Above the Aufträge table you also find Jetzt abrufen (Fetch now) to check for new jobs immediately, and Log leeren (Clear log) to remove completed jobs. Log leeren is final. Offisy Connect archives the lab requests' export files first. Open jobs are kept. The same applies to jobs whose result hasn't reached Offisy yet.

Data table

The Aufträge table shows, per row: Zeitpunkt (Timestamp), Account (with multiple accounts), Art (Type), Patient, Geburtsdatum (Date of birth), Status, and Fehler (Error). Above the table you can search by patient, date of birth, or error text, and filter by status.

Fig. 2The Aufträge table with its filters, Jetzt abrufen, and Log leeren.

The Ergebnisse table shows, per row: Zeitpunkt, Account (with multiple accounts), Gerät (Device), Patient, Nr. (No.), and Status. If the name on the device differs from the assigned customer, the warning "Laut Gerät: …" (According to device: …) appears below it. If individual attachments weren't accepted into the customer record, the status shows "⚠ 1 Anhang nicht übernommen" (1 attachment not accepted) or "⚠ 2 Anhänge nicht übernommen" (2 attachments not accepted). You can search by patient, date of birth, number, or customer, and filter by status or device.

A result has one of these statuses:

• Offen (Open) — not yet assigned to a customer.
• Zugeordnet (Assigned) — assigned to a customer.
• Hochgeladen (Uploaded) — arrived in Offisy. If only individual attachments weren't accepted, the measurements still land in the customer record and the result shows Hochgeladen.
• Abgelehnt (Rejected) — nothing from the result could be accepted. This happens, for example, when it has no measurements and every attachment was rejected.
• Nicht zuordenbar (Not assignable) — the account this result belongs to is no longer connected. Kunde zuweisen (Assign customer) and Erneut versuchen (Retry) are then no longer possible. Only Details ansehen (View details) and Verwerfen (Discard) remain.

Opening the details of a result shows the Messwerte (Measurements) section (name, value, unit, reference range) and the Anhänge (Attachments) section (file names of the delivered files). Ordner öffnen (Open folder) opens the directory with the result files from there, if one exists.

Fig. 3The details dialog of a result, with measurements and attachments.

If individual attachments weren't accepted, the details dialog also shows the Nicht übernommene Anhänge (Attachments not accepted) section — file name and reason per row:

• "Das Modul für medizinische Dateien ist nicht gebucht oder abgelaufen. Nach der Freischaltung lässt sich die Datei erneut senden." (The medical files module isn't booked or has expired. Once it's enabled, the file can be sent again.)
• "Der Speicherplatz des Accounts ist erschöpft. Nach dem Freiräumen oder einer Erweiterung lässt sich die Datei erneut senden." (The account's storage space is full. Once space is freed up or extended, the file can be sent again.)
• "Die Datei ist zu groß für die Ablage in der Kundenakte." (The file is too large for storage in the customer record.)
• "Der Dateityp ist für die Kundenakte nicht zugelassen." (The file type isn't allowed for the customer record.)

The first two reasons depend on the account's state and are fixable. The file stays on the practice computer. Anhänge erneut senden (Resend attachments) picks it up once you've resolved the cause.

The last two reasons are final, because they're a property of the file itself. The file is no longer on the computer, and a retry isn't possible.

Depending on which reasons occur in a result, the dialog shows one of three notes below the list:

• Only final rejections: "Diese Dateien liegen nicht mehr auf diesem Rechner. Offisy hat sie nicht übernommen, ein erneuter Versuch ist nicht möglich." (These files are no longer on this computer. Offisy didn't accept them, and a retry isn't possible.)
• Only fixable rejections: "Diese Dateien liegen noch auf diesem Rechner. Ist die Ursache behoben, holt „Anhänge erneut senden" sie nach." (These files are still on this computer. Once the cause is resolved, "Anhänge erneut senden" picks them up.)
• A mix of both: "Die endgültig abgelehnten Dateien liegen nicht mehr auf diesem Rechner. Die übrigen liegen noch hier: ist die Ursache behoben, holt „Anhänge erneut senden" sie nach." (The files that were finally rejected are no longer on this computer. The rest are still here: once the cause is resolved, "Anhänge erneut senden" picks them up.)

Fig. 4A result with one attachment that was not accepted: file name, reason and note.

Row actions

In the Aufträge table, the row menu for lab requests offers Export-Datei im Ordner anzeigen (Show export file in folder).

In the Ergebnisse table, the row menu offers, depending on the result's state:

• Kunde zuweisen — for an open result with a connected account.
• Erneut versuchen — if the upload of the whole result was previously rejected. This option isn't available for a single attachment that wasn't accepted.
• Anhänge erneut senden — if at least one attachment of the result wasn't accepted because of the account's state (missing medical files module, full storage space) and is still on the practice computer. Only sends those attachments again, not the whole result.
• Kundenakte öffnen (Open customer record) — if the result is already assigned to a customer.
• Details ansehen — always available, opens Messwerte and Anhänge.
• Verwerfen — as long as the result hasn't been uploaded yet.

Assign an open result to a customer

Offisy Connect asks Offisy whether the customer can be matched uniquely by customer number. If the customer number is ambiguous, the result stays Offen. There's no fallback to the social security number in that case.

If no customer number matches, Offisy Connect asks again using the social security number. If that doesn't produce a unique match either, the result stays Offen. Offisy does the matching itself.

To assign an open result by hand:

1. Open the Ergebnisse page in Offisy Connect.
2. In the row menu for the relevant row, select Kunde zuweisen.
3. Search for the customer using the customer search (enter at least three characters).
4. Select the matching customer from the results list.
5. Click Zuweisen (Assign).

After a successful upload, the customer record in Offisy gets the lab values and all documents Offisy took over. Individual attachments can be missing — Offisy Connect points this out in the result's details dialog.

Discard a result

A result can only be discarded as long as it hasn't been uploaded yet. Discarding is final.

1. Open the Ergebnisse page in Offisy Connect.
2. In the row menu for the relevant row, select Verwerfen.
3. Confirm the dialog.

Offisy Connect deletes the result and its attachments locally on the practice computer and uploads nothing to Offisy.

Metrics

The Ergebnisse page shows the Offene Ergebnisse (Open results) metric at the top — the number of results not yet assigned to a customer.

Fig. 5The Ergebnisse page with the Offene Ergebnisse metric and status badges.

Job statuses

Status	What it means
Empfangen	Offisy Connect has fetched the lab request from the cloud.
An Gerät übergeben	The job file is in the target device's export directory.
Wartet auf Ergebnis	Doesn't occur for a lab request — a lab request gets no direct answer from the device.
Verarbeitet	The export file has been written. For a lab request, the job is complete at this point — no result and no upload follow.
Hochgeladen	The result has arrived successfully in Offisy.
Fehlgeschlagen	The job could not be completed.
Zeitüberschreitung	No result arrived within the configured waiting time.
Abgebrochen	The job ended without delivering a result.

If the internet connection drops, Offisy Connect buffers results locally. Once the connection is back, Offisy Connect uploads them in order — with no duplicate processing.