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
  }
}
Att skapa från en mall är en asynkron process. Projektet skapas omedelbart, men innehåll kopieras i bakgrunden. Använd `copyProjectStatus` frågan för att spåra framsteg.

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

AI-assistent

Svar genereras med hjälp av AI och kan innehålla misstag.

Hur kan jag hjälpa dig?

Fråga mig vad som helst om Blue eller denna dokumentation.

Tryck Enter för att skicka • Shift+Enter för ny rad • ⌘I för att öppna