Wolkenwald
PurePower Engine · Bauen

Formulare und XSD

Mit Formulare und XSD baut die PurePower Engine Eingabemasken aus einer XML-Beschreibung: vom Kontaktformular auf der Website bis zum Prüfprotokoll mit Fotos, Sprachnotiz und Unterschrift, das ein Techniker unterwegs auf dem Handy ausfüllt. Jede Definition wird gegen ein XML-Schema (XSD) geprüft, jede Eingabe ebenso.

Prüfabschnitt eines Formulars mit Statusknöpfen, Fotos, Sprachnotiz und Bemerkung

Ein Prüfabschnitt beim Ausfüllen: Zustand je Prüfpunkt per Knopf, dazu Fotos von Kamera oder Galerie, Sprachnotiz und Bemerkung.

Ein Formular ist eine XML-Datei

Abschnitte, Felder, Auswahllisten und Einstellungen stehen in einer Definition, die das Schema form.xsd beschreibt. Ein kleines Beispiel:

<form>
  <settings>
    <submit_label>Protokoll absenden</submit_label>
    <columns>2</columns>
  </settings>
  <fields>
    <section name="pruefung">
      <title>Prüfung</title>
      <fields>
        <field name="brenner"><type>status_check</type><label>Brenner</label>
          <is_mandatory>true</is_mandatory><requires_image_on>bad,urgent</requires_image_on></field>
        <field name="fotos"><type>image_upload</type><label>Fotos</label></field>
        <field name="unterschrift"><type>signature</type><label>Unterschrift</label></field>
      </fields>
    </section>
  </fields>
</form>
  • Feldtypen: Text, Textbereich, E-Mail, Zahl, Telefon, Webadresse, Datum, Passwort, Auswahl, Kontrollkästchen, Optionsknöpfe, Datei, versteckte Felder, Beschreibung, Trennlinie und Feldgruppe.
  • Für den Einsatz vor Ort: Zustandsprüfung mit sechs Werten (in Ordnung, teilweise, schlecht, dringend, nicht anwendbar, beobachten), mehrere Bilder je Feld, Sprachnotiz, Unterschrift mit Finger oder Maus, Adresse mit GPS-Position und Verweis auf eine Datei.
  • Aufbau: Abschnitte, auf- und zuklappbar und verschachtelt; wiederholbare Abschnitte („+ Teilfläche hinzufügen“) mit Mindest- und Höchstzahl; bis vier Spalten; Navigation in Schritten, Reitern oder als Baum.
  • Bedingte Felder: ein Feld oder Abschnitt erscheint nur, wenn ein anderes Feld einen bestimmten Wert hat, gefüllt oder leer ist.
  • Rechte je Feld: sichtbar oder bearbeitbar nur mit einem Recht, nur in bestimmten Zuständen des Ablaufs oder nur lesend für bestimmte Gruppen.

Gestalten in der Verwaltung

Formulare werden unter Verwaltung → Formulare angelegt: im einfachen Designer per Klick, im erweiterten Designer, der direkt aus dem Schema arbeitet, oder als XML. Änderungen entstehen als Entwurf; die veröffentlichte Fassung bleibt so lange gültig, bis der Entwurf veröffentlicht wird, und frühere Fassungen bleiben erhalten.

Feldübersicht eines Formulars mit Abschnitten und Feldtypen
Die Felder eines Formulars nach Abschnitten, mit Typ und Feldname.
Erweiterter Formular-Designer mit den Elementen des Schemas
Der erweiterte Designer bietet genau die Elemente an, die das Schema erlaubt, und zeigt Fehler sofort.

Prüfungen

  • Auf dem Server gegen ein XSD: Die Eingaben werden als XML zusammengesetzt und gegen ein Schema geprüft, das aus der Definition entsteht — oder gegen ein eigenes XSD je Formular.
  • Beim Abschliessen: Pflichtfelder müssen gefüllt sein, und ein Prüfpunkt im Zustand „schlecht“ oder „dringend“ verlangt auf Wunsch mindestens ein Foto. Was fehlt, wird markiert zurückgegeben.
  • Spam-Schutz für öffentliche Formulare.

Öffentlich, im Team und offline

Jedes Formular hat eine eigene Adresse /forms/<slug> und lässt sich auf der Website einbinden. Für die Arbeit unterwegs gibt es die installierbare Web-App PurePower Formulare: Sie hält Formulare und Einreichungen auf dem Gerät, nimmt Fotos und Sprachnotizen auch ohne Netz auf und gleicht ab, sobald wieder Verbindung besteht — mit Erkennung, wenn auf dem Server inzwischen jemand anderes geändert hat.

  • Vorbelegung: Eine neue Einreichung übernimmt auf Wunsch die Werte der letzten abgeschlossenen für dasselbe Formular und denselben Kunden — Zustände ja, Bilder nein. So fällt auf, was sich seit dem letzten Mal verändert hat.
  • Vorlagen: Formularvorlagen nach Kategorien (Inspektion, Checkliste, Protokoll, Allgemein), aus denen neue Formulare und Einreichungen entstehen.
  • Zuweisung an eine Person, Kundenbezug, Adresse und Position je Einreichung; Sprachnotizen können eine Abschrift erhalten.

Was nach dem Absenden passiert

Eine Einreichung löst das Ereignis form.submitted aus, zusätzlich eines je Formular. Pipelines reagieren darauf: Bestätigung verschicken, Ticket anlegen, Daten weitergeben. Jedes Formular kann einen eigenen Workflow haben, etwa Prüfung und Freigabe, und auf eine Einreichung lässt sich in einem Verlauf antworten. Umgekehrt können Pipelines selbst Formulare aus JSON, XML, CSV oder einer Tabelle erzeugen. Formulare, Einreichungen, Bilder, Sprachnotizen und XSD-Prüfung sind auch über die REST-Schnittstelle und als MCP-Werkzeuge erreichbar.

Die Bildschirme der Verwaltung selbst entstehen ebenfalls deklarativ — mehr dazu unter XUI-Oberflächen. Zurück zur PurePower Engine.

Kontakt

Fragen zu Formulare und XSD?

Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.