Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

Hier können Sie Ihre benutzerdefinierten Tour Workflows anlegen, bearbeiten und verwalten. Um dieses Modul nutzen zu können, muss für Ihre Firma das Modul "Touren" freigeschaltet sein und Sie müssen das Portalrecht "Aufträge/Nachrichten konfigurieren" besitzen.

Panel
titleInhaltsverzeichnis

Table of Contents

Was ist ein Workflow?

Eine Tour besteht aus Zielen die der Fahrer anfahren soll und Sendungen, die dabei auszuführen sind. Wenn Sie eine Tour an ein Display übermitteln, so kommt diese zunächst als einfache Menge an Daten an, ohne Vorgabe, wie diese zu bearbeiten sind. Workflows geben Ihnen die Möglichkeit, Arbeitsabläufe zu definieren und Ihren Fahrern somit die Arbeit zu erleichtern. Ein Workflow besteht aus einer Menge an Statusmeldungen, die in Abhängigkeit zueinander stehen. So können Sie beispielsweise definieren, dass ein 'Tour beendet' Status erst gedrückt werden darf, nachdem 'Tour gestartet' gedrückt wurde. Ebenso können Sie die Abarbeitungsreihenfolge der einzelnen Ziele und Sendungen vorgeben, sowie weitere Aktionen an das Auslösen eines Status binden.

Ein Workflow wird jeweils an ein einzelnes Element der Tour gebunden, d.h. entweder an eine Tour, ein Ziel oder eine Sendung. Ein Workflow ist universell einsetzbar, sie müssen zuvor nicht definieren für welche Art von Element er gelten soll. Die Angabe eines Workflow ist nicht verpflichtend. Ebenso können Sie Workflows auch nur an eine einzelne Elemente der Tour anhängen und andere freilassen.

Da Workflows eigene Statusmeldungen definieren, wird damit die Standard-Tourstatuskonfiguration für das Element, an dem dieser Workflow hängt, überschrieben.


Status

Zentrales Element eines Workflow sind Statusmeldungen. Grundlegend unterscheiden wir zwischen Displaystatus, also Statusmeldungen die vom Fahrer auf dem Display gedrückt werden, und Systemstatus, das sind Status die automatisch z.B. beim Starten der Navigation erzeugt werden. In Ihrem Workflow können Sie beliebig viele Status hinzufügen. Diese sind analog zu Auftrags- und Tourstatus konfigurierbar. Sie können Ihre vordefinierten Statusmeldungen aus diesen Standardkonfigurationen als Vorlage einbinden. Beachten Sie jedoch, dass Änderungen in der Auftragsstatus- bzw. Tourstatusverwaltung keinen Einfluss auf bestehende Workflows haben!


Aktionen

An einen Status können Aktionen gebunden werden. Diese werden ausgelöst, sobald dieser Status auf dem Display gedrückt wurde bzw. der Systemstatus automatisch ausgelöst wurde. Folgende Aktionen sind verfügbar:

AktionBeschreibung
Element aktiv setzenMarkiert dieses Element (z.B. die Tour an der dieser Workflow hängt) als aktiv.
Element beendenMarkiert dieses Element (z.B. die Tour an der dieser Workflow hängt) als beendet.
Kindelemente beendenBeendet alle Kindelemente. (z.B. alle Sendungen eines Ziels an welchem dieser Workflow hängt)
Kindelement öffnenÖffnet das erste Kindelement auf dem Display. ( z.B. das erste Ziel einer Tour ) Nach Abarbeitung eines Kindelementes wird ggf. das nächste geöffnet.
Formular öffnenÖffnet ein benutzerdefiniertes Formular.
Navigation startenStartet automatisch die Navigation.
Folgestatus auslösenLöst einen internen Folgestatus aus. Dieser hat keinen Einfluss auf das Verhalten auf dem Display. Das ist vorwiegend relevant für Schnittstellen.
Web-Url öffnenÖffnet die vorgegebene URL in einem Browser
RTI freigebenSetzt den RTI Freigabestatus des Displays welches die Tour bearbeitet auf "freigegeben".
RTI sperrenSetzt den RTI Freigabestatus des Displays welches die Tour bearbeitet auf "gesperrt".
Trailerprüfung

