Verstehen von Wörterbuchaktionen in SharePoint Designer 2013
Der Variablentyp "Wörterbuch" ist ein neuer Variablentyp in der Workflowplattform von SharePoint, die Sie mit SharePoint Designer 2013 verwenden können.
Hinweis
SharePoint 2010-Workflows wurden am 1. August 2020 für neue Mandanten eingestellt und am 1. November 2020 aus bestehenden Mandanten entfernt. Wenn Sie SharePoint 2010-Workflows verwenden, empfehlen wir die Migration zu Power Automate oder anderen unterstützten Lösungen. Weitere Informationen hierzu finden Sie unter Einstellung von SharePoint 2010-Workflows.
Grundlegendes zum Variablentyp "Wörterbuch"
Ein Workflow ist eine Folge von Aktionen, die zu einem gewünschten Ergebnis führen. Beim Erstellen eines Workflows müssen Sie häufig Werte für die Verwendung in anderen Teilen des Workflows in einer Variablen (Speichercontainer) speichern.
Wenn Sie eine Variable erstellen, müssen Sie der Workflow-Engine mitteilen, welcher Datentyp in der Variablen enthalten sein wird. Beispielsweise können Sie den Namen eines Mitarbeiters in einer Variablen speichern. Der Name eines Mitarbeiters ist eine Zeichenfolge von Zeichen, sodass Sie eine Variable vom Typ String erstellen würden. Der Workflow könnte dann den Namen des Mitarbeiters, z. B. "John Doe", in der Variablen speichern.
Abbildung: Eine Zeichenfolgenvariable
SharePoint Designer 2013 verfügt über einen neuen Variablentyp Wörterbuch. Der Variablentyp Wörterbuch ist ein Container, der eine Auflistung von anderen Variablen enthalten soll. In Ihrem Workflow muss möglicherweise mehr als nur der Name des Mitarbeiters gespeichert werden. Sie müssen möglicherweise auch seine Adresse und sein Geburtsdatum speichern. Wenn Sie keine Wörterbuch-Variable verwenden, müssen Sie mehrere eigenständige Variablen erstellen. Dies kann schnell zu Schwierigkeiten in der Organisation und bei der Verwendung in der Workflowlogik führen. Eine Wörterbuch-Variable ermöglicht es, mehrere Datenpunkte in einer Variablen zu speichern.
Die Abbildung veranschaulicht das Konzept.
Abbildung: Eine Wörterbuchvariable
Workflowaktionen für den Variablentyp "Wörterbuch"
Ein Workflow besteht aus mehreren Aktionen, die während der Verarbeitung des Workflows ausgeführt werden. SharePoint Designer 2013 enthält viele verschiedene Aktionen. Beispielsweise gibt es eine Aktion zum Senden einer E-Mail, zum Erstellen eines Listenelements und zum Protokollieren von Nachrichten im Workflowverlauf.
Im Folgenden sind die drei Aktionen aufgeführt, die speziell für den Variablentyp Wörterbuch entwickelt wurden.
Wörterbuch erstellen
Elemente in einem Wörterbuch zählen
Ein Element aus einem Wörterbuch abrufen
Die Workflowaktionen für den Variablentyp Wörterbuch finden Sie in der Dropdownliste Aktion, wie in der Abbildung dargestellt.
Abbildung: Wörterbuchaktionen
Erstellen von Variablen mit der Aktion "Wörterbuch erstellen"
Sie verwenden die Aktion Wörterbuch erstellen, um eine Variable vom Typ Wörterbuch zu erstellen. Sie geben den Inhalt des Wörterbuchs ein und geben dann den Namen des Wörterbuchs in der Variablenliste an.
Die Abbildung zeigt das Dialogfeld Wörterbuch erstellen. Beachten Sie, dass dem Wörterbuch drei Variablen hinzugefügt wurden: eine Zeichenfolge, eine ganze Zahl und eine Datum/Uhrzeit-Variable.
Abbildung: Das Dialogfeld "Wörterbuch erstellen"
Ein Wörterbuch kann jeden Typ von Variable enthalten, der in der SharePoint-Workflowplattform verfügbar ist. In der folgenden Liste werden die verfügbaren Variablentypen definiert:
Boolean: Ein Ja/Nein-Wert Wert
Date/Time: Datum und Uhrzeit
Dictionary: Eine Auflistung von Variablen
Guid: Eine GUID (Globally Unique Identifier)
Integer: Eine ganze Zahl ohne Dezimalstellen
Number: Eine Zahl, die Dezimalstellen enthalten kann
Zeichenfolge: Eine Folge aus Zeichen
Wichtig: Der Variablentyp Wörterbuch ist wichtig bei der Verwendung der Aktion HTTP-Webdienst aufrufen.
Vorsicht: Sie können das Feld Name nur für die Suche verwenden, wenn Sie einen Wert in einem Wörterbuch festlegen. Wenn Sie ein Wörterbuch aufbauen, wird das Feld Name nicht für die Suche unterstützt.
Hinweis
Eine Wörterbuch-Variable kann eine Variable vom Typ Wörterbuch enthalten. Die Möglichkeit zum Speichern von Wörterbuch-Variablen innerhalb einer Wörterbuch-Variablen bietet eine Reihe von Vorteilen. Sie können z. B. ein Wörterbuch zum Speichern von Informationen zu Mitarbeitern erstellen. In diesem Wörterbuch könnten Sie einen weiteren Wörterbuch-Eintrag für jeden Mitarbeiter erstellen. Bei der Erstellung des Workflows können Sie die Wörterbuch-Variable verwenden, statt ständig neue eigenständige Variablen für die einzelnen Informationsarten zu jedem Mitarbeiter zu erstellen. Wie in diesem Beispiel dargestellt, kann ein Wörterbuch zum Organisieren komplexer Informationen innerhalb des Workflows verwendet werden.
Ermitteln und Speichern von Variablen mit der Aktion „Elemente in einem Wörterbuch zählen“
Mit der Aktion Elemente in einem Wörterbuch zählen zählen Sie die Variablen, die ein Wörterbuch enthält, und speichern diese Zahl dann in einer ganzzahligen Variablen. Anschließend können Sie die Anzahl von Elementen zum Durchlaufen des Wörterbuchs verwenden.
Die Abbildung zeigt die Workflowaktion Elemente in einem Wörterbuch zählen.
Abbildung: Elemente in einem Wörterbuch zählen
Abrufen von Variablen mit der Aktion "Ein Element aus einem Wörterbuch abrufen"
Mit der Aktion Ein Element aus einem Wörterbuch abrufen rufen Sie eine im Wörterbuch gespeicherte Variable ab und platzieren sie in einer Variablen. Dies ist hilfreich, wenn Sie einen Wert aus dem Wörterbuch in einer eigenständigen Variablen gespeichert benötigen. Sie können einen Wert durch Eingeben des Namens der Variablen abrufen.
Die Abbildung zeigt die Workflowaktion Ein Element aus einem Wörterbuch abrufen. Beachten Sie, dass Age der Name der Variablen im Wörterbuch ist, die in eine neue Integer-Variable ausgegeben wird.
Abbildung: Ein Element aus einem Wörterbuch abrufen
