Lieferumfang

Service-Katalog-Services

Info

Eine Beschreibung, wo die Serviceformulare zu finden sind, ist im FAQ zu finden.

Delete Dracoon User Service

Dieser Service ermöglicht das Löschen eines Nutzers anhand der DracoonUserId aus einem Katalog. Bei der Auslieferung ist kein Katalog voreingestellt; dieser muss manuell gesetzt werden.

Dracoon Room Permission

Mit diesem Service können Berechtigungen für einen Raum anhand der UserId und RoomId gesetzt werden. Auch hier ist bei der Auslieferung kein Katalog voreingestellt und muss manuell gesetzt werden.

Delete Dracoon Room Service

Dieser Service ermöglicht das Löschen eines Raums anhand der Room/NodeId. Der Katalog ist bei der Auslieferung nicht voreingestellt und muss manuell gesetzt werden.

Dracoon Data Room

Mit diesem Service kann ein Raum anhand eines Namens erstellt werden. Der Katalog ist bei der Auslieferung nicht voreingestellt und muss manuell gesetzt werden.

Dracoon Permissions

Dieser Service ermöglicht es, einem Nutzer Berechtigungen für einen Raum zu erteilen. Der Katalog ist bei der Auslieferung nicht voreingestellt und muss manuell gesetzt werden.

Dracoon User

Mit diesem Service kann ein Nutzer in Dracoon angelegt werden. Der Katalog ist bei der Auslieferung nicht voreingestellt und muss manuell gesetzt werden.

Remove Dracoon Permissions

Dieser Service entzieht einem Dracoon-Nutzer die Rechte für einen Raum anhand der RaumId. Der Katalog ist bei der Auslieferung nicht voreingestellt und muss manuell gesetzt werden.

Workflow-Aktivitäten

Dracoon: Add Dracoon Data Room Member

Mit dieser Aktivität kannst du einem bestehenden Dracoon-Datenraum einen neuen Nutzer hinzufügen. Dabei legst du fest, welche Berechtigungen der Nutzer im Datenraum erhält. Diese Berechtigungen umfassen das Erstellen, Ändern, Löschen und Verwalten von Inhalten sowie den Zugriff auf den Papierkorb.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Change	`Boolean`	✔	Berechtigung des Nutzers, Inhalte zu ändern	`True`
Create	`Boolean`	✔	Berechtigung des Nutzers, neue Inhalte zu erstellen	`True`
Data Room ID	`Integer`	✔	ID des Datenraums, dem der Nutzer hinzugefügt wird	`123`
Delete	`Boolean`	✔	Berechtigung des Nutzers, Inhalte zu löschen	`True`
Delete Recycle Bin	`Boolean`	✔	Berechtigung des Nutzers, den Papierkorb zu leeren	`True`
Manage	`Boolean`	✔	Berechtigung des Nutzers, den Datenraum zu verwalten	`True`
Manage Download Share	`Boolean`	✔	Berechtigung des Nutzers, Download-Shares zu verwalten	`True`
Manage Upload Share	`Boolean`	✔	Berechtigung des Nutzers, Upload-Shares zu verwalten	`True`
Read	`Boolean`	✔	Berechtigung des Nutzers, Inhalte zu lesen	`True`
Read Recycle Bin	`Boolean`	✔	Berechtigung des Nutzers, den Papierkorb einzusehen	`True`
Restore Recycle Bin	`Boolean`	✔	Berechtigung des Nutzers, Inhalte aus dem Papierkorb wiederherzustellen	`True`
User ID	`Integer`	✔	DracoonId des Nutzers, der hinzugefügt wird	Output UserId Variable im WF Studio

Dracoon: Create Dracoon Data Room

Mit dieser Aktivität kannst du einen neuen Dracoon-Datenraum erstellen. Du bestimmst den Namen und die Notizen des Raums und legst fest, welche Administratoren oder Gruppen Zugriff haben. Optional kannst du den Raum in einem übergeordneten Datenraum platzieren und eine Speicherbegrenzung festlegen.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Room Name	`String`	✔	Name des Raums	`"Testraum"`
Room Notes	`String`	✔	Notizen an einem Raum	`"Für Testzwecke"`
Admins	`Integer[]`	✖	Entweder Admin oder Gruppe muss gesetzt sein.	`New List(Of Integer) ({UserID des ServiceNutzers, DracoonUserID von 2. Admin})`
Groups	`Integer[]`	✖	Entweder Admin oder Gruppe muss gesetzt sein.	`New List(Of Integer) ({RoleId})`
Parent Data Room ID	`Integer`	✖	ID des überliegenden Raums	`324`
Quota	`Long`	✖	Erfordert einen Wert in Bytes zur Bestimmung der Größe des Datenraums	`524288000` (500 MiB)

