---

Ein Projekt archivieren

Das Archivieren von Projekten ist nützlich, wenn Sie ein Projekt vorübergehend ausblenden möchten, ohne es dauerhaft zu löschen. Archivierte Projekte:

• Sind aus aktiven Projektlisten ausgeblendet
• Können nicht bearbeitet oder verändert werden
• Können weiterhin von Projektmitgliedern eingesehen werden
• Können jederzeit dearchiviert werden

Einfaches Beispiel

mutation {
  archiveProject(id: "project-123")
}

Verwendung des Projektkontext-Headers

# With header: x-bloo-project-id: project-123
mutation {
  archiveProject
}

Mit Variablen

mutation ArchiveProject($projectId: String!) {
  archiveProject(id: $projectId)
}

Variablen:

{
  "projectId": "abc123-project-id"
}

Ein Projekt dearchivieren

Um ein archiviertes Projekt wieder in den aktiven Status zu versetzen:

mutation {
  unarchiveProject(id: "project-123")
}

Mutationsparameter

archiveProject

Parameter	Typ	Erforderlich	Beschreibung
id	String	Nein	Die Projekt-ID, die archiviert werden soll. Wenn nicht angegeben, wird das Projekt aus den Kontext-Headern verwendet.

unarchiveProject

Parameter	Typ	Erforderlich	Beschreibung
id	String	Nein	Die Projekt-ID, die dearchiviert werden soll. Wenn nicht angegeben, wird das Projekt aus den Kontext-Headern verwendet.

Antwort

Beide Mutationen geben einen Boolean zurück, der den Erfolg anzeigt:

Feld	Typ	Beschreibung
Boolean	Boolean!	Gibt true zurück, wenn die Operation erfolgreich ist

Erforderliche Berechtigungen

Projektrolle	Kann archivieren/dearchivieren
OWNER	✅ Ja
ADMIN	✅ Ja
MEMBER	❌ Nein
CLIENT	❌ Nein
COMMENT_ONLY	❌ Nein
VIEW_ONLY	❌ Nein

Projekt-ID-Auflösung

Die Projekt-ID kann auf zwei Arten angegeben werden:

1. Als Parameter (empfohlen):

   archiveProject(id: "project-123")
   

2. Über den HTTP-Header:

   • x-bloo-project-id: project-123 (bevorzugt)
   • x-project-id: project-123 (veraltet)

Wenn beide angegeben sind, hat der Parameter Vorrang.

Fehlermeldungen

Projekt nicht gefunden

{
  "errors": [{
    "message": "Project was not found.",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

Unzureichende Berechtigungen

{
  "errors": [{
    "message": "You don't have permission to archive this project",
    "extensions": {
      "code": "UNAUTHORIZED"
    }
  }]
}

Was passiert beim Archivieren

Wenn Sie ein Projekt archivieren:

1. Projektstatus: Das Projekt wird als archiviert markiert
2. Sichtbarkeit: Aus aktiven Projektlisten ausgeblendet
3. Vorlagen: Wenn das Projekt eine Vorlage war, verliert es den Vorlagenstatus
4. Position: An das Ende der Projektliste des Benutzers verschoben
5. Ordner: Aus allen Projektordnern entfernt
6. Aktivitätsprotokoll: Archivierungsaktion wird aufgezeichnet
7. Echtzeit-Updates: Alle verbundenen Benutzer werden benachrichtigt

Wichtige Hinweise

• Idempotente Operation: Das Archivieren eines bereits archivierten Projekts gibt true ohne Änderungen zurück
• Rückgängig: Verwenden Sie unarchiveProject, um das Projekt wiederherzustellen
• Zugriffsrechte: Archivierte Projekte bleiben für bestehende Mitglieder einsehbar
• Kein Datenverlust: Das Archivieren bewahrt alle Projektdaten, im Gegensatz zur Löschung
• Alternative zur Löschung: Ziehen Sie in Betracht, Projekte anstelle von Löschungen vorübergehend zu archivieren