Funktioniert nur auf Ziel-Ebene: Wenn einem Ziel ein Trailer zugewiesen wurde, so wird bei Auslösen dieser Aktion geprüft, ob der richtige Trailer mit dem Fahrzeug verbunden ist. Wenn dies nicht der Fall ist, wird ein Hinweis auf dem Display angezeigt und ggf. ein Formular geöffnet, sofern ein Formular für diese Aktion ausgewählt wurde. Ein falscher Trailer hält den Fahrer nicht davon ab die Tour fortzusetzen!

Setzt voraus, dass die YellowFox Trailertelematik genutzt wird.


Abhängigkeiten

Eine Abhängigkeit markiert die Reihenfolge zweier Statusmeldungen. Besteht eine Abhängigkeit von Status A zu Status B, so bedeutet dies, dass Status B auf dem Display erst zur Auswahl gestellt wird, wenn der Fahrer zuvor Status A gedrückt hat. Von einem Status aus, können beliebig viele Abhängigkeiten zu anderen Status existieren. Abhängigkeiten sind immer in eine Richtung gerichtet. Sie können auch Schleifen anlegen. Status die initial angezeigt werden sollen, benötigen eine Abhängigkeit vom Start-Knoten aus. Status die als Aktion das Element beenden, zeigen automatisch auf den End-Knoten. Wenn ein Status keine Abhängigkeit zu einem anderen Status oder dem End-Knoten besitzt, so kann das aktuelle Element nicht mehr vom Display aus beendet werden.


Beziehungen von Workflows zu anderen Workflows

Die Workflows der einzelnen Tourebenen sind unabhängig voneinander und verbleiben in ihrem aktuellen Status, auch wenn Sie in andere Tourelemente wechseln. Ein Beispiel: In dem Workflow Ihrer Tour drücken Sie zunächst "Tour Start". Dieser Status führt über eine Aktion dazu, dass das erste Ziel geöffnet wird. Nach Beenden der Ziele kehren Sie in die Tourebene zurück. Sie befinden sich nun immer noch nach dem Status "Tour Start" und müssen den Workflow nicht von vorne starten.


Workflow Übersicht

Initial sehen Sie eine Liste all Ihrer Workflows. Klicken Sie auf einen der Namen, um eine Vorschau zu öffnen. Um den ausgewählten Workflow zu bearbeiten, klicken Sie anschließend auf Bearbeiten. Sie können den Workflow von hier aus auch direkt per Löschen entfernen. Über die Suchleiste oben links, können Sie nach dem Namen eines Workflows filtern.

Workflow anlegen / bearbeiten

Um einen neuen Workflow anzulegen, klicken sie zunächst auf Erstellen. Der Editor startet initial mit einem Start- und Endknoten. Diese Knoten können Sie verschieben, jedoch nicht weiter bearbeiten. Auf der rechten Seite sehen Sie die Meta-Informationen Ihres Workflow. Hier können Sie einen Namen und eine Beschreibung festlegen. Der Name muss eindeutig sein. Weiterhin geben Sie hier die Abarbeitungsreihenfolge des Workflow an. Eine freie Reihenfolge bedeutet, dass alle Kindelemente des Elements an welches dieser Workflow gebunden wurde, in beliebiger Reihenfolge bearbeitet werden können (z.B. Workflow hängt an einem Ziel, dann können die Sendungen beliebig bearbeitet werden). Eine feste Reihenfolge gibt vor, dass der Fahrer die Kindelemente in der vorgegebenen Reihenfolge zu bearbeiten hat (z.B. Workflow hängt an einer Tour, dann muss zunächst Ziel 1, dann Ziel 2 usw. angefahren werden). Unten stehend finden Sie die Option Workflow löschen um diesen Workflow wieder zu entfernen.

Status anlegen

Um einen neuen Status hinzuzufügen, klicken sie links oben in der Werkzeugleiste auf Status hinzufügen. Über das danebenstehende Häkchen können Sie die Liste an vordefinierten Auftrags- und Tourstatus aus Ihren Konfigurationen öffnen. Wählen Sie einen dieser an, um den entsprechenden Status als Vorlage in den Editor zu laden.