Dracoon: Create Dracoon Data Room Folder

Mit dieser Aktivität kannst du einen neuen Ordner in einem bestehenden Dracoon-Datenraum erstellen. Du benötigst ein Access Token, um die Berechtigung zu erhalten, und musst den Namen des Ordners angeben. Optional kannst du die ID des übergeordneten Raums festlegen, in dem der Ordner erstellt werden soll.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Folder Name	`String`	✔	Name des Ordners im Datenraum	`"Zeugnisse"`
Parent Room ID	`Integer`	✖	ID des überliegenden Raums	`324`

Mit dieser Aktivität kannst du einen Download-Share in Dracoon erstellen. Ein Download-Share ermöglicht es, Dateien oder Datenräume mit anderen zu teilen, indem ein Link generiert wird. Du kannst festlegen, ob der Share ein Ablaufdatum hat, wie viele Downloads erlaubt sind und ob ein Passwort erforderlich ist. Zudem kannst du den Inhalt der Benachrichtigungs-E-Mail anpassen und entscheiden, ob der Name des Erstellers angezeigt wird.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Node ID	`Integer`	✔	Ein Knoten kann entweder eine DataRoomId oder eine FileId sein	`324`
Mail Body	`String`	✖	Kann benutzt werden, um den Mailinhalt zu definieren	`"Willkommen im Labtagon Onboarding!"`
Enable Dracoon Mailing	`Boolean`	✖	Dracoon-System verschickt die Mail für den Downloadshare	`True`
Enable Expiration	`Boolean`	✖	Ob ein Ablauf des Shares eingestellt werden soll	`True`
Expire At	`DateTime`	✖	Datum, an dem der Share ablaufen soll (YYYY/DD/MM)	`New DateTime(2022, 2, 1)`
Internal Notes	`String`	✖	Interne Notizen	`"läuft ab"`
Max Downloads	`Integer`	✖	Anzahl an verfügbaren Downloads	`10`
Name	`String`	✖	Name des Shares	`"TestShare"`
Notes	`String`	✖	Notizen	`"Für Arbeitszeitberichte"`
Password	`String`	✖	Passwort für Share	`"TestPasswort"`
Recipient mail addresses	`String[]`	✖	Empfänger der Mailadresse	`"test@test.de"`
Show Creator Name	`Boolean`	✖	Zeigt den Ersteller des Shares	`True`

Ausgabe-Argumente

Name	Typ	Beschreibung	Beispiel
Share Id	`Integer`	Die ID des erstellten Download-Shares	`12`
Share Url	`String`	Die URL des erstellten Download-Shares	`"https://example.com/share"`

