Fragebögen zum Aktionsergebnis einrichten

Ein Fragebogen zum Aktionsergebnis ist die Reihe von Fragen, die ein Fahrer beim Abschluss einer Aufgabe beantwortet, etwa beim Entladen. Die Antworten bilden das Aktionsergebnis: ob die Aufgabe erledigt wurde, warum nicht, Anmerkungen, Fotos und Unterschriften. Antworten können auch den Auftrag aktualisieren, zum Beispiel die Anzahl der tatsächlich geladenen Paletten oder ein neues Lieferdatum.

So funktionieren Fragebögen

• Ihre Plattform hat höchstens einen Fragebogen pro Aktionstyp, zum Beispiel einen für das Beladen und einen für das Entladen. Um die Fragen innerhalb eines Typs zu variieren, verwenden Sie Bedingungen (siehe unten).
• Wenn ein Fahrer eine Aufgabe in OpenMove abschließt, ersetzt der Fragebogen ihres Typs den normalen Ergebnisbildschirm. Siehe Aktionsfragebögen beantworten.
• Derselbe Fragebogen öffnet sich in der geteilten Ausführungsansicht eines Trips, wenn dort jemand eine Aufgabe im Browser abschließt.
• Antworten, die ein Fahrer an einem Bordcomputer gibt, zum Beispiel Transics oder Webfleet, werden denselben Fragen zugeordnet (siehe Antworten vom Bordcomputer unten).
• Ohne Fragebogen wählen Fahrer Erledigt, Teilweise erledigt oder Fehlgeschlagen und geben einen Grund und Anmerkungen ein.

Die Fragebögen öffnen

1. Öffnen Sie das Seitenmenü (☰, oben rechts) und wählen Sie Einstellungen.
2. Klicken Sie auf den Tab Umgebung.
3. Öffnen Sie den Abschnitt Fragebögen zum Aktionsergebnis zwischen Planung und Preise.

Der Abschnitt zeigt die Schaltfläche Mit KI generieren und einen Editor mit den Fragebögen als JSON-Text. Ist noch nichts eingerichtet, enthält der Editor {}.

Fragebögen mit KI erstellen oder ändern

Am schnellsten beginnen Sie, indem Sie beschreiben, was Sie brauchen, oder das Informationsblatt Ihres Bordcomputers hochladen.

1. Klicken Sie auf Mit KI generieren.
2. Fügen Sie optional unter Informationsblatt oder Dokumente (optional) Dateien hinzu: Klicken Sie auf die Büroklammer oder ziehen Sie Dateien darauf. PDF, Word, Excel, CSV, Bilder und andere gängige Formate werden akzeptiert.
3. Beschreiben Sie unter Anweisung, was Sie möchten, zum Beispiel „Beim Entladen eine Schadensfrage mit Foto hinzufügen“ oder „Die Fragebögen aus diesem Transics-Informationsblatt erstellen“.
4. Klicken Sie auf Generieren. Das kann bis zu einigen Minuten dauern.
5. Lesen Sie die angezeigte Zusammenfassung. Aktualisiert: nennt die Aktionstypen, die erstellt oder geändert wurden; die übrigen Aktionstypen bleiben genau so, wie sie waren.
6. Prüfen Sie die neuen Fragebögen im Editor darunter.
7. Klicken Sie unten auf der Seite auf Speichern, um sie zu behalten.

Klicken Sie ohne Anweisung und ohne Dateien auf Generieren, sehen Sie Bitte geben Sie eine Anweisung ein oder laden Sie ein Dokument hoch. Gab es nichts zu ändern, sehen Sie Die KI hat nichts geändert.

Die Fragebögen selbst bearbeiten

1. Tippen Sie den Text im Editor ein oder fügen Sie ihn ein. Mit den Schaltflächen oben im Editor formatieren Sie den Text oder machen eine Änderung rückgängig.
2. Achten Sie auf den Rand des Editors: Ein Fehler im JSON, etwa ein fehlendes Komma oder Anführungszeichen, wird in seiner Zeile markiert. Solange der Text ungültig ist, ist Speichern deaktiviert.
3. Klicken Sie unten auf der Seite auf Speichern.
4. Testen Sie den Fragebogen, indem Sie auf einem Test-Trip eine Aufgabe dieses Typs abschließen (siehe Einen Fragebogen testen unten).

Der Text ist ein Objekt mit einem Eintrag pro Aktionstyp. Jeder Eintrag hat enabled (nur Fragebögen mit true werden verwendet), eine Liste questions und eine Liste resultMappings. Dieses Beispiel fragt, ob eine Entladung gut verlaufen ist, fragt nach einem Grund, wenn nicht, und erfasst eine Unterschrift, wenn ja:

