Benutzer zu Gruppe hinzufügen

Dieser Service Task weist einen Benutzer einer bestehenden Gruppe zu.

Nutzen: Prozesse können organisatorische Änderungen automatisieren — neue Mitarbeiter während des Onboardings ihrem Team zuordnen, Benutzer dynamisch Projektgruppen zuweisen oder rollenbasierten Zugriff über Gruppenmitgliedschaften verwalten.

Funktionsweise

Anhand einer Benutzer-ID (userSub) und einer Gruppen-ID (groupId) wird die Gruppenzuordnung in der Datenbank erstellt. Optional kann ein Anzeigename für den Mitgliedschaftseintrag angegeben werden.

Ist der Benutzer bereits Mitglied der Gruppe, wird die Zuordnung überschrieben (idempotent).

Eingabeparameter

Parameter	Typ	Pflicht	Beschreibung
`userSub`	String	Ja	Die Cognito User-Sub (eindeutige Benutzer-ID) des zuzuweisenden Benutzers.
`groupId`	String	Ja	Die ID der Gruppe, der der Benutzer zugewiesen werden soll.
`displayName`	String	Nein	Ein Anzeigename für den Mitgliedschaftseintrag (z. B. der vollständige Name des Benutzers).

Beispiel-Eingabe

{
  "userSub": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "groupId": "sales",
  "displayName": "Max Mustermann"
}

Ausgabe

Feld	Typ	Beschreibung
`success`	Boolean	`true`, wenn die Zuweisung erstellt wurde.
`userSub`	String	Die Benutzer-ID.
`groupId`	String	Die Gruppen-ID.
`displayName`	String	Der mit der Zuweisung gespeicherte Anzeigename.

Beispiel-Ausgabe

{
  "success": true,
  "userSub": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "groupId": "sales",
  "displayName": "Max Mustermann"
}

Anwendungsfälle

Mitarbeiter-Onboarding: Neue Mitarbeiter automatisch ihrer Abteilung und Projektgruppen zuordnen.
Projektbesetzung: Benutzer projektspezifischen Gruppen zuweisen, wenn ein Projekt startet.
Rollenrotation: Benutzer basierend auf Zeitplanung oder Workflow-Logik zwischen Gruppen verschieben.
Self-Service-Anfragen: Benutzern ermöglichen, Gruppenmitgliedschaften über einen Prozess mit Genehmigungsschritten anzufordern.

Hinweise

Die Gruppe muss bereits existieren. Gruppen werden über die Verwaltungsoberfläche erstellt, oder mit Alle Gruppen auflisten kann die Verfügbarkeit geprüft werden.
Ist der Benutzer bereits in der Gruppe, wird die Operation ohne Fehler ausgeführt (idempotentes Überschreiben).
Dieser Task verwaltet Pantarey-Benutzergruppen, nicht Cognito-Gruppen. Die Zuweisung wird in DynamoDB gespeichert.