Prozeduren und Prüfschritte¶

Kalibrierprozeduren definieren den standardisierten Ablauf einer Kalibrierung. Prozeduren werden als eigene Seite unter Inventar → Prozeduren verwaltet; die einzelnen Prüfschritte (TestSteps) gehören zur jeweiligen Kalibrierung und werden dort im Tab „Prüfschritte" bearbeitet und ausgeführt.

Prozedur-Verwaltung¶

Die Prozedurliste (/procedure) ist ein vollwertiges Grid (Spaltenfilter, Sortierung, Mehrfachauswahl mit Löschen). Die Detailseite bietet die Tabs Details, Gerätetypen und Prüfpläne.

Felder einer Prozedur¶

Feld	Beschreibung
Bezeichnung	Name der Prozedur (Pflichtfeld)
Kalibriergegenstand	Was kalibriert wird (z. B. „Digital Multimeter")
Kalibriermethode	Verfahren (z. B. „Vergleich")
Beschreibung	Detaillierte Beschreibung des Verfahrens
Messbedingungen	Umgebungsbedingungen (z. B. „23 °C, 50 % r.F.")
Normen	Referenz auf zugrunde liegende Normen
Geltungsbereich	Einsatzbereich der Prozedur
MET/CAL-Prozedur	Name der MET/CAL-Prozedur, die diese Prüfprozedur ausführt — nur für den MET/CAL-Start, siehe unten

Über Duplizieren (POST /api/v2/procedures/{id}/duplicate) entsteht eine Kopie inklusive Gerätetyp-Zuordnungen mit dem Namenszusatz „(Kopie)".

Die vier Texte für Seite 2 des Kalibrierscheins¶

Kalibriergegenstand, Kalibriermethode, Beschreibung und Messbedingungen bilden im DAkkS-Kalibrierschein die Prozedurbeschreibungen auf Seite 2. Sie werden deshalb nicht als Fliesstext gepflegt, sondern mit einem Editor — mit genau den Auszeichnungen, die der Bericht auch drucken kann:

Geht auf den Schein	Geht nicht
fett, kursiv, unterstrichen, durchgestrichen	Farben, Schriftarten, Schriftgrössen
Indizes (H~2~O, m^2^)	Überschriften, Ausrichtung, Einzüge
Aufzählungen und nummerierte Listen	Tabellen, Bilder, Links
Absätze und Zeilenumbrüche

Die rechte Spalte fehlt nicht aus Sparsamkeit: Der Berichtsgenerator (JasperReports) übernimmt aus einem HTML-Feld nur Zeichenauszeichnung. Eine Schriftart aus dem Text ersetzt die eingebettete Berichtsschrift — im PDF fielen Umlaute dann auf ein Ersatzzeichen zurück. Was der Editor nicht anbietet, wird beim Speichern entfernt, auch wenn es über die Zwischenablage hereinkommt.

Über den Knopf „HTML-Code" lässt sich der Quelltext direkt bearbeiten; beim Speichern gilt dieselbe Grenze.

Bestehende Texte bleiben, wie sie sind

Ein Text ohne Auszeichnung wird nicht angefasst. Zwei Dinge korrigiert der Bericht allerdings von sich aus, auch bei alten Datensätzen: Ein getippter Zeilenumbruch wird gedruckt (bisher wurde er zu einem Leerzeichen), und ein „<" im Text verschluckt nicht mehr den Rest der Zeile — „U < 10 V" stand vorher als „U" auf dem Schein.

Normen und Geltungsbereich bleiben einfache Textfelder. Der Bericht kennt beide Werte, druckt sie aber in keinem Textfeld; ein Editor darauf verspräche eine Wirkung, die es nicht gibt.

Der Feldtyp dahinter heisst HTML-Editor und steht in der Feldverwaltung (Administration → Datenmodell → Felder) auch für andere Felder zur Verfügung.

Damit die Texte auf dem Schein ankommen: procedure_field setzen

Der Kalibrierschein nimmt diese vier Texte nicht automatisch aus der Prozedur. Er braucht die Berichtsvariable procedure_field (Administration → Berichte → Variablen, Geltungsbereich „Bericht"): Dort steht der api_name des Kalibrierfelds, in dem der Name der Prüfprozedur hinterlegt ist — im V1-Original C2320, in Ihrer Installation das Feld, das die Kalibrierung mit der Prozedur verknüpft. Kein Prozedurname, sondern der Feldname.

Ist die Variable nicht gesetzt oder trägt das Feld einen Namen, den es unter Prozeduren nicht gibt, druckt der Schein für diese vier Abschnitte die Textbausteine des Berichts (Asset_description, Calibration_document, Calibration_procedure_1 und „im permanenten Labor") — für jedes Gerät denselben Text, ohne Fehlermeldung. Das ist die häufigste Ursache für „meine Prozedurtexte stehen nicht auf dem Schein".

Bei Berichtspaketen mit Parameter-Katalog (V2-JSON-Bundles wie DAKKS-JSON-SAMPLE) schlägt calServer die Variable beim Hochladen selbst vor, samt Erklärung — siehe Parameter-Katalog.

Kopftexte mit KI vorausfüllen¶

Diese sechs Felder landen auf dem Kalibrierschein und bleiben deshalb selten aus Nachlässigkeit leer, sondern weil sie Formulierungsarbeit sind. Der KI-Assistent kann sie vorschlagen: Detailseite → „Mehr" → „Kopftexte mit KI vorausfüllen".

Grundlage ist, was der Prozedur zugewiesen ist — nicht ihre Bezeichnung allein. Der Server liest die zugewiesenen Gerätetypen, eine Stichprobe der betroffenen Geräte und die Spezifikationsblätter der Typen mit ihren Messbereichen, Auflösungen und Genauigkeiten. Je mehr davon gepflegt ist, desto genauer wird der Text: aus „101 Federmanometer -1 bis 30 bar" plus einem Spezifikationsblatt wird ein Kalibriergegenstand mit Messbereich und Genauigkeitsklasse, ohne Zuordnung bleibt der Vorschlag allgemein. Der Dialog sagt unter dem Ergebnis, woraus er entstanden ist.

Im Dialog wählbar:

Felder — welche der sechs vorgeschlagen werden sollen. Abgewählte werden gar nicht erst gefragt.
Nur leere Felder vorschlagen (Vorgabe an) — bereits formulierte Texte bleiben unangetastet und gehen auch nicht an die KI.
Hinweis — alles, was nirgends im Datensatz steht: Verfahren, verwendetes Normal, Umgebungsbedingungen des Labors.

Jeder Vorschlag steht neben dem aktuellen Wert und ist einzeln abwählbar. Vorausgewählt sind nur die, die etwas ändern. Gespeichert wird erst beim Übernehmen, und nur was angehakt geblieben ist — über denselben Weg wie eine Änderung von Hand, also mit Rechteprüfung und Audit-Trail.

Normen und Messbedingungen prüfen

Das Modell wird angewiesen, kein Regelwerk zu nennen, das nicht aus den übergebenen Daten hervorgeht, und keine Inhalte einer Richtlinie wiederzugeben. Eine vorgeschlagene Norm ist trotzdem ein Vorschlag und keine geprüfte Prüfgrundlage — auf dem Kalibrierschein ist sie eine Zusicherung gegenüber dem Kunden. Dasselbe gilt für Messbedingungen: „23 °C ± 2 K" ist die übliche Laborangabe, ob sie für Ihr Labor gilt, weiß nur Ihr Labor.

Voraussetzungen: Ein Administrator schaltet die Funktion unter Administration → KI-Assistent → Konfiguration frei („Textvorschläge für Prozedurköpfe"); ab Werk ist sie aus. Bedienen darf sie, wer ai_assistant_edit und procedure_edit hat. Was genau übermittelt wird, steht im Dialog unter „Was an die KI übermittelt wird" — die Gerätestichprobe folgt dabei Ihrer eigenen Sichtbarkeit im Inventar.

GET  /api/v2/ai/procedure-text/availability
POST /api/v2/ai/procedure-text        # { "procedure_id": "...", "only_empty": true }

Der Endpunkt schreibt nichts; er antwortet mit Vorschlägen. Zeitbudget 120 s, einstellbar über AI_PROCEDURE_TEXT_BUDGET_S.

MET/CAL-Prozedur hinterlegen¶

Nur relevant, wenn die Prüfprozedur über „In MET/CAL starten" in der Fluke MET/CAL Runtime läuft. Das Feld steht auf der Detailseite im eigenen Abschnitt „MET/CAL-Start".

Was hier hineingehört, ist nicht die Bezeichnung der calServer-Prozedur, sondern der Name der MET/CAL-Prozedur — die Instrument Line der kompilierten Prozedur, also genau der Wert, der in MET/TEAM als Prozedurname steht. Über diesen Namen findet die Runtime beim Start die Prozedur in ihrem Prozedurverzeichnis; ohne ihn öffnet MET/CAL zwar, belegt aber weder Gerät noch Kalibrierung vor.

Die Auswahl liest die echte Prozedurliste aus MET/TEAM (MET/CAL-Prozeduren zuerst) und meldet unter dem Feld, ob MET/TEAM den gepflegten Namen kennt. Ohne eingerichtete MET/TEAM-Anbindung — oder wenn der Server gerade nicht erreichbar ist — bleibt die freie Eingabe; der Name wird dann nicht gegengeprüft, und das steht auch dort.

calServer legt in MET/TEAM keine Prozeduren an. Fehlt die Referenz oder ist sie drüben unbekannt, meldet der MET/CAL-Start das im Klartext, statt still eine leere Prozedur anzulegen. Der ganze Ablauf steht unter Prozedurvorlagen.

Auf übernommenen Anlagen ist der Name meist schon da¶

Wer aus MET/TEAM oder MET/TRACK migriert hat, muss das Feld oft gar nicht von Hand füllen. Beide Systeme führen zu jeder Kalibrierung, mit welcher Prozedur sie gelaufen ist — in MET/TEAM ist das die „Procedure Used" am Arbeitsauftrag — und die Übernahme bringt diesen Namen mit. Es ist derselbe Wert, den das Feld hier trägt.

Deshalb zwei Dinge:

Der Start greift von selbst darauf zurück, solange am Feld nichts gepflegt ist. Eine übernommene Kalibrierung startet MET/CAL also mit vorbelegtem Gerät, ohne dass jemand etwas eingetragen hat.
Für neue Kalibrierungen reicht das nicht. Ein frisch angelegter Datensatz hat kein Übernahme-Feld, und dann zählt wieder nur der gepflegte Name. Der Administrator zieht ihn deshalb einmalig an die Prüfprozeduren:

docker exec calserver-api-v2 php artisan procedures:backfill-metcal-name

Ohne --apply berichtet der Befehl nur. Er überschreibt keinen gepflegten Namen, und wo die Kalibrierungen derselben Prüfprozedur verschiedene Namen tragen, entscheidet er nicht, sondern listet sie auf — dann war die Prozedur drüben umbenannt worden, oder es waren fachlich zwei.

Ein gepflegter Name geht dem übernommenen immer vor. Wurde die Prozedur in MET/CAL umbenannt, ist der Eintrag am Feld die Korrektur, und der alte Wert aus der Historie kommt nicht dagegen an.

Gerätetypen zuordnen¶

Im Tab „Gerätetypen" wird die Prozedur per Zuweisungsliste mit einem oder mehreren Gerätetypen verknüpft:

GET    /api/v2/procedures/{id}/types
POST   /api/v2/procedures/{id}/types            # { "type_id": "..." }
DELETE /api/v2/procedures/{id}/types/{typeId}

Zugewiesen heißt angeboten. Wird ein Gerät des zugewiesenen Typs kalibriert, steht die Prozedur dort zur Messwertaufnahme zur Auswahl — ohne weiteren Pflegeschritt.

Standardprüfprozedur markieren (Stern)¶

Neben jedem zugewiesenen Gerätetyp steht ein Stern. Er markiert die Prozedur als Standardprüfprozedur dieses Typs: sie ist dann bei einer Kalibrierung vorausgewählt, statt nur angeboten zu werden.

Ein Gerätetyp kann mehrere Prozeduren zugewiesen haben; genau eine trägt den Stern. Die erste Zuordnung eines Typs bekommt ihn automatisch, spätere sind Alternativen.
Ein Klick auf einen leeren Stern macht diese Prozedur zum Standard des Typs; der bisherige Standard bleibt als Alternative erhalten.
Auflösung/Präzedenz: Eine Zuordnung direkt am Gerät überschreibt den Typ-Standard. Fehlt eine Geräte-Zuordnung, greift der Typ-Standard. Eine einzelne Kalibrierung kann beides überstimmen, ohne die Vorgabe zu ändern.

Dieselbe Zuordnung lässt sich auch vom Gerätetyp und vom Einzelgerät aus pflegen (dort im Tab „Prozeduren") — es ist eine Zuordnung, nur von der anderen Seite betrachtet.

GET    /api/v2/procedures/{id}/standard-for-types
POST   /api/v2/procedures/{id}/standard-for-types                  # { "type_id": "...", "make_default": true }
PUT    /api/v2/procedures/{id}/standard-for-types/{typeId}/default
PUT    /api/v2/procedures/{id}/standard-for-types/{typeId}/template  # { "template_hash": "..." | null }
GET    /api/v2/procedures/{id}/template-usage
DELETE /api/v2/procedures/{id}/standard-for-types/{typeId}

Bestandsdaten aus V1

V1 kennt nur „Prozedur gehört zu Gerätetyp", nicht die Standardmarkierung. Übernommene Zuordnungen werden beim Migrieren bzw. beim nächsten v1:sync automatisch ergänzt: der älteste Link eines Typs wird sein Standard, die übrigen bleiben Alternativen.

Prüfschritte (TestSteps)¶

Prüfschritte sind die einzelnen Messpunkte einer Kalibrierung. Die hierarchische Schrittnummer (test_step, z. B. 1.001, 1.002, 2.001) wird automatisch vergeben: jede Zeile erhöht die Minor-Stelle, ein Schritt vom Typ Manual Test oder Rating schließt den Block ab.

Eigenschaft	Beschreibung
Reihenfolge / Schrittnummer	Automatisch verwaltet (Hoch/Runter-Buttons zum Umsortieren)
Beschreibung	Name des Prüfschritts
Testtyp	`Manual Test`, `Rating`, `Header`, `Comment`, `Message`
Konfiguration	z. B. `NUMERIC,UUT INDICATED` (numerische Messung) oder `TEXT(Y=PASS)` (Bestätigung)
Testwert / Präfix / Einheit	Soll- bzw. Referenzwert mit SI-Präfix
Toleranz	Grammatik: `1%` (messwertbezogen), `2/` (bereichsbezogen), `2U` (absolut), `5D` (auflösungsbezogen); kombinierbar (`1% 2D`); bei Rating: `1-2:fail\\|3-5:pass`
Unsicherheit	Erweiterte Messunsicherheit (bestimmt die Guard-Bands)

Ausführung (Wizard)¶

Der Button „Ausführen" im Prüfschritte-Tab startet den Ausführungs-Wizard, der die Schritte in Reihenfolge durchläuft:

Numerische Messung: Messwert mit SI-Präfix/Einheit erfassen — Grenzen, Guard-Bands, Toleranzausnutzung und Pass/Fail werden serverseitig berechnet und sofort angezeigt.
Bestätigung: Bestanden / Nicht bestanden (Y/N).
Bewertung: Note 1–5; das Bewertungsschema in der Toleranz entscheidet über Pass/Fail.
Info-Schritte (Kommentar, Hinweis, Überschrift) werden angezeigt und übersprungen.

Jede Aktion schreibt sofort eine Zeile in die Messergebnisse.

GET  /api/v2/calibrations/{id}/wizard              # Schritte inkl. Ergebnisse
POST /api/v2/test-steps/{id}/submit-measurement    # { "varq": 10.1, "varq_p": "m", "varq_u": "V" }
POST /api/v2/test-steps/{id}/confirm-manual        # { "pass": "Y" }
POST /api/v2/test-steps/{id}/confirm-rating        # { "rating": 4 }
POST /api/v2/test-steps/{id}/clone
POST /api/v2/calibrations/{id}/test-steps/reorder  # { "ordered_ids": [...] }

Prüfpläne¶

Prüfabläufe lassen sich als versionierte Prüfpläne speichern und in andere Kalibrierungen laden.

Standardprüfplan je Gerätetyp¶

Welcher Prüfplan für einen Gerätetyp gilt, lässt sich von beiden Seiten wählen: am Gerätetyp (bzw. Gerät) unter der Standardprüfprozedur, oder im Reiter Prüfpläne der Prozedur. Die Spalte Standardprüfplan für zeigt je Plan die Gerätetypen, für die er gewählt ist (blau: die Prozedur ist dort Standardprüfprozedur, grau: sie ist es nicht, der Plan greift dann noch nicht), und wie viele Geräte ihn selbst gewählt haben. Über das Zeilenmenü Standardprüfplan für Gerätetypen wird er für einen Typ der Prozedur gesetzt oder aufgehoben; das Feld „Standardprüfplan" der Geräte folgt der Wahl. Geräte mit eigener Wahl behalten ihren Plan. Das Gerätefeld „Standardprüfplan“ selbst ist schreibgeschützt; am Gerät führt der Link In den Prüfvorgaben ändern zur Prüfplan-Wahl. Das Setzen braucht procedure_edit und ändert nicht, welche Prozedur Standard des Typs ist.

Berechtigungen¶

Operation	Berechtigung
Prozeduren ansehen	`procedure_view`
Prozeduren anlegen/ändern, Typ-Zuordnung, Standardmarkierung je Typ	`procedure_edit`
Prozeduren löschen	`procedure_delete`
Prüfschritte ansehen (inkl. Wizard-Daten)	`calibration_view`
Prüfschritte bearbeiten/ausführen	`calibration_edit`