{
  "unload": {
    "enabled": true,
    "questions": [
      {
        "id": "delivered",
        "label": "Were all goods delivered?",
        "type": "select",
        "order": 1,
        "options": [
          { "value": "yes", "label": "Yes", "setsResultStatus": "succeeded" },
          { "value": "partly", "label": "Partly", "setsResultStatus": "partiallySucceeded" },
          { "value": "no", "label": "No", "setsResultStatus": "failed" }
        ]
      },
      {
        "id": "why",
        "label": "What went wrong?",
        "type": "text",
        "order": 2,
        "conditions": [{ "questionId": "delivered", "operator": "notEquals", "value": "yes" }],
        "fieldMapping": { "target": "actionResult", "fieldPath": "reason" }
      },
      {
        "id": "signature",
        "label": "Signature of the receiver",
        "type": "signature",
        "required": false,
        "order": 3,
        "conditions": [{ "questionId": "delivered", "operator": "equals", "value": "yes" }]
      }
    ],
    "resultMappings": []
  }
}

Aktionstypen

Der Schlüssel jedes Eintrags ist der Aktionstyp, für den er gilt:

Schlüssel	Aufgabe
load	Beladen
unload	Entladen
attachTransportEquipment	Ankoppeln eines Aufliegers oder Containers
detachTransportEquipment	Abkoppeln eines Aufliegers oder Containers
genericAction	Allgemeine Aktion
refuel, customs, weighing, wait, break	Tanken, Zoll, Wiegen, Warten und Pausen

Fragen

Einstellung	Wirkung
id	Ein innerhalb des Fragebogens eindeutiger Name für die Frage, etwa delivered. Bedingungen und Ergebniszuordnungen verweisen darauf. Ändern Sie ihn nicht mehr, sobald Fahrer geantwortet haben.
label	Die Frage, die der Fahrer sieht.
type	Die Art der Antwort (siehe die nächste Tabelle). Ohne Typ ist die Frage eine Textfrage.
required	Ob der Fahrer antworten muss, bevor er abschließen kann. Eine Frage ist Pflicht, außer Sie setzen "required": false.
order	Die Position im Fragebogen, die niedrigste zuerst.
description, placeholder	Hilfetext unter der Frage und der graue Text in einem leeren Feld.
options	Die Auswahlmöglichkeiten einer Auswahlfrage, jeweils mit einem value (gespeichert) und einem label (angezeigt). Eine Option kann auch das Ergebnis setzen (siehe Das Ergebnis festlegen) oder mit nextQuestionId eine andere Frage zu ihrer Folgefrage machen.
conditions	Wann die Frage angezeigt wird (siehe Eine Frage nur anzeigen, wenn sie zutrifft).
validation	Grenzen für die Antwort: minLength und maxLength (Zeichen), min und max (Zahlen, einschließlich) und decimals (Stellen nach dem Dezimaltrennzeichen).
fieldMapping	Wohin die Antwort geschrieben wird (siehe Antworten in den Auftrag schreiben).
externalIds	Die Codes, die ein Bordcomputer für diese Frage verwendet (siehe Antworten vom Bordcomputer).

Fragetypen

Typ	Der Fahrer
text	Gibt freien Text ein.
number	Gibt eine Zahl ein. Sowohl 12,5 als auch 12.5 werden akzeptiert.
select	Wählt eine Option.
multiSelect	Hakt eine oder mehrere Optionen an.
boolean	Nutzt einen Ja/Nein-Schalter. Die Antwort wird als true oder false gespeichert.
date, datetime	Wählt ein Datum oder ein Datum mit Uhrzeit.
photo	Macht ein Foto oder wählt eines vom Telefon.
signature	Lässt jemanden auf dem Bildschirm unterschreiben.
message	Liest eine Anweisung, etwa „Fotos der Plombe machen“. Sie braucht keine Antwort. Fügen Sie "messageState": "important" hinzu, um sie als Achtung statt Info anzuzeigen.

Eine Frage nur anzeigen, wenn sie zutrifft

Geben Sie einer Frage conditions, um sie nur in bestimmten Fällen anzuzeigen. Eine Frage mit mehreren Bedingungen wird nur angezeigt, wenn alle erfüllt sind. Eine ausgeblendete Frage ist nie Pflicht, und ihre Antwort wird nicht verwendet.

Eine Bedingung vergleicht die Antwort auf eine frühere Frage mit einem value:

