Vorlagen ermöglichen es Ihnen, die Struktur bestehender Projekte wiederzuverwenden, um neue Initiativen mit demselben bereits vorhandenen Rahmen zu starten.


Übersicht über Vorlagen

Blue unterstützt zwei Arten von Vorlagen:

  • Unternehmensvorlagen: Von Ihrer Organisation für den internen Gebrauch erstellt
  • Offizielle Vorlagen: Von Blue für alle Benutzer erstellt (industriestandardisierte Vorlagen)

Vorlagen bewahren die gesamte Projektstruktur, einschließlich Todos, Listen, benutzerdefinierte Felder, Automatisierungen und mehr.

Listen von Vorlagen

Verwendung der Vorlagen-Abfrage

query GetTemplates {
  templates(
    companyId: "company-123"
    isOfficialTemplate: false
    category: MARKETING
  ) {
    id
    name
    description
    category
    isOfficialTemplate
    icon
    color
    image {
      thumbnail
      small
    }
  }
}

Verwendung von projectList mit Vorlagenfilter

query ListTemplates {
  projectList(
    filter: {
      companyIds: ["company-id"]
      isTemplate: true
    }
    sort: [updatedAt_DESC]
    take: 20
    skip: 0
  ) {
    items {
      id
      slug
      name
      description
      category
      isTemplate
      isOfficialTemplate
      color
      icon
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      totalItems
    }
    totalCount
  }
}

Projekt aus Vorlage erstellen

Um ein neues Projekt aus einer bestehenden Vorlage zu erstellen:

mutation CreateFromTemplate {
  createProject(
    input: {
      templateId: "template-id-or-slug"
      name: "Q1 Marketing Campaign"
      companyId: "company-id"
      description: "Marketing initiatives for Q1"
      color: "#10B981"
    }
  ) {
    id
    name
    slug
  }
}
Die Erstellung aus einer Vorlage ist ein asynchroner Prozess. Das Projekt wird sofort erstellt, aber der Inhalt wird im Hintergrund kopiert. Verwenden Sie die `copyProjectStatus`-Abfrage, um den Fortschritt zu verfolgen.

Projekt in Vorlage umwandeln

Ein bestehendes Projekt in eine wiederverwendbare Vorlage umwandeln:

mutation ConvertToTemplate {
  convertProjectToTemplate(
    input: {
      projectId: "project-123"
      isOfficialTemplate: false
    }
  ) {
    id
    name
    isTemplate
    isOfficialTemplate
  }
}

Vorlagenstatus entfernen

Eine Vorlage zurück in ein reguläres Projekt umwandeln:

mutation RemoveTemplateStatus {
  removeProjectFromTemplates(projectId: "template-123") {
    id
    name
    isTemplate
  }
}

Einzelne Vorlage abrufen

Details zu einer bestimmten Vorlage abrufen:

query GetTemplate {
  template(templateId: "template-123") {
    id
    name
    description
    category
    isOfficialTemplate
    todoLists {
      name
      todos {
        title
      }
    }
  }
}

Abfrageparameter

templates-Abfrage

Parameter Typ Erforderlich Beschreibung
companyId String Nein Vorlagen nach Unternehmen filtern. Auslassen, um offizielle Vorlagen anzuzeigen.
isOfficialTemplate Boolean Nein Nur offizielle Blue-Vorlagen anzeigen
category ProjectCategory Nein Nach Projektkategorie filtern

convertProjectToTemplate-Eingabe

Parameter Typ Erforderlich Beschreibung
projectId String! ✅ Ja Das Projekt, das in eine Vorlage umgewandelt werden soll
isOfficialTemplate Boolean! ✅ Ja Als offizielle Vorlage markieren (nur für Blue-Mitarbeiter)

Vorlagenkategorien

Wert Beschreibung
CRM Kundenbeziehungsmanagement
CROSS_FUNCTIONAL Projekte für funktionsübergreifende Teams
CUSTOMER_SUCCESS Initiativen zum Kundenerfolg
DESIGN Design- und Kreativprojekte
ENGINEERING Ingenieurwesen und Entwicklung
GENERAL Allgemeine Projekte (Standard)
HR Personalwesen
IT Informationstechnologie
MARKETING Marketingkampagnen
OPERATIONS Betrieb und Logistik
PRODUCT Produktmanagement
SALES Vertrieb und Geschäftsentwicklung

Was aus Vorlagen kopiert wird

Beim Erstellen eines Projekts aus einer Vorlage wird Folgendes kopiert:

  • Struktur: Alle Todo-Listen und Todos mit ihren Positionen
  • Inhalt: Beschreibungen, Kommentare und Anhänge
  • Organisation: Tags, Labels und benutzerdefinierte Felder
  • Automatisierung: Alle Automatisierungsregeln und Workflows
  • Formulare: Projektformulare und deren Konfigurationen
  • Dokumente: Wiki-Seiten und Dokumentationen
  • Einstellungen: Cover-Konfigurationen und Anzeigeeinstellungen
  • Rollen: Benutzerrollendefinitionen (aber keine Benutzerzuweisungen)

Nicht kopiert:

  • ❌ Benutzerzuweisungen (außer dem Ersteller)
  • ❌ Aktivitätsverlauf
  • ❌ Zeitverfolgungsdaten
  • ❌ Abgeschlossenheitsstatus von Todos

Erforderliche Berechtigungen

Vorlagen erstellen

Aktion Erforderliche Rolle
Convert project to template Project OWNER or ADMIN
Create official template Blue employee only
Remove template status Project OWNER or ADMIN

Vorlagen verwenden

Vorlagentyp Wer kann verwenden
Company templates Users in the same company
Official templates All Blue users

Fehlermeldungen

Vorlage nicht gefunden

{
  "errors": [{
    "message": "Template not found",
    "extensions": {
      "code": "TEMPLATE_NOT_FOUND"
    }
  }]
}

Zu viele Todos

{
  "errors": [{
    "message": "This project has more than 250,000 todos and cannot be used as a template",
    "extensions": {
      "code": "TOO_MANY_TODOS"
    }
  }]
}

Wichtige Hinweise

  • Größenbeschränkung: Projekte mit mehr als 250.000 Todos können nicht als Vorlagen verwendet werden
  • Asynchrone Kopie: Der Inhalt der Vorlage wird im Hintergrund über eine Jobwarteschlange kopiert
  • Archivstatus: Die Umwandlung in eine Vorlage archiviert das Projekt automatisch
  • Ordnerentfernung: Vorlagen werden aus Ordnern entfernt, wenn sie umgewandelt werden
  • Zugriffskontrolle: Offizielle Vorlagen sind für alle sichtbar, Unternehmensvorlagen nur für Mitglieder
  • Echtzeit-Updates: Abonnieren Sie Änderungen an Vorlagen mit dem subscribeToProject-Abonnement

KI-Assistent

Antworten werden mit KI generiert und können Fehler enthalten.

Wie kann ich Ihnen helfen?

Fragen Sie mich alles über Blue oder diese Dokumentation.

Eingabe zum Senden • Shift+Eingabe für neue Zeile • ⌘I zum Öffnen