Um einen Status zu verschieben, klicken Sie diesen zunächst an. Anschließend können sie durch Ziehen des Icons oben rechts Image Added den Status bewegen. Durch das Anklicken des Status öffnet sich ebenfalls die Detailansicht dessen auf der rechten Seite. Hier sehen Sie alle Meta-Informationen die zu diesem Status gehören. Um diese zu bearbeiten, klicken Sie auf den Button Bearbeiten. Es öffnet sich ein neues Fenster. Klicken Sie auf Übernehmen, um die getätigten Änderungen in den Workflow zu übernehmen und die Ansicht zu aktualisieren. Ein Status ist definiert durch eine ID, eine optionale Kennung, einen deutschen Statustext und beliebig viele Übersetzungen. Weiterhin können Sie eine Farbe definieren. Diese hat ausschließlich Auswirkungen auf die Darstellung im Editor und wird nicht an das Display übertragen. Um die Farbe zu ändern, klicken Sie auf den farbigen Kreis. Dies ist auch direkt in der Seitenleiste möglich. 

Sie können Ihrem Status Eigenschaften zuweisen:

  • wiederholbar: Der Status besitzt eine Abhängigkeit auf sich selbst und kam somit mehrfach gedrückt werden, wenn die entsprechende Stelle im Workflow erreicht wurde.
  • immer erreichbar: Ein solcher Status kann jederzeit gedrückt werden und springt anschließend zur eigentlichen Stelle im Workflow zurück.


Bedingung anlegen

Eine Bedingung definiert einen Entscheidungspfad. Um eine neue Bedingung hinzuzufügen, klicken Sie auf Bedingung hinzufügen in der Werkzeugleiste. Diese verhält sich ähnlich wie ein Status: Sie kann verschoben werden, Sie können Meta-Informationen einsehen und Abhängigkeiten anlegen. Besonders ist das Festlegen eines Typs. Dies definiert die Bedingung die eintreten oder auch nicht eintreten muss damit danach ein bestimmter Pfad im Workflow eingeschlagen wird. Folgende Typen werden aktuell unterstützt:


TypBeschreibung
alle Kindelemente beendetDiese Bedingung prüft, ob alle Kindelemente des Elementes an welchem der Workflow hängt bereits beendet wurden.
TrailerprüfungDiese Bedingung prüft ob der korrekte Trailer an die Zugmaschine gekoppelt ist. Diese Bedingung macht ausschließlich auf Ziel-Ebene der Tour Sinn, da nur hier ein Trailer angehangen werden kann.


Abhängigkeiten die von einer Bedingung weggehen besitzen entsprechend einen Typ. Diesen können Sie festlegen, indem sie die Linie anwählen und den gewünschten Typ in dem Detailfenster rechts anwählen. Anhand dessen entscheidet sich, ob der entsprechende Folgestatus bei Eintreten oder nicht Eintreten angezeigt werden soll.


Aktionen anhängen

Bei Status und bei Bedingungen können Sie Aktionen festlegen. Um eine neue Aktion hinzuzufügen, klicken Sie auf + Aktion. Es öffnet sich ein neues Fenster. Hier können Sie einen Aktionstyp auswählen (siehe oben). Für "Kindelemente beenden" und "Folgestatus auslösen" müssen Sie jeweils den Status angeben, der bei Auslösen dieser Aktion intern gesetzt werden soll. Das hat keine direkten Auswirkungen auf die Anzeige auf dem Display, kann aber beispielsweise per Schnittstelle ausgelesen werden. Für "Formular öffnen" müssen Sie ein entsprechendes Formular auswählen. Mit Ausnahme von "Folgestatus auslösen" können alle Aktionen nur einmalig pro Status an diesen gebunden werden. Klicken Sie auf Übernehmen, um die getätigten Änderungen in den Workflow zu übernehmen und die Ansicht zu aktualisieren. Um eine bestehende Aktion zu bearbeiten, fahren Sie mit der Maus über diese. Hier können Sie erneut das Fenster zum Konfigurieren über das Zahnrad aufrufen oder die Aktion per Papierkorb löschen. Sie haben ebenfalls die Möglichkeit die Aktionen in ihrer Reihenfolge zu bearbeiten, indem Sie auf das Icon links klicken und die Aktion an die entsprechende Stelle ziehen. Über den Button Status löschen können Sie den Status inklusive aller dazugehörigen Abhängigkeiten entfernen. 