Mit der Create Dracoon Upload Share-Aktivität kannst du einen Upload-Share in Dracoon erstellen. Ein Upload-Share ermöglicht es, Dateien in einen bestimmten Datenraum hochzuladen. Du kannst festlegen, ob der Share ein Ablaufdatum hat, wie viele Dateien hochgeladen werden können und welche maximale Dateigröße erlaubt ist. Zudem kannst du den Inhalt der Benachrichtigungs-E-Mail anpassen und entscheiden, ob der Name des Erstellers angezeigt wird.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Target ID	`Integer`	✔	Muss eine valide DatenraumId sein	`324`
Mail Body	`String`	✖	Kann benutzt werden, um den Mailinhalt zu definieren	`"Willkommen im Labtagon Onboarding!"`
Enable Dracoon Mailing	`Boolean`	✖	Dracoon-System verschickt die Mail für den Downloadshare	`True`
Enable Expiration	`Boolean`	✖	Ob ein Ablauf des Shares eingestellt werden soll	`True`
Expire At	`DateTime`	✖	Datum, an dem der Share ablaufen soll (YYYY/DD/MM)	`New DateTime(2022, 2, 1)`
Files Expiry Period	`Integer`	✖	Hochgeladene Dateien laufen nach xy Tagen ab. 0 setzen, um niemals abzulaufen	`0`
Internal Notes	`String`	✖	Interne Notizen	`"läuft nicht ab"`
Max Size	`Integer`	✖	Maximale Größe der Dateien in Bytes	`52428800` (50 MiB)
Max Slots	`Integer`	✖	Maximale Anzahl der hochladbaren Dateien	`25`
Name	`String`	✖	Name des Shares	`"TestShare"`
Notes	`String`	✖	Notizen	`"Für Arbeitszeitberichte"`
Password	`String`	✖	Passwort für Share	`"TestPasswort"`
Recipient mail addresses	`String[]`	✖	Empfänger der Mailadresse	`"test@test.de"`
Show Creator Name	`Boolean`	✖	Zeigt den Ersteller des Uploads	`True`
Show Creator Username	`Boolean`	✖	Zeigt den Nutzernamen des Uploaders
Show Uploaded Files	`Boolean`	✖	Hochgeladene Dateien sind einsehbar	`True`

Ausgabe-Argumente

Name	Typ	Beschreibung	Beispiel
Share Id	`Integer`	Die ID des erstellten Upload-Shares	`12`
Share Url	`String`	Die URL des erstellten Upload-Shares	`"https://example.com/share"`

Dracoon: Delete Dracoon Data Room

Lösche einen oder mehrere Datenräume in Dracoon.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Data Room IDs	`Integer[]`	✔	Liste mit IDs der zu löschenden Datenräume	`New List(Of Integer)({324, 325})`

Dracoon: Delete Dracoon Data Room Member

Entferne Mitglieder aus einem Dracoon-Datenraum.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Data Room ID	`Integer`	✔	ID des Datenraums, aus dem Mitglieder entfernt werden sollen	`324`
Users	`Integer[]`	✔	Liste mit User-IDs, die entfernt werden sollen	`New List(Of Integer)({101, 102})`

Lösche einen oder mehrere Download-Shares in Dracoon.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Share Ids	`Integer[]`	✔	Array der IDs der zu löschenden Download-Shares	`{12, 13}`

Lösche einen oder mehrere Upload-Shares in Dracoon.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Share Ids	`Integer[]`	✔	Array der IDs der zu löschenden Upload-Shares	`{21, 22}`

Dracoon: Delete Dracoon File

Entferne eine Datei aus Dracoon.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
File ID	`Long`	✔	ID der zu löschenden Datei	`987654321`

Dracoon: Delete Dracoon User

Entferne einen Benutzer aus Dracoon.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
User ID	`Integer`	✔	ID des zu löschenden Benutzers	`101`

Dracoon: Create Dracoon User

Erstelle einen neuen Benutzer in Dracoon.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Email	`String`	✔	E-Mail-Adresse des Nutzers	`"neuer.user@test.de"`
First Name	`String`	✔	Vorname des Nutzers	`"Max"`
Last Name	`String`	✔	Nachname des Nutzers	`"Mustermann"`
Notifiy User	`Boolean`	✔	Falls true, erhält der Nutzer eine Benachrichtigung	`True`
User Name	`String`	✔	Benutzername für Dracoon	`"max.mustermann"`
Active Directory Configuration Id	`Integer`	✖	AD-Konfigurations-ID (falls AD-Anbindung)	`5`
Return Error if User already exists	`Boolean`	✖	Ob Fehler geworfen wird, wenn Nutzer schon existiert	`False`
Expiration Date	`DateTime`	✖	Ablaufdatum des Nutzerkontos	`New DateTime(2025, 12, 31)`
Login	`String`	✖	Benutzerlogin (falls abweichend vom User Name)	`"maxmuster"`
Must Change Password	`Boolean`	✖	Erzwingt Passwortänderung bei nächstem Login	`True`
OpenId Configuration Id	`Integer`	✖	OpenID-Konfigurations-ID	`3`
Password	`String`	✖	Passwort für den neuen Nutzer	`"SicheresPasswort123"`
Phone Number	`String`	✖	Telefonnummer des Nutzers	`"+49 123 456789"`