Operator	Erfüllt, wenn die Antwort
equals / notEquals	genau dem Wert entspricht / ihm nicht entspricht. Verwenden Sie für Ja/Nein-Fragen "true" oder "false".
contains	den Wert enthält.
greaterThan / lessThan	eine Zahl über / unter dem Wert ist. Der Wert muss eine Zahl sein.
isEmpty / isNotEmpty	leer ist / gegeben wurde. Diese brauchen keinen Wert.

Eine Bedingung kann statt einer Antwort auch den Auftrag prüfen. Setzen Sie "source": "field", ein target (action oder consignment) und einen fieldPath, mit denselben Pfaden wie in Antworten in den Auftrag schreiben. Fragen Sie zum Beispiel nur dann nach der Aufliegertemperatur, wenn die erste Warenzeile der Sendung ein Kennzeichen hat:

"conditions": [{ "source": "field", "target": "consignment", "fieldPath": "goods.0.licensePlate", "operator": "isNotEmpty" }]

So deckt ein Fragebogen mehrere Varianten derselben Aufgabe ab, etwa für verschiedene Abteilungen oder Kunden. Lässt sich das Feld gar nicht lesen, wird die Frage angezeigt.

Für „diese Frage erst nach jener Antwort“ geben Sie der Option stattdessen eine nextQuestionId. Die genannte Frage wird zur Folgefrage: Sie wird erst angezeigt und ist erst Pflicht, wenn diese Option oder eine andere Option, die auf sie verweist, gewählt ist. Ihre eigenen Bedingungen gelten weiterhin.

Das Ergebnis festlegen

Die Antworten bestimmen das Ergebnis der Aufgabe. Transportial prüft in dieser Reihenfolge und verwendet das Erste, das zutrifft:

1. Ergebniszuordnungen. Der erste Eintrag in resultMappings, dessen conditions alle erfüllt sind, setzt seinen resultStatus und resultReason. Verwenden Sie diese für Kombinationen, etwa „teilweise geliefert und mehr als 5 Stück übrig“.
2. Optionen. Eine gewählte Option mit setsResultStatus setzt diesen Status und setsResultReason den Grund.
3. Standard. Andernfalls ist das Ergebnis Erledigt.

"resultMappings": [
  {
    "conditions": [
      { "questionId": "delivered", "operator": "equals", "value": "partly" },
      { "questionId": "itemsLeft", "operator": "greaterThan", "value": "5" }
    ],
    "resultStatus": "failed",
    "resultReason": "Too many items not delivered"
  }
]

Status	Angezeigt als	Wirkung
succeeded	Erledigt	Keine.
partiallySucceeded	Teilweise erledigt	Zählt als erledigt.
failed	Fehlgeschlagen	Die Sendung muss neu geplant werden.
cancelled	Storniert	Zählt als erledigt.

Was eine fehlgeschlagene Aufgabe auslöst, ist in Status erklärt: Aufträge, Sendungen, Trips und Aktionen beschrieben.

Antworten in den Auftrag schreiben

Ein fieldMapping schreibt die Antwort auf eine Frage in ein Feld. Es hat ein target, einen fieldPath und optional eine strategy und eine transform.

Ziel	Feldpfade
actionResult	reason und remark des Ergebnisses. requestedRescheduleAt erfasst ein neues, vom Empfänger gewünschtes Datum, was die Neuplanung auslöst. Jeder andere Name wird unter diesem Namen beim Ergebnis gespeichert.
action	startTime, endTime, eta, etd, remark, duration (Sekunden) und externalAttributes.<name>. Bei einer Fotofrage fügt documents das Foto den Dokumenten der Aufgabe hinzu, wo Disponenten es auf der Aktionskarte sehen.
consignment	remark, description, constraints.delivery.startingDateTime, constraints.delivery.endingDateTime und externalAttributes.<name>. Waren: goods.<field> (jede Warenzeile), goods.0.<field> (die erste Zeile, gezählt ab 0) oder goods.0.containedGoods.1.<field> (das zweite Stück im ersten Auflieger oder Container). Warenfelder: quantity, name, description, remark, barCode, weight, grossWeight, loadMeters und für Auflieger und Container licensePlate, seal und equipmentId.

Die strategy bestimmt, was mit der Antwort geschieht:

Strategie	Wirkung
overwrite (Standard)	Ersetzt das Feld durch die Antwort.
recordDifference	Lässt das Feld unverändert. Weicht die Antwort davon ab, erfasst das Ergebnis eine Abweichung, etwa 33 gemeldete Paletten, wo der Auftrag 32 nennt. Verwenden Sie dies, um den Auftrag zu prüfen, statt ihn zu ändern.
appendComment	Fügt der Anmerkung des Ziels eine Zeile „Frage: Antwort“ hinzu.