Image Added



  Image Added

Abhängigkeit anlegen

Um eine Abhängigkeit zwischen zwei Status anzulegen, aktivieren Sie zunächst das Linien-Werkzeug indem Sie auf den Pfeil Image Added in der Werkzeugleiste klicken. Klicken Sie nun auf den Status von welchem die Abhängigkeit ausgehen soll. Dieser wird nun hervorgehoben. Klicken Sie anschließend auf das gewünschte Ziel. Die Linie wird automatisch angelegt. Rechts öffnet sich anschließend die Detailansicht zu dieser Abhängigkeit. Diese Ansicht erreichen Sie ebenfalls, indem Sie auf eine bestehende Linie in der Zeichenfläche klicken. Unten stehend befindet sich die Schaltfläche Abhängigkeit löschen um die ausgewählte Abhängigkeit wieder zu entfernen. Abhängigkeiten können von jedem Status aus in beliebiger Anzahl angelegt werden, sie sind gerichtet. Vom Start-Knoten aus können nur ausgehende Abhängigkeiten angelegt werden, vom End-Knoten aus nur eingehende. Es kann keine Abhängigkeit direkt vom Start zum Ende gezogen werden.

Um die automatisch angelegte Linie in ihren Zwischenpunkten zu bearbeiten, wählen Sie diese zunächst aus. Klicken und ziehen Sie einen der Punkte, um die Linie zu verschieben. Um einen Zwischenpunkt wieder zu entfernen, klicken Sie auf diesen ohne ihn zu ziehen. Zwischen den manuell gesetzten Punkten wird die Linie weiterhin automatisch gezogen.

Sortierreihenfolge

Über die Sortierreihenfolge können Sie festlegen, in welcher Reihenfolge gleichzeitig erreichbare Status auf dem Display angezeigt werden sollen. Sie erreichen diese Einstellung über die Meta-Informationen des Workflow. Hier finden Sie den Button Anzeigereihenfolge bearbeiten. Es öffnet sich ein neues Fenster. Untereinander werden die entsprechenden Schritte des Workflows aufgeführt und die darauffolgenden Folgestatus. Per Drag-and-Drop können Sie die Reihenfolge für jeden Schritt einzeln anpassen. Klicken Sie anschließend auf Übernehmen.


Speichern

Wenn Sie mit Ihrem Workflow zufrieden sind, klicken Sie oben auf Speichern. Standardmäßig überschreiben Sie damit gegebenenfalls vorhandene Daten dieses Workflows. Sie haben jedoch auch die Möglichkeit den Workflow als Kopie zu speichern. Wichtig ist hierbei, dass Sie der Kopie einen neuen Namen zuweisen. Bevor der Workflow gespeichert wird, wird dieser zunächst validiert. Liegen Probleme vor, so werden diese Ihnen angezeigt. Sie können den Workflow dennoch speichern. Beachten Sie jedoch, dass es möglicherweise zu Problemen kommen kann, wenn ein solcher Workflow anschließend an ein Display übertragen wird.

Über Abbrechen können Sie den Bearbeitungsvorgang ohne Speichern schließen.








Image Added

Workflows nutzen

Workflows sind aktuell ausschließlich über den TourWS nutzbar. Die Doku zum TourWS finden sie hier.

Workflows können nur auf Displays die mindestens die Fleet App Version

...

4.0.6.5 besitzen genutzt werden.

Beispiele

Die Möglichkeiten zum Einsatz von Workflows sind grenzenlos. Hier einige Beispiele wie ein möglicher Ablauf aussehen könnte.

Beladung

Image Added

Lademitteltausch

Image Added

Tagestour inkl. Reinigung

Image Added

Sv translation
languageen

