Workflow Konfiguration
In diesem Beispiel wird ein Report innerhalb eines Workflows ausgeführt und die erzeugte Datei per EMail versendet. Navigieren Sie dafür im Administrationsbereich in das Workflow Studio und starten Sie es (Abbildung 1: Workflow Studio ).
Erstellen Sie einen neuen Workflow oder wählen Sie einen bestehenden Workflow aus, in dem Sie die erzeugte Report Datei verwenden möchten (Abbildung 2: Neuen Workflow erstellen) und öffnen Sie anschließend den Bearbeitungsdialog des Workflows.
Auf der linken Seite erreichen Sie die Report Activity über den Reiter Labtagon oder über die Suche. Ziehen Sie die Report Activity an die gewünschte Stelle im Workflow und verbinden Sie diese wie gewünscht (Abbildung 3: Report Activity).
Wählen Sie die Report Activity mit einem Linksklick aus. Auf der rechten Seite erscheint nun das Eigenschaften Panel, in dem Sie die Konfiguration vornehmen können. Üner die Schaltfläche […] gelangen Sie in den Bearbeitungsdialog der einzelnen Attribute (Abbildung 4. Report Activity Konfiguration). Die Konfiguration ist zunächst sehr ähnlich zu der des Web Services. Es müssen Parameter für den „FileName“, „FileType“, „Parameters“, „ReportName“, „ReportPath“ und die „ReportServerUrl“ übergeben werden.
Den FileType kann man über eine Auswahlliste auswählen. Die anderen Parameter können durch einen Ausdruck oder durch eine Workflow-Variable befüllt werden.
Im Unterschied zu dem Web Service, kann man in der Activity konfigurieren, ob die erzeugte Datei an ein Matrix Objekt als Attachment angehangen werden soll. Hierzu setzt man den Haken „Attach to Objects“, gibt das Konfigurationselement ein und übergibt eine Liste von [Expression-ObjectID]‘s, an die der Anhang hochgeladen werden soll. (Die Liste kann auch nur ein Objekt enthalten)
Vorsicht: Falls der Haken nicht gesetzt ist, wird auch kein Attachment erstellt.
Konfigurieren Sie die Parameter wie in Abbildung 5: Parameter Konfiguration.
Erstellen Sie unter Output eine neue Variable für die Report Datei (Abbildung 6: Report Activity Output).
Die Activity gibt zwei Parameter zurück:
- File: Diese Variable stellt ein Objekt dar, welches Informationen über die Datei enthält. Auf diese Informationen kann über Objekteigenschaften zugegriffen werden. Folgende Eigenschaften sind enthalten:
- FileName (Enthält den Dateinamen)
- MimeType (Enthält den MimeType der Datei)
- Extension (Enthält die Dateityperweiterung)
- Encoding (Enthält das Encoding mit dem die Datei encodiert wurde)
- MatrixFileId (Enthält eine GUID, die auf die „Files“ Tabelle in Matrix zeigt)
- FileData (Enthält die Datei als Byte Array)
- Warnings (Enthält eventuelle Warnungen, die vom Report Server ausgegeben wurden)
- MatrixFileId: Diese Variable enthält die GUID der Datei, die in der „Files“-Tabelle von Matrix abgelegt wurde. (Identisch mit der File.MatrixFileId Eigenschaft)
Wählen Sie unter Attachments nun die Variable aus, die Sie in der Report Activity konfiguriert haben, aus und bestätigen Sie die Eingabe mit einem Klick auf OK (Abbildung 8: Anhang an E-Mail knüpfen).
Damit haben Sie den Workflow eingerichtet. Speichern Sie Ihre Einstellungen und testen Sie Ihren Workflow, um sicherzugehen, dass alles wie erwartet funktioniert. Fertig!