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
}
}
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