Mallar gör att du kan återanvända strukturen av befintliga projekt för att kickstarta nya initiativ med samma ramverk redan på plats.
Översikt över Mallar
Blue stöder två typer av mallar:
- Företagsmallar: Skapade av din organisation för internt bruk
- Officiella mallar: Skapade av Blue för alla användare (branschstandardmallar)
Mallar bevarar hela projektstrukturen inklusive att-göra-listor, listor, anpassade fält, automatiseringar och mer.
Lista Mallar
Använda mallar Query
query GetTemplates {
templates(
companyId: "company-123"
isOfficialTemplate: false
category: MARKETING
) {
id
name
description
category
isOfficialTemplate
icon
color
image {
thumbnail
small
}
}
}
Använda projectList med Mallfilter
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
}
}
Skapa Projekt från Mall
För att skapa ett nytt projekt från en befintlig mall:
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
}
}
Konvertera Projekt till Mall
Transformera ett befintligt projekt till en återanvändbar mall:
mutation ConvertToTemplate {
convertProjectToTemplate(
input: {
projectId: "project-123"
isOfficialTemplate: false
}
) {
id
name
isTemplate
isOfficialTemplate
}
}
Ta Bort Mallstatus
Konvertera en mall tillbaka till ett vanligt projekt:
mutation RemoveTemplateStatus {
removeProjectFromTemplates(projectId: "template-123") {
id
name
isTemplate
}
}
Hämta Enskild Mall
Hämta detaljer om en specifik mall:
query GetTemplate {
template(templateId: "template-123") {
id
name
description
category
isOfficialTemplate
todoLists {
name
todos {
title
}
}
}
}
Frågeparametrar
templates Query
Parameter | Typ | Obligatorisk | Beskrivning |
---|---|---|---|
companyId |
String | Nej | Filtrera mallar efter företag. Utelämna för att se officiella mallar. |
isOfficialTemplate |
Boolean | Nej | Visa endast officiella Blue-mallar |
category |
ProjectCategory | Nej | Filtrera efter projektkategori |
convertProjectToTemplate Input
Parameter | Typ | Obligatorisk | Beskrivning |
---|---|---|---|
projectId |
String! | ✅ Ja | Projektet som ska konverteras till en mall |
isOfficialTemplate |
Boolean! | ✅ Ja | Markera som officiell mall (endast Blue-anställda) |
Mallkategorier
Värde | Beskrivning |
---|---|
CRM |
Kundrelationshantering |
CROSS_FUNCTIONAL |
Tvärfunktionella teamprojekt |
CUSTOMER_SUCCESS |
Kundframgångsinitiativ |
DESIGN |
Design- och kreativa projekt |
ENGINEERING |
Ingenjörs- och utvecklingsprojekt |
GENERAL |
Allmänna projekt (standard) |
HR |
Personalavdelning |
IT |
Informationsteknik |
MARKETING |
Marknadsföringskampanjer |
OPERATIONS |
Drift och logistik |
PRODUCT |
Produktledning |
SALES |
Försäljning och affärsutveckling |
Vad Kopieras från Mallar
När du skapar ett projekt från en mall kopieras följande:
- ✅ Struktur: Alla att-göra-listor och att-göra-punkter med sina positioner
- ✅ Innehåll: Beskrivningar, kommentarer och bilagor
- ✅ Organisation: Taggar, etiketter och anpassade fält
- ✅ Automatisering: Alla automatiseringsregler och arbetsflöden
- ✅ Formulär: Projektformulär och deras konfigurationer
- ✅ Dokument: Wiki-sidor och dokumentation
- ✅ Inställningar: Omslagskonfigurationer och visningspreferenser
- ✅ Roller: Användarrolldefinitioner (men inte användartilldelningar)
Inte kopierat:
- ❌ Användartilldelningar (utom skaparen)
- ❌ Aktivitetshistorik
- ❌ Tidsregistreringsdata
- ❌ Avslutat status för att-göra-punkter
Obligatoriska Behörigheter
Skapa Mallar
Åtgärd | Obligatorisk Roll |
---|---|
Convert project to template | Project OWNER or ADMIN |
Create official template | Blue employee only |
Remove template status | Project OWNER or ADMIN |
Använda Mallar
Malltyp | Vem Kan Använda |
---|---|
Company templates | Users in the same company |
Official templates | All Blue users |
Felmeddelanden
Mall Inte Hittad
{
"errors": [{
"message": "Template not found",
"extensions": {
"code": "TEMPLATE_NOT_FOUND"
}
}]
}
För Många Att-Göra-Punkter
{
"errors": [{
"message": "This project has more than 250,000 todos and cannot be used as a template",
"extensions": {
"code": "TOO_MANY_TODOS"
}
}]
}
Viktiga Anteckningar
- Storleksgräns: Projekt med mer än 250 000 att-göra-punkter kan inte användas som mallar
- Asynkron Kopiering: Mallinnehåll kopieras i bakgrunden via jobbkön
- Arkiveringsstatus: Konvertering till mall avarkiverar automatiskt projektet
- Mappborttagning: Mallar tas bort från mappar när de konverteras
- Åtkomstkontroll: Officiella mallar är synliga för alla, företagsmallar endast för medlemmar
- Real-tidsuppdateringar: Prenumerera på malländringar med hjälp av
subscribeToProject
prenumeration