Allgemeines

Workflows dienen zum Beispiel der Erstellung von neuen Daten oder zur Modifikation bestehender Daten.

Sie legen eine Abfolge von Schritten fest, die von einem Benutzer ausgeführt werden müssen, damit z.B. ein neues Objekt erfasst werden kann

Beschreibung

Die Definition von Workflows findet in Form von XML-Dateien statt, die im Verzeichnis <GISX3HOME>/definitions/workflows abgelegt werden.

Beim Dateinamen handelt es sich hierbei um die ID des Workflows. Groß- und Kleinschreibung von Datei und Unterverzeichnisnamen sind hier relevant. Als Verzeichnisebenentrenner wird bei der ID-Generierung "." verwenden. (Der Workflow in der Datei <GISX3HOME>/definitions/workflows/example/Test.xml kann über die ID "example.Test" angesprochen werden.) Es gelten die allgemeinen Hinweise zur Benamung.

Im folgenden Beispiel wird ein Workflow zur Erfassung einer Beschwerde gezeigt:

<?xml version="1.0" encoding="UTF-8"?>
<SimpleCreationWorkflow
	xmlns="http://www.geograt.de/namespaces/gisx3/workflowdefinition/1.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<title>Beschwerde erfassen</title>
	<theme>gisx3:beschwerden</theme>
	<steps>
		<geometryStep>
			<title>Punkt wählen</title>
			<description>Wählen Sie eine Koordinate, die den Ort des Problems beschreibt.</description>
			<geoType>Point</geoType>
			<targetAttribute>geometry</targetAttribute>
		</geometryStep>
		<dataStep>
			<title>Details zur Beschwerde</title>
			<description>Geben Sie den Grund der Beschwerde und Ihre Kontaktdaten zwecks Rückmeldung an.</description>
			<createFormId>BeschwerdeErfassen</createFormId>
		</dataStep>
	</steps>
	<afterCreate>
		<showMap>
			<mapId>issues</mapId>
		</showMap>
		<showDialog />
	</afterCreate>
</SimpleCreationWorkflow>

Basiselement eines Workflows ist "SimpleCreationWorkflow". Als Namespace ist "http://www.geograt.de/namespaces/gisx3/workflowdefinition/1.0" zu verwenden.

SimpleCreationWorkflow

SimpleCreationWorkflow dient der generellen Beschreibung eines Erfassungsworkflows und kann mehrere Schritte ("steps") definieren.

Folgende Attribute sind zu verwenden:

MultiCreationWorkflow

MultiCreationWorkflow dient der generellen Beschreibung eines Erfassungsworkflows und kann dazu verwendet werden Datensätze in mehreren Themen zu erzeugen.

Hiermit kann zum Beispiel ein Workflow definiert werden, der einen Baum anlegt, die erste Baumkontrolle dazu und (optional) mehrere Pflegemaßnahmen dazu.

MultiCreationWorkflowPart

MultiCreationWorkflowPart beschreibt einen auszuführende Bestandteil.

WorkflowValue

WorkflowValue beschreibt die Verwendung eines Attributes eines Datensatzes das durch einen vorherigen Bestandteil erzeugt wurde als Attribut im Datensatz des aktuellen Bestandteils.

Hierdurch ist es z.B. möglich im Bestandteil zur Erfassung einer Baumkontrolle die ID des Baumes (der im vorherigen Bestandteil erfasst wurde) zu erfragen und für die Erzeugung zu verwenden.

Einzelne Datentypen

Die folgenden Datentypen werden von unterschiedlichen Workflows verwendet. Der Aufbau ist immer gleich.

featureSelectStep

featureSelectStep beschreibt die Auswahl eines Features

geometryStep

geometryStep beschreibt die Erfassung einer Geometrie

dataStep

dataStep beschreibt die Erfassung von Sachdaten. Es stehen folgende Attribute zur Auswahl:

showMap

showMap beschreibt dass nach der erfolgreichen Durchführung des Workflows (bzw. nach erfolgreicher Erzeugung eines Features) eine Karte angezeigt bzw. aktualisiert werden soll.

showDialog

showDialog beschreibt dass nach der erfolgreichen Durchführung des Workflows (bzw. nach erfolgreicher Erzeugung eines Features) ein Dashboard mit dem erzeugten Feature aufgerufen wird.

Es wird hierbei das in der Themendefinition festgelegte Dashboard aufgerufen.

Beispiel

Im folgenden Beispiel ist ein Workflow definiert der es erlaubt einen Baum zusammen mit einer Baumkontrolle zu erfassen. Optional können außerdem Pflegemaßnahmen vergeben werden:

<?xml version="1.0" encoding="UTF-8"?>
<MultiCreationWorkflow
	xmlns="http://www.geograt.de/namespaces/gisx3/workflowdefinition/1.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<title>Baum mit Baumkontrolle erfassen</title>
	<part>
		<min>1</min>
		<max>1</max>
		<theme>gisx3:tree.trees</theme>
		<steps>
			<geometryStep>
				<title>Punkt wählen</title>
				<description>Bitte setzen Sie den Baumstandort.
			</description>
				<geoType>Point</geoType>
				<targetAttribute>geometry</targetAttribute>
			</geometryStep>
			<dataStep>
				<title>Bestandsdaten zum Baum</title>
				<description>Bitte geben Sie hier die Bestandsdaten des Baumes an.</description>
				<createFormId>tree.form-treeBaseDataCreate</createFormId>
			</dataStep>
		</steps>
	</part>
	<part>
		<min>1</min>
		<max>1</max>
		<theme>gisx3:tree.treeInspection</theme>
		<steps>
			<dataStep>
				<title>Grunddaten zur Baumkontrolle</title>
				<description>Bitte geben Sie hier die Grunddaten der Baumkontrolle an.</description>
				<createFormId>tree.inspection.form-baseData</createFormId>
			</dataStep>
		</steps>
		<workflowValue>
			<featureIndex>0</featureIndex>
			<sourceAttributeName>id</sourceAttributeName>
			<targetAttributeName>treeId</targetAttributeName>
		</workflowValue>
	</part>
	<part>
		<min>0</min>
		<theme>gisx3:tree.treeCarePlannedTask</theme>
		<steps>
			<dataStep>
				<title>Pflegemaßname</title>
				<description>Bitte geben Sie eine Pflegemaßnahme an</description>
				<createFormId>tree.treeCarePlannedTask</createFormId>
			</dataStep>
		</steps>
		<workflowValue>
			<featureIndex>0</featureIndex>
			<sourceAttributeName>id</sourceAttributeName>
			<targetAttributeName>treeId</targetAttributeName>
		</workflowValue>
	</part>
	<afterCreate>
		<showMap>
			<mapId>map-trees</mapId>
		</showMap>
	</afterCreate>
</MultiCreationWorkflow>

Besondere Bedeutung haben hierbei die Werte zu "workflowValue".

Sowohl für die Baumkontrolle als auch für die Pflegemaßnahme ist es notwendig dass die ID des zugehörigen Baumes bei Erzeugung mit angegeben wird.

Da diese aber zum Zeitpunkt der Erfassung noch unbekannt ist, wird sie mittels "workflowValue" direkt vom Baum genommen der im ersten Bestandteil erzeugt wurde.