State Machine Workflow mit InfoPath Formularen für SharePoint 2010 Teil 6

Transkript

1 State Machine Workflow mit InfoPath Formularen für SharePoint 2010 Teil 6 Abstract: Im sechsten Teil der Workflow Serie verbinden wir die Formulare aus dem vorigen Teil mit unserem Workflow. Teil 6: InfoPath Formulare mit dem Workflow verbinden Nachdem wir im letzten Teil die InfoPath Formulare erstellt haben, können wir diese nun mit dem Workflow verbinden. Die generelle Vorgehensweise für die Erweiterung des Workflows mit InfoPath Formularen ist dabei wie folgt: 1. Aufnehmen der veröffentlichten Formulare in den Workflow Ordner in Visual Studio 2. Anpassen der Datei Elements.xml des Workflows mit den Formular-IDs 3. Anpassen des Workflows Features, mit den Information für das globale Bereitstellen als Workflow freigeschaltete Formulare Aufnehmen der veröffentlichten Formulare in den Workflow Ordner in Visual Studio Da wir die Formulare in unserem vorigen Teil der Serie bereits in den Workflow Ordner des Projektes veröffentlicht haben, können wir diesen nun ins Projekt mit aufnehmen (Rechte Maustaste auf den Workflow-Ordner in Visual Studio und Add -> Existing Item):

2 Dann die beiden Formulare auswählen und Add anklicken. Damit sind die beiden Formulare dann dem Workflow-Ordner hinzugefügt worden: Das alleine reicht aber noch nicht. Man muss die Formulare dem Workflow noch in der Datei Elements.xml bekannt machen. Nachdem die Dateien hinzugefügt sind, sind diese noch als ElementFile zu kennzeichnen. Dies erreicht man durch Anklicken des jeweiligen Formulars und Auswahl von ElementFile in der Eigenschaft Deployment Type: Anpassen der Datei Elements.xml des Workflows mit den Formular-Ids Die Datei Elements.xml befindet sich ebenfalls im Workflow Ordner von Visual Studio:

3 In dieser Datei sind bereits das Zuweisungs- und Startformular eingetragen (AssociationUrl und InstantiationUrl). Die beiden Aufgabenformulare (Task Form) fehlen aber noch. Im Kommentar in dieser XML-Datei sieht man die URN auf das Task Formular benötigt: Die Frage ist nur, wo man diese herbekommt? Man die URN aus den Eigenschaften des InfoPath Formulars auslesen. Hierzu wieder das Approver Formular im Explorer mit rechter Maustaste und Auswahl von Design öffnen: Dann den Reiter File (Datei) auswählen und im rechten Teil kann man die Form Template Properties aufrufen:

4 Im Feld ID steht die gesuchte URN und kann von dort aus kopiert werden: Diese URN trägt man dann in die Elements.xml für das Element <Task0_FormURN> ein. Die gleiche Prozedur macht man für das Formular des Initiators (Reviewer.xsn) für das Element

5 <Task1_FormURN>. Die Kommentare kann man dabei getrost entfernen. Meine Elements.xml Datei sieht nun wie folgt aus: Eine wichtige Sache müssen wir allerdings noch eintragen: den Inhaltstyp der Aufgabenliste, die wir für das Anlegen der jeweiligen Aufgaben im Workflow nutzen wollen. Wir müssen also im Element <Workflow> ein Attribut TaskListContentTypeId mit der ID des entsprechenden Inhaltstyps eintragen: TaskListContentTypeId="0x C9C9515DE4E F980F93160" Die fertige Elements.xml sieht danach wie folgt aus: Die Formulare sind dem Workflow nun bekannt. Jetzt müssen wir noch dafür sorgen, dass die Formulare auch global zur Verfügung stehen und als Workflow Formulare gekennzeichnet sind. Anpassen des Workflows Features, mit den Information für das globale Bereitstellen als Workflow freigeschaltete Formulare Das Hochladen als globales Formular und Kennzeichnen als Workflow Formular erfolgt mit Hilfe eines sog. Feature Receivers. Aber keine Angst, wie müssen diesen nicht selbst schreiben. Er steht bereits

6 zur Verfügung. Wir müssen ihn nur noch im Feature mit angeben. Zuerst benennen wir aber das Feature um (rechte Maustaste auf Feature1 und Auswahl von Rename) und geben ihm den Namen StateMachineApproval: Ein Doppelklick auf das soeben umbenannte Feature bringt uns in die Eigenschaften des Features. Hier kann man noch einen vernünftigen Titel und eine Beschreibung vergeben. In der Mitte findet man den Punkt Manifest: Nach dem Anklicken brauchen wir die Edit Options. Das ist die Stelle an der wir die Feature Definition mit unseren eigenen Angaben erweitern können:

7 Wir müssen hier 2 Dinge erweitern: 1. Den Feature Receiver eintragen 2. Die Formulare als globale Formulare registrieren Die Edit Optionen sehen mit diesen Änderungen wie folgt aus: <?xml version="1.0" encoding="utf-8"?> <Feature ReceiverAssembly="Microsoft.Office.Workflow.Feature, Version= , Culture=neutral, PublicKeyToken=71e9bce111e9429c" ReceiverClass="Microsoft.Office.Workflow.Feature.WorkflowFeatureReceiver" xmlns=" <Properties> <Property Key="GloballyAvailable" Value="true" /> <Property Key="RegisterForms" Value="SMApprovalWorkflow\*.xsn" /> </Properties> </Feature> Und das Ganze noch als Screenshot:

8 Unsere Formulare sind jetzt mit dem Workflow verbunden. Im nächsten Teil fügen wir den notwendigen Code ein, damit der Workflow richtig verzweigt und dass entsprechende Aufgaben für jeweiligen Personen im Workflow angelegt werden.