LexoNETDocs
Docs 0.6.0Anmelden
Architektur und API

Props, Terminals und Drucker

Eine Druckerdefinition im MDT beschreibt ein fachliches Ausgabegerät. Einen Editor zum Platzieren von Props oder Terminals im Spiel gibt es noch nicht; der Abruf platzierungen/stand ist für Connector v1.1 geplant.

#Umfang

TeilStand
Drucker im MDT anlegen, Status ändern, Auftrag erstellenVerfügbar
druck/offen, druck/ausgebenVerfügbar bei aktivem Druckmodul
Prop-/Terminaleditor im SpielNoch nicht vorhanden
platzierungen/standConnector v1.1 geplant, nicht aufrufen

Es gibt keinen Platzierungsbefehl und keine automatische Synchronisierung von Koordinaten.

#Drucker fachlich einrichten

  1. In der Testbehörde das Druckmodul und dessen Dokumentenabhängigkeit prüfen.
  2. Mit druck.verwalten einen Drucker anlegen: Name, IC-Standort und eindeutige Kennung.
  3. Kennung mit 2 bis 40 Zeichen aus a-z, 0-9, Bindestrich wählen. Sie ist nach dem Anlegen fest.
  4. Status auf „Bereit“ setzen. „Gestört“ erzeugt wartende Aufträge; „Außer Betrieb“ verhindert Ausgabe.
  5. Ein freigegebenes synthetisches Dokument mit eigener Behörde und passender Sicherheitsstufe an diesen Drucker schicken.

#IC-Platzierung vorbereiten

Bis Connector v1.1 verfügbar ist, Platzierungen als lokalen Plan führen:

  1. Behörde und unveränderliche Druckerkennung bestimmen.
  2. Freigegebenes Propmodell und Ort im Testserver auswählen.
  3. Koordinaten, Ausrichtung, Interaktionsabstand und erforderliche Rechte im Testplan festhalten.
  4. Serverprüfung für Entfernung, aktuellen Charakter und Behörde vorsehen; Clientkoordinaten nicht als Beweis verwenden.
  5. Erst mit Connector v1.1 umsetzen. Keine eigenen Endpunkte, Events oder Exportnamen erfinden.

#Ausgabe anbinden

druck/offen liefert höchstens 50 sichtbare abholbereite Aufträge am angegebenen Drucker. druck/ausgeben benötigt zusätzlich Auftrag und Prüfcode. Derselbe Ausgabeschlüssel muss bei Wiederholung erhalten bleiben.

Das MDT bestätigt die Ausgabe idempotent; die Ressource muss zusätzlich lokal vermerken, dass sie das Item je Schlüssel genau einmal ausgegeben hat. Bei X-HS-Wiederholt: 1 oder daten.wiederholt: true nur ausgeben, wenn lokal noch keine Ausgabe vermerkt ist. Das verhindert Itemduplikate bei erneut gelieferten Antworten.

Itemdaten enthalten Referenz, Prüfcode und begrenzte Anzeigeinformationen, keinen Dokumentvolltext. Vorschau höchstens 140 Zeichen und nur bei Sicherheitsstufe 0. Inventar-, Kapazitäts- und Absturzfälle mit synthetischen Aufträgen testen; keine allgemeine Exactly-once-Garantie zwischen zwei Systemen behaupten.

#Typische Fehler

  • Prop vorhanden, aber kein Drucker im MDT: Gerätekennung und Behörde zuerst anlegen.
  • 404 drucker_unbekannt: falsche oder fremde Kennung.
  • 404 unbekannt: Druckmodul inaktiv oder Endpunkt nicht registriert.
  • 409 bereits_ausgegeben: kein neuer Ausgabeschlüssel für denselben Auftrag verwenden.
  • 423 drucker_aus: Gerätestatus kontrollieren.

#Wer darf das?

druck.verwalten verwaltet Geräte. druck.nutzen erlaubt eigene Ausgabe; Drucken benötigt zusätzlich dokumente.ansehen. Serveradministration platziert IC-Geräte erst mit Connector v1.1.