Here you can create, edit and manage your user-defined tour workflows. To use this module your company has to have unlocked the module "tours" and you have to have the portal right "orders/messages configure".

Panel
titleInhaltsverzeichnis

Table of Contents

What is a workflow?

A tour consists of destinations which should be targeted by the driver and shipments, which are to be executed. If you send a tour to a display, it will arrive as a simple mass of data, without any rules how this data is to be handled. Workflows allow you to define work sequences and therefore faciliate your drivers work. A workflow consists of a set of status messages which are dependant on each other. For example you could define that the 'tour end' status can only be pressed if the 'tour start' status was pressed before. Furthermore you are able to define an execution order for destinations and shipments and bind further actions to triggering a status.

A workflow is bind to a single element of the tour, i.e. a tour, a destination or a shipment. A workflow is universally usable, you do not have to set a type of element for it. Assigning a workflow is not mandatory. You might assign a workflow to just some elements and leave others empty.

Since workflows define own status messages, the default tour status configuration of the element to which the workflow is assigned, will be overwritten by it.


Status

The central element of a workflow are status messages. We differ between display status, these are status messages which can be pressed by the driver on the display, and system status, which are generated automatically, e.g. on starting the navigation. You can add an arbitrary amount of status to your workflow. These are defined like your default order- and tour states. You can even use those a templates. But please notice that changes to your default configurations, will not affect your existing workflows!


Actions

Actions can be bind to a status. These will be triggered when the status was pressed on the display resp. the system status was triggered automatically. The following actions are available:

actiondescription
set element activeMarks this element (e.g. the tour to which the workflow is assigned) as active.
set element to doneMarks this element (e.g. the tour to which the workflow is assigned) as deleted.
set child elements to doneEnds all child elements. (e.g. all shipments of a destination to which the workflow is assigned)
open child elementOpen the first child element on the display. (e.g. the first destination of a tour) After finishing the child element the next one will be opened if available.
open formOpen an user-defined form.
start navigationAutomatically start the navigation.
trigger consecutive statusTrigger an internal consecutive status. This does not affect the display output, but might be relevant for interfaces.
open web urlOpen the given URL in a web browser. 
enable RTISets the RTI status of the display which is working on the tour to "unlocked".
deactivate RTISets the RTI status of the display which is working on the tour to "locked".
trailer check

Works only on destination level: If the destination has an assigned trailer, the display will check on trigger of this action if the correct trailer is connected to the vehicle. If this is not the case, the display will show a hint and open a form if a form was selected for the action. An incorrect trailer does not stop the driver to continue the tour!

You have to use YellowFoy trailer telematics for this function.

Dependencies

A dependency marks the order of two status messages. If there is a dependency from status A to status B, this means, that status B will only be available for selection on the display as soon as the driver has pressed status A. There can be an infinite amount of dependencies from a status to others. A single dependency is always unidirectional, but you can define loops. Status which should be shown initially, need a dependency from the start node. Status which own the action 'set element to done' automatically own a dependency directed to the end node as well. If a status does not have a dependency to another status or the end node, the current element can not be set to done from here on.


Relations of workflows to each other

The workflows of the different tour levels are independent and remain in their current state on switch to another tour element. An example: In your tour workflow the first state is "tour start". On click the first destination is opened. After finishing the destinations, you return to the tour level. The current state of this is still after "tour start", you do not restart the workflow.

Workflow overview

Initially a list of all your workflows is displayed. Click on a name to open a preview. Click on edit to start editing. You might also directly delete this workflow by pressing delete. Via the search bar on top left, you can filter the list by the workflows names.

Create/edit workflow

To add a new workflow, press create. The editor will start with a start and end node. These nodes can be dragged but not edited. On the right side you can see the meta information of your workflow. Here you can set a name and description. The name has to be unique among all your workflows. Furthermore you can set the execution order. A free order means that all child elements of the element to which this workflow is bind, can be executed in an arbitrary order (e.g. the workflow is assigned to a destination, then the shipments can be executed in any order). If a workflow is strict ordered, then the child elements have to be executed in the given order (e.g. the workflow is assigned to a tour, then destination 1 has to be done first, then 2 and so on). Below you will find the option delete workflow to remove your workflow.