Dracoon: Download Dracoon File

Lade eine Datei aus Dracoon herunter.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
FileName	`String`	✔	Name der herunterzuladenden Datei	`"bericht.pdf"`
Target Directory	`String`	✔	Zielverzeichnis lokal	`"C:\Downloads"`
Dracoon File ID	`Integer`	✖	ID der Datei (falls bekannt)	`1234`
File Output Path	`String`	✖	Vollständiger Zielpfad inkl. Dateiname	`"C:\Downloads\bericht_neu.pdf"`

Dracoon: Get Dracoon Access Token

Erhalte ein Access Token für die Dracoon-API.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Base URI	`String`	✔	Basis-URL der Dracoon-Instanz	`"https://dracoon.example.com"`
Client ID	`String`	✔	API-Client-ID	`"my-client-id"`
Client Secret	`String`	✔	API-Client-Secret	`"my-client-secret"`
Password	`String`	✔	Passwort des Benutzers	`"MeinPasswort123"`
User Name	`String`	✔	Benutzername für Login	`"mein.benutzer"`

Dracoon: Get Dracoon Data Rooms

Rufe Datenräume aus Dracoon ab.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Limit	`Integer`	✔	Anzahl der zurückzugebenden Räume	`50`
Parent Room ID	`Integer`	✔	0 für Top-Level-Räume	`0`
Room Manager	`Boolean`	✔	Falls true, nur Räume mit Managerrechten anzeigen	`True`

Dracoon: Get Dracoon Files

Rufe Dateien aus einem Dracoon-Datenraum ab.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Parent Room ID	`Integer`	✔	ID des Datenraums, aus dem Dateien geladen werden sollen	`324`

Dracoon: Get Dracoon Roles

Erhalte eine Liste der Rollen in Dracoon.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio

Ausgabe-Argumente

Name	Typ	Beschreibung	Beispiel
Roles	List	Ausgabe der Liste aller Rollen mit Name und Id	`{12, Admin; 11, Bearbeiter;}`

Dracoon: Get Dracoon Shares

Rufe Shares aus Dracoon ab.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Limit	`Integer`	✔	Anzahl der zurückzugebenden Shares	`50`
Offset	`Integer`	✔	Start-Offset für Paging	`0`

Dracoon: Get Dracoon User

Finde einen Benutzer in Dracoon.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
E-Mail	`String`	✔	E-Mail-Adresse des gesuchten Nutzers	`"benutzer@test.de"`

Ausgabe-Argumente

Name	Typ	Beschreibung	Beispiel
User Found	`Boolean`	Gibt an, ob der Nutzer gefunden wurde	`True`
User ID	`Integer`	Dracoon-ID des Nutzers	`101`

Dracoon: Get Dracoon Users From Data Room

Rufe Nutzer aus einem Dracoon-Datenraum ab.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Data Room ID	`Integer`	✔	ID des Datenraums, aus dem Nutzer abgerufen werden sollen	`324`

Dracoon: Set Room Policy

Setze die Raumrichtlinien in Dracoon.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
Access Token	`AccessToken`	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
Virus Protection Enabled	`Boolean`	✔	Aktiviert/Deaktiviert Virenschutz für den Raum	`True`
Default Expiration Period	`Integer`	✖	Standard-Ablaufzeit in Tagen	`30`
Room Id	`Integer`	✖	ID des betroffenen Raums	`324`

Dracoon: Upload Dracoon File

Lade eine Datei in Dracoon hoch.

Eingabe-Argumente

Name	Typ	Erforderlich	Beschreibung	Beispiel
`AccessToken`	AccessToken	✔	AccessToken aus dem Output der AccessToken Activity	AccessToken-Variable im WF Studio
File Path	`String`	✔	Vollständiger lokaler Pfad zur hochzuladenden Datei	`"C:\Dokumente\bericht.pdf"`
Expiration	Expiration	✖	Benötigt ein neues Expiration-Objekt	`new Labtagon.M42.DracoonConnector.Contracts.Expiration{EnableExpiration = 0/1, ExpireAt = new DateTime()}`
Notes	`String`	✖	Notizen zum Upload	`"Jahresbericht"`
Dracoon Parent Room ID	`Integer`	✖	ID des Ziel-Datenraums	`324`