SharePoint Activities

Inhaltsverzeichnis

Überblick

Labtagon SharePoint Activities  ist eine Erweiterung für das Matrix42 Workspace Management System. Mit diesen Workflow Activities kann das Matrix42 System mit einem oder mehreren SharePoint Systemen zum bidirektionalen Datenaustausch verbunden werden. Dabei spielt es keine Rolle ob der SharePoint in der Cloud oder im lokalen Rechenzentrum eingesetzt wird.

Die Labtagon SharePoint Activities  ermöglichen es Elemente aus beliebigen SharePoint Listen auszulesen, zu verändern oder zu löschen. Neue Elemente können natürlich auch angelegt werden. Bei der Entwicklung wurde darauf Wert gelegt, dass die Activities sehr einfach zu bedienen sind und sich problemlos in vorhandene Workflows integrieren lassen. Die Inbetriebnahme ist innerhalb von wenigen Minuten erledigt und wird durch mitgelieferte Beispiele erleichtert.

 

Activities

Establish Sharepoint Connection

Diese Activity erstellt eine Verbindung zum SharePoint und speichert diese in eine Variable zur weiteren Verwendung der anderen Activities.

          Parameter Name Beschreibung
1. Connection Variable enthält die Connection und wird für alle weiteren Activities verwendet.
2. Credentials Zusammenfassung der Verbindungsparameter (URL, Username und Passwort),  die nur über die Schaltfläche „Edit Credentials“ eingebeben werden können.

 

 

Edit Credentials

Ändern Sie die URL, die Authentifizierungsart (z.B. SharePoint Online, NTLM), den Benutzernamen und das Passwort. Anschließend können Sie mit der Schaltfläche „Test Credentials“ Ihre Eingabe kontrollieren. Mit der Authentifizierungsart „Pass Through“ wird der Matrix42 Service Benutzer verwendet, unter der die Matrix42 Windowsdienste und der IIS-Applikationpool läuft. In diesem Fall müssen Sie kein Passwort eingeben.

Abbildung 1: Fehlermeldung nachdem Klick auf „Test Credentials“, das Passwort war falsch.

 

Abbildung 2: Einstellungen waren alle richtig, die Verbindung wurde erfolgreich aufgebaut.

Wenn Sie einen Fehler erhalten, versuchen Sie es auch außerhalb vom Workflow Studio, um sicherzugehen, dass die Zugangsdaten stimmen. Wenn Sie die richtigen Zugangsdaten verwendet haben, können Sie die Eingaben mit der Schaltfläche „Save“ speichern.

 

 

Add SharePoint Item

Diese Activity erstellt neue Elemente in einer SharePoint Liste. Als optionaler Rückgabewert kann die ID des angelegten Elementes verwendet werden.

          Parameter Name Beschreibung
1. New SharePoint List Item ID ID des angelegten Elementes im SharePoint
2. Connection Variable enthält die Connection zum SharePoint
3. List Name Dies ist der SharePoint Listenname
4. New List Item Field Assignment In dieser Liste können Sie die SharePoint Felder mit den Workflow Variablen verbinden.

 

 

 

Delete SharePoint Item

Löschen von Elementen aus einer SharePoint Liste.

          Parameter Name Beschreibung
1. SharePoint List Item ID ID des zu löschenden Elementes im SharePoint
2. Connection Variable enthält die Connection zum SharePoint
3. List Name Dies ist der SharePoint Listenname

 

 

 

Edit SharePoint Item

Änderung von vorhandenen Elementen aus einer SharePoint Liste.

          Parameter Name Beschreibung
1. SharePoint List Item ID ID des zu ändernden Elementes im SharePoint
2. Connection Variable enthält die Connection zum SharePoint
3. List Item Field Assignments In dieser Liste können Sie die SharePoint Felder mit den Workflow Variablen verbinden
4. List Name Dies ist der SharePoint Listenname

 

 

 

Get SharePoint Items

Holt alle Elemente aus einer Liste, gefiltert auf einen vorgegebenen Wert, um die Anzahl der Elemente direkt einzuschränken. Weiterhin werden nur die Felder geholt, die ausgewählt worden sind. Als Filterwert kann jeder Wert aus der SharePoint Liste verwendet werden (GetSharePointItem kann nur die SharePoint ID verwenden).

          Parameter Name Beschreibung
1. SharePoint List Item Field Dies ist der Feldname in der SharePoint Liste, die als Filter Feldname verwendet werden soll.
2. SharePoint List Item Value Dies ist die Workflow Variable oder Expression die als Filterwert verwendet wird, beispielsweise „CMP0004“.
3. Result Rückgabe der Liste in eine Liste von Dictionaries vom Typ List<Dictionary<String,Object>>. Die Schlüssel sind die jeweiligen Spaltennamen. In den Werten befinden sich die Rückgabewerte.
4. Connection Variable enthält die Connection zum SharePoint
5. List Nachdem Klick auf „Select List“ wird der Listenname eingegeben. Weiterhin können jetzt die Felder ausgewählt werden, die bei der Abfrage geholt werden.

 

 

 

Get SharePoint Item

Holt ein Element mit einer bestimmten ID aus der Liste. Es werden nur die Felder geholt, die ausgewählt worden sind. Soll nach anderen Feldnamen gefiltert werden muss die Activity „Get SharePoint Items“ verwendet werden.

          Parameter Name Beschreibung
1. SharePoint List Item ID SharePoint ID des abzufragenden Elements. Es handelt sich hier um die Standard ID (Int32) aus der SharePoint Liste.
2. Result Rückgabe der Liste in ein Dictionary vom Typ Dictionary<String,Object>. Die Schlüssel sind die jeweiligen Spaltennamen. In den Werten befinden sich die Rückgabewerte.
3. Connection Variable enthält die Connection zum SharePoint
4. List Nachdem Klick auf „Select List“ wird der Listenname eingegeben. Weiterhin können jetzt die Felder ausgewählt werden, die bei der Abfrage geholt werden.