Create status

To add a new status, click on add status on the left side of the toolbar. Click on the arrow to expand the list of pre-defined order- and tour states of your configurations. Click on of those to load it as a template into your editor.

To move a status, click on it first. After that you can drag-and-drop it by the icon in the top right corner. Clicking the status will also unfold its detail view on the right side. Here you can see all its meta information. To edit this, click on the button edit. A new window will open. Click on apply to apply your changes and refresh the main view. A status is defined by an ID, an optional ident, a german status text and an arbitrary amount of translations. Furthermore you can set a color. This is only relevant for the editor and will not be sent to the display. To change the color, click on the circle. You can also do this directly from the side bar.


You can assign properties to your status:

  • repeatable: This status owns a dependency to itself and can therefore be pressed multiple times once this step of the workflow is reached.
  • always reachable: Such a state can be pressed at any time during the workflow and will return to the actual step of the workflow afterwards.


Add conditions

A condition is a decision path. To create a new condition, click on add condition at the toolbar. Conditions are similar to status: You can move them, you can view detail info and create dependencies. What is special is that you can set a type. This defines the condition that has to be met or not be met in order to go a specific path in the workflow. The following types are supported:


typedescription
all children doneThis condition checks if all child elements of the element to which this worklow is attached are already set to done.
trailer checkThis condition checks if the correct trailer is attached to the towing vehicle. This condition only works if used on destination level of the tour, as this is the only one where you can attach trailers.


Dependencies which are linked from a condition to somewhere else own a type. To set it, click on the line and go to the detail view on the right. The type defines wether the follwoing state should be reached on meeting the condition or not meeting the condition.


Attach actions

Actions can be attached to status as well as conditions. To add a new action, click on +action. A new window will open. You need to set an action type (see above). If you have chosen 'set child elements to done' or 'trigger consecutive status' you will have to define a status as well, which should be set in this moment. This does not affect display output, but can be accessed via interfaces. If you have chosen 'open form' you need to set an user-defined form. Besides 'trigger consecutive status', all action types can only be attached once per status. Click on apply to apply your changes and refresh the main view. To edit an existing action, hover it with your mouse and click on the gear icon or click on the bin to delete it. You can also change the order of your actions by grabbing the icon on the left and drag-and-dropping it to your desired position. By clicking delete status you can delete the status and all its dependencies.

Image Added


Image Added

Add dependencies

To create a dependency between two status, you need to activate the line tool first by clicking on the arrow icon in the toolbar. Now click on the status from which your dependency should start. It will be highlighted. Now select the target. The line will be drawn automatically. The detail view of your new dependency will open on the right. You can also open this view by clicking on an existing line. Here you can find the option delete dependency to remove this line. Dependencies can be created from any status in an arbitrary amount, they are directional. The start node can only be the start of a dependency, the end node can only be the target. You are not able to draw a dependency directly from start to end.

To edit the intermediate points of the automatically generated line, select it first. Drag and Drop one of the highlighted points to move the line. To delete an intermediate point, just click on it without dragging. The manually set points will be connected automatically.


Sorting order

The sorting order defines in which order simultaneously reachable states should be shownon the display. You can reach this option via the meta view of the workflow, here you will find the button edit sorting order. A new window will open. One below the other you will see all states and their corresponding follow-up states. You can edit the order via drag-and-drop for each step. Click on apply if you are done.


Saving

If you are done with editing click on save at the top. By default this will overwrite the old data if given. You can also save your workflow as a copy. Your copy has to have a new name. Before saving the workflow, it will be validated. If there are any problems, these will be displayed. You can save the workflow nevertheless. Please notice that unwanted behaviour might occur if such a workflow is sent to a display.

Via cancel you can stop editing without saving.









Image Added

Use workflows

Currently workflows can only be used via TourWS. You can find the documentation here.

Workflows can only be used on displays with fleet app version 4.0.6.5 and beyond.

Examples

The possibilities in using workflows are infinite. Here are some examples how a workflow might look like.

Loading

Image Added

Load exchange

Image Added

Day tour incl. cleaning

Image Added