Antworten werden so geschrieben, wie sie gegeben wurden. Um ein Datum in einem anderen Format zu schreiben, fügen Sie "transform": { "type": "dateParse", "format": "dd-MM-yyyy HH:mm" } hinzu; "type": "addDuration" macht aus einer Anzahl Sekunden einen Zeitpunkt, der so weit nach jetzt liegt.

Antworten vom Bordcomputer

Fahrer mit einem Bordcomputer beantworten Fragen auf diesem Gerät. Transportial ordnet diese Antworten Ihrem Fragebogen über externalIds zu: pro System (transics oder webfleet) der Code, den der Bordcomputer sendet. Antworten auf Fragen ohne Zuordnung werden nicht auf den Fragebogen angewendet.

• Transics. Verwenden Sie den Code aus den „Info columns“ Ihres Informationsblatts, etwa SNR für eine Plombennummer. Hat eine Frage keinen Code, verwenden Sie ihre genaue Beschreibung aus dem Blatt. Geben Sie Optionen beide Kodierungen: den Antworttext als value und den Antwortcode in eigenen externalIds.
• Webfleet. Verwenden Sie den Namen des Felds in der Auftragsnachricht.

{
  "id": "seal",
  "label": "Seal number?",
  "type": "text",
  "required": false,
  "externalIds": { "transics": "SNR" },
  "fieldMapping": { "target": "consignment", "fieldPath": "goods.0.seal", "strategy": "recordDifference" }
}

Antworten vom Bordcomputer kommen einzeln an. Pflichtfragen können daher unbeantwortet bleiben, und eine ungültige Antwort wird übersprungen, statt den Rest abzulehnen. Das Ergebnis ändert sich nur, wenn eine Antwort eines setzt.

Standardmäßig wird außerdem jede Antwort des Fahrers bei der Aufgabe angezeigt, auch Antworten, für die Sie keine Frage haben. Um nur zugeordnete Antworten zu erfassen, schalten Sie in der Bordcomputer-Integration Alle Antworten des Bordcomputers erfassen aus. Siehe Bordcomputer.

Auf Abweichungen reagieren

Wenn eine Antwort eine Abweichung erfasst oder eine Antwort vom Bordcomputer als ungültig übersprungen wird, löst Transportial das Ereignis Nach einem Fragebogen-Konflikt aus. Wählen Sie es als Auslöser eines Workflows, einer Warnregel oder einer Nachrichtenautomatisierung, zum Beispiel um den Disponenten oder den Kundenservice zu benachrichtigen. Siehe Arbeit mit Workflows automatisieren und Warnungen und Warnregeln einrichten.

Einen Fragebogen testen

1. Legen Sie einen Test-Trip mit einer Aufgabe dieses Aktionstyps an und starten Sie den Trip.
2. Klicken Sie auf dem Trip auf das Symbol Ausführungsansicht teilen, um den Link zu kopieren, und öffnen Sie ihn in einem neuen Browser-Tab.
3. Klicken Sie bei der Aufgabe auf Start und dann auf Abschließen.
4. Beantworten Sie die Fragen und prüfen Sie, ob Folgefragen erscheinen, wenn sie sollen.
5. Klicken Sie auf Abschließen und prüfen Sie das Ergebnis bei der Aufgabe im Trip. Siehe Aktionsergebnisse lesen.

Fehlerbehebung

• Der Fragebogen erscheint nicht. Prüfen Sie, ob enabled auf true steht, ob der Schlüssel zum Aktionstyp der Aufgabe passt und ob Sie die Einstellungen gespeichert haben.
• Eine Frage erscheint nie. Prüfen Sie ihre Bedingungen: Die questionId muss eine frühere Frage sein, und der value muss genau dem value der Option entsprechen, nicht ihrem Label.
• Der Fahrer kann nicht abschließen. Eine Frage ist Pflicht, außer sie hat "required": false. Ausgeblendete Fragen sind nie Pflicht.
• Das falsche Ergebnis wird gesetzt. Ergebniszuordnungen kommen vor Optionen, und die erste passende Zuordnung gewinnt. Setzen Sie die spezifischste Zuordnung an den Anfang.
• Ein Feld wird nicht aktualisiert. Prüfen Sie den fieldPath anhand der Listen oben, ob die Strategie overwrite ist und ob die Aufgabe zu einer Sendung gehört, wenn das Ziel